Коды ошибок
Ошибки Klipper: понятная таблица первых действий
У Klipper важен не только заголовок, но и продолжение после двоеточия. Скопируйте строку полностью и сохраните klippy.log до обновления или прошивки.
У Klipper важен не только заголовок, но и продолжение после двоеточия. Скопируйте строку полностью и сохраните klippy.log до обновления или прошивки.
Код ошибки — это не диагноз детали. Важно сохранить полный текст, модель принтера и действие, на котором произошла остановка.
Сообщения Klipper: таблица первых действий
У Klipper важен не только заголовок, но и продолжение после двоеточия. Скопируйте строку полностью и сохраните klippy.log до обновления или прошивки.
| Код или сообщение | Что означает | Что проверить сначала | Когда остановиться |
|---|---|---|---|
Lost communication with MCU | Пропала связь с одной из плат. | Проверить имя MCU в строке, питание, кабель и лог. | При повторе под нагрузкой или повреждённом кабеле. |
Unable to connect to MCU | Klipper не нашёл устройство при запуске. | Проверить путь serial/CAN и наличие устройства в системе. | Не менять прошивку до сохранения конфигурации. |
MCU shutdown: Timer too close | Планировщик не успевает передать команды вовремя. | Проверить нагрузку хоста, связь и строки перед shutdown. | Если повторяется — нужен анализ лога. |
ADC out of range | Датчик температуры дал значение вне допустимого диапазона. | По имени heater_bed/extruder определить датчик и проверить провод. | При 0 °C, −50 °C или экстремально высокой температуре. |
Heater … not heating at expected rate | Нагрев идёт медленнее защитного порога. | Проверить нагреватель, датчик, питание и обдув. | Не ослаблять verify_heater до ремонта. |
Extruder below minimum temp | Экструзия запрошена при слишком холодном хотенде. | Проверить целевую и фактическую температуру, затем датчик. | Не обходить минимальную температуру ради теста. |
TMC reports error: ot=1 | Драйвер мотора перегрелся. | Охладить, проверить вентилятор, ток и механику оси. | При повторе после охлаждения. |
TMC reports error: ShortToGND / ShortToSupply | Возможное короткое замыкание мотора или кабеля. | Обесточить и осмотреть проводку. | Не запускать мотор повторно с повреждённым кабелем. |
Unable to read tmc uart … IFCNT | Нет ответа от TMC по UART. | Проверить питание моторов, UART и конфигурацию драйвера. | Если связь остаётся нестабильной. |
Unable to write tmc spi … | Нет записи в драйвер по SPI. | Проверить питание и линии SPI. | Не переставлять разъёмы под напряжением. |
No trigger on probe after full movement | Датчик не сработал за допустимый ход. | Остановить движение, проверить датчик и высоту. | Если сопло приближается к столу без остановки. |
Endstop … still triggered after retract | Концевик не отпустился после отхода. | Проверить механический ход и статус endstop. | При заклинившем или сломанном датчике. |
Move out of range | Команда просит координату за пределами кинематики. | Проверить координату, origin и размеры стола в конфигурации. | Не увеличивать границы без измерения. |
Must home axis first | Положение оси неизвестно после запуска или shutdown. | Выполнить безопасную парковку после устранения причины. | Не двигать ось вслепую рядом со столом. |
Shutdown due to webhooks request | Внешний интерфейс запросил штатную остановку Klipper. | Сохранить предыдущие строки лога, затем использовать FIRMWARE_RESTART после устранения причины. | Если shutdown повторяется сразу после запуска. |
Как выглядит узел или сообщение
Сопоставьте кадр с вашей моделью. Подпись объясняет, что именно важно увидеть; цвет корпуса и расположение разъёмов могут отличаться.


Официальные источники таблицы и кадров
Материал переведён и объяснён редакцией 3D Gemma. Перед разборкой сверяйте модель и ревизию принтера.
Перед началом
- Сфотографируйте экран полностью.
- Запишите модель, прошивку и последнее действие.
- При запахе, дыме или неконтролируемом нагреве отключите питание.
Когда работа закончена
Причина локализована до конкретной группы: питание, связь, нагрев, движение или подача. Если безопасная проверка не помогла, сохранены данные для специалиста.
Методика и официальные источники
Инструкция написана 3D Gemma простыми словами. Ссылки ниже нужны для проверки модели, ревизии и требований производителя.
Если коротко: что проверить на этой странице
- Короткий ответ
- Что делать при MCU shutdown, heater not heating, verify heater, lost communication и ошибках конфигурации Klipper.
- Кому полезно
- Новичкам и владельцам FDM-принтеров, которые хотят понять симптом, проверить простые причины и не менять исправные детали наугад.
- Раздел
- Коды ошибок
- Когда спросить менеджера
- Если неизвестна ревизия принтера, тип хотенда, маркировка старой детали или совместимость расходника.
Как понять эту тему, даже если вы новичок
Не пытайтесь сразу чинить всё. Сначала найдите симптом, затем проверьте одну простую причину и только после этого меняйте деталь или настройку.
Опишите проблему обычными словами: не липнет, щёлкает, нитки, кривая линия, угол поднялся.
Обычно причина простая: грязная пластина, высота сопла, влажный пластик, засор или сопротивление подачи.
Делайте безопасную проверку без разборки. Одно действие — один короткий тест.
Мини-словарь без сложных слов
- Homing / парковка
- поиск принтером известной начальной точки оси X, Y или Z.
- Концевик
- датчик, который сообщает, что ось дошла до края или нулевой точки.
- Probe / датчик уровня
- система, которая измеряет положение стола; это может быть отдельный датчик, сопло, loadcell или тензодатчик.
- MCU
- микроконтроллер на плате, который управляет движением, нагревом или отдельным узлом.
- Прошивка
- программа внутри принтера. Пакет должен точно соответствовать модели и аппаратной ревизии.
- Лог
- журнал событий принтера с точным временем и подробностями ошибки.
- Ревизия
- аппаратный вариант одной модели; внешне похожие принтеры могут иметь разные платы и кабели.
- Самотест
- штатная короткая проверка узлов, которую запускают после устранения причины.
Нашли ошибку или знаете способ лучше?
Напишите, что стоит исправить или уточнить. Одобренные комментарии помогут другим владельцам 3D-принтеров.
Можно первым подсказать уточнение, безопасный приём или рассказать, на какой модели принтера проверили инструкцию.