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

運動、リミット、レベリングエラー

このページでは、移動範囲、ホーミング、リミット、プローブ、メッシュベッド、マルチ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_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コード行の形式が不完全（例：G1 Z の後に具体的な座標値がない）。
  • マクロ変数が空で、最終的に生成された移動コマンドに X、Y、Z、E または F の値が欠けている。
  • スライサーのスタート/エンドGコード内の改行、中括弧、変数名、またはエスケープ形式に誤りがある。
  • F 速度パラメータが空、0、または数値ではない。
  • Gコードファイルがインチモード 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コードとマクロを確認し、移動コマンドの前にホーミングが完了していることを確認する。
  3. Klipperまたはファームウェアを最近更新した場合、ホーミング関連マクロが現在のバージョンと互換性があるか確認する。
  4. センサーレスホーミングを使用している場合、ドライバー電流、感度、homing_retract_dist を確認する。

関連設定の参考：ホーミングと方向校正ガイド、センサーレスホーミングの使用。

Endstop still triggered after retract​

エラーメッセージ：ホーミングでリミットをトリガーした後、後退距離の終了時にリミットがまだトリガー状態です。

よくある原因：

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

解決方法：

電源オフ作業

リミットプラグ、モーター配線の確認、またはケーブル抜き差しを行う前に、プリンターの電源を完全に切り、電源供給を遮断してください。通電テスト時はウェブコマンドとリミットの機械的トリガー部分のみ操作し、端子には触れないでください。

  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 ピンドライバーでは、diag0_pin と diag1_pin のどちらを使用するか確認する。
  3. B クラスメインボードで DIAG ジャンパーキャップが取り付けられており、対応するリミットポートに他のデバイスが接続されていないことを確認する。
  4. ホーミング電流とホーミング速度を適切に上げてから再テストする。

設定エラー：不明なピンチップ名​

エラーメッセージ：起動時に 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 のピン名のスペルを確認する。許可されるのは ^、! プレフィックスと有効なピン名のみである。

設定エラー：TMCドライバ設定セクションが見つかりません​

エラーメッセージ：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​

エラーメッセージ：ホーミング中にプリンターがシャットダウンし、Homing failed due to printer shutdown と表示される。

一般的な原因：

  • これはリミットスイッチレス特有の故障ではなく、ホーミング中に他のシャットダウン（例：DIAG 信号のチャタリングによる誤トリガー、ドライバエラー、サービスの再起動）が発生し、緊急停止に至った。
  • 本当の原因を確認するには、klippy.log で Homing failed の直前にある最初のシャットダウンエラーを確認する必要がある。

解決方法：

  1. klippy.log を開き、Homing failed due to printer shutdown の上にある最初の shutdown エラーを探し、対応するカテゴリに従って調査する。
  2. その上に Can't reset time when stepper active がある場合は、システム、パフォーマンス、サービスエラー に従って処理する。
  3. DIAG 信号のチャタリングによる誤トリガーの場合は、diag_pin のプルアップとジャンパーピンを確認し、感度を適切に下げる。

関連ドキュメント：リミットスイッチレス使用、全移動後もエンドストップがトリガーされない、TMCエラー調査

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

電源オフ作業

BLTouch、Probe、TAP、Klicky、EDDY などのプローブの配線、コネクタ、またはピン配列を確認する前に、プリンターの電源を完全に切り、電源を遮断してください。通電中はクエリコマンドの実行や状態の確認のみを行い、配線の抜き差しは絶対に行わないでください。

移動前にプローブがトリガーされました​

エラーメッセージ：ホーミングまたはプローブ動作の開始前に、プローブがすでにトリガー状態にある。

エラーの原因：

  • プローブが電源投入後またはリセット後にデフォルトで 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 の設定を確認する。

関連設定の参考：エンドストップ関連、よく使うデバッグコマンド。

全移動後もプローブがトリガーされない​

エラーメッセージ：プローブが完全なプローブ下降ストローク内でトリガーしなかった。

一般的な原因：

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

解決方法：

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

関連設定の参考：エンドストップ関連、マクロ紹介。

プローブサンプルが 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。

一般的な原因：

  • 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がセンサー状態の確認に失敗しました​

エラーメッセージ：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 のタイミングが互換性がない。
  • プローブへの供給電力不足（5V ではなく、マザーボードの 3.3V を使用）。

解決方法：

  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 より大きい。
  • ノズル、プローブホルダー、またはホットエンド交換後、プローブ取り付け高さが大きく変化した。
  • 複数のインクルードファイルで 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 はこのアルゴリズム使用時の単軸プローブ点数を 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]、またはメッシュ設定読み込み時にプロファイルが見つからないというエラー。

よくある原因：

  • 開始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. 毎回印刷前にメッシュを再測定する場合、不要なプロファイル読み込みコマンドを削除してもよい。

関連設定参考：マクロ紹介。

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 実行後にシャットダウンが発生する。

よくある原因:

  • ベッドメッシュサンプリングポイントデータが異常（全て同じ値、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...