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

運動・エンドストップ・レベリングのエラー

本ページでは、移動範囲、ホーミング、エンドストップ、プローブ、ベッドメッシュ、複数 Z 軸のレベリングに関するエラーをまとめます。配線、コネクタ、手動での機械調整を伴う場合は、必ず電源を切ってから作業してください。

Move out of range​

エラー内容：目標座標が Klipper の許容する移動範囲を超えています。ログには通常 Move out of range: X Y Z [E] のような表示が出ます。

Loading...

よくある原因：

  • スライサー側のマシン寸法と Klipper 設定の position_min / position_max が一致していません。
  • スタート G-code、エンド G-code、フィラメント交換マクロ、一時停止マクロがマシン範囲外へ移動しています。
  • スキュー補正、プローブオフセット、ベッドメッシュ設定を使用した結果、実際に計算される座標が負の値になったり最大ストロークを超えたりしています。
  • モデルの高さが Z 軸の最大ストロークを超えています。

解決方法：

  1. エラー内の座標から、どの軸が範囲外かを判断します。
  2. 該当する軸の position_min、position_max とスライサーのマシン寸法を確認します。
  3. スタート、エンド、一時停止、フィラメント交換などのマクロの待機座標を確認し、0,0 や最大境界に停止しないようにします。
  4. ベッドスキャン中にエラーが発生する場合は、[bed_mesh] の mesh_min、mesh_max とプローブオフセットを確認します。
  5. 設定を保存して Klipper を再起動してから、再度テストします。

関連設定：マクロの紹介、ホーミングと方向校正のガイド。

Unable to parse move / Invalid speed​

エラー内容：Unable to parse move 'G1 Z'、Unable to parse move 'G1 X... Y... Z...'、Invalid speed in 'G1 ...'、Machine does not support G20 (inches) command、Unknown g-code state: xxx。

よくある原因：

  • G-code の行の書式が不完全です。たとえば G1 Z の後に具体的な座標値がありません。
  • マクロ変数が空で、最終的に組み立てられる移動コマンドに X、Y、Z、E、F の数値がありません。
  • スライサーのスタート / エンド G-code で、改行、波かっこ、変数名、エスケープの書式が誤っています。
  • F の速度パラメータが空、0、または数値になっていません。
  • G-code ファイルがインチモード G20 を使用していますが、Klipper はこのコマンドに対応していません。
  • マクロ内の SAVE_GCODE_STATE / RESTORE_GCODE_STATE で使用している名前が一致していません。

解決方法：

  1. klippy.log で完全なエラー行を探し、どの G1、G0、または状態コマンドでエラーになっているかを確認します。
  2. スライサーのスタート、エンド、一時停止、再開、フィラメント交換の各マクロを確認し、すべての移動コマンドに完全な数値があることを確かめます。
  3. マクロのパラメータに既定値を設定し、使用前に数値へ変換します（例：params.Z|default(10)|float）。
  4. スライサーの単位がミリメートルであること、G20 を出力していないことを確認します。
  5. Unknown g-code state が表示される場合は、SAVE_GCODE_STATE NAME= と RESTORE_GCODE_STATE NAME= で同じ名前を使用しているか確認します。

関連設定：マクロの紹介。

Must home axis first​

エラー内容：軸がまだホーミングされていないため、現在の移動コマンドを実行できません。

よくある原因：

  • 電源投入後や FIRMWARE_RESTART の後に G28 を実行していません。
  • マクロ内で移動コマンドを先に実行し、その後にホーミングコマンドを実行しています。
  • 印刷の一時停止、再開、キャンセルの後でマシン状態がリセットされています。
  • ホーミングマクロ、プローブマクロ、センサーレスホーミングの設定に異常があり、Klipper がホーミング済みの状態を正しく記録できていません。

解決方法：

  1. 手動で G28 を実行してから、該当する軸を移動します。
  2. スタート G-code とマクロを確認し、移動コマンドの前にホーミングが完了していることを確かめます。
  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 movement、No trigger on y after full movement、または同様のエンドストップ未トリガーの表示が出ます。

よくある原因：

  • ホーミング方向の設定が誤っており、モーターがエンドストップから離れる方向へ移動しています。
  • エンドストップスイッチが導通していない、コネクタが緩んでいる、またはピン設定が誤っています。
  • position_endstop、position_min、position_max の設定が実際のストロークと一致しておらず、ホーミング距離が足りません。
  • センサーレスホーミングの感度が低すぎて、機械的な端点に当たってもトリガーと判定されません。
  • モーターの配線順序や方向設定が誤っており、軸の移動方向が想定と逆になっています。

