Ошибки движения, концевых выключателей и выравнивания
На этой странице собраны ошибки, связанные с перемещением, возвратом в исходное положение, концевыми выключателями, щупами, сеткой и выравниванием нескольких осей 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 и повторите тест.
Соответствующая справочная конфигурация: Введение в макросы, Руководство по возврату в исходное положение и калибровке направления.
Must home axis first
Сообщение об ошибке: Ось еще не возвращена в исходное положение, нельзя выполнить текущую команду перемещения.
Распространенные причины:
- После включения или
FIRMWARE_RESTARTне выполнена командаG28. - В макросе сначала выполняется команда перемещения, а затем команда возврата в исходное положение.
- После паузы, возобновления или отмены печати состояние станка сбрасывается.
- Некорректная конфигурация макроса возврата в исходное положение, макроса щупа или бесконтактных концевых выключателей, из-за чего Klipper неправильно фиксирует статус выполненного возврата.
Методы решения:
- Выполните
G28вручную, а затем перемещайте соответствующую ось. - Проверьте стартовый G-code и макросы, убедитесь, что возврат в исходное положение выполнен до команд перемещения.
- Если вы недавно обновляли Klipper или прошивку, проверьте совместимость макросов возврата в исходное положение с текущей версией.
- При использовании бесконтактных концевых выключателей проверьте ток драйвера, чувствительность и
homing_retract_dist.
Соответствующая справочная конфигурация: Руководство по возврату в исходное положение и калибровке направления, Использование бесконтактных концевых выключателей.
Endstop still triggered after retract
Сообщение об ошибке: После срабатывания концевого выключателя при возврате в исходное положение и отхода на расстояние возврата концевой выключатель все еще находится в сработанном состоянии.
Распространенные причины:
- Перепутана логика нормально разомкнутого/нормально замкнутого концевого выключателя.
- Концевой выключатель заклинило, он поврежден или неправильная распиновка.
- Слишком маленькое значение
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.
Соответствующая справочная конфигурация: Руководство по возврату в исходное положение и калибровке направления, Концевые выключатели.
Проблемы с щупом и выравниванием
Перед проверкой проводки, разъемов или распиновки щупов 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 raise probe
Сообщение об ошибке: После возврата в исходное положение или измерения Klipper обнаружил, что щуп BLTouch не был успешно втянут.
Распространенные причины:
- Старые версии клонов BLTouch не могут сообщить о состоянии втянутого щупа.
- Механическое заедание щупа, смещение магнитного сердечника или ослабление винтов.
- Неправильная распиновка или конфигурация
control_pin.
Методы решения:
-
Проверьте функцию управления щупом:
BLTOUCH_DEBUG COMMAND=pin_downиBLTOUCH_DEBUG COMMAND=pin_up. -
Если движение выполняется, но ошибка появляется, добавьте в
[bltouch]:pin_up_reports_not_triggered: False -
Если щуп заклинило, рекомендуется заменить модуль щупа или обратиться в сервисную службу, не разбирайте устройство под напряжением.
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в конфигурации выравнивания.- После замены сопла, держателя щупа или хотэнда высота установки щупа значительно изменилась.
- В нескольких 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-code или макросе выполняется
BED_MESH_PROFILE LOAD=xxx, но профиль с таким именем никогда не сохранялся. - Была выполнена команда
BED_MESH_CLEARили удалены данные сетки из автоматически сохраненной области. - После завершения калибровки сетки не была выполнена команда
SAVE_CONFIG. - Несовпадение регистра или пробелов в имени профиля.
Методы решения:
- Выполните
BED_MESH_OUTPUTили просмотрите автоматически сохраненную область в конце конфигурации, чтобы узнать имя профиля. - Если нужного профиля нет, повторно выполните
BED_MESH_CALIBRATE, затемSAVE_CONFIG. - Измените
BED_MESH_PROFILE LOAD=в стартовом G-code, чтобы имя совпадало с фактически сохраненным. - Если вы каждый раз перед печатью сканируете стол заново, можно удалить ненужные команды загрузки профиля.
Соответствующая справочная конфигурация: Введение в макросы.
Ошибки 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 раза от значения по умолчанию.
Соответствующая справочная конфигурация: Руководство по возврату в исходное положение и калибровке направления.