プローブ校正ツール

Klipper のプローブ Z オフセット、Z エンドストップ、ベッドメッシュ、Delta 校正などのコマンドは、最終的にすべて同じ手動プロービングのフローに入ります。これは manual_probe モジュールが提供しているもので、このモジュールはKlipper が自動的にロードするため printer.cfg に書く必要も設定項目もありません。実際に設定が必要なのは [probe]（または [bltouch]）と [stepper_z] です。

このフローが出力するプロンプトのほとんどは TESTZ の入力を待っているだけであり、故障ではありません。校正が無効になったりコマンドが起動しなくなったりする本当の原因は、以下の 3 つだけです。

1 分早見表

ターミナル表示	性質	対処方法
`Starting manual Z probe…`	正常なプロンプト、入力を待機	`TESTZ Z=-0.1` で下方向に近づく → `ACCEPT`；中止する場合は `ABORT`
`Manual probe failed!…`	今回の校正は無効（shutdown せず、設定も書き込まない）	校正コマンドを再実行；その間 X/Y を動かさず、最終的な Z は開始時より低くする
`Already in a manual Z probe…`	コマンドレベルのエラー	まず `ABORT` で古いセッションを終了するか、`ACCEPT` を占有している他のツールを終了する

プローブのハードウェアや設定に関するエラー（Probe triggered prior to movement、No trigger on probe、Probe samples exceed samples_tolerance、BLTouch、bed_mesh）は、運動・エンドストップ・レベリングのエラーを参照してください。

どのコマンドが手動プロービングに入るか

コマンド	用途	手動プロービング
`MANUAL_PROBE`	プローブがない場合に紙片法で任意の点の Z を測定	常に
`PROBE_CALIBRATE`	プローブの `z_offset` を校正	プロービング完了後に微調整
`Z_ENDSTOP_CALIBRATE`	`position_endstop` を校正	常に；`[stepper_z]` に `position_endstop` が設定されている場合にのみ存在し、プローブを Z エンドストップとする機種（`probe:z_virtual_endstop`、例：TAP）にはこのコマンドはありません
`DELTA_CALIBRATE`	Delta タワーの高さ / 半径	プローブがない場合、または `METHOD=manual` の場合
`BED_MESH_CALIBRATE`、`BED_TILT_CALIBRATE`、`Z_TILT_ADJUST`、`QUAD_GANTRY_LEVEL`	ベッドメッシュ / 傾き / 複数 Z の測定点取得	`METHOD=manual` を付けた場合

画面のポップアップ

Mainsail / Fluidd の校正ポップアップが読み取っているのは manual_probe の状態であり、ACCEPT をクリックすることはターミナルで ACCEPT を入力することと同じです。

TESTZ の使い方

書き方	動作
`TESTZ Z=-0.1`	数値に従って移動し、ステップ幅の制限を受けません（離れているときはこれで一気に移動）
`TESTZ Z=-` / `--`	より低い既探査点へ二分 / ジャンプし、1 ステップ ≤ `0.2mm`
`TESTZ Z=+` / `++`	より高い既探査点へ二分 / ジャンプし、1 ステップ ≤ `0.2mm`

知っておきたい 2 点

+ / - / ++ / -- は 1 回の移動が最大 0.2mm なので、遅いと感じたら数値指定に切り替えてください。
TESTZ のたびに、まず「目標 + 0.5mm」まで上昇してから目標まで下降するため、途中でノズルが少し上がるのは正常です。

3 つのプロンプトの詳細

Starting manual Z probe

// Starting manual Z probe. Use TESTZ to adjust position.
// Finish with ACCEPT or ABORT command.
// Z position: ?????? --> 5.000 <-- ??????

正常なプロンプトで、状態は ready のままで、自動的に終了することもタイムアウトすることもありません。--> と <-- の間が現在の Z で、左右はそれぞれ既に探査したより低い / より高い位置であり、?????? はその方向にまだ記録がないことを示します。

やること：紙片法の手順に従って少しずつ下降させ、接触したら ACCEPT します。

Manual probe failed!

// Manual probe failed! Use TESTZ commands to position the
// nozzle prior to running ACCEPT.

