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

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

このページでは、移動範囲、ホーミング、リミット、プローブ、メッシュベッド、マルチ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 などのプローブの配線、コネクタ、または線序を確認する前に、プリンタの電源を完全に切り、電源供給を遮断してください。通電時はクエリコマンドの実行や状態の観察のみを行い、ケーブルの抜き差しはしないでください。

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 ではこのアルゴリズムを使用する場合、単軸のプローブ点数を 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-code やマクロで BED_MESH_PROFILE LOAD=xxx を実行しているが、その名前が一度も保存されていない。
  • BED_MESH_CLEAR を実行した、または自動保存領域のメッシュデータを削除した。
  • メッシュキャリブレーション完了後に SAVE_CONFIG を実行していない。
  • プロファイル名の大文字小文字やスペースが一致していない。

解決方法：

  1. BED_MESH_OUTPUT を実行するか、設定末尾の自動保存領域を確認し、既存のプロファイル名を確認します。
  2. 必要なプロファイルがない場合は、再度 BED_MESH_CALIBRATE を実行し、その後 SAVE_CONFIG を実行します。
  3. スタート G-code の 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 後に 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...