解決方法：

  1. QUERY_ENDSTOPS を実行し、手動でエンドストップを押して、状態が open から TRIGGERED に変わることを確認します。
  2. 短い距離の移動で軸方向を確認し、dir_pin の前の ! を調整する必要があるか確認します。
  3. homing_positive_dir がエンドストップのある方向と一致していることを確認します。
  4. position_endstop、position_min、position_max が実際の機械的ストロークと合っているか確認します。
  5. センサーレスホーミングの場合は、ホーミング速度を下げ、TMC の感度を調整します。

関連設定：ホーミングと方向校正のガイド、エンドストップ関連。

センサーレスホーミング（Sensorless Homing）のトラブルシューティング​

センサーレスホーミングは、TMC ドライバの DIAG 信号でモーターのストールを判断し、物理的なエンドストップスイッチの代わりにします。設定や感度が適切でないと、以下のエラーが発生します。互換性の確認、参考設定、感度の調整方法の詳細は センサーレスホーミングの使用 を参照してください。

ホーミングがトリガーされない：No trigger on x after full movement​

エラー内容：virtual_endstop でホーミングすると No trigger on x after full movement または No trigger on y after full movement が表示され、キャリッジが端点に当たっても停止しません。

よくある原因：

  • 感度のしきい値が適切ではありません：TMC2209 の driver_SGTHRS が低すぎる（感度不足）、または TMC5160 / TMC2240 / TMC2130 の driver_SGT が高すぎます。
  • B クラスのメインボードに DIAG のジャンパが取り付けられていない、または該当するエンドストップ端子に他の機器が接続されたままです。
  • diag_pin にプルアップ記号 ^ がなく、オープンドレイン信号が安定してトリガーできません。
  • ホーミング速度やドライバ電流が低すぎて、ストール時の電流変化が DIAG 信号をトリガーするのに足りません。
電源を切って作業

ジャンパ、エンドストップ端子の配線を確認する場合や、配線を抜き差しする場合は、まずプリンタを停止して電源を切断してください。通電状態で端子に触れたり、配線を抜き差ししたりしないでください。

解決方法：

  1. センサーレスホーミングの使用 · 感度のテスト の方法に従い、最も高い感度から徐々に SGTHRS / sgt を調整します。
  2. diag_pin に ^ のプルアップが付いていることを確認します（例：diag_pin: ^PD9）。TMC5160 など DIAG ピンを 2 つ持つドライバでは、diag0_pin と diag1_pin のどちらを使うかを確認する必要があります。
  3. B クラスのメインボードでは、DIAG のジャンパが取り付けられていること、該当するエンドストップ端子に他の機器が接続されていないことを確認します。
  4. ホーミング電流とホーミング速度を適切に上げてから再テストします。

設定エラー：Unknown pin chip name​

エラー内容：起動時に Unknown pin chip name 'tmc5160 stepper_x'、Unknown pin chip name '^awd' などが表示され、Klipper が ready 状態になれません。

よくある原因：

  • endstop_pin でドライバ名と軸名の間に誤ってスペースを使っています（例：tmc5160 stepper_x:virtual_endstop）。正しい書き方は下線を使った tmc5160_stepper_x:virtual_endstop です。
  • diag_pin / diag0_pin / diag1_pin のピン名のつづりが誤っている、または不正な文字が入っています。

解決方法：

  1. [stepper_x] の endstop_pin を確認し、tmcXXXX_stepper_x:virtual_endstop の形式で、ドライバ名と軸名の間がスペースではなく下線になっていることを確かめます。
  2. ドライバ設定セクション名 [tmcXXXX stepper_x] の内部ではスペースを使いますが、endstop_pin から参照するときは下線に変える必要があり、両方の名前が対応している必要があります。
  3. diag_pin のピン名のつづりを確認します。使用できるのは ^、! の接頭辞と正しいピン名のみです。

設定エラー：Could not find any TMC driver config section​

エラー内容：Could not find any TMC driver config section for 'stepper_x' required by TMC autotuning。

