Ошибки движения, концевых выключателей и выравнивания
На этой странице собраны ошибки, связанные с диапазоном перемещения, возвратом в исходное положение, концевыми выключателями, щупом, сеткой стола и выравниванием по нескольким 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 совпадают.
- Если ошибка возникает только при возврате в ноль по определенной оси, уделите особое внимание экранированию и заземлению жгутов проводов двигателя и концевых выключателей этой оси.
Связанная диагностика: Потеря связи с 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.
Общие причины:
- Значение
z_offset, сохраненное послеPROBE_CALIBRATE, больше, чемhorizontal_move_zв конфигурации выравнивания. - После замены сопла, кронштейна щупа или хотэнда высота установки щупа значительно изменилась.
- В нескольких включаемых файлах дублируется конфигурация
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, из-за чего портал наклоняется в противоположную сторону.
- Разная высота установки концевых выключателей, из-за чего начальные положения осей Z после хоуминга сильно различаются.
- Ослабление механической конструкции портала, проскальзывание ремня или большой люфт гаек ходовых винтов.
Методы решения:
Перед ручной регулировкой ходовых винтов Z, синхронизирующих ремней, муфт или проверкой установки концевых выключателей портала полностью выключите принтер и отключите источник питания. Не вращайте с усилием ходовые винты или синхронизирующие ремни, когда двигатели находятся под напряжением и удерживают момент.
- Проверьте
x_offset,y_offsetв секции[probe], а такжеpointsв секции[z_tilt]или[quad_gantry_level]. - Если отклонение превышает
max_adjust, полностью обесточьте принтер, вручную выровняйте портал примерно до горизонтального уровня, затем снова подайте питание, выполните хоуминг и процедуру выравнивания. - Выполните
STEPPER_BUZZ STEPPER=stepper_zиSTEPPER_BUZZ STEPPER=stepper_z1(в соответствии с фактическими именами), чтобы убедиться, что каждый двигатель Z вращается в одном направлении. - После отключения питания проверьте, одинакова ли высота установки концевых выключателей по углам портала, отсутствие люфта гаек ходовых винтов, натяжение синхронизирующих ремней и отсутствие проскальзывания муфт.
- Если ограничение
max_adjustслишком мало, можно немного увеличить это значение, но не более чем в 2-3 раза от значения по умолчанию.
Связанная конфигурация: Руководство по калибровке хоуминга и направления.
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или тайм-аут щупа, перед сообщением об ошибке.