メインコンテンツにスキップ

運動、リミットスイッチとレベリングエラー

このページでは、移動範囲、原点復帰、リミットスイッチ、プローブ、メッシュベッド、マルチZレベリングに関連するエラーをまとめています。配線、コネクタ、手動での機械調整を行う場合は、必ず最初に電源を切ってから操作してください。

Move out of range

エラーメッセージ: 目標座標がKlipperで許可されている動作範囲を超えています。ログには通常 Move out of range: X Y Z [E] のように表示されます。

Loading...

よくある原因:

  • スライサーのマシンサイズがKlipper設定の position_min / position_max と一致していない。
  • 開始Gコード、終了Gコード、フィラメント交換マクロ、一時停止マクロがマシン範囲外に移動している。
  • スキュー補正、プローブオフセット、メッシュベッド設定を使用した後、実際に計算される座標が負の値になるか、最大ストロークを超えている。
  • モデルの高さがZ軸の最大ストロークを超えている。

解決方法:

  1. エラーに含まれる座標から、どの軸が範囲外かを判断します。
  2. 該当軸の position_minposition_max、およびスライサーのマシンサイズを確認します。
  3. 開始、終了、一時停止、フィラメント交換などのマクロ内の退避座標を確認し、0,0 や最大境界に停止しないようにします。
  4. メッシュベッド作成中にエラーが発生した場合は、[bed_mesh]mesh_minmesh_max、およびプローブオフセットを確認します。
  5. 設定を保存してKlipperを再起動し、再度テストします。

関連設定の参考: マクロ紹介原点復帰と方向校正ガイド

Must home axis first

エラーメッセージ: 軸がまだ原点復帰していないため、現在の移動コマンドを実行できません。

よくある原因:

  • 起動または FIRMWARE_RESTART 後に G28 を実行していない。
  • マクロ内で移動コマンドが原点復帰コマンドより先に実行されている。
  • 印刷の一時停止、再開、またはキャンセル後にマシンの状態がリセットされた。
  • 原点復帰マクロ、プローブマクロ、またはエンドストップレスホーミングの設定に異常があり、Klipperが正しく原点復帰状態を記録できていない。

解決方法:

  1. 手動で G28 を実行してから該当軸を移動させます。
  2. 開始Gコードとマクロを確認し、移動コマンドの前に原点復帰が完了していることを確認します。
  3. Klipperまたはファームウェアを最近更新した場合は、原点復帰関連のマクロが現在のバージョンと互換性があるか確認します。
  4. エンドストップレスホーミングを使用している場合は、ドライバー電流、感度、homing_retract_dist を確認します。

関連設定の参考: 原点復帰と方向校正ガイドエンドストップレスホーミングの使用

Endstop still triggered after retract

エラーメッセージ: リミットスイッチに当たって原点復帰した後、設定された後退距離を戻ってもリミットスイッチがまだトリガー状態になっています。

よくある原因:

  • リミットスイッチのノーマルオープン/ノーマルクローズの論理設定が逆になっている。
  • リミットスイッチが固着している、壊れている、または配線順序が間違っている。
  • homing_retract_dist が小さすぎるため、後退後もリミットスイッチを押し続けている。
  • エンドストップレスホーミングの感度が高すぎるため、後退後もトリガー状態と判断されている。
  • ドライバーの enable_pin、モーターの方向、またはリミットスイッチのピン設定が間違っており、原点復帰動作が正常に行われない。

解決方法:

電源切断操作

リミットスイッチのコネクタ、モーターの配線、またはケーブルの抜き差しを確認する前に、必ずプリンターの電源を完全に切り、電源コンセントからプラグを抜いてください。通電テスト時は、Webコマンドとリミットスイッチの機械的なトリガー箇所のみを操作し、端子には触れないでください。

  1. QUERY_ENDSTOPS を実行し、トリガーされていない状態で open、手動でトリガーした後で TRIGGERED になることを確認します。
  2. 状態が逆の場合は、リミットスイッチピンの前にある ! を調整します。
  3. 電源を切った後、リミットスイッチの機械的状態、配線順序、コネクタを確認します。
  4. 適切に homing_retract_dist を増やしてから再テストします。
  5. エンドストップレスホーミングを使用している場合は、感度を下げ、原点復帰電流が適切か確認します。

