Инструмент калибровки щупа

Команды Klipper для Z-смещения щупа, Z-концевика, сетки стола, калибровки Delta и другие в итоге попадают в один и тот же процесс ручного зондирования. Его обеспечивает модуль manual_probe — этот модуль загружается Klipper автоматически, в printer.cfg его не нужно прописывать, и настраиваемых параметров у него нет; настраивать нужно [probe] (или [bltouch]) и [stepper_z].

Большинство сообщений, которые выводит этот процесс, всего лишь ждут ввода TESTZ — это не ошибка. Реально приводят к аннулированию калибровки или к тому, что команда не запускается, только три случая ниже.

Быстрая справка за минуту

Сообщение в терминале	Характер	Что делать
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=- / --	Двоичный поиск / переход к более низкой уже опробованной точке, один шаг ≤ 0.2mm
TESTZ Z=+ / ++	Двоичный поиск / переход к более высокой уже опробованной точке, один шаг ≤ 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 не стал ниже: сопло только поднимали, или опустили слишком низко и вернули к исходной точке — проверяется только Z в момент нажатия ACCEPT, промежуточный процесс не важен (не пройдёт даже при превышении на 0.01mm).

Решение:

1. Повторите команду калибровки и сближайтесь только в одном направлении — вниз командой TESTZ Z=-0.1 (после сближения — -0.05); убедитесь, что значение в середине Z position стало меньше начального, и только затем ACCEPT.
2. Во время сеанса не трогайте X/Y.
3. Если провал наступает сразу каждый раз, проверьте, не слишком ли низкая начальная высота, различая по конструкции:
   • Машины с отдельным 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 с тем же именем, что и встроенная команда.

Решение:

1. Выполните ABORT, чтобы завершить старый сеанс. Если появляется Unknown command: ABORT, значит текущего сеанса нет — завершите тот инструмент, который реально занимает ACCEPT (например, выполните ADJUSTED в BED_SCREWS_ADJUST).
2. Если это повторяется всегда, проверьте во всех файлах include, нет ли макроса с тем же именем, что и встроенная команда; переименуйте или удалите его и повторите.
3. Обновление интерфейса или перезапуск Klipper убирают оставшееся в интерфейсе окно калибровки.

После ACCEPT

• MANUAL_PROBE отвечает Z position is <значение>; PROBE_CALIBRATE и Z_ENDSTOP_CALIBRATE выводят рекомендованное новое значение.
• Конфигурация записывается и применяется после перезапуска только при выполнении SAVE_CONFIG (или SAVE_CONFIG & Restart в интерфейсе).
• Отказ на полпути — через ABORT: конфигурация не пишется и Manual probe failed! не появляется.

Стандартный процесс с бумагой

Риск движения

Во время калибровки сопло автоматически движется вниз. Перед выполнением уберите руки и инструменты, убедитесь, что под соплом нет препятствий, а на подогреваемом столе нет оставшихся деталей, и будьте готовы в любой момент нажать аварийный останов.

1. Выполните homing и переместите сопло точно над калибруемой точкой.
2. Выполните команду калибровки и убедитесь, что появилось Starting manual Z probe.
3. Подложите бумагу между соплом и подогреваемым столом и подвигайте её туда-обратно.
4. Опускайтесь командой TESTZ Z=-0.1; после сближения перейдите на TESTZ Z=-0.05 или Z=- для более мелкого шага.
5. Остановитесь, когда бумага слегка зажата и при движении ощущается заметное сопротивление.
6. Выполните ACCEPT; если появилось Manual probe failed!, разберитесь по этому пункту и повторите.
7. Выполните SAVE_CONFIG, чтобы сохранить и перезапустить.

Сближайтесь только в одном направлении

Всегда сближайтесь с точкой контакта сверху вниз: это и уменьшает ошибку люфта оси Z, и не приведёт к провалу из-за того, что Z не стал ниже начальной высоты.

Связанные документы

Ошибки щупа и выравнивания: Ошибки движения, концевиков и выравнивания · BLTouch: Настройка и диагностика BLTouch · EDDY: Сборник проблем EDDY · Load Cell: Диагностика щупа Load Cell

Частые отладочные команды: Частые отладочные команды · Процесс калибровки машины: Калибровка машины