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

Обзор распространенных ошибок

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

Быстрый указатель​

Тип ошибкиКлючевые словаМесто поиска
Проблемы с подключениемUnable to connect, Invalid CAN uuid, Lost communication, MCU Protocol error, /dev/serial/by-idПроблемы с подключением на этой странице, Конфигурация MCU ID, Сеть CAN и поиск ID
Проблемы с конфигурациейnot valid, not a valid config section, must be specified, Unable to parse, SAVE_CONFIG, Option conflictОшибки конфигурации
Команды макросов и слайсераUnknown command, Error evaluating 'gcode_macro, jinja2.exceptions.UndefinedError, dict object has no attributeОшибки конфигурации
Перемещение и парковкаMove out of range, Must home axis first, No trigger, Endstop still triggeredОшибки перемещения, концевых выключателей и выравнивания
Парсинг G-codeUnable to parse move, Invalid speed, Machine does not support G20, G2/G3Ошибки перемещения, концевых выключателей и выравнивания, Рекомендации по аппроксимации дуг
Выравнивание зондомProbe triggered, No trigger on probe, samples_tolerance, bed_mesh, BLTouch failed, Z_TILT, QUAD_GANTRY_LEVELОшибки перемещения, концевых выключателей и выравнивания
Нагрев температурыADC out of range, not heating at expected rate, Verify heater, temperatureОшибки температуры, нагрева и экструзии
Проблемы с экструзиейExtrude below minimum temp, Extrude only move too long, Move exceeds maximum extrusion, Filament sensor, M600Ошибки температуры, нагрева и экструзии
Тайм-аут производительностиTimer too close, Missed scheduling, Stepper too far in past, Rescheduled timer, restarting too fast, SD busyОшибки системы, производительности и служб
Драйвер TMCUnable to read tmc uart, Unable to write tmc spi, GSTAT, coil short circuitУстранение ошибок TMC
Сеть CANbytes_invalid, Network is down, No buffer space available, Invalid CAN uuidСеть CAN и поиск ID
Периферия датчиковInvalid adxl345 id, No data, Insufficient axis, Eddy current sensor error, Invalid read dataТестирование и калибровка акселерометра, Сборник проблем EDDY

Быстрый поиск по страницам конфигурации​

Направление ошибкиРекомендуемая справка
Синтаксис конфигурации, отступы, комментарии, повторяющиеся пиныПримечания к изменению конфигурации
Направление парковки, осей, принудительное перемещениеРуководство по парковке и калибровке направления
Концевые выключатели, TAP, оптические выключатели, датчики приближенияКонцевые выключатели
Парковка без концевых выключателей, чувствительность виртуальных концевых выключателейИспользование без концевых выключателей
Нагрев, PID, медленный нагрев, защита температурыНагрев, Оптимизация verify_heater, Оптимизация M109
Конфигурация вентиляторов, приводных вентиляторов, вентиляторов 7040Эталонная конфигурация вентилятора
Параметры экструдера, расстояние вращения, конфигурация экструзииЭталонная конфигурация экструдера, Калибровка станка
Макросы запуска/завершения, пауза и возобновление, макросы выравнивания и сеткиВведение в макросы
Часто используемые команды отладки, зонды, компенсация резонансаЧасто используемые директивы отладки

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

Пояснение к конфигурации MCU ID​

В Klipper MCU ID относится к идентификационной информации, используемой для подключения к плате управления в разделе конфигурации [mcu] или [mcu xxx]. В зависимости от способа связи синтаксис различается:

Способ подключенияПараметр конфигурацииПример
USB-прошивкаserial:serial: /dev/serial/by-id/usb-Klipper_xxxxxxxxxxxx
CAN-прошивкаcanbus_uuid:canbus_uuid: xxxxxxxxxxxx
MCU верхнего уровняserial:serial: /tmp/klipper_host_mcu

Правила заполнения:

  1. Основная плата по умолчанию использует [mcu], а для инструментальных или расширительных плат используются пользовательские имена, такие как [mcu tool] или [mcu toolboard].
  2. Для USB-прошивки указывается только serial:, для CAN-прошивки — только canbus_uuid:, не оставляйте оба параметра в одном [mcu].
  3. В машинах с несколькими MCU каждый [mcu xxx] должен использовать свой собственный реальный ID, не копируйте один и тот же USB-ID или CAN UUID.
  4. Имя [mcu xxx] влияет на префикс пинов: например, для [mcu tool] пины должны записываться как tool:gpio13; регистр имени должен быть согласованным.
  5. xxxxxxxx в примерах документации нельзя использовать напрямую, его необходимо заменить на фактический найденный ID.