関連設定の参考: リミットスイッチ関連エンドストップレスホーミングの使用

No trigger on endstop after full movement

エラーメッセージ: No trigger on x after full movementNo trigger on y after full movement または同様のリミットスイッチ未トリガーを示すメッセージ。

よくある原因:

  • 原点復帰方向の設定が間違っており、モーターがリミットスイッチから遠ざかる方向に移動している。
  • リミットスイッチが接続されていない、コネクタが緩んでいる、またはピン設定が間違っている。
  • position_endstopposition_minposition_max の設定が実際のストロークと一致しておらず、原点復帰の移動距離が不足している。
  • エンドストップレスホーミングの感度が低すぎて、機械的な端に当たってもトリガーと判断されない。
  • モーターの配線順序や方向設定が間違っており、軸の移動方向が期待と逆になっている。

解決方法:

  1. QUERY_ENDSTOPS を実行し、手動でリミットスイッチを押して、状態が open から TRIGGERED に変わるか確認します。
  2. 少し移動させて軸の方向を確認し、dir_pin の前の ! を調整する必要があるか確認します。
  3. homing_positive_dir がリミットスイッチのある方向と一致していることを確認します。
  4. position_endstopposition_minposition_max が実際の機械的ストロークと合っているか確認します。
  5. エンドストップレスホーミングのシナリオでは、原点復帰速度を下げ、TMCの感度を調整します。

関連設定の参考: 原点復帰と方向校正ガイドリミットスイッチ関連

プローブとレベリングの問題

電源切断操作

BLTouch、Probe、TAP、Klicky、EDDY などのプローブの配線、コネクタ、または配線順序を確認する前に、必ずプリンターの電源を完全に切り、電源コンセントからプラグを抜いてください。通電時はクエリコマンドの実行または状態の観察のみを行い、ケーブルを抜き差ししないでください。

Probe triggered prior to movement

エラーメッセージ: 原点復帰またはプローブ移動が開始される前に、プローブが既にトリガー状態になっています。

エラー原因:

  • プローブが電源投入またはリセット後のデフォルト状態で TRIGGERED になっている。
  • プローブの配線順序が間違っているか接触不良で、信号が常にトリガー状態になっている。
  • プローブの機械的故障、例えばBLTouchプローブが引っ込まなくなったなど。
  • Z軸が既に最下部にあるため、プローブが押し付けられている。

解決方法:

  1. QUERY_PROBE を実行し、ヒートベッドに触れていない状態で open であることを確認します。
  2. QUERY_ENDSTOPS を実行し、リミットスイッチ/プローブの信号が正しいか確認します。
  3. BLTouchの場合: BLTOUCH_DEBUG COMMAND=pin_up でプローブが確実に引っ込んでいることを確認し、その後 QUERY_PROBE で確認します。
  4. Z軸の現在位置を確認し、必要に応じてZ軸を上昇させます。
  5. 電源を切った後、プローブの配線と sensor_pin 設定を確認します。

関連設定の参考: リミットスイッチ関連よく使うデバッグコマンド

No trigger on probe after full movement

エラーメッセージ: プローブが完全な下降ストローク内でトリガーしませんでした。

よくある原因:

  • プローブの配線、電源、またはピン設定が間違っている。
  • プローブの取り付け高さが適切でなく、下降ストローク内でトリガーできない。
  • Z軸の方向、プローブオフセット、またはレベリングエリアの設定が間違っている。
  • プローブ本体の故障、または移動時にケーブルが接触不良を起こしている。

解決方法:

  1. QUERY_PROBE を実行し、手動でプローブをトリガーして状態が正常に変化するか確認します。
  2. 電源を切った後、プローブの電源、信号線、設定ピンを確認します。
  3. プローブの取り付け高さを確認し、下降前にプローブがトリガー可能な範囲にあることを確認します。
  4. [probe][bed_mesh][z_tilt]、または [quad_gantry_level] 内のプローブポイントがヒートベッドから外れていないか確認します。
  5. 特定の位置だけで問題が発生する場合は、ケーブルの引き回しとプローブオフセットを重点的に確認します。

