BLTouch の設定とトラブルシューティング

この記事では、Klipper における BLTouch プローブの配線、設定、テスト、校正、および一般的なトラブルシューティングについて説明します。

関連エラー: BLTouch 関連のエラーの迅速なトラブルシューティングについては、動作、エンドストップ、およびレベリングエラー を参照してください。

配線と設定

作業前の電源オフ

作業を開始する前に、プリンターの電源を完全にオフにし、電源コードを抜いてください。通電状態でのケーブルの抜き差し、端子の整理、または端子への接触は行わないでください。

BLTouch には2組のケーブルがあります：

• 3線（サーボ/制御側）：黄線が control_pin 信号線です。
• 2線（センサー側）：白線が sensor_pin 信号線です。

制御側をマザーボードの Servo / BLTouch 制御ピンに接続し、センサー側をマザーボードの Probe / Z-Max などのエンドストップ入力ピンに接続します。具体的なピンについては、対応する FLY マザーボードの設定ドキュメントを参照してください。

プルアップ抵抗

ほとんどの BLTouch の sensor_pin にはプルアップ抵抗を設定する必要があり、ピン名の前に ^ プレフィックスを付けます。例：sensor_pin: ^PC4。

基本設定例：

[bltouch]
sensor_pin: ^PC4
control_pin: PA1
x_offset: 0
y_offset: 0
z_offset: 0
speed: 5

BLTouch を Z 軸ホーミングエンドストップとして使用する場合は、以下が必要です：

1. [stepper_z] で endstop_pin: probe:z_virtual_endstop を設定し、position_endstop を削除します。
2. [safe_z_home] 設定を追加します：

[safe_z_home]
home_xy_position: 100, 100  # ヒートベッドの中心座標に変更
speed: 50
z_hop: 10                   # ホーミング前に 10mm 上昇
z_hop_speed: 5

z_hop の高さ

z_hop は、プローブが伸びた状態でもヒートベッドや治具に衝突しないよう、十分な高さを確保してください。

初期テスト

セルフテスト

電源投入後、BLTouch は自動的にセルフテストを実行します。プローブが数回上下に伸縮し、完了後は収納され、赤色 LED が常時点灯します。赤色 LED が点滅したり、プローブが伸びたままの状態で停止した場合は、電源を切り、配線と設定を確認してください。

制御ピンテスト

BLTOUCH_DEBUG COMMAND=pin_down

プローブが伸出し、赤色 LED が消灯することを確認します。次に：

BLTOUCH_DEBUG COMMAND=pin_up

プローブが収納され、赤色 LED が再び点灯することを確認します。赤色 LED が点滅する場合は、異常が存在します。

センサーピンテスト

1. BLTOUCH_DEBUG COMMAND=pin_down を実行し、プローブが伸出することを確認します。
2. BLTOUCH_DEBUG COMMAND=touch_mode を実行します。
3. QUERY_PROBE を実行します。probe: open が返されるはずです。
4. 指の爪でプローブを軽く上に押し、再度 QUERY_PROBE を実行します。probe: TRIGGERED が返されるはずです。
5. BLTOUCH_DEBUG COMMAND=pin_up を実行し、プローブを収納します。

QUERY_PROBE の結果が正しくない場合、通常は配線または設定の誤りです（一部のクローンモデルは特別な処理が必要です。下記参照）。

プローブテスト

プリントヘッドをヒートベッドから離れた位置に移動し、G28（または PROBE）を実行します。プリントヘッドが下降し始めたら、指の爪でプローブに軽く触れてトリガーさせます。いつでもプリンターの電源をオフにできるように準備してください。成功したら、プローブをヒートベッドに接触させる通常のホーミングを再度実行します。

障害復旧（赤色 LED 点滅）

BLTouch が異常状態になり、赤色 LED が継続的に点滅している場合は、以下を実行します：

BLTOUCH_DEBUG COMMAND=reset

一般的なトリガー原因：プローブ伸出中に遮られ、キャリブレーションが中断された場合。

reset 後も正常に動作しない場合は、プローブ内部の磁石コアがずれている可能性があります：

作業前の電源オフ

BLTouch プローブの分解や調整を行う前に、プリンターの電源を完全にオフにし、電源コードを抜いてください。

1. 電源を切り、プローブ上部のネジを緩め、ボールペンなどで磁石コアを優しく元の位置に押し戻します。
2. プローブを再度取り付け、自然に伸出位置に落ちるようにします。
3. ネジの位置を慎重に調整し、電源を入れた後、BLTOUCH_DEBUG COMMAND=reset、pin_up、pin_down で伸縮と赤色 LED が正常かどうかをテストします。

クローンモデルの互換性

ほとんどのクローン BLTouch はデフォルト設定で正常に動作しますが、一部のクローンデバイスには以下の問題があります：

重要な注意

必要性を確認せずに、pin_up_reports_not_triggered または pin_up_touch_mode_reports_triggered を False に設定しないでください。正規品の BLTouch ではこれらの2つの項目を変更しないでください。誤った設定はプローブ時間を増加させ、プリンターを損傷する可能性があります。

touch_mode をサポートしていない

一部のクローンデバイスは touch_mode をサポートしておらず、QUERY_PROBE コマンドが正常に機能しませんが、G28 / PROBE は成功する場合があります。このようなデバイスでは probe_with_touch_mode を有効にしないでください。

BLTouch failed to verify sensor state

クローンデバイスは Klipper の内部センサー検証に合格できません。最初に センサーピンテスト で QUERY_PROBE の結果が正しいことを確認してください。手動テストが常に正常であるにもかかわらずエラーが発生する場合は、以下を追加します：

