Перейти к основному содержанию

Часто встречающиеся сообщения об ошибках

Эта страница предназначена для быстрой локализации распространенных ошибок Klipper. Сначала найдите полное сообщение об ошибке в klippy.log, а затем ознакомьтесь с соответствующим объяснением.

Проблемы подключения​

mcu 'xxx': Unable to connect​

Сообщение об ошибке: Верхний компьютер не может найти или подключиться к плате.

Loading...

Распространенные причины:

  • ID USB-устройства не указан или указан неверно.
  • CAN UUID не указан, указан неверно или устройство не в сети.
  • UTOC, USB-кабель, CAN-мостовое ПО или питание неисправны.
  • CAN0 не запущен или конфигурация CAN-сети некорректна.

Методы решения:

  1. Откройте klippy.log и прокрутите в самый низ, чтобы подтвердить конкретную информацию об ошибке.

  2. Если появляется [Errno 2], это обычно означает, что найденный ID USB-устройства не добавлен в printer.cfg.

    Loading...

  3. Если появляется Serial connection closed, обычно необходимо заново выполнить поиск CAN ID и проверить CAN-сеть.

    Loading...

  4. Если появляется Unable to open CAN port: [Errno 19] No such device, это обычно означает отсутствие устройства UTOC, USB-мостового CAN ПО или устройства CAN0.

    Loading...

  5. Если появляется [Errno 100] Network is down или [Errno 105] No buffer space available, следуйте инструкциям CAN сеть и поиск ID для повторной проверки конфигурации CAN0.

mcu 'mcu': Invalid CAN uuid​

Сообщение об ошибке: CAN UUID недействителен или не может быть распознан.

Loading...

Причина ошибки: canbus_uuid: указан неверно, устройство не в сети или CAN-сеть не обменивается данными должным образом.

Методы решения:

  1. Следуйте инструкциям CAN сеть и поиск ID для повторного поиска CAN UUID.
  2. Убедитесь, что в printer.cfg указан фактически найденный UUID.
  3. Убедитесь, что в одном [mcu] не включены одновременно serial: и canbus_uuid:.
  4. Проверьте CAN-H, CAN-L, оконечные резисторы, питание и скорость CAN прошивки.

Option 'serial' in section 'mcu' must be specified​

Сообщение об ошибке: В разделе конфигурации [mcu] должен быть указан serial.

Loading...

Причина ошибки: При подключении через USB-прошивку не указан serial:, или раздел конфигурации [mcu] был случайно удален.

Методы решения:

  1. Выполните повторный поиск ID USB-устройства.
  2. В разделе [mcu] файла printer.cfg укажите:
[mcu]
serial: /dev/serial/by-id/фактически найденный ID
  1. Сохраните и перезапустите Klipper.

Если на текущей плате прошита CAN-прошивка, используйте canbus_uuid:, не указывайте serial:.

Lost communication with MCU​

Сообщение об ошибке: Связь между Klipper и MCU прервана. В логе может появиться Lost communication with MCU, Lost communication with mcu или подобное сообщение.

Распространенные сценарии: Во время возврата в ноль или перемещения, при срабатывании концевого выключателя плата или инструментальная плата отключаются; после повторного включения питания соединение восстанавливается.

Распространенные причины:

  • Неправильное подключение концевого выключателя, приводящее к короткому замыканию сигнального вывода с питанием или землей при срабатывании.
  • При использовании трехпроводных, оптических или датчиков Холла перепутан порядок подключения питания, земли и сигнального провода.
  • Повреждение изоляции, пережатие проводов концевых выключателей или короткое замыкание при движении по кабель-каналу.
  • Мгновенное срабатывание концевого выключателя вызывает колебания питания платы, перезагрузку MCU или прерывание связи USB/CAN.
  • Линия связи USB/CAN между MCU и верхним компьютером проходит рядом с сильными источниками помех, что увеличивает вероятность отключения при срабатывании концевого выключателя или движении.
  • Назначенный в конфигурации вывод концевого выключателя не соответствует фактическому подключению, что приводит к срабатыванию не того интерфейса.