関連設定の参考: リミットスイッチ関連マクロ紹介

Probe samples exceed samples_tolerance

エラーメッセージ: Probe samples exceed samples_tolerance、またはログに Probe samples exceed tolerance. Retrying... が繰り返し表示されます。

よくある原因:

  • プローブの再現性が低く、数回のサンプリングでZ高さの差が samples_tolerance を超えている。
  • ヒートベッド、ガントリー、ホットエンド、またはプローブの固定が不十分で、プローブ中にぐらつきが生じている。
  • プローブ速度が速すぎるか、下降距離/リトラクト距離が適切でない。
  • 誘導式、渦電流式、または圧力センサーが温度ドリフトや電磁干渉の影響を受けている。

解決方法:

  1. プローブ、ホットエンド、ベッド、ガントリー構造がしっかり固定されているか確認します。
  2. [probe] 内の speed を下げ、sample_retract_dist を適切に増やします。
  3. 一時的に samples_tolerance を緩めてテストします(例:0.01 から 0.030.05 へ)。
  4. 誘導式/渦電流プローブを使用している場合は、ヒートベッドとノズルの温度が安定してからレベリングします。
  5. 特定の領域だけで問題が発生する場合は、その領域のベッド面、マグネットシート、ケーブル引き回し、プローブオフセットを確認します。

関連設定の参考: マシンキャリブレーションマクロ紹介

Must home before probe

エラーメッセージ: Must home before probe

よくある原因:

  • G28 を実行せずに PROBEBED_MESH_CALIBRATEZ_TILT_ADJUST、または QUAD_GANTRY_LEVEL を実行した。
  • マクロ内でレベリングコマンドを呼び出す前に、XY/Zが原点復帰していることが保証されていない。
  • FIRMWARE_RESTART、緊急停止、またはエラー回復後、Klipperが原点復帰状態をクリアした。

解決方法:

  1. 最初に G28 を実行してから、プローブまたはレベリングコマンドを実行します。
  2. レベリングマクロの先頭に原点復帰判定を追加するか、直接 G28 を追加します。
  3. 独立した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が点滅している。

解決方法:

  1. まず BLTOUCH_DEBUG COMMAND=pin_downBLTOUCH_DEBUG COMMAND=touch_modeQUERY_PROBE を実行して状態を確認します。

  2. 手動テストは成功するが、自動ホーミング/プローブでエラーが発生する場合は、[bltouch] に以下を追加します:

    pin_up_touch_mode_reports_triggered: False
  3. sensor_pin にプルアップ抵抗が設定されていることを確認します(例: sensor_pin: ^PC4)。

  4. BLTouchのセルフテストが正常か確認します: 電源投入後、プローブが数回伸縮し、赤色LEDが常時点灯すれば正常です。

BLTouch failed to raise probe

エラーメッセージ: 原点復帰またはプローブ後、KlipperがBLTouchプローブの正常な収縮を検出できませんでした。

よくある原因:

  • 旧バージョンのクローンBLTouchがプローブ収縮状態を報告できない。
  • プローブが機械的に固着している、磁気コアがずれている、またはネジが緩んでいる。
  • control_pin の配線または設定が間違っている。

解決方法:

  1. プローブ制御機能をテストします: BLTOUCH_DEBUG COMMAND=pin_downBLTOUCH_DEBUG COMMAND=pin_up

  2. 動作は正常だがエラーが発生する場合は、[bltouch] に以下を追加します:

    pin_up_reports_not_triggered: False
  3. プローブが固着している場合は、プローブモジュールの交換を推奨するか、アフターサービスに連絡してください。通電したまま機器を分解しないでください。

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 が重複して設定されている。

解決方法:

  1. すべての horizontal_move_zz_offset を検索し、最終的に有効な設定を確認します。
  2. 関連するレベリング設定の horizontal_move_z を、プローブの z_offset より大きい安全な値に設定します。
  3. z_offset が異常に大きい場合は、プローブの取り付け高さを再確認し、PROBE_CALIBRATE を実行します。
  4. 保存後、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 以下に制限しています。