よくある原因：

  • endstop_pin が tmcXXXX_stepper_x:virtual_endstop を参照していますが、設定に対応する [tmcXXXX stepper_x] ドライバセクションがない、またはセクション名が参照と一致していません。
  • ドライバセクションがコメントアウトされている、つづりが誤っている、または軸名が一致していません。

解決方法：

  1. endstop_pin の参照に完全対応するドライバ設定セクションがあることを確認します。たとえば endstop_pin: tmc2209_stepper_x:virtual_endstop には [tmc2209 stepper_x] が必要です。
  2. ドライバセクションがコメントアウトされていないか、軸名を書き間違えていないか確認します（stepper_x と stepper_y を混同しないでください）。

ホーミング時の緊急停止：Homing failed due to printer shutdown​

エラー内容：ホーミングの途中でプリンタが shutdown に入り、Homing failed due to printer shutdown が表示されます。

よくある原因：

  • これはセンサーレスホーミング固有の故障ではなく、ホーミング中に発生した別の shutdown（DIAG 信号の揺れによる誤トリガー、ドライバエラー、サービスの再起動など）が緊急停止を引き起こしています。
  • 本当の原因は、klippy.log で Homing failed より前の最初の shutdown エラーを確認する必要があります。

解決方法：

  1. klippy.log を開き、Homing failed due to printer shutdown より上の最初の shutdown エラーを探し、該当する分類に従って原因を確認します。
  2. その上が Can't reset time when stepper active の場合は、システム・性能・サービスのエラー に従って対処します。
  3. DIAG 信号の揺れによる誤トリガーの場合は、diag_pin のプルアップとジャンパを確認し、感度を適切に下げます。

関連ドキュメント：センサーレスホーミングの使用、No trigger on endstop after full movement、TMC のエラー調査

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

電源を切って作業

BLTouch、Probe、TAP、Klicky、EDDY などのプローブの配線、コネクタ、配線順序を確認する場合は、プリンタを完全に停止して電源を切断してください。通電中は照会コマンドの実行や状態の確認のみを行い、配線を抜き差ししないでください。

校正ツールの対話プロンプト：Starting manual Z probe、Manual probe failed!、Already in a manual Z probe など TESTZ / ACCEPT の過程で表示されるプロンプトは、プローブのハードウェア故障ではありません。詳細は プローブ校正ツール を参照してください。

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.03 や 0.05 へ変更）。
  4. インダクタンス式 / 渦電流式プローブを使用している場合は、ヒートベッドとノズルの温度が安定してからレベリングします。
  5. 特定の領域でのみ問題が発生する場合は、その領域のベッド面、マグネットシート、配線の引き回し、プローブオフセットを確認します。

関連設定：マシンの校正、マクロの紹介。

Must home before probe​

エラー内容：Must home before probe。

よくある原因：

  • G28 を実行せずに PROBE、BED_MESH_CALIBRATE、Z_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_down、BLTOUCH_DEBUG COMMAND=touch_mode、QUERY_PROBE を実行して状態を確認します。

  2. 手動テストは通るのに自動のホーミング / プロービングでエラーになる場合は、[bltouch] に次を追加します：

    pin_up_touch_mode_reports_triggered: False

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

  4. BLTouch の自己診断が正常か確認します。通電後にプローブが数回伸縮し、赤い LED が点灯したままなら正常です。

BLTouch failed to deploy​

エラー内容：BLTouch failed to deploy。

よくある原因：

  • BLTouch のプローブが機械的に引っかかり、伸びません。
  • control_pin の配線や設定が誤っており、プローブに伸長信号が届いていません。
  • 非正規品 / クローンの BLTouch はタイミングが互換ではありません。
  • プローブの電源が不足しています（メインボードの 3.3V を使用しており、5V ではありません）。

解決方法：

  1. プローブ制御を手動でテストします：BLTOUCH_DEBUG COMMAND=pin_down を実行し、プローブが伸びるか観察します。
  2. [bltouch] の control_pin と sensor_pin がメインボードのドキュメントと一致していることを確認します。
  3. BLTouch の電源が 5V か確認します（一部のメインボードではジャンパで選択する必要があります）。
  4. プローブがまったく動作しない場合は、電源を切った後に配線とコネクタを確認し、必要に応じてプローブモジュールを交換します。

BLTouch failed to raise probe​

エラー内容：ホーミングやプロービングの後、Klipper が BLTouch のプローブの収納に失敗したことを検出しました。