今回の校正は無効になります。shutdown は発生しませんが、設定は一切書き込まれず、ACCEPT / TESTZ / ABORT はその後効力を失うため、校正コマンドを再実行する必要があります（この時点で SAVE_CONFIG を押しても意味がありません）。

原因は 2 つだけで、どちらかに該当すれば失敗します：

X/Y を動かした：セッション中にジョグ / 矢印キーを使った、またはマクロに G1 X.. Y.. や Klicky のドッキング動作が含まれている。
Z が低くなっていない：上方向にしか動かしていない、または下げすぎてから開始点まで戻した——判定は ACCEPT を押した瞬間の Z だけを見ており、途中の経過とは関係ありません（たとえ 0.01mm でも高いと通りません）。

対処法：

校正コマンドを再実行し、TESTZ Z=-0.1（近づいたら -0.05）で一方向に下向きに近づけます。Z position の中央の数値が開始時より小さくなっていることを確認してから ACCEPT します。
セッション中は X/Y に触れないでください。
毎回すぐに失敗する場合は、開始高さが低すぎないか確認します。構造によって確認箇所が異なります：
- 独立した Z エンドストップがある機種：[stepper_z] position_endstop を確認します。
- プローブを Z エンドストップとして使う場合（probe:z_virtual_endstop、Voron TAP のようなノズル接触式の構造など）：[stepper_z] には position_endstop がないため、[probe] z_offset と Z 軸の下限 position_min を確認します。
- Delta 機種：minimum_z_position も確認できます。

Already in a manual Z probe

Already in a manual Z probe. Use ABORT to abort it.

コマンドレベルのエラーです。新しいセッションを開始する前に、Klipper は ACCEPT が既に占有されていることを検出しています。

よくある原因：前のセッションが ACCEPT / ABORT で終了していない；BED_SCREWS_ADJUST などのツールも ACCEPT を占有している；組み込みコマンドと同じ名前の gcode_macro を定義している。

対処法：

ABORT を実行して古いセッションを終了します。Unknown command: ABORT と表示された場合は現在セッションがありません——本当に ACCEPT を占有しているツールを終了してください（例：BED_SCREWS_ADJUST の中で ADJUSTED を実行する）。
毎回必ず発生する場合は、すべての include ファイルに組み込みコマンドと同じ名前のマクロがないか確認し、名前を変更するか削除してから再試行します。
画面を再読み込みするか Klipper を再起動すると、画面に残った校正ポップアップを消せます。

ACCEPT の後

MANUAL_PROBE は Z position is <数値> を返します。PROBE_CALIBRATE、Z_ENDSTOP_CALIBRATE は推奨される新しい値を提示します。
SAVE_CONFIG を実行する必要があります（または画面の SAVE_CONFIG & Restart）。これで設定が書き込まれ、再起動して反映されます。
途中で中止する場合は ABORT を使います。設定は書き込まれず、Manual probe failed! も発生しません。

標準的な紙片法の手順

動作のリスク

校正の途中でノズルは自動的に下降します。実行前に手や工具をどけ、ノズルの下に障害物がなく、ヒートベッド上に残留物がないことを確認し、いつでも非常停止できるようにしておいてください。

ホーミングを完了し、ノズルを校正対象点の真上へ移動します。
校正コマンドを実行し、Starting manual Z probe が表示されることを確認します。
紙片をノズルとヒートベッドの間に置き、前後に動かします。
TESTZ Z=-0.1 で少しずつ下降します。近づいたら TESTZ Z=-0.05 または Z=- に切り替えて細かく調整します。
紙片が軽く挟まれ、動かすとはっきり抵抗がある状態で停止します。
ACCEPT を実行します。Manual probe failed! が表示された場合は、該当項目に従って原因を確認してからやり直します。
SAVE_CONFIG を実行して保存し、再起動します。

一方向からのみ近づく

常に高い位置から接触点へ向けて下降させることで、Z 軸のバックラッシュ誤差を減らせるだけでなく、Z が開始高さより低くならずに失敗することも避けられます。

1 分早見表​

どのコマンドが手動プロービングに入るか​

TESTZ の使い方​

3 つのプロンプトの詳細​

Starting manual Z probe​

Manual probe failed!​

Already in a manual Z probe​

ACCEPT の後​

標準的な紙片法の手順​

関連ドキュメント​