解決方法:

  1. 7x79x9 などのより細かいグリッドが必要な場合は、[bed_mesh] で次のように設定します:

    algorithm: bicubic
  2. 細かいグリッドが必要ない場合は、probe_count6,6 以下に下げます。

  3. アダプティブメッシュベッドをスライサーやマクロから PROBE_COUNT で渡す場合も、最終的な点数とアルゴリズムが一致しているか確認します。

  4. 変更後、保存して RESTART を実行します。

関連設定の参考: マクロ紹介

bed_mesh: Unknown profile

エラーメッセージ: bed_mesh: Unknown profile [xxx] またはメッシュベッド設定のロード時にプロファイルが見つからないというメッセージ。

よくある原因:

  • 開始Gコードまたはマクロ内で BED_MESH_PROFILE LOAD=xxx を実行しているが、その名前で保存されたことがない。
  • BED_MESH_CLEAR を実行したか、自動保存エリアのメッシュベッドデータを削除した。
  • メッシュベッドキャリブレーション完了後に SAVE_CONFIG を実行していない。
  • プロファイル名の大文字小文字やスペースが一致していない。

解決方法:

  1. BED_MESH_OUTPUT を実行するか、設定ファイル末尾の自動保存エリアを確認して、既存のプロファイル名を確認します。
  2. 必要なプロファイルがない場合は、再度 BED_MESH_CALIBRATE を実行し、その後 SAVE_CONFIG を実行します。
  3. 開始Gコード内の BED_MESH_PROFILE LOAD= を修正し、実際に保存されている名前と一致させます。
  4. 毎回印刷前にメッシュベッドを作成する場合は、不要なプロファイルロードコマンドを削除できます。

関連設定の参考: マクロ紹介

Z_TILT_ADJUST / QUAD_GANTRY_LEVEL エラー

エラーメッセージ: Z_TILT_ADJUST: Point X,Y not reachable with current probe offsetQUAD_GANTRY_LEVEL: Max adjustment X.XXXX exceeds limit、またはガントリーレベリング後も偏差が大きすぎる。

よくある原因:

  • プローブオフセット設定が正しくなく、計算されたプローブポイントがヒートベッド範囲から外れている。
  • 複数Z軸のガントリー偏差が max_adjust で許容される範囲を超えている。
  • Z軸モーターの方向が一致しておらず、ガントリーが逆方向に傾いている。
  • リミットスイッチの取り付け高さが一致しておらず、原点復帰後の各Z軸の開始位置の差が大きすぎる。
  • ガントリーの機械的構造の緩み、ベルトの滑り、またはリードスクリューナットのガタが大きすぎる。

解決方法:

電源切断操作

Zリードスクリュー、タイミングベルト、カップリングを手動で調整したり、ガントリーリミットスイッチの取り付けを確認する前に、必ずプリンターの電源を完全に切り、電源コンセントからプラグを抜いてください。モーターに通電保持トルクがかかっている状態で、無理にリードスクリューやタイミングベルトを回さないでください。

  1. [probe] 内の x_offsety_offset、および [z_tilt] または [quad_gantry_level] 内の points を確認します。
  2. 偏差が max_adjust を超えている場合は、完全に電源を切った状態でガントリーを手動でおおよそ水平に調整し、その後再び電源を入れて原点復帰とレベリングを実行します。
  3. STEPPER_BUZZ STEPPER=stepper_z および STEPPER_BUZZ STEPPER=stepper_z1(実際の名前に合わせて)を実行し、各Zモーターが個別に同じ方向に動くか確認します。
  4. 電源を切った後、ガントリー各コーナーのリミットスイッチの取り付け高さが一致しているか、リードスクリューナット、タイミングベルトの張り、カップリングに滑りがないか確認します。
  5. 単に max_adjust の制限が小さすぎる場合は、その値を適切に増やせますが、デフォルト値の2~3倍を超えないようにしてください。

関連設定の参考: 原点復帰と方向校正ガイド

Loading...