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 軸ホーミングエンドストップとして使用する場合は、以下が必要です:
[stepper_z]でendstop_pin: probe:z_virtual_endstopを設定し、position_endstopを削除します。[safe_z_home]設定を追加します:
[safe_z_home]
home_xy_position: 100, 100 # ヒートベッドの中心座標に変更
speed: 50
z_hop: 10 # ホーミング前に 10mm 上昇
z_hop_speed: 5
z_hop は、プローブが伸びた状態でもヒートベッドや治具に衝突しないよう、十分な高さを確保してください。
初期テスト
セルフテスト
電源投入後、BLTouch は自動的にセルフテストを実行します。プローブが数回上下に伸縮し、完了後は収納され、赤色 LED が常時点灯します。赤色 LED が点滅したり、プローブが伸びたままの状態で停止した場合は、電源を切り、配線と設定を確認してください。
制御ピンテスト
BLTOUCH_DEBUG COMMAND=pin_down
プローブが伸出し、赤色 LED が消灯することを確認します。次に:
BLTOUCH_DEBUG COMMAND=pin_up
プローブが収納され、赤色 LED が再び点灯することを確認します。赤色 LED が点滅する場合は、異常が存在します。
センサーピンテスト
BLTOUCH_DEBUG COMMAND=pin_downを実行し、プローブが伸出することを確認します。BLTOUCH_DEBUG COMMAND=touch_modeを実行します。QUERY_PROBEを実行します。probe: openが返されるはずです。- 指の爪でプローブを軽く上に押し、再度
QUERY_PROBEを実行します。probe: TRIGGEREDが返されるはずです。 BLTOUCH_DEBUG COMMAND=pin_upを実行し、プローブを収納します。
QUERY_PROBE の結果が正しくない場合、通常は配線または設定の誤りです(一部のクローンモデルは特別な処理が必要です。下記参照)。
プローブテスト
プリントヘッドをヒートベッドから離れた位置に移動し、G28(または PROBE)を実行します。プリントヘッドが下降し始めたら、指の爪でプローブに軽く触れてトリガーさせます。いつでもプリンターの電源をオフにできるように準備してください。成功したら、プローブをヒートベッドに接触させる通常のホーミングを再度実行します。
障害復旧(赤色 LED 点滅)
BLTouch が異常状態になり、赤色 LED が継続的に点滅している場合は、以下を実行します:
BLTOUCH_DEBUG COMMAND=reset
一般的なトリガー原因:プローブ伸出中に遮られ、キャリブレーションが中断された場合。
reset 後も正常に動作しない場合は、プローブ内部の磁石コアがずれている可能性があります:
BLTouch プローブの分解や調整を行う前に、プリンターの電源を完全にオフにし、電源コードを抜いてください。
- 電源を切り、プローブ上部のネジを緩め、ボールペンなどで磁石コアを優しく元の位置に押し戻します。
- プローブを再度取り付け、自然に伸出位置に落ちるようにします。
- ネジの位置を慎重に調整し、電源を入れた後、
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
古いバージョンのクローンデバイスは、プローブ収納状態を報告できません。テスト方法:
- プリントヘッドをヒートベッドから離れた場所に移動します。
BLTOUCH_DEBUG COMMAND=pin_down→ 伸出を確認します。QUERY_PROBE→probe: openが返されるはずです。BLTOUCH_DEBUG COMMAND=pin_up→ 収納を確認します。QUERY_PROBE→probe: TRIGGEREDが返される場合(openではなく)、デバイスが収納を報告できないことを示します。
確認後、以下を追加します:
[bltouch]
pin_up_reports_not_triggered: False
BLTouch V3 バージョンに関する注意事項
V3.0 の信号問題
BLTouch V3.0 の sensor_pin をフィルタコンデンサ付きのエンドストップピンに接続すると、トリガー信号を安定して送信できない場合があります。QUERY_PROBE テストは正常でも、G28 / PROBE 時にプリントヘッドが時々停止しないことがあります。解決方法:
[bltouch]
probe_with_touch_mode: True
V3.1 の偶発的なエラー状態
BLTouch V3.1 は、プローブ成功後に数秒間赤色 LED が点滅することがあります。Klipper は自動的にこのエラーをクリアするため、通常は無害です。probe_with_touch_mode: True を設定すると、この問題を回避できます。
一部のクローンデバイスと BLTouch V2.0 以前のバージョンでは、probe_with_touch_mode: True を有効にすると精度が低下し、プローブの伸出時間が増加する可能性があります。変更前後で PROBE_ACCURACY コマンドを使用して比較テストを行ってください。
複数回のプローブで収納しない
デフォルトでは、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_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パラメータは必要ありません。