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

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

このページでは、移動範囲、原点復帰、リミット、プローブ、メッシュベッド、マルチ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、モーターの方向、またはエンドストップのピン設定が間違っており、原点復帰動作が正常に行われない。

解決方法：

電源オフ作業

エンドストップのコネクタ、モーターの配線、またはケーブルの抜き差しを確認する前に、プリンターの電源を完全に切り、電源ケーブルを抜いてください。通電テスト時は、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の感度を調整する。

関連設定の参考：原点復帰と方向キャリブレーションガイド、エンドストップ関連。

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

電源オフ作業

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 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. プローブが引っかかっている場合、プローブモジュールの交換を推奨するか、サポートに連絡してください。通電状態の機器を分解しないでください。

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はこのアルゴリズムを使用する際、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]、またはメッシュベッド設定を読み込む際にプロファイルが見つからないというエラー。

よくある原因：

  • 開始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倍を超えないようにする。

関連設定の参考：原点復帰と方向キャリブレーションガイド。

Loading...