[bltouch]
pin_up_touch_mode_reports_triggered: False

BLTouch failed to raise probe

古いバージョンのクローンデバイスは、プローブ収納状態を報告できません。テスト方法：

1. プリントヘッドをヒートベッドから離れた場所に移動します。
2. BLTOUCH_DEBUG COMMAND=pin_down → 伸出を確認します。
3. QUERY_PROBE → probe: open が返されるはずです。
4. BLTOUCH_DEBUG COMMAND=pin_up → 収納を確認します。
5. QUERY_PROBE → probe: TRIGGERED が返される場合（open ではなく）、デバイスが収納を報告できないことを示します。

確認後、以下を追加します：

[bltouch]
pin_up_reports_not_triggered: False

CRTouch 設定

CRTouch も同様に [bltouch] 設定セクションを使用します。参考設定は以下の通りです：

[bltouch]
sensor_pin: ^<プローブ信号ピン>
control_pin: <制御ピン>
x_offset: 0                  # 実際のプローブからノズルまでの X 偏差に合わせて変更
y_offset: 0                  # 実際の Y 偏差に合わせて変更
z_offset: 2.295              # 初回は近似値を設定し、その後 PROBE_CALIBRATE で校正
probe_with_touch_mode: True  # CRTouch の重要項目、3D Touch とは逆
stow_on_each_sample: False   # 連続プローブ時に伸出状態を維持し、収納・伸出の回数を削減
samples: 2                   # 各ポイントで最低2回プローブ
samples_tolerance: 0.0125    # 2回の差がこの値を超えたら再プローブ
samples_tolerance_retries: 5

CRTouch と 3D Touch の核心的な違い

probe_with_touch_mode: True は CRTouch と 3D Touch の核心的な違いです：3D Touch では有効にすると精度が低下する可能性がありますが、CRTouch では有効にしないと不安定になります。

failed to verify sensor state が報告された場合は、以下を追加してください：

[bltouch]
pin_up_touch_mode_reports_triggered: False

複数回のプローブで収納しない

デフォルトでは、Klipper はプローブのたびにプローブを収納してから再接続するため、複数回のプローブには時間がかかります。以下のオプションを設定すると、連続するプローブ間でプローブを伸出したままにできます：

[bltouch]
stow_on_each_sample: False

安全上の注意

False に設定すると、Klipper はプローブが伸出した状態で水平移動を行う可能性があります。すべてのプローブ操作で Z ギャップが十分にあることを必ず確認してください。そうしないと、水平移動中にプローブが障害物に衝突し、プリンターを損傷する可能性があります。

推奨組み合わせ

stow_on_each_sample: False を使用する場合は、同時に probe_with_touch_mode: True を設定することをお勧めします。これにより、信号ロジックが簡素化され、安定性が向上します。一部のクローンデバイスでは、このオプションを組み合わせないと、後続のトリガーを検出できない場合があります。

オフセット校正

PROBE_CALIBRATE コマンドを使用して、x_offset、y_offset、z_offset を校正します。

Z オフセットの推奨値

z_offset の理想的な値は約 1mm です。偏差が大きすぎる場合は、プローブの取り付け高さを調整することをお勧めします。プローブは、ノズルがヒートベッドに接触する前に十分に早くトリガーし、収納後はノズルよりも高くなり、印刷物への引っかかりを防ぐ必要があります。調整後は、PROBE_CALIBRATE を再度実行する必要があります。

出力モード（5V / Open-Drain）

BLTouch V3.0 および V3.1 は、5V 出力モードと Open-Drain 出力モードの両方をサポートしており、デフォルトは Open-Drain です。

• マザーボードの入力ピンが5V のハイレベルを必要とし、5V に耐えられる場合は、以下を設定できます：

[bltouch]
set_output_mode: 5V

電圧互換性

マザーボードの入力信号線が 5V に耐えられることが確認できている場合のみ、5V モードを使用してください。誤った設定はマザーボードの CPU を損傷する可能性があります。

• V3.0：起動のたびに set_output_mode: 5V で設定する必要があります。V3.0 は設定を記憶できません。
• V3.1：BLTOUCH_STORE MODE=5V を一度実行してモードを内部 EEPROM に書き込むことができ、その後は set_output_mode を設定する必要はありません。ストアコマンドを繰り返し実行しないでください。EEPROM の寿命は約 10 万回です。
• その他のプローブ：一部のプローブは、基板上のジャンパーまたはパターンカットによって出力モードが永続的に設定されており、その場合は set_output_mode パラメータは必要ありません。

出力モード（5V / オープンドレイン）

BLTouch V3.0 および V3.1 は、5V とオープンドレインの 2 つの出力モードをサポートしており、デフォルトはオープンドレインです。

• メインボードの入力ピンが 5V 高レベルを必要とし、かつ 5V に耐性がある場合は、次のように設定できます：

[bltouch]
set_output_mode: 5V

電圧互換性

メインボードの入力信号線が 5V に耐性があることを確認した場合にのみ、5V モードを使用してください。誤った設定はメインボードの CPU を損傷する可能性があります。

• V3.0：V3.0 は記憶できないため、起動するたびに set_output_mode: 5V で設定する必要があります。
• V3.1：一度 BLTOUCH_STORE MODE=5V を実行してモードを内部 EEPROM に書き込めば、その後は set_output_mode を設定する必要はありません。保存コマンドを繰り返し実行しないでください。EEPROM の寿命は約 10 万回です。
• その他のプローブ：一部のプローブは、回路基板のジャンパまたはトレースの切断により出力モードを永続的に設定します。この場合、set_output_mode パラメータは不要です。