Ошибки движения, концевых выключателей и выравнивания
На этой странице собраны ошибки, связанные с диапазоном перемещения, возвратом в исходное положение, концевыми выключателями, щупом, сеткой стола и выравниванием по нескольким Z. При работе с проводкой, разъемами и ручной механической регулировкой сначала отключайте питание.
Move out of range
Сообщение об ошибке: Целевая координата выходит за пределы допустимого диапазона движения, настроенного в Klipper. В журнале обычно отображается что-то вроде Move out of range: X Y Z [E].
Распространенные причины:
- Размеры станка в слайсере не соответствуют
position_min/position_maxв конфигурации Klipper. - Начальный G-code, конечный G-code, макрос смены филамента или макрос паузы перемещают головку за пределы станка.
- После применения коррекции перекоса, смещения щупа или конфигурации сетки стола вычисленные координаты становятся отрицательными или превышают максимальный ход.
- Высота модели превышает максимальный ход по оси Z.
Методы решения:
- Определите по координатам в сообщении об ошибке, какая ось вышла за пределы.
- Проверьте
position_min,position_maxдля этой оси и размеры станка в слайсере. - Проверьте координаты парковки в макросах начала, конца, паузы, смены филамента и т.д., избегайте остановки в
0,0или на максимальных границах. - Если ошибка возникает при обходе стола, проверьте
mesh_min,mesh_maxв[bed_mesh]и смещение щупа. - Сохраните конфигурацию, перезапустите 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-code, например, после
G1 Zотсутствует конкретное значение координаты. - Переменная макроса пуста, в итоговой команде перемещения отсутствуют значения
X,Y,Z,EилиF. - Ошибка форматирования переносов строк, фигурных скобок, имен переменных или экранирования в начальном/конечном G-коде слайсера.
- Параметр скорости
Fпуст, равен 0 или не является числом. - В G-code файле используется дюймовый режим
G20, который не поддерживается Klipper. - Несоответствие имен, используемых в
SAVE_GCODE_STATE/RESTORE_GCODE_STATEв макросе.
Методы решения:
- Найдите в
klippy.logполную строку с ошибкой, чтобы определить, какая командаG1,G0или состояния вызвала проблему. - Проверьте макросы начала, конца, паузы, возобновления и смены филамента в слайсере, убедитесь, что все команды перемещения имеют полные значения.
- Установите значения по умолчанию для параметров макроса и преобразуйте их в числа перед использованием, например,
params.Z|default(10)|float. - Убедитесь, что единицы измерения в слайсере установлены в миллиметры и не выводится команда
G20. - При ошибке
Unknown g-code stateпроверьте, используются ли одинаковые имена вSAVE_GCODE_STATE NAME=иRESTORE_GCODE_STATE NAME=.
Связанные конфигурации: Введение в макросы.
Must home axis first
Сообщение об ошибке: Ось не возвращена в исходное положение, невозможно выполнить текущую команду перемещения.
Распространенные причины:
- После включения или
FIRMWARE_RESTARTне была выполнена командаG28. - В макросе сначала выполняется команда перемещения, а затем команда возврата в исходное положение.
- Состояние станка сбрасывается после паузы, возобновления или отмены печати.
- Некорректная конфигурация макроса возврата в исходное положение, макроса щупа или возврата без концевых выключателей, из-за чего Klipper неправильно фиксирует состояние возврата.
Методы решения:
- Вручную выполните
G28, а затем перемещайте соответствующую ось. - Проверьте начальный G-code и макросы, убедитесь, что возврат в исходное положение выполнен до команд перемещения.
- Если вы недавно обновляли Klipper или прошивку, проверьте совместимость макросов возврата с текущей версией.
- При использовании возврата без концевых выключателей проверьте ток драйвера, чувствительность и
homing_retract_dist.
Связанные конфигурации: Руководство по калибровке исходного положения и направления, Использование бесконтактных концевых выключателей.
Endstop still triggered after retract
Сообщение об ошибке: После отката на расстояние homing_retract_dist концевой выключатель все еще остается в сработавшем состоянии.
Распространенные причины:
- Инвертирована логика нормально разомкнутого/нормально замкнутого концевого выключателя.
- Концевой выключатель заклинил, поврежден или неправильно подключен.
- Слишком маленькое значение
homing_retract_dist, после отката выключатель все еще нажат. - Слишком высокая чувствительность при возврате без концевых выключателей, состояние срабатывания определяется после отката.
- Неправильная конфигурация
enable_pinдрайвера, направления двигателя или пина концевого выключателя, приводящая к некорректному движению при возврате.
Методы решения:
Перед проверкой разъема концевого выключателя, распиновки двигателя или переподключением жгутов полностью выключите принтер и отключите его от источника питания. При тестировании под напряжением используйте только веб-команды и механическое нажатие на концевой выключатель, не прикасайтесь к клеммам.
- Выполните
QUERY_ENDSTOPS, убедитесь, что в несработавшем состоянии отображаетсяopen, а при ручном нажатии —TRIGGERED. - Если состояние инвертировано, откорректируйте
!перед пином концевого выключателя. - Отключив питание, проверьте механическое состояние концевого выключателя, распиновку и разъем.
- Увеличьте
homing_retract_distи повторите тест. - При использовании возврата без концевых выключателей уменьшите чувствительность и убедитесь, что ток возврата подходит.
Связанные конфигурации: Концевые выключатели, Использование бесконтактных концевых выключателей.
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реальному ходу, расстояние возврата недостаточно. - Слишком низкая чувствительность при возврате без концевых выключателей, удар о механический упор не распознается как срабатывание.
- Неправильная распиновка или направление двигателя, приводящие к движению оси в противоположную сторону.
Методы решения:
- Выполните
QUERY_ENDSTOPS, вручную нажмите на концевой выключатель, убедитесь, что состояние меняется сopenнаTRIGGERED. - Переместите ось на небольшое расстояние, чтобы определить направление движения, затем проверьте, нужно ли корректировать
!передdir_pin. - Убедитесь, что
homing_positive_dirсоответствует направлению, в котором находится концевой выключатель. - Проверьте соответствие
position_endstop,position_min,position_maxреальному механическому ходу. - В сценарии возврата без концевых выключателей снизьте скорость возврата и отрегулируйте чувствительность TMC.
Связанные конфигурации: Руководство по калибровке исходного положения и направления, Концевые выключатели.
Поиск неисправностей возврата без концевых выключателей (Sensorless Homing)
Возврат без концевых выключателей использует сигнал DIAG драйвера TMC для обнаружения блокировки двигателя, заменяя физические концевые выключатели. При неправильной конфигурации или чувствительности возникают следующие ошибки. Полную проверку совместимости, эталонные конфигурации и методы настройки чувствительности см. в разделе Использование бесконтактных концевых выключателей.
Возврат не запускается: No trigger on x after full movement
Сообщение об ошибке: При возврате в исходное положение с использованием virtual_endstop появляется сообщение No trigger on x after full movement или No trigger on y after full movement, каретка ударяется о конечную точку и не останавливается.
Распространенные причины:
- Неподходящий порог чувствительности: слишком низкое значение
driver_SGTHRSдля TMC2209 (недостаточно чувствительно) или слишком высокое значениеdriver_SGTдля TMC5160 / TMC2240 / TMC2130. - На материнской плате класса B не установлена перемычка
DIAG, или к соответствующему порту концевого выключателя подключено другое устройство. - Отсутствует символ подтяжки
^у пинаdiag_pin, сигнал с открытым стоком не может стабильно срабатывать. - Слишком низкая скорость возврата или ток драйвера, изменение тока при блокировке недостаточно для генерации сигнала
DIAG.
Перед проверкой перемычек, подключения к порту концевого выключателя или переподключением жгутов сначала выключите принтер и отключите его от источника питания. Не прикасайтесь к клеммам и не подключайте/отключайте жгуты под напряжением.
Методы решения:
- Следуя методике Использование бесконтактных концевых выключателей · Проверка чувствительности, начните с максимальной чувствительности и постепенно настраивайте
SGTHRS/sgt. - Убедитесь, что
diag_pinимеет подтяжку^(например,diag_pin: ^PD9); для драйверов с двумя выводамиDIAG, таких как TMC5160, необходимо уточнить, какой вывод используется:diag0_pinилиdiag1_pin. - Для материнских плат класса B убедитесь, что установлена перемычка
DIAGи к соответствующему порту концевого выключателя не подключено других устройств. - Соответственно увеличьте ток и скорость возврата, затем повторите тест.
Ошибка конфигурации: Unknown pin chip name
Сообщение об ошибке: При запуске появляются сообщения 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или использование недопустимых символов.
Способы решения:
- Проверьте
endstop_pinв[stepper_x], убедитесь, что форматtmcXXXX_stepper_x:virtual_endstop, между именем драйвера и именем оси должно быть подчеркивание, а не пробел. - В имени секции конфигурации драйвера
[tmcXXXX stepper_x]используется пробел, но при ссылке вendstop_pinнеобходимо использовать подчеркивание. Имена должны соответствовать друг другу. - Проверьте написание имени пина
diag_pin. Допускаются только префиксы^,!с последующим допустимым именем пина.
Ошибка конфигурации: Could not find any TMC driver config section
Сообщение об ошибке: 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], или имя секции драйвера не совпадает со ссылкой. - Секция драйвера закомментирована, содержит ошибку в написании или имя оси не совпадает.
Способы решения:
- Убедитесь, что существует секция конфигурации драйвера, полностью соответствующая ссылке в
endstop_pin. Например, дляendstop_pin: tmc2209_stepper_x:virtual_endstopобязательно должна быть секция[tmc2209 stepper_x]. - Проверьте, не закомментирована ли секция драйвера и не перепутаны ли имена осей (
stepper_xиstepper_yне должны путаться).
Экстренная остановка при хоминге: Homing failed due to printer shutdown
Сообщение об ошибке: Во время процесса хоминга принтер переходит в состояние shutdown с сообщением Homing failed due to printer shutdown.
Распространенные причины:
- Это не исключительная ошибка работы без концевиков, а скорее экстренная остановка, вызванная другим аварийным завершением во время хоминга (например, ложное срабатывание сигнала
DIAG, ошибка драйвера, перезапуск службы). - Истинную причину нужно искать в
klippy.log, найдя первую ошибкуshutdownперед сообщениемHoming failed.
Способы решения:
- Откройте
klippy.log, найдите первую ошибкуshutdownвыше строкиHoming failed due to printer shutdownи проведите диагностику по соответствующей категории. - Если выше находится сообщение
Can't reset time when stepper active, действуйте согласно разделу Системные ошибки, производительность и службы. - Если это ложное срабатывание из-за дребезга сигнала
DIAG, проверьте подтяжкуdiag_pinи перемычки, а также уменьшите чувствительность.
Связанная документация: Использование без концевиков, No trigger on endstop after full movement, Устранение ошибок TMC
Проблемы с датчиком и выравниванием
Перед проверкой проводки, разъёмов или порядка проводов датчиков BLTouch, Probe, TAP, Klicky, EDDY и других обязательно полностью выключите принтер и отключите питание. При включённом питании выполняйте только команды запроса или наблюдайте за состоянием, не подключайте и не отключайте жгуты проводов.
Probe triggered prior to movement
Сообщение об ошибке: датчик уже находится в сработавшем состоянии до начала движения парковки или зондирования.
Причины ошибки:
- Состояние датчика по умолчанию после включения питания или сброса —
TRIGGERED. - Неправильный порядок проводов датчика или плохой контакт, из-за чего сигнал постоянно находится в сработавшем состоянии.
- Механическая неисправность датчика, например, застревание щупа BLTouch и невозможность втягивания.
- Ось Z уже находится в самом нижнем положении, из-за чего датчик прижат.
Способы решения:
- Выполните
QUERY_PROBEбез касания стола и убедитесь, что состояние должно бытьopen. - Выполните
QUERY_ENDSTOPS, чтобы убедиться в правильности сигналов концевых выключателей/датчика. - Для BLTouch:
BLTOUCH_DEBUG COMMAND=pin_up, чтобы убедиться, что щуп втянут, затемQUERY_PROBEдля проверки. - Проверьте текущее положение оси Z, при необходимости сначала поднимите ось Z.
- После отключения питания проверьте проводку датчика и конфигурацию
sensor_pin.
Справочная конфигурация: Концевые выключатели, Часто используемые отладочные команды.
No trigger on probe after full movement
Сообщение об ошибке: датчик не сработал в течение полного хода опускания.
Частые причины:
- Ошибка в проводке, питании или конфигурации вывода датчика.
- Неподходящая высота установки датчика, срабатывание невозможно в пределах хода опускания.
- Ошибка в направлении оси Z, смещении датчика или конфигурации области выравнивания.
- Неисправность самого датчика или плохой контакт жгута проводов при движении.
Способы решения:
- Выполните
QUERY_PROBE, вручную активируйте датчик и убедитесь, что состояние нормально изменяется. - После отключения питания проверьте питание датчика, сигнальный провод и настроенный вывод.
- Проверьте высоту установки датчика и убедитесь, что перед опусканием датчик находится в зоне возможного срабатывания.
- Проверьте, не выходят ли точки зондирования в
[probe],[bed_mesh],[z_tilt]или[quad_gantry_level]за пределы стола. - Если проблема возникает только в определённых местах, обратите особое внимание на натяжение жгута проводов и смещение датчика.
Справочная конфигурация: Концевые выключатели, Описание макросов.
Probe samples exceed samples_tolerance
Сообщение об ошибке: Probe samples exceed samples_tolerance или повторяющееся в журнале Probe samples exceed tolerance. Retrying....
Частые причины:
- Плохая повторяемость датчика, разница высот Z между несколькими выборками превышает
samples_tolerance. - Стол, портал, экструдер или датчик закреплены ненадёжно, при зондировании возникает люфт.
- Слишком высокая скорость датчика или неподходящее расстояние опускания/отскока.
- Индуктивные, вихретоковые или тензометрические датчики подвержены влиянию температурного дрейфа и электромагнитных помех.
Способы решения:
- Проверьте надёжность крепления датчика, хотэнда, плиты стола и конструкции портала.
- Уменьшите
speedв[probe], при необходимости увеличьтеsample_retract_dist. - Для проверки временно ослабьте
samples_tolerance, например, с0.01до0.03или0.05. - При использовании индуктивного/вихретокового датчика дождитесь стабилизации температуры стола и сопла, затем выполняйте выравнивание.
- Если проблема возникает только в определённой зоне, проверьте поверхность стола, магнитное покрытие, натяжение жгута проводов и смещение датчика в этой зоне.
Справочная конфигурация: Калибровка станка, Описание макросов.
Must home before probe
Сообщение об ошибке: Must home before probe.
Частые причины:
- Запуск
PROBE,BED_MESH_CALIBRATE,Z_TILT_ADJUSTилиQUAD_GANTRY_LEVELбез предварительного выполненияG28. - В макросе перед вызовом команды выравнивания не гарантировано выполнение парковки XY/Z.
- После
FIRMWARE_RESTART, аварийной остановки или восстановления после ошибки Klipper сбросил состояние парковки.
Способы решения:
- Сначала выполните
G28, затем команду зондирования или выравнивания. - Добавьте в начало макроса выравнивания проверку парковки или непосредственно
G28. - При использовании отдельного 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.
- Самопроверка датчика не удалась, красный светодиод мигает.
Способы решения:
-
Сначала выполните
BLTOUCH_DEBUG COMMAND=pin_down,BLTOUCH_DEBUG COMMAND=touch_modeиQUERY_PROBEдля проверки состояния. -
Если ручной тест проходит, но автоматическая парковка/зондирование по-прежнему выдаёт ошибку, добавьте в
[bltouch]:pin_up_touch_mode_reports_triggered: False -
Убедитесь, что для
sensor_pinнастроен подтягивающий резистор, напримерsensor_pin: ^PC4. -
Проверьте нормальность самопроверки BLTouch: после включения питания щуп несколько раз выдвигается и втягивается, красный светодиод горит постоянно — это нормально.
BLTouch failed to deploy
Сообщение об ошибке: BLTouch failed to deploy.
Частые причины:
- Механическое застревание щупа BLTouch, невозможность выдвижения.
- Ошибка в проводке или конфигурации
control_pin, щуп не получает сигнал выдвижения. - Несовместимость таймингов поддельного/клонированного BLTouch.
- Недостаточное питание датчика (используется 3.3V материнской платы вместо 5V).
Способы решения:
- Проверьте управление датчиком вручную:
BLTOUCH_DEBUG COMMAND=pin_down, наблюдайте за выдвижением щупа. - Убедитесь, что
control_pinиsensor_pinв[bltouch]соответствуют документации материнской платы. - Проверьте, что питание BLTouch составляет 5V (на некоторых платах требуется выбор перемычкой).
- Если датчик совсем не реагирует, после отключения питания проверьте проводку и разъёмы, при необходимости замените модуль датчика.
BLTouch failed to raise probe
Сообщение об ошибке: после парковки или зондирования Klipper обнаружил, что щуп BLTouch не втянулся успешно.
Частые причины:
- Старые клонированные версии BLTouch не могут сообщить состояние втягивания щупа.
- Механическое застревание щупа, смещение магнитного сердечника или ослабление винтов.
- Ошибка в проводке или конфигурации
control_pin.
Способы решения:
-
Проверьте функцию управления датчиком:
BLTOUCH_DEBUG COMMAND=pin_downиBLTOUCH_DEBUG COMMAND=pin_up. -
Если движения нормальные, но возникает ошибка, добавьте в
[bltouch]:pin_up_reports_not_triggered: False -
Если щуп застревает, рекомендуется заменить модуль датчика или обратиться в сервисную службу; не разбирайте оборудование под напряжением.
Полное руководство: полное описание конфигурации BLTouch, включая проводку, тестирование, совместимость клонов и режимы вывода, см. в Настройка и диагностика BLTouch.
Communication timeout during homing
Сообщение об ошибке: Communication timeout during homing x, Communication timeout during homing y и т. д.
Частые причины:
- Во время парковки шина CAN подвергается электромагнитным помехам от движения двигателей, происходят потери пакетов связи.
- Плохой контакт USB-кабеля связи, отключение при вибрации во время движения.
- Перегрузка MCU (например, одновременный опрос большого количества датчиков во время парковки).
Способы решения:
- Проверьте прокладку кабеля связи CAN / USB, убедитесь, что он проложен вдали от проводов двигателей, нагревателей и питания.
- Убедитесь в надёжности разъёмов кабеля связи, замените на более качественный экранированный кабель.
- Убедитесь, что версии прошивок всех MCU совпадают.
- Если проблема возникает только при парковке определённой оси, обратите особое внимание на экранирование и заземление проводов двигателя этой оси и жгута концевых выключателей.
Связанная диагностика: 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_CALIBRATEz_offsetбольше, чемhorizontal_move_zв конфигурации выравнивания. - После замены сопла, держателя щупа или хотэнда высота установки щупа сильно изменилась.
- В нескольких include-файлах повторно настроены
horizontal_move_zилиz_offset.
Способы решения:
- Найдите все
horizontal_move_zиz_offset, чтобы определить итоговую действующую конфигурацию. - Установите в соответствующей конфигурации выравнивания
horizontal_move_zв безопасное значение, большее чемz_offsetщупа. - Если
z_offsetаномально велик, перепроверьте высоту установки щупа и выполнитеPROBE_CALIBRATE. - После сохранения выполните
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 при использовании этого алгоритма.
Способы решения:
-
Если нужна сетка
7x7,9x9или более плотная, установите в[bed_mesh]:algorithm: bicubic -
Если плотная сетка не нужна, уменьшите
probe_countдо6,6или меньше. -
Если адаптивная сетка стола получает
PROBE_COUNTот слайсера или макроса, также убедитесь, что итоговое количество точек соответствует алгоритму. -
После изменения сохраните и выполните
RESTART.
Справочная информация по конфигурации: Описание макросов.
bed_mesh: Unknown profile
Сообщение об ошибке: bed_mesh: Unknown profile [xxx] или при загрузке конфигурации сетки стола появляется сообщение о том, что профиль не найден.
Частые причины:
- В стартовом G-коде или макросе выполняется
BED_MESH_PROFILE LOAD=xxx, но это имя никогда не сохранялось. - Была выполнена команда
BED_MESH_CLEARили удалены данные сетки стола из области автосохранения. - После завершения калибровки сетки стола не была выполнена команда
SAVE_CONFIG. - Имя профиля отличается по регистру или содержит лишние пробелы.
Способы решения:
- Выполните
BED_MESH_OUTPUTили просмотрите область автосохранения в конце конфигурации, чтобы确认 существующие имена профилей. - Если нужного профиля нет, повторно выполните
BED_MESH_CALIBRATE, затемSAVE_CONFIG. - Измените
BED_MESH_PROFILE LOAD=в стартовом G-коде так, чтобы имя совпадало с фактически сохранённым. - Если стол сканируется заново перед каждой печатью, можно удалить ненужные команды загрузки профиля.
Справочная информация по конфигурации: Описание макросов.
Ошибки расширенной конфигурации 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не соответствуют размерам станка и смещению щупа.
Способы решения:
- Проверьте в
[bed_mesh]параметрыmesh_min,mesh_max,probe_count,fade_start,fade_end,fade_target. - Если непонятно назначение
fade_target, лучше удалите этот параметр, чтобы Klipper использовал поведение по умолчанию. - Убедитесь, что все точки прощупывания с учётом
x_offset/y_offsetиз[probe]остаются в пределах перемещения станка. - Если настроены
zero_reference_positionилиfaulty_region, убедитесь, что нулевая опорная точка не попадает в область неисправности. - При ошибке адаптивной сетки стола сначала протестируйте с фиксированными
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 не согласовано, из-за чего портал наклоняется в противоположные стороны.
- Высота установки концевых выключателей не одинакова, из-за чего после homing начальные позиции осей Z сильно различаются.
- Ослаблена механическая конструкция портала, проскальзывает ремень или слишком большой люфт в гайке ходового винта.
Способы решения:
Перед ручной регулировкой винтов Z, ремней синхронизации, муфт или проверкой установки концевых выключателей портала полностью выключите принтер и отключите питание. Не пытайтесь проворачивать винты или ремни синхронизации силой, пока двигатели находятся под напряжением и удерживают момент.
- Проверьте
x_offset,y_offsetв[probe], а такжеpointsв[z_tilt]или[quad_gantry_level]. - Если отклонение превышает
max_adjust, после полного отключения питания вручную выставьте портал примерно горизонтально, затем снова включите питание, выполните homing и выравнивание. - Выполните
STEPPER_BUZZ STEPPER=stepper_zиSTEPPER_BUZZ STEPPER=stepper_z1(по фактическим именам), чтобы убедиться, что каждый двигатель Z движется в согласованном направлении. - После отключения питания проверьте одинаковость высоты установки концевых выключателей по углам портала, а также натяжение ремней, гайки ходовых винтов и муфты на предмет проскальзывания.
- Если ограничение
max_adjustпросто слишком мало, его можно немного увеличить, но не более чем в 2-3 раза от значения по умолчанию.
Справочная информация по конфигурации: Руководство по homing и калибровке направлений.
no samples between time
Сообщение об ошибке: no samples between time X.X and X.X, обычно появляется после выполнения BED_MESH_CALIBRATE.
Частые причины:
- Версия прошивки вихретокового щупа EDDY или потокового щупа Cartographer не соответствует версии Klipper на хосте.
- Поток данных щупа прерывается во время сканирования сетки стола (нестабильность связи CAN, недостаточная пропускная способность USB).
- После обновления Klipper не была синхронно обновлена прошивка модуля щупа.
- Слишком высокая нагрузка на CPU хоста приводит к аномальным временным меткам данных выборки.
Способы решения:
- Убедитесь, что версия прошивки модуля щупа (EDDY, Cartographer и т. д.) соответствует текущей версии Klipper; при необходимости перепрошейте прошивку щупа.
- Проверьте состояние шины CAN, убедитесь, что
bytes_retransmitиbytes_invalidне продолжают расти. - Временно отключите камеру, KlipperScreen и другие высоконагруженные сервисы, затем повторно выполните калибровку сетки стола.
- Если ошибка возникает только в определённой области, проверьте, не выходит ли эта область за пределы эффективного диапазона срабатывания щупа.
- Попробуйте снизить скорость сканирования сетки стола (уменьшить параметр
speed) и повторить тест.
Связанное со щупом EDDY: Сборник проблем EDDY
SVD did not converge in Linear Least Squares
Сообщение об ошибке: numpy.linalg.LinAlgError: SVD did not converge in Linear Least Squares, обычно вызывает shutdown после выполнения BED_MESH_CALIBRATE или ACCEPT.
Частые причины:
- Аномальные данные точек выборки сетки стола (все одинаковые, содержат NaN или экстремальные скачки), из-за чего numpy не может完成 аппроксимацию матрицы.
- Щуп срабатывает аномально во время выборки (например, прерывание потока данных EDDY, выход Cartographer за пределы модели).
- На поверхности стола есть металлические посторонние предметы или загрязнение чувствительной поверхности щупа, из-за чего отдельные показания сильно отклоняются.
- Слишком старая версия numpy на хосте или повреждённая установка. Способы решения:
- Повторно выполните
BED_MESH_CALIBRATEи проверьте, не возникает ли ошибка каждый раз в одной и той же точке. - Проверьте, чистая ли поверхность стола, нет ли остатков филамента или металлической стружки на чувствительной поверхности датчика.
- Если используется датчик EDDY / Cartographer, убедитесь, что версия прошивки совместима с Klipper, и проверьте стабильность связи по CAN.
- Попробуйте уменьшить
probe_count(например, с 7x7 до 5x5) и повторите измерение, чтобы исключить влияние аномалии в отдельной точке. - Если проблема сохраняется, попробуйте обновить numpy на хосте:
pip install --upgrade numpy. - Проверьте в
klippy.log, не предшествовали ли ошибке сообщенияToolhead stopped outside model rangeили тайм-аут датчика.