Klipper для новичков: что это, зачем нужен и как перепрошить принтер

Klipper — не слайсер и не программа для компьютера. Это прошивка: она заменяет Marlin, который стоит на плате принтера с завода.

Название пугает. Кажется, что придётся паять, компилировать и разбираться в электронике. На деле установка занимает вечер, а управление идёт через браузер.

Если коротко:

• Klipper считает движения на Raspberry Pi, а не на слабой плате принтера.
• Отсюда два плюса: выше ускорения и точнее компенсации — Input Shaping и Pressure Advance.
• Настройка живёт в текстовом printer.cfg: правка без перепрошивки платы.
• Понадобятся плата принтера, Raspberry Pi, SD-карта и полчаса на первый запуск.

Что такое Klipper и чем он отличается от Marlin

В Marlin всё живёт на плате принтера. Микроконтроллер читает G-код, планирует движения, считает шаги и включает нагреватели. Плата дешёвая и слабая: её память и тактовая частота ограничивают, сколько команд она успевает обработать.

Klipper делит работу на две части. Вся математика — разбор G-кода, планирование, кинематика — идёт на внешнем компьютере, его называют хостом. Обычно это Raspberry Pi. Плата получает готовые команды и выдаёт импульсы шаговых двигателей по таймеру.

Практический итог простой: плата перестаёт быть узким местом. Хост просчитывает траекторию далеко вперёд, поэтому скорость и ускорения ограничены механикой, а не электроникой.

Второе следствие — настройка. В Marlin смена пина или температуры означает правку кода, компиляцию и перепрошивку. В Klipper всё лежит в printer.cfg: поменяли строку, перезапустили сервис, поехали.

Зачем это нужно

Перепрошивка не делает принтер волшебным. Но четыре вещи Klipper закрывает заметно лучше.

Скорость и ускорения

Планировщик на хосте видит больше команд вперёд, чем успевает обработать плата с Marlin. Поэтому можно поднять ускорения и скорость, не упираясь в производительность микроконтроллера. Предел остаётся один — механика принтера.

Input Shaping

Резонансы — та самая рябь на стенках детали, которую ещё называют ringing. Klipper измеряет резонансы конкретного принтера: акселерометром вроде ADXL345 или тестом с печатью. Дальше он гасит колебания компенсаторами. Ускорения растут, а рябь уменьшается.

Pressure Advance

Это компенсация давления в сопле. На поворотах и в конце линий не остаётся клякс и недолива, швы выглядят ровнее. На Bowden-экструдере разница особенно заметна.

Удобство

Веб-интерфейс Mainsail или Fluidd, история печати, макросы, обновление одной командой. Конфиг — обычный текст: его можно держать в git и переносить на второй принтер.

Честная оговорка: кривую механику Klipper не исправит. Люфт по осям, разболтанные эксцентрики и гнутый стол останутся проблемами. Сначала механика, потом прошивка.

Что понадобится

Минимальный набор выглядит так.

• Плата, которую поддерживает Klipper. Список есть в документации Klipper, в разделе про платы. Закрытые платформы вроде Bambu Lab не поддерживаются: там своя прошивка, и Klipper на штатную плату не ставится.
• Хост. Raspberry Pi 3B+, 4 или Zero 2 W, либо мини-ПК на Linux. Zero 2 W хватает на один принтер без камеры, для камеры и нескольких принтеров берите Pi 4.
• SD-карта для хоста. 8–32 ГБ, class 10. Дешёвая карта — частая причина зависаний и ошибки «Timer too close».
• Питание и кабель. Блок питания для Pi и USB-кабель к плате принтера. Плохой кабель даёт обрывы связи посреди печати.
• Сеть. Ethernet надёжнее Wi-Fi: по Wi-Fi веб-интерфейс иногда отваливается, а печать продолжается.
• Конфигурационный файл. printer.cfg не пишут с нуля: в репозитории Klipper есть готовые примеры под популярные платы, их берут за основу.
• Акселерометр ADXL345. Не обязателен, но с ним Input Shaping настраивается за десять минут вместо часа ручных тестов.

По деньгам: Raspberry Pi 4 в России стоит примерно 4–7 тысяч рублей, Zero 2 W — 2–3 тысячи. Если Pi уже есть, перепрошивка не стоит ничего.

Как перепрошить: шесть шагов

Полная инструкция у каждого принтера своя, но порядок общий. Ниже карта процесса, а не замена документации производителя.

Шаг 1. Подготовить хост

На Raspberry Pi ставим систему для 3D-принтера. Два пути: готовый образ MainsailOS или установка через скрипт KIAUH на чистый Raspberry Pi OS Lite. В обоих случаях на хосте появятся Klipper, Moonraker и веб-интерфейс — Mainsail или Fluidd.

Шаг 2. Собрать прошивку для платы

В папке Klipper запускаем make menuconfig. Выбираем микроконтроллер своей платы, способ связи (USB или CAN) и смещение загрузчика. На выходе получаем klipper.bin — это прошивка для платы, а не для Raspberry Pi.