Методы проверки:

  1. Отключите питание и проверьте распиновку концевого выключателя, особенно是否正确 подключены VCC, GND и Signal для трехпроводных выключателей.
  2. Временно отключите соответствующий провод концевого выключателя, затем снова подайте питание и проверьте, отключается ли плата.
  3. С помощью мультиметра проверьте наличие короткого замыкания до и после срабатывания концевого выключателя, особое внимание уделите тому, не подключен ли сигнальный вывод к питанию.
  4. Проверьте места изгиба кабель-канала, разъемов и жгутов проводов, убедитесь, что при срабатывании или движении не происходит короткого замыкания из-за пережатия.
  5. Проверьте линию связи USB/CAN между MCU и верхним компьютером, по возможности держите ее подальше от проводов двигателей, нагревателей, стола и силовых кабелей.
  6. Если корпус машины, блок питания или экранирующий слой не имеют надежного заземления, это также может увеличить восприимчивость к помехам. Проверьте заземление в соответствии с требованиями электробезопасности оборудования.
  7. Убедитесь, что назначенный в конфигурации вывод концевого выключателя соответствует документации на плату и фактическому подключению.
  8. После устранения проблемы выполните QUERY_ENDSTOPS, чтобы убедиться, что состояние концевого выключателя нормально изменяется с open на TRIGGERED.

MCU Protocol error​

Сообщение об ошибке: Ошибка протокола MCU. В логе может появиться MCU Protocol error, Unknown command или Command format mismatch.

Loading...

Распространенные причины:

  • Обновлен Klipper на верхнем компьютере, но не перекомпилирована и не прошита прошивка платы или инструментальной платы.
  • Версия прошивки MCU (платы, инструментальной платы, EDDY, ADXL и т.д.) не соответствует версии Klipper на верхнем компьютере.
  • Использование пользовательской системы или сторонних плагинов, что приводит к несоответствию поддерживаемых команд между хостом Klipper и MCU.

Методы решения:

  1. Проверьте, обновлялись ли недавно Klipper, образ системы или плагины.
  2. Перекомпилируйте и прошейте соответствующую прошивку Klipper для данного MCU.
  3. Если это инструментальная плата, EDDY, ADXL и т.д., обновите соответствующую прошивку периферийного устройства синхронно.
  4. При использовании пользовательской системы убедитесь, что она поддерживает текущую версию Klipper.
  5. После завершения прошивки выполните FIRMWARE_RESTART, затем проверьте подключение заново.

Проблемы конфликта конфигурации​

homing override method always homes X and Y before homing Z. The safe_z_home​

Сообщение об ошибке: Конфликт между безопасным возвратом по Z и конфигурацией переопределения возврата в ноль.

Loading...

Причина ошибки: Одновременная настройка [safe_z_home] и [homing_override], что не позволяет Klipper определить, какую логику возврата использовать.

Методы решения:

  1. Найдите в файле конфигурации [safe_z_home] и [homing_override].
  2. Оставьте только один из них в соответствии с фактической логикой возврата станка.
  3. Сохраните и перезапустите Klipper.

Проблемы движения и возврата в ноль​

Move out of range​

Сообщение об ошибке: Целевые координаты выходят за пределы допустимого диапазона движения Klipper. В логе обычно отображается Move out of range: X Y Z [E].

Loading...

Распространенные причины:

  • Размеры станка в слайсере не соответствуют position_min / position_max в конфигурации Klipper.
  • В стартовом G-code, финишном G-code, макросе смены филамента или макросе паузы выполняется перемещение за пределы станка.
  • Парковочные координаты в макросах M600, PAUSE, CANCEL_PRINT слишком близки к границе.
  • После использования коррекции перекоса, смещения щупа или конфигурации сетки стола рассчитанные координаты становятся отрицательными или превышают максимальный ход.
  • Высота модели превышает максимальный ход оси Z.

Методы решения:

  1. Определите по координатам в ошибке, какая ось вышла за пределы.
  2. Проверьте position_min, position_max для соответствующей оси и размеры станка в слайсере.
  3. Проверьте парковочные координаты в макросах старта, финиша, паузы, смены филамента и т.д., избегайте остановки в 0,0 или на максимальной границе.
  4. Если ошибка возникает во время измерения сетки стола, проверьте mesh_min, mesh_max и смещение щупа в [bed_mesh].
  5. Сохраните конфигурацию, перезапустите Klipper и повторите тест.

Must home axis first​

Сообщение об ошибке: Ось еще не возвращена в ноль, нельзя выполнить текущую команду перемещения.

Распространенные причины:

  • После включения питания или FIRMWARE_RESTART не была выполнена команда G28.
  • В макросе сначала выполняется команда перемещения, а затем команда возврата в ноль.
  • После паузы, возобновления или отмены печати состояние станка было сброшено.
  • Некорректная конфигурация макроса возврата, макроса щупа или возврата без концевых выключателей, из-за чего Klipper не регистрирует правильно состояние возвращенной оси.

