프로브 교정 도구

Klipper의 프로브 Z 오프셋, Z 엔드스탑, 베드 메시, Delta 교정 등의 명령은 결국 모두 동일한 수동 프로빙 절차로 들어갑니다. 이는 manual_probe 모듈이 제공하며—이 모듈은 Klipper가 자동으로 로드하므로 printer.cfg에 작성할 필요도, 설정 가능한 항목도 없습니다. 실제로 설정해야 하는 것은 [probe](또는 [bltouch])와 [stepper_z]입니다.

이 절차에서 출력되는 대부분의 안내는 TESTZ 입력을 기다리는 것일 뿐이며, 고장이 아닙니다. 실제로 교정을 무효로 만들거나 명령이 시작되지 않게 하는 것은 아래 세 가지뿐입니다.

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`

두 가지 알아둘 점

+ / - / ++ / --는 매회 최대 0.2mm만 이동하므로 느리다면 수치 표기로 바꾸십시오.
TESTZ마다 먼저 '목표 + 0.5mm'까지 올라간 뒤 목표로 내려가므로, 도중에 노즐이 약간 상승하는 것은 정상입니다.

세 가지 메시지 상세

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를 누르는 것은 의미가 없습니다).

원인은 두 가지뿐이며, 어느 하나에 해당하면 실패합니다:

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 사용법​

세 가지 메시지 상세​

Starting manual Z probe​

Manual probe failed!​

Already in a manual Z probe​

ACCEPT 이후​

표준 종이법 절차​

관련 문서​