Распространенные ошибки:

  • Использование ID режима прошивки (например, ID, содержащий katapult или canboot) в качестве ID прошивки Klipper.
  • Настройка canbus_uuid: в USB-прошивке или сохранение старого serial: в CAN-прошивке.
  • Настройка инструментальной платы как [mcu], перекрывая конфигурацию MCU основной платы.
  • Несоответствие префикса пинов и имени MCU: например, конфигурация [mcu toolboard], а пины записаны как tool:gpio13.

Запрос USB ID: Для USB-прошивки выполните ls /dev/serial/by-id/*, чтобы получить ID.

Запрос CAN ID: CAN-сеть и поиск ID

Конфигурация инструментальной платы: Добавление MCU инструментальной платы и межплатная конфигурация

mcu 'xxx': Unable to connect​

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

Loading...

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

  • Идентификатор 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:.

USB ID не найден / Вмешательство системных служб​

Сообщение об ошибке: Выполнение ls /dev/serial/by-id/* не дает вывода или выдает No such file or directory; Klipper сообщает mcu 'xxx': Unable to open serial port, [Errno 2] No such file or directory, или USB-плата постоянно отключается и подключается в системе.

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

  • Плата не перешла в режим работы прошивки Klipper и все еще находится в режиме прошивки Katapult / CanBoot / DFU и т.д.
  • USB-кабель, USB-порт, питание хост-компьютера или питание платы неисправны.
  • Некоторые версии udev в Debian 11 Bullseye имеют проблемы и могут не генерировать путь устройства /dev/serial/by-id/.
  • В настольных версиях Linux могут быть установлены ModemManager или BRLtty, которые могут захватывать последовательные порты, мешая Klipper стабильно подключаться к плате.

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

Работа с отключением питания

Перед повторным подключением USB-кабеля, проверкой проводов питания платы или упорядочиванием USB/CAN жгутов полностью выключите принтер и отключите источник питания. Не упорядочивайте клеммы и не касайтесь их под напряжением.

  1. Сначала убедитесь, что на плате прошита и запущена прошивка Klipper, USB ID должен содержать usb-Klipper. Не вписывайте в printer.cfg ID режимов katapult, canboot, Bootloader или DFU.
  2. Отключите питание, замените USB-кабель и USB-порт хост-компьютера на надежные, затем снова включите питание и выполните ls /dev/serial/by-id/*.
  3. Если используется Debian 11 Bullseye, старая версия MainsailOS / FluiddPi / Armbian и т.п., выполните команду для просмотра версии udev:
apt-cache policy udev
  1. Если подтверждена проблема с udev в Debian 11, приоритетно обновите udev через штатные источники обновлений системы или замените образ системы на более новый.
  2. Проверьте наличие служб, которые могут захватывать последовательные порты:
systemctl list-units --all | grep -Ei 'ModemManager|brltty'
  1. Если эти службы установлены и хост-компьютер не требует функций модема или брайлевского терминала, замените полное имя модуля из предыдущей команды в команду, остановите и отключите их, затем перезагрузите систему:
sudo systemctl disable --now ModemManager.service
sudo systemctl disable --now brltty.service
sudo systemctl disable --now brltty.path
  1. После завершения снова запросите USB ID и убедитесь, что serial: в разделе [mcu] файла printer.cfg соответствует фактическому выводу.

Соответствующая конфигурация: Конфигурация MCU ID.

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. Для периферийных MCU, таких как инструментальная плата, EDDY, ADXL, синхронно обновите соответствующую прошивку периферии.
  4. Если используется кастомная система, убедитесь, что она поддерживает текущую версию Klipper.
  5. После прошивки выполните FIRMWARE_RESTART и снова проверьте подключение.

Часто задаваемые вопросы по направлениям​

НаправлениеВход
Конфликты конфигурации, парсинг параметров, SAVE_CONFIGОшибки конфигурации
Неизвестные команды, шаблоны макросов, начальный G-code слайсераОшибки конфигурации
Перемещение, парковка, концевые выключатели, зонды, выравнивание сеткиОшибки перемещения, концевых выключателей и выравнивания
Температура, нагрев, экструзия, детектор окончания нитиОшибки температуры, нагрева и экструзии
Производительность, тайм-ауты, прошивка, системные службыОшибки системы, производительности и служб
G2/G3, аппроксимация дуг, точность пути слайсераРекомендации по аппроксимации дуг
Связь драйвера TMC, перегрев, проблемы с катушкамиУстранение ошибок TMC
Сеть CAN, UUID, bytes_invalidСеть CAN и поиск ID
Тестирование акселерометра и резонансаТестирование и калибровка акселерометра
Вихретоковый зонд EDDYСборник проблем EDDY
Loading...