Методы решения:

  1. Вручную выполните G28, затем перемещайте соответствующую ось.
  2. Проверьте стартовый G-code и макросы, убедитесь, что возврат в ноль выполнен перед командами перемещения.
  3. Если вы недавно обновляли Klipper или прошивку, проверьте, совместимы ли макросы, связанные с возвратом, с текущей версией.
  4. При использовании возврата без концевых выключателей проверьте ток двигателя, чувствительность и homing_retract_dist.

Endstop still triggered after retract​

Сообщение об ошибке: После возврата концевого выключателя по окончании расстояния отката концевой выключатель все еще находится в сработанном состоянии.

Распространенные причины:

  • Неправильно настроена логика нормально разомкнутого/нормально замкнутого концевого выключателя.
  • Концевой выключатель заклинил, поврежден или неправильная распиновка.
  • homing_retract_dist слишком мал, после отката концевой выключатель все еще нажат.
  • Завышена чувствительность возврата без концевых выключателей, после отката все еще определяется как сработавший.
  • Неправильная настройка enable_pin драйвера, направления двигателя или вывода концевого выключателя, что приводит к некорректной работе возврата.

Методы решения:

  1. Выполните QUERY_ENDSTOPS, убедитесь, что без срабатывания состояние open, а после ручного срабатывания - TRIGGERED.
  2. Если состояние противоположное, добавьте или удалите ! перед выводом концевого выключателя.
  3. Проверьте механическое состояние концевого выключателя, распиновку и разъем.
  4. Увеличьте homing_retract_dist и повторите тест.
  5. При использовании возврата без концевых выключателей снизьте чувствительность и убедитесь, что ток возврата подходит.

No trigger on probe after full movement​

Сообщение об ошибке: Щуп не сработал в течение полного хода опускания.

Распространенные причины:

  • Неправильное подключение, питание или конфигурация вывода щупа.
  • Неподходящая высота установки щупа, срабатывание невозможно в пределах хода опускания.
  • Неправильная конфигурация направления оси Z, смещения щупа или области выравнивания.
  • Неисправность самого щупа или плохой контакт в жгуте проводов при движении.
  • Положение стола, сопла или щупа выходит за пределы диапазона обнаружения.

Методы решения:

  1. Выполните QUERY_PROBE, вручную активируйте щуп, убедитесь, что состояние изменяется корректно.
  2. Проверьте питание щупа, сигнальный провод и назначенный вывод.
  3. Проверьте высоту установки щупа, убедитесь, что перед началом опускания щуп находится в диапазоне срабатывания.
  4. Проверьте, не выходят ли точки зондирования в [probe], [bed_mesh], [z_tilt] или [quad_gantry_level] за пределы стола.
  5. Если проблема возникает только в определенных положениях, особое внимание уделите перемещению жгута проводов и смещению щупа.

Проблемы обнаружения температуры​

Error 'XXX mcu' shutdown: ADC out of range​

Сообщение об ошибке: АЦП выходит за пределы допустимого диапазона, обнаружена аномалия температуры.

Loading...

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

Внимание

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

Порядок проверки:

  1. Проверьте, надежно ли вставлен термистор, нет ли обрыва или короткого замыкания проводов.
  2. Проверьте, соответствует ли модель термистора и назначение вывода фактическому оборудованию.
  3. При необходимости временно расширьте температурный диапазон для проверки показаний, например, уменьшите min_temp и увеличьте max_temp.
  4. После выявления и устранения проблемы с подключением или конфигурацией немедленно верните исходные безопасные ограничения температуры.
  5. Сохраните и перезапустите Klipper.

Heater not heating at expected rate​

Сообщение об ошибке: Нагреватель не нагревается с ожидаемой скоростью. В логе может появиться Heater extruder not heating at expected rate или Heater heater_bed not heating at expected rate.

Loading...

Распространенные причины:

  • Неисправность нагревательного стержня, стола или выхода SSR/MOS-транзистора.
  • Плохой контакт термистора, полуобрыв провода или скачки показаний.
  • Вентилятор направлен на хот-энд, стол или зону нагрева, что замедляет нагрев.
  • Недостаточная мощность стола или слишком низкое ограничение max_power.
  • Неподходящие параметры PID, слишком большое колебание температуры при приближении к цели.

Методы решения:

  1. Проверьте надежность соединений нагревателя и термистора.
  2. Наблюдайте за кривой температуры, убедитесь, что нагрев непрерывен и нет аномальных скачков.
  3. Проверьте, не дует ли вентилятор непосредственно на хот-энд или стол.
  4. Проверьте мощность нагревателя, питание, предохранители, SSR/MOS-транзистор и настройку max_power.
  5. После подтверждения исправности оборудования выполните калибровку PID заново.
  6. Если подтверждено, что нагрев идет медленно только из-за большого стола или особой конструкции, обратитесь к оптимизации verify_heater.