よくある原因：

  • 古いバージョンのクローン BLTouch はプローブの収納状態を報告できません。
  • プローブが機械的に引っかかり、磁心がずれているかネジが緩んでいます。
  • control_pin の配線または設定が誤っています。

解決方法：

  1. プローブ制御機能をテストします：BLTOUCH_DEBUG COMMAND=pin_down と BLTOUCH_DEBUG COMMAND=pin_up。

  2. 動作は正常なのにエラーになる場合は、[bltouch] に次を追加します：

    pin_up_reports_not_triggered: False

  3. プローブが引っかかっている場合は、プローブモジュールの交換やサポートへの連絡をおすすめします。通電中の機器を分解しないでください。

総合ガイド：BLTouch の配線、テスト、クローンの互換性、出力モードなどの詳しい設定方法は BLTouch の設定とトラブルシューティング を参照してください。

Communication timeout during homing​

エラー内容：Communication timeout during homing x、Communication timeout during homing y などが表示されます。

よくある原因：

  • ホーミング中に CAN バスがモーター動作による電磁干渉を受け、通信パケットが失われています。
  • USB 通信ケーブルの接触が悪く、動作の振動で切断されています。
  • MCU が過負荷になっています（ホーミングと同時に大量のセンサー照会が発生するなど）。

解決方法：

  1. CAN / USB 通信ケーブルの引き回しを確認し、モーター線、ヒーター線、電源線から離します。
  2. 通信ケーブルのコネクタがしっかり差し込まれていることを確認し、品質の良いシールド線に交換します。
  3. すべての MCU のファームウェアバージョンが一致していることを確認します。
  4. 特定の軸のホーミング時のみ発生する場合は、その軸のモーター線とエンドストップスイッチ配線のシールドとアースを重点的に確認します。

関連する調査：Lost communication with MCU、CAN のエラー調査

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 より大きくなっています。
  • ノズル、プローブマウント、ホットエンドを交換した後で、プローブの取り付け高さが大きく変わっています。
  • 複数の include ファイルで horizontal_move_z や z_offset が重複して設定されています。

解決方法：

  1. すべての horizontal_move_z と z_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. 7x7、9x9 などのより細かいグリッドが必要な場合は、[bed_mesh] で次を設定します：

    algorithm: bicubic

  2. 細かいグリッドが不要な場合は、probe_count を 6,6 以下に下げます。

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

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

関連設定：マクロの紹介。

bed_mesh: Unknown profile​

エラー内容：bed_mesh: Unknown profile [xxx]、またはベッドメッシュ設定の読み込み時に profile が見つからない旨が表示されます。

よくある原因：

  • スタート G-code やマクロで BED_MESH_PROFILE LOAD=xxx を実行していますが、その名前は一度も保存されていません。
  • BED_MESH_CLEAR を実行した、または自動保存セクションのベッドメッシュデータを削除しています。
  • ベッドメッシュの校正が完了した後に SAVE_CONFIG を実行していません。
  • profile 名の大文字 / 小文字やスペースが一致していません。

解決方法：

  1. BED_MESH_OUTPUT を実行するか、設定の末尾にある自動保存セクションを確認し、既存の profile 名を確かめます。
  2. 必要な profile がない場合は、BED_MESH_CALIBRATE を再実行し、その後に SAVE_CONFIG を実行します。
  3. スタート G-code の BED_MESH_PROFILE LOAD= を修正し、実際に保存された名前と一致させます。
  4. 印刷のたびにベッドスキャンし直す場合は、不要な profile 読み込みコマンドを削除してかまいません。

関連設定：マクロの紹介。

bed_mesh の高度な設定エラー​

エラー内容：bed_mesh: ERROR, fade_target lies outside of mesh z range、bed_mesh: Mesh extends outside of the fade range、bed_mesh: Cannot probe zero reference position、bed_mesh: invalid min/max points、bed_mesh: malformed 'xxx' value。

よくある原因：

  • fade_target が現在のベッドメッシュの Z 高さ範囲を超えている、またはベッドメッシュデータ全体の偏差が大きすぎます。
  • mesh_min、mesh_max、zero_reference_position がプローブオフセットと計算された結果、プロービングできない領域に入っています。
  • faulty_region がゼロ基準点を覆っており、Klipper が基準位置をプロービングできません。
  • 座標リストの書式が誤っており、カンマが足りない、または中国語の句読点が使われています。
  • アダプティブベッドメッシュのマクロが渡す MESH_MIN / MESH_MAX が、マシン寸法やプローブオフセットと一致していません。