Шаг 3. Прошить плату

Способ зависит от платы. Чаще всего файл переименовывают по требованию производителя (обычно firmware.bin), кладут в корень microSD и включают принтер: загрузчик прошивает плату сам. Другие платы прошиваются по USB через DFU. Точное имя файла и режим есть в документации платы — ошибка здесь самая частая причина «принтер не видит прошивку».

Шаг 4. Прописать printer.cfg

Минимум, без которого принтер не поедет:

• [mcu] — порт платы, обычно /dev/serial/by-id/...;
• кинематика: cartesian, corexy или delta;
• шаговые двигатели: пины, ток, микрошаги;
• концевые датчики и position_max по осям;
• нагреватели и термисторы;
• ограничения max_velocity и max_accel — для начала скромные.

Конфиг проверяется командой RESTART в веб-интерфейсе. Klipper покажет ошибку с номером строки, а не просто «не работает».

Шаг 5. Откалибровать

По порядку: PID сопла и стола, срабатывание концевиков, Z-offset, карта стола (bed_mesh), затем Pressure Advance и Input Shaping. Каждый шаг занимает 10–20 минут. Пропускать их нельзя: без калибровок принтер печатает хуже, чем на Marlin.

Шаг 6. Перенести макросы и слайсер

Стартовый и финальный G-код в слайсере теперь вызывает макросы Klipper — PRINT_START и PRINT_END. Температуры и профили материалов остаются прежними.

Ориентир по времени: у новичка перепрошивка занимает 2–4 часа, калибровки — ещё вечер. Второй такой принтер прошивается примерно за час.

Сравнение Klipper и Marlin

Параметр	Marlin	Klipper
Где считаются движения	На плате принтера	На Raspberry Pi, плате остаются шаги
Скорость	Ограничена платой и её планировщиком	Выше: траектория считается на хосте
Резонансы	Input Shaping только в свежих сборках и редко включён	Input Shaping — штатная калибровка
Компенсация давления	Linear Advance	Pressure Advance, заметно проще на Bowden
Настройка	Правка кода, компиляция, перепрошивка	Текстовый printer.cfg и перезапуск
Обновление	Прошивка платы целиком	git pull на хосте, плату не трогают
Что нужно	Только принтер	Плюс хост, карта памяти, сеть
Интерфейс	Экран принтера, OctoPrint	Mainsail или Fluidd в браузере
Сложность входа	Ниже: прошил и печатай	Выше: конфиг и калибровки
Цена	Ноль	2–7 тысяч рублей за хост

Качество не появляется само: Klipper даёт инструменты, а результат зависит от калибровок. Если пропустить Input Shaping и Pressure Advance, принтер будет печатать примерно как на Marlin, только с более удобной настройкой.

Ошибки и что они значат

Первые дни Klipper пугает сообщениями, которых Marlin не выдавал.

• «Timer too close» — хост не успевает отдавать команды. Обычно виноваты дешёвая SD-карта, Wi-Fi, USB-хаб или слабый блок питания.
• «MCU shutdown» — плата потеряла связь с хостом. Проверяйте кабель и питание, а не конфиг.
• «Move out of range» — команда ушла за position_min или position_max. Часто это макрос, который паркует голову до калибровки.
• «Option … is not valid» — опечатка или устаревший параметр в printer.cfg. Номер строки Klipper пишет прямо в сообщении.

Порядок разбора один: открыть klippy.log и посмотреть последние двадцать строк. Там будет причина, а не только следствие.

Отдельная история — ошибки самой платформы принтера, а не Klipper. Например, Bambu Lab A1 с ошибкой 0500-4003 в эту песочницу не пустит: прошивка закрытая, и Klipper на штатную плату не ставится. Что означает этот код и как вернуть принтер к печати — в статье «Ошибка 0500-4003 на Bambu Lab A1».

Материалы после перепрошивки

Klipper не меняет температуры: PLA остаётся PLA, PETG остаётся PETG. Меняется другое — при высоких ускорениях у обдува меньше времени на каждый слой. На PETG это заметно: если после перехода деталь начала расслаиваться, добавьте 5 °C к соплу и опустите обдув до 30–40%.

Подробное сравнение материалов, температуры и настройки PETG — в статье «PLA или PETG: что выбрать и как настроить принтер».

Коротко

1. Klipper — прошивка, которая считает движения на Raspberry Pi, а не на плате принтера.
2. Главные плюсы: выше ускорения, Input Shaping и Pressure Advance.
3. Понадобятся хост, SD-карта и printer.cfg; закрытые платы вроде Bambu Lab не подходят.
4. Порядок: хост → прошивка платы → Mainsail или Fluidd → конфиг → калибровки.
5. Klipper не заменяет механику: люфты и кривой стол останутся проблемами.

Если вы хотите не просто перепрошить принтер, а научиться инженерному подходу к печати — расчетам на прочность, реверс-инжинирингу и созданию функциональных деталей, забирайте наш курс «Инженер». В нём 10 уроков с реальными расчетами и проектами. Ссылка: /courses/engineer.