Проблемы экструзии​

Extrude below minimum temp​

Сообщение об ошибке: Температура сопла ниже минимально допустимой для экструзии. В логе может появиться Extrude below minimum temp или Extruder not hot enough.

Распространенные причины:

  • Выполнение команды экструзии без предварительного нагрева сопла.
  • В стартовом G-code, макросе смены филамента, макросе паузы/возобновления отсутствует команда ожидания температуры.
  • Целевая температура еще не достигнута, а макрос уже выполнил экструзию или ретракт.
  • Аномальные показания датчика температуры, из-за которых Klipper считает, что сопло не достигло температуры, пригодной для экструзии.

Методы решения:

  1. Перед экструзией убедитесь, что сопло достигло температуры, необходимой для данного филамента.
  2. Проверьте, есть ли в стартовом G-code, макросах M600, PAUSE, RESUME и т.д. логика ожидания температуры.
  3. Используйте M109 или эквивалентную команду ожидания Klipper в местах, где необходимо дождаться температуры.
  4. Проверьте термистор и кривую температуры, убедитесь в стабильности показаний.
  5. Не рекомендуется постоянно снижать min_extrude_temp для обхода ошибки.

Проблемы производительности и тайм-аута​

Проблемы тайм-аута при возврате в ноль​

При возврате в ноль возникают тайм-ауты связи, отключение MCU или аномалии при возврате нескольких MCU. Обратитесь к Проблемы тайм-аута при возврате в ноль.

MCU 'mcu' shutdown: Stepper too far in past​

Сообщение об ошибке: Событие шагового двигателя вышло за пределы временного диапазона, который может обработать MCU. Принтер перейдет в состояние shutdown.

Loading...

Типичный сценарий: Эта ошибка не обязательно вызвана конфигурацией сетки стола; фактическую причину необходимо определять в сочетании с klippy.log и текущей операцией. При выполнении многоточечного измерения стола, если probe_count в [bed_mesh] установлен слишком большим, например 20,20, и одновременно настроен высокий mesh_pps, например mesh_pps: 4,4, это может привести к генерации слишком плотных данных сетки, увеличивая нагрузку на вычисления и планирование движения на верхнем компьютере, что может спровоцировать подобную ошибку.

Методы решения:

  1. Если ошибка возникает во время многоточечного измерения стола, попробуйте сначала уменьшить probe_count в [bed_mesh], например, до 7,7 или 9,9.
  2. Если настроен высокий mesh_pps, уменьшите или удалите эту настройку, например, измените на mesh_pps: 2,2; если интерполяция не нужна, установите 0,0 в соответствии с фактическими потребностями.
  3. Сохраните конфигурацию, перезапустите Klipper и повторите операцию, которая вызывала ошибку.
  4. Если ошибка повторяется, продолжайте проверять нагрузку на верхний компьютер, скорость печати, ускорение, качество связи и текущие выполняемые макросы или G-code.

MCU 'mcu' shutdown: Timer too close​

Сообщение об ошибке: Таймер MCU слишком близок, что приводит к тайм-ауту системы.

Loading...

Причина ошибки: Слишком высокая нагрузка на обработку нижнего компьютера, тайм-аут ответа верхнего компьютера, слишком высокая скорость печати, слишком высокое микрошаговое разрешение, помехи синхронизации системного времени или помехи в линии связи MCU могут вызвать эту проблему.

Методы решения:

  1. Уменьшите микрошаговое разрешение шагового двигателя, чтобы снизить нагрузку на MCU по обработке импульсов.
  2. Уменьшите скорость печати и ускорение, понаблюдайте, исчезнет ли проблема.
  3. Проверьте нагрузку на верхний компьютер, качество питания и связи USB/CAN.
  4. Проверьте, не проходит ли линия связи между MCU и верхним компьютером рядом с проводами двигателей, нагревателей, стола или силовыми кабелями. При необходимости переложите кабель или замените на экранированный.
  5. Проверьте заземление станка; незаземленные станки более подвержены помехам связи.
  6. Если проблема возникает на этапе возврата в ноль, обратитесь к Проблемы тайм-аута при возврате в ноль.
  7. Если проблема сохраняется, рассмотрите возможность перепрошивки системы верхнего компьютера или прошивки.

Пользователи Raspberry Pi могут проверить статус синхронизации времени NTP:

sudo timedatectl status | grep "NTP service"

Для временного отключения синхронизации NTP выполните:

sudo timedatectl set-ntp false

После подтверждения, что проблема не связана с NTP, вы можете снова включить его по мере необходимости:

sudo timedatectl set-ntp true
Loading...