解決方法：

  1. [bed_mesh] の mesh_min、mesh_max、probe_count、fade_start、fade_end、fade_target を確認します。
  2. fade_target の意味がわからない場合は、まずこの項目を削除し、Klipper の既定の動作に任せます。
  3. すべてのプロービングポイントに [probe] の x_offset / y_offset を加えても、マシンの移動可能範囲内にあることを確認します。
  4. zero_reference_position や faulty_region を設定している場合は、ゼロ基準点が故障領域に入っていないことを確認します。
  5. アダプティブベッドメッシュでエラーになる場合は、まず固定の mesh_min / mesh_max でテストし、基本のベッドメッシュ設定が正常だと確認してからマクロを戻します。

関連設定：マクロの紹介、マシンの校正。

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 のリードスクリュー、タイミングベルト、カップリングを手動で調整する場合や、ガントリーのエンドストップの取り付けを確認する場合は、プリンタを完全に停止して電源を切断してください。モーターに通電してトルクが保持されている状態で、リードスクリューやタイミングベルトを無理に回さないでください。

  1. [probe] の x_offset、y_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 倍を超えないようにしてください。

関連設定：ホーミングと方向校正のガイド。

no samples between time​

エラー内容：no samples between time X.X and X.X。通常は BED_MESH_CALIBRATE の実行後に発生します。

よくある原因：

  • EDDY 渦電流プローブや Cartographer などのストリーミングサンプリングプローブのファームウェアバージョンが、ホスト側の Klipper と一致していません。
  • ベッドメッシュのサンプリング中にプローブのデータストリームが途切れています（CAN 通信の揺れ、USB 帯域不足）。
  • Klipper をアップグレードした後、プローブモジュールのファームウェアを同時に更新していません。
  • ホストの CPU 負荷が高すぎて、サンプリングデータのタイムスタンプが異常になっています。

解決方法：

  1. プローブモジュール（EDDY、Cartographer など）のファームウェアバージョンが現在の Klipper バージョンと一致していることを確認し、必要に応じてプローブのファームウェアを書き直します。
  2. CAN バスの状態を確認し、bytes_retransmit、bytes_invalid が増え続けていないことを確かめます。
  3. カメラ、KlipperScreen、その他の高負荷サービスを一時的に停止してから、ベッドメッシュの校正を再度実行します。
  4. 特定の領域でのみエラーになる場合は、その領域がプローブの有効な検出範囲を超えていないか確認します。
  5. ベッドメッシュのサンプリング速度を下げ（speed パラメータを小さくする）、再テストします。

EDDY プローブ関連：EDDY のトラブル集

SVD did not converge in Linear Least Squares​

エラー内容：numpy.linalg.LinAlgError: SVD did not converge in Linear Least Squares。通常は BED_MESH_CALIBRATE や ACCEPT の実行後に shutdown が発生します。

よくある原因：

  • ベッドメッシュのサンプリングデータが異常（すべて同じ値、NaN を含む、極端な跳びがある）で、numpy が行列のフィッティングを完了できません。
  • サンプリング中にプローブのトリガーが異常になります（EDDY のデータストリーム断、Cartographer のモデル範囲超過など）。
  • ヒートベッド表面に金属異物がある、またはプローブの検出面が汚れていて、一部のポイントの読み値が大きく外れています。
  • ホストの numpy バージョンが古い、またはインストールが壊れています。

解決方法：

  1. BED_MESH_CALIBRATE を再実行し、毎回同じポイントで失敗するか観察します。
  2. ヒートベッド表面がきれいか、プローブの検出面に残留したフィラメントや金属片がないか確認します。
  3. プローブが EDDY / Cartographer の場合は、ファームウェアバージョンが Klipper と一致していることを確認し、CAN 通信の安定性を調べます。
  4. probe_count を小さくして（例：7x7 から 5x5 へ）再テストし、単一ポイントの異常の影響を排除します。
  5. 問題が続く場合は、ホストの numpy を更新してみてください：pip install --upgrade numpy。
  6. klippy.log でエラーより前に Toolhead stopped outside model range やプローブのタイムアウトなど、先行するエラーがないか確認します。
Loading...