運動、リミットスイッチとレベリングエラー
このページでは、移動範囲、原点復帰、リミットスイッチ、プローブ、メッシュベッド、マルチZレベリングに関連するエラーをまとめています。配線、コネクタ、手動での機械調整を行う場合は、必ず最初に電源を切ってから操作してください。
Move out of range
エラーメッセージ: 目標座標がKlipperで許可されている動作範囲を超えています。ログには通常 Move out of range: X Y Z [E] のように表示されます。
よくある原因:
- スライサーのマシンサイズがKlipper設定の
position_min/position_maxと一致していない。 - 開始Gコード、終了Gコード、フィラメント交換マクロ、一時停止マクロがマシン範囲外に移動している。
- スキュー補正、プローブオフセット、メッシュベッド設定を使用した後、実際に計算される座標が負の値になるか、最大ストロークを超えている。
- モデルの高さがZ軸の最大ストロークを超えている。
解決方法:
- エラーに含まれる座標から、どの軸が範囲外かを判断します。
- 該当軸の
position_min、position_max、およびスライサーのマシンサイズを確認します。 - 開始、終了、一時停止、フィラメント交換などのマクロ内の退避座標を確認し、
0,0や最大境界に停止しないようにします。 - メッシュベッド作成中にエラーが発生した場合は、
[bed_mesh]のmesh_min、mesh_max、およびプローブオフセットを確認します。 - 設定を保存してKlipperを再起動し、再度テストします。
関連設定の参考: マクロ紹介、原点復帰と方向校正ガイド。
Must home axis first
エラーメッセージ: 軸がまだ原点復帰していないため、現在の移動コマンドを実行できません。
よくある原因:
- 起動または
FIRMWARE_RESTART後にG28を実行していない。 - マクロ内で移動コマンドが原点復帰コマンドより先に実行されている。
- 印刷の一時停止、再開、またはキャンセル後にマシンの状態がリセットされた。
- 原点復帰マクロ、プローブマクロ、またはエンドストップレスホーミングの設定に異常があり、Klipperが正しく原点復帰状態を記録できていない。
解決方法:
- 手動で
G28を実行してから該当軸を移動させます。 - 開始Gコードとマクロを確認し、移動コマンドの前に原点復帰が完了していることを確認します。
- Klipperまたはファームウェアを最近更新した場合は、原点復帰関連のマクロが現在のバージョンと互換性があるか確認します。
- エンドストップレスホーミングを使用している場合は、ドライバー電流、感度、
homing_retract_distを確認します。
関連設定の参考: 原点復帰と方向校正ガイド、エンドストップレスホーミングの使用。
Endstop still triggered after retract
エラーメッセージ: リミットスイッチに当たって原点復帰した後、設定された後退距離を戻ってもリミットスイッチがまだトリガー状態になっています。
よくある原因:
- リミットスイッチのノーマルオープン/ノーマルクローズの論理設定が逆になっている。
- リミットスイッチが固着している、壊れている、または配線順序が間違っている。
homing_retract_distが小さすぎるため、後退後もリミットスイッチを押し続けている。- エンドストップレスホーミングの感度が高すぎるため、後退後もトリガー状態と判断されている。
- ドライバーの
enable_pin、モーターの方向、またはリミットスイッチのピン設定が間違っており、原点復帰動作が正常に行われない。
解決方法:
リミットスイッチのコネクタ、モーターの配線、またはケーブルの抜き差しを確認する前に、必ずプリンターの電源を完全に切り、電源コンセントからプラグを抜いてください。通電テスト時は、Webコマンドとリミットスイッチの機械的なトリガー箇所のみを操作し、端子には触れないでください。
QUERY_ENDSTOPSを実行し、トリガーされていない状態でopen、手動でトリガーした後でTRIGGEREDになることを確認します。- 状態が逆の場合は、リミットスイッチピンの前にある
!を調整します。 - 電源を切った後、リミットスイッチの機械的状態、配線順序、コネクタを確認します。
- 適切に
homing_retract_distを増やしてから再テストします。 - エンドストップレスホーミングを使用している場合は、感度を下げ、原点復帰電流が適切か確認します。
関連設定の参考: リミットスイッチ関連、エンドストップレスホーミングの使用。
No trigger on endstop after full movement
エラーメッセージ: No trigger on x after full movement、No trigger on y after full movement または同様のリミットスイッチ未トリガーを示すメッセージ。
よくある原因:
- 原点復帰方向の設定が間違っており、モーターがリミットスイッチから遠ざかる方向に移動している。
- リミットスイッチが接続されていない、コネクタが緩んでいる、またはピン設定が間違っている。
position_endstop、position_min、position_maxの設定が実際のストロークと一致しておらず、原点復帰の移動距離が不足している。- エンドストップレスホーミングの感度が低すぎて、機械的な端に当たってもトリガーと判断されない。
- モーターの配線順序や方向設定が間違っており、軸の移動方向が期待と逆になっている。
解決方法:
QUERY_ENDSTOPSを実行し、手動でリミットスイッチを押して、状態がopenからTRIGGEREDに変わるか確認します。- 少し移動させて軸の方向を確認し、
dir_pinの前の!を調整する必要があるか確認します。 homing_positive_dirがリミットスイッチのある方向と一致していることを確認します。position_endstop、position_min、position_maxが実際の機械的ストロークと合っているか確認します。- エンドストップレスホーミングのシナリオでは、原点復帰速度を下げ、TMCの感度を調整します。
関連設定の参考: 原点復帰と方向校正ガイド、リミットスイッチ関連。
プローブとレベリングの問題
BLTouch、Probe、TAP、Klicky、EDDY などのプローブの配線、コネクタ、または配線順序を確認する前に、必ずプリンターの電源を完全に切り、電源コンセントからプラグを抜いてください。通電時はクエリコマンドの実行または状態の観察のみを行い、ケーブルを抜き差ししないでください。
Probe triggered prior to movement
エラーメッセージ: 原点復帰またはプローブ移動が開始される前に、プローブが既にトリガー状態になっています。
エラー原因:
- プローブが電源投入またはリセット後のデフォルト状態で
TRIGGEREDになっている。 - プローブの配線順序が間違っているか接触不良で、信号が常にトリガー状態になっている。
- プローブの機械的故障、例えばBLTouchプローブが引っ込まなくなったなど。
- Z軸が既に最下部にあるため、プローブが押し付けられている。
解決方法:
QUERY_PROBEを実行し、ヒートベッドに触れていない状態でopenであることを確認します。QUERY_ENDSTOPSを実行し、リミットスイッチ/プローブの信号が正しいか確認します。- BLTouchの場合:
BLTOUCH_DEBUG COMMAND=pin_upでプローブが確実に引っ込んでいることを確認し、その後QUERY_PROBEで確認します。 - Z軸の現在位置を確認し、必要に応じてZ軸を上昇させます。
- 電源を切った後、プローブの配線と
sensor_pin設定を確認します。
関連設定の参考: リミットスイッチ関連、よく使うデバッグコマンド。
No trigger on probe after full movement
エラーメッセージ: プローブが完全な下降ストローク内でトリガーしませんでした。
よくある原因:
- プローブの配線、電源、またはピン設定が間違っている。
- プローブの取り付け高さが適切でなく、下降ストローク内でトリガーできない。
- Z軸の方向、プローブオフセット、またはレベリングエリアの設定が間違っている。
- プローブ本体の故障、または移動時にケーブルが接触不良を起こしている。
解決方法:
QUERY_PROBEを実行し、手動でプローブをトリガーして状態が正常に変化するか確認します。- 電源を切った後、プローブの電源、信号線、設定ピンを確認します。
- プローブの取り付け高さを確認し、下降前にプローブがトリガー可能な範囲にあることを確認します。
[probe]、[bed_mesh]、[z_tilt]、または[quad_gantry_level]内のプローブポイントがヒートベッドから外れていないか確認します。- 特定の位置だけで問題が発生する場合は、ケーブルの引き回しとプローブオフセットを重点的に確認します。
関連設定の参考: リミットスイッチ関連、マクロ紹介。
Probe samples exceed samples_tolerance
エラーメッセージ: Probe samples exceed samples_tolerance、またはログに Probe samples exceed tolerance. Retrying... が繰り返し表示されます。
よくある原因:
- プローブの再現性が低く、数回のサンプリングでZ高さの差が
samples_toleranceを超えている。 - ヒートベッド、ガントリー、ホットエンド、またはプローブの固定が不十分で、プローブ中にぐらつきが生じている。
- プローブ速度が速すぎるか、下降距離/リトラクト距離が適切でない。
- 誘導式、渦電流式、または圧力センサーが温度ドリフトや電磁干渉の影響を受けている。
解決方法:
- プローブ、ホットエンド、ベッド、ガントリー構造がしっかり固定されているか確認します。
[probe]内のspeedを下げ、sample_retract_distを適切に増やします。- 一時的に
samples_toleranceを緩めてテストします(例:0.01から0.03や0.05へ)。 - 誘導式/渦電流プローブを使用している場合は、ヒートベッドとノズルの温度が安定してからレベリングします。
- 特定の領域だけで問題が発生する場合は、その領域のベッド面、マグネットシート、ケーブル引き回し、プローブオフセットを確認します。
関連設定の参考: マシンキャリブレーション、マクロ紹介。
Must home before probe
エラーメッセージ: Must home before probe。
よくある原因:
G28を実行せずにPROBE、BED_MESH_CALIBRATE、Z_TILT_ADJUST、またはQUAD_GANTRY_LEVELを実行した。- マクロ内でレベリングコマンドを呼び出す前に、XY/Zが原点復帰していることが保証されていない。
FIRMWARE_RESTART、緊急停止、またはエラー回復後、Klipperが原点復帰状態をクリアした。
解決方法:
- 最初に
G28を実行してから、プローブまたはレベリングコマンドを実行します。 - レベリングマクロの先頭に原点復帰判定を追加するか、直接
G28を追加します。 - 独立したZプローブを使用している場合は、
endstop_pin: probe:z_virtual_endstopと[probe]の設定が完全であることを確認します。
関連設定の参考: 原点復帰と方向校正ガイド、マクロ紹介。
BLTouch failed to verify sensor state
エラーメッセージ: BLTouch failed to verify sensor state; retrying. 複数回のリトライ後にエラーになります。
よくある原因:
- 非正規/クローンBLTouchがKlipperの内部センサー検証を通過できない。
sensor_pinにプルアップ抵抗が設定されていない(^プレフィックスがない)。- BLTouchの制御ピンまたはセンサーピンの配線が間違っている。
- プローブのセルフテストに失敗し、赤色LEDが点滅している。
解決方法:
-
まず
BLTOUCH_DEBUG COMMAND=pin_down、BLTOUCH_DEBUG COMMAND=touch_mode、QUERY_PROBEを実行して状態を確認します。 -
手動テストは成功するが、自動ホーミング/プローブでエラーが発生する場合は、
[bltouch]に以下を追加します:pin_up_touch_mode_reports_triggered: False -
sensor_pinにプルアップ抵抗が設定されていることを確認します(例:sensor_pin: ^PC4)。 -
BLTouchのセルフテストが正常か確認します: 電源投入後、プローブが数回伸縮し、赤色LEDが常時点灯すれば正常です。
BLTouch failed to raise probe
エラーメッセージ: 原点復帰またはプローブ後、KlipperがBLTouchプローブの正常な収縮を検出できませんでした。
よくある原因:
- 旧バージョンのクローンBLTouchがプローブ収縮状態を報告できない。
- プローブが機械的に固着している、磁気コアがずれている、またはネジが緩んでいる。
control_pinの配線または設定が間違っている。
解決方法:
-
プローブ制御機能をテストします:
BLTOUCH_DEBUG COMMAND=pin_downとBLTOUCH_DEBUG COMMAND=pin_up。 -
動作は正常だがエラーが発生する場合は、
[bltouch]に以下を追加します:pin_up_reports_not_triggered: False -
プローブが固着している場合は、プローブモジュールの交換を推奨するか、アフターサービスに連絡してください。通電したまま機器を分解しないでください。
horizontal_move_z can't be less than probe's z_offset
エラーメッセージ: horizontal_move_z can't be less than probe's z_offset。
よくある原因:
PROBE_CALIBRATE後に保存されたz_offsetが、レベリング設定のhorizontal_move_zより大きい。- ノズル、プローブマウント、またはホットエンド交換後、プローブの取り付け高さが大きく変わった。
- 複数のインクルードファイルで
horizontal_move_zまたはz_offsetが重複して設定されている。
解決方法:
- すべての
horizontal_move_zとz_offsetを検索し、最終的に有効な設定を確認します。 - 関連するレベリング設定の
horizontal_move_zを、プローブのz_offsetより大きい安全な値に設定します。 z_offsetが異常に大きい場合は、プローブの取り付け高さを再確認し、PROBE_CALIBRATEを実行します。- 保存後、
RESTARTを実行し、BED_MESH_CALIBRATEまたはレベリングコマンドを再テストします。
関連設定の参考: マシンキャリブレーション、マクロ紹介。
bed_mesh: cannot exceed a probe_count of 6
エラーメッセージ: bed_mesh: cannot exceed a probe_count of 6 when using lagrange interpolation。
エラー原因: lagrange 補間はサンプリング数が多いと振動しやすくなるため、Klipperはこのアルゴリズム使用時に1軸あたりのプローブ点数を 6 以下に制限しています。
解決方法:
-
7x7、9x9などのより細かいグリッドが必要な場合は、[bed_mesh]で次のように設定します:algorithm: bicubic -
細かいグリッドが必要ない場合は、
probe_countを6,6以下に下げます。 -
アダプティブメッシュベッドをスライサーやマクロから
PROBE_COUNTで渡す場合も、最終的な点数とアルゴリズムが一致しているか確認します。 -
変更後、保存して
RESTARTを実行します。
関連設定の参考: マクロ紹介。
bed_mesh: Unknown profile
エラーメッセージ: bed_mesh: Unknown profile [xxx] またはメッシュベッド設定のロード時にプロファイルが見つからないというメッセージ。
よくある原因:
- 開始Gコードまたはマクロ内で
BED_MESH_PROFILE LOAD=xxxを実行しているが、その名前で保存されたことがない。 BED_MESH_CLEARを実行したか、自動保存エリアのメッシュベッドデータを削除した。- メッシュベッドキャリブレーション完了後に
SAVE_CONFIGを実行していない。 - プロファイル名の大文字小文字やスペースが一致していない。
解決方法:
BED_MESH_OUTPUTを実行するか、設定ファイル末尾の自動保存エリアを確認して、既存のプロファイル名を確認します。- 必要なプロファイルがない場合は、再度
BED_MESH_CALIBRATEを実行し、その後SAVE_CONFIGを実行します。 - 開始Gコード内の
BED_MESH_PROFILE LOAD=を修正し、実際に保存されている名前と一致させます。 - 毎回印刷前にメッシュベッドを作成する場合は、不要なプロファイルロードコマンドを削除できます。
関連設定の参考: マクロ紹介。
Z_TILT_ADJUST / QUAD_GANTRY_LEVEL エラー
エラーメッセージ: Z_TILT_ADJUST: Point X,Y not reachable with current probe offset、QUAD_GANTRY_LEVEL: Max adjustment X.XXXX exceeds limit、またはガントリーレベリング後も偏差が大きすぎる。
よくある原因:
- プローブオフセット設定が正しくなく、計算されたプローブポイントがヒートベッド範囲から外れている。
- 複数Z軸のガントリー偏差が
max_adjustで許容される範囲を超えている。 - Z軸モーターの方向が一致しておらず、ガントリーが逆方向に傾いている。
- リミットスイッチの取り付け高さが一致しておらず、原点復帰後の各Z軸の開始位置の差が大きすぎる。
- ガントリーの機械的構造の緩み、ベルトの滑り、またはリードスクリューナットのガタが大きすぎる。
解決方法:
Zリードスクリュー、タイミングベルト、カップリングを手動で調整したり、ガントリーリミットスイッチの取り付けを確認する前に、必ずプリンターの電源を完全に切り、電源コンセントからプラグを抜いてください。モーターに通電保持トルクがかかっている状態で、無理にリードスクリューやタイミングベルトを回さないでください。
[probe]内のx_offset、y_offset、および[z_tilt]または[quad_gantry_level]内のpointsを確認します。- 偏差が
max_adjustを超えている場合は、完全に電源を切った状態でガントリーを手動でおおよそ水平に調整し、その後再び電源を入れて原点復帰とレベリングを実行します。 STEPPER_BUZZ STEPPER=stepper_zおよびSTEPPER_BUZZ STEPPER=stepper_z1(実際の名前に合わせて)を実行し、各Zモーターが個別に同じ方向に動くか確認します。- 電源を切った後、ガントリー各コーナーのリミットスイッチの取り付け高さが一致しているか、リードスクリューナット、タイミングベルトの張り、カップリングに滑りがないか確認します。
- 単に
max_adjustの制限が小さすぎる場合は、その値を適切に増やせますが、デフォルト値の2~3倍を超えないようにしてください。
関連設定の参考: 原点復帰と方向校正ガイド。