← Оглавление

Прошивка

Внимание: Если вы не работали с Linux и Klipper — оставайтесь на стоке. Он стабилен и функционален. Любая модификация ставится на свой страх и риск (потеря гарантии, риск «кирпича»); после установки или удаления мода делайте полную рекалибровку.

Что выбрать

Стоковая прошивка AD5M/5M Pro — это сам Klipper, но без веб-интерфейса (Fluidd/Mainsail в стоке нет) и с закрытым конфигом. Памяти ~128 МБ, поэтому Klipper урезан. Расширяют возможности тремя модами:

Прошивка	Что это	Веб	Версия
Сток (FlashOS)	Штатный Klipper. Wi-Fi, FlashCloud/FlashMaker, печать .gco. Управление только с экрана	нет	—
ZMod	Надстройка поверх стока: открывает printer.cfg, SSH, Fluidd. KAMP-меш, dual-boot со стоком, OTA-обновления, фиксы ошибок, плагины. Сохраняет функции стока и добавляет Klipper 13. 5M / 5M Pro / AD5X	Fluidd / Mainsail / Guppy / Helix + удалённый доступ	1.7.1
Forge-X	Сборка на основе ZMod (автор DrA1ex)	Fluidd / Mainsail / Guppy	1.4.1
KlipperMod	Отдельная система (свой Klipper, по сути «виртуалка»)	Mainsail/Fluidd	v00.06-beta

Рекомендация: для веб-интерфейса и доступа к конфигу — ZMod (или его сборка Forge-X). KlipperMod — самый «тяжёлый» вариант (отдельная система).

Примечание: Если нужно только исправить E0011/E0017, отключить автообновление, перешить 5M↔Pro или получить root — ставить полный мод не обязательно: эти правки есть отдельными патчами для стоковой прошивки (в репозитории ZMod). Полноценный ZMod/Forge-X ставят ради веб-морды, плагинов и облака.

Экосистема ZMod: документация wiki.zmod.link + бот @zmod_help_bot; облачный удалённый доступ zmod.link (альтернатива VPN); экран HelixScreen/GuppyScreen; плагины (bambufy — меньше отходов при смене цвета, g28_tenz — стабильный Z-offset, nopoop, timelapse). Поддержка — через тикеты GitHub с файлом config.tar (команда TAR_CONFIG).

Моды совместимы не со всеми версиями стока — проверяйте список совместимости в документации своего мода перед прошивкой. Версия 2.4.5 много лет считалась самой стабильной и совместима со всем; KlipperMod официально заявляет поддержку 2.4.5, 2.5.5 и 2.5.6.

Устанавливаются моды одинаково: файл .tgz/образ кладётся в корень флешки FAT32 (размер кластера 4096), флешка в выключенный принтер, включаем, ждём. Не отключайте питание во время установки.

Важно: После любого мода не пользуйтесь штатным обновлением прошивки из меню — обновляйтесь только вручную, иначе слетит разблокировка/мод. На стоке с интернетом принтер при загрузке постоянно предлагает обновиться — отказывайтесь.

---

Root-доступ (SSH)

Root (права суперпользователя) нужен, чтобы вручную править конфиги, ставить доработки и чинить принтер по SSH. SSH-сервис на принтере уже есть — патч лишь сбрасывает пароль суперпользователя.

Если стоит мод (ZMod, Forge-X или KlipperMod) — root уже встроен, отдельный патч не нужен; см. документацию своего мода (ZMod wiki, Forge-X, KlipperMod).

На чистом стоке root добавляют патчем с флешки (распаковать в корень FAT32, вставить в выключенный принтер, включить, дождаться, перезагрузить). Логин root, пароль зависит от версии патча (123456 либо root): - AD5X — AD5X-root.tgz (подробно — в AD5X → Root). - 5M / 5M Pro — root, разблокировка 5M→Pro и проверка MD5 портированы на сток отдельными патчами в репозитории ZMod (раздел «не нужно ставить мод, если…»).

Актуальный вариант рутовалки — на dropbear (лёгкий SSH-сервер, меньше ест ресурсов). Он аккуратнее лезет в систему: не подменяет файлы passwd/group/shadow, а меняет пароль штатным passwd. Логин root, пароль после установки — root, сменить свой можно командой passwd. Если ранее стоял старый патч с обычным sshd, его автозапуск при установке удаляется.

• Скачать: just_root_dropbear.zip

Совет: SSH — это удалённый доступ к «внутренностям» принтера (его Linux) с компьютера. Для доступа к файлам/конфигу проще всего зайти программой WinSCP (протокол SCP, хост — IP принтера, логин root). Сменить пароль — команда passwd в SSH-консоли.

---

Изменение конфига

Основные файлы: printer.cfg (пользовательский) и printer.base.cfg (базовый, секции железа).

Способ 1 — через флешку и инженерное меню (сток, без root, самый простой): 1. Вставьте в принтер флешку (FAT32). 2. На экране откройте «i» (Информация о машине / Machine Info). 3. Удерживайте палец на заголовке «Информация о машине» 10+ секунд — откроется скрытое инженерное меню. Ничего лишнего там не нажимайте. 4. Вкладка «Test» → кнопка «get» — оба .cfg скачаются на флешку (сразу сделайте резервные копии). 5. Отредактируйте файлы на ПК (Notepad++ или Блокнот), положите обратно на флешку. 6. Залейте обратно через тот же раздел инженерного меню (кнопка загрузки) и перезагрузите принтер.

Способ 2 — через SSH/веб (ZMod, KlipperMod): редактируете printer.cfg прямо в Fluidd/Mainsail или по SSH/WinSCP — удобнее всего. После правки — сохранить и перезагрузить.

Совет: Проверить, что файл прошивки/патча залился без ошибок (нужен root или мод): sha256sum <файл> и сравнить с эталонной суммой.

---

Разблокировка температуры хотенда (291 → 320 °C)

Штатно хотенд ограничен 291 °C (на экране — не выше 280 °C, из слайсера до 291 °C). Лимит зашит в MCU головы и снимается её перепрошивкой (патч ставится с флешки, работает и на стоке, и на KlipperMod).

Порядок: 1. Сделайте бэкап конфигов. 2. Распакуйте патч в корень флешки FAT32, вставьте, включите, дождитесь окончания, выньте флешку, перезагрузите. 3. В printer.cfg поднимите лимит проверки нагрева:

[verify_heater extruder]
max_error: 350

4. На KlipperMod после запроса вынуть флешку — удалите с неё всё, кроме файла klipper_mod_skip, верните флешку, перезагрузите (нужно для корректного обновления MCU головы).

После разблокировки заново откалибруйте PA, поток и шейперы — прошивка MCU изменилась.

Осторожно: Родные хотенды выше 280 °C массово не грели — рискуете нагревателем/термистором. Безопаснее Bambu-mod (замена пары нагреватель-термистор стоит ~150 ₽) или сразу установка PT1000.

---

Полезные правки конфига

Обдув платы при удержании моторов

Штатно вентилятор платы (pcb_fan) крутится только во время печати. При снятии шейперов или простое с включёнными моторами драйверы и eMMC греются. Сделайте вентилятор зависимым от моторов и нагревателей — в printer.base.cfg замените секцию:

[controller_fan pcb_fan]
pin: PB7
fan_speed: 1.0 # 0.3 мин … 1.0 макс
idle_timeout: 30 # сек работы после отключения нагрузки
stepper: stepper_x, stepper_y, stepper_z
heater: extruder, heater_bed

Коррекция температуры стола

Реальная температура стола может отличаться от заданной. Калибруют по термопаре, плотно прижатой к подложке у центра (пирометры врут). Снимите реальную температуру при 60 °C и 110 °C, затем в printer.base.cfg перед секцией heater_bed добавьте свой термистор (через ; указаны значения с экрана, слева — измеренные):

[thermistor my_thermistor]
temperature1: 20 ;20
resistance1: 126779
temperature2: 57 ;60
resistance2: 25606
temperature3: 105 ;110
resistance3: 5277

И в секции heater_bed замените sensor_type: Generic 3950 на sensor_type: my_thermistor. Сохраните, перезагрузите.

---

Датчик филамента

Принтер штатно умеет работать с датчиком движения/прохождения филамента (Filament Motion Sensor) — он останавливает печать при застревании или окончании прутка. Подключается к свободному входу платы; в конфиг добавляется секция [filament_motion_sensor]/[filament_switch_sensor] с указанием пина и реакции (pause + макрос). На KlipperMod настраивается через веб-интерфейс.

---

Камеры (USB)

Сток и моды поддерживают многие USB-камеры (подключение в USB-порт экрана или обжать в задний разъём):

Камера	Статус
Оригинальная FF	Штатное крепление, самый простой вариант
Logitech C270	Работает, макс. 1280×960
Logitech C310/C615/C920/C160	Работают (C615 может лагать через приложение)
Камера ноутбука HP	Не даёт картинку
IP-камеры по RTSP (Tapo C211)	Klipper напрямую RTSP не умеет
Arducam, OV9726, ESP32-CAM	Рабочие варианты для самосбора

Типичные жалобы — низкий FPS и узкий угол обзора; для серьёзного видеонаблюдения камеру выносят на внешний хост.

---

Функции защиты ZMod

ZMod с версии 1.4.0 добавил механизмы, которых нет в стоке (список изменений — #606835 Sergei):

• Контроль удара сопла о стол / отрыва детали (NOZZLE_CONTROL). Порог по весу на тензодатчиках: WEIGHT= в граммах, WEIGHT=0 отключает (#458). При превышении принтер аварийно останавливается. Работает только во время печати. В логах событие выглядит как transition to shutdown state с авто-рестартом прошивки (#640881).

  Ложное срабатывание: при заполнении сопло может оставить соплю, которая на следующем слое читается как касание стола (#650050). Если ловите ложные аварии — поднимайте порог.

• Восстановление печати после потери питания. Для полного возобновления ZMod сохраняет состояние: X/Y/Z/E, Z-offset, PA (значение+время), 4 параметра ретракта, позицию в файле, целевые температуры стола и сопла, обдув, скорость потока и печати, режимы экструзии и движения, карту стола (#583750).
• Контроль загруженной пластины — сверяет снятую карту стола с текущей пластиной, не даёт печатать по чужой карте.
• Умная парковка с KAMP, спектрограмма ремней, работа с датчиком движения филамента — там же.

Сброс до заводских настроек

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

Когда помогает: - После ручной правки конфига через root принтер стал ловить E0011 при каждой печати — вылечено factory reset + переустановка заводской прошивки (#762482). - Ошибка Include file '.../mod/display_off.cfg' does not exist после установки ZMod — перепрошивка со сбросом к заводским (#713594, #716777). - Кривая прошивка из-за побитых данных на диске (не обязательно смерть eMMC) — сначала «чек системы» (чинит битые библиотеки), затем накатка factory (правит прошивку MCU) (#844829).

Файлы полной прошивки (пример для AD5X): AD5X-factory-1.0.9.tgz + опционально config.tar — в релизах ZMod (тег R) (#824628).

Обновление и откат

• Обновление мода — только вручную, файлом с флешки/через веб. Штатное меню обновления на моде не использовать.

Порядок обновления стоковой прошивки, когда стоит ZMod. Последовательность важна, иначе ловите ошибки:

1. Если ZMod у вас свежий — просто скачайте и поставьте обновление родной прошивки, перезагрузитесь. Всё.
2. Если ZMod давно не обновлялся — сначала обновите сам ZMod с флешки, потом через Fluidd доберите обновления модулей/плагинов, и только затем обновляйте родную прошивку.
3. Если уже обновили сток первым и что-то сломалось — переустановите ZMod с флешки и добёрите обновления через Fluidd. Обычно этого достаточно.

Чего не забыть:

• На Klipper 13 перед обновлением родной прошивки обязательно выполните в консоли Fluidd UPDATE_MCU — иначе версии хоста и MCU разъедутся.
• Плагины перед обновлением лучше отключить: DISABLE_PLUGIN name=имя_плагина для каждого.
• На AD5X после обновления родной прошивки ZMod нужно активировать заново — положите на флешку AD5X-ENABLE-zmod.tgz и вставьте в принтер.
• Возврат на сток / откат — заливкой стоковой прошивки с флешки. Стоковые/factory-прошивки лежат в релизах ZMod (тег R); для AD5X — в разделе AD5X.
• Отключить телеметрию / автообновление / выгрузку фото в облако — заблокируйте на роутере домен обновлений update.sz3dp.com:10443 (тогда принтер не «звонит домой» и не сбрасывает разблокировку). Сменить firmwareExe между 5M и Pro можно при совпадающих версиях прошивки — MD5 менять не нужно.

Удалённое управление со стока: приложение FlashMaker + Orca-Flashforge — привязка по QR-коду. Подробнее про отправку на печать и веб-морду — в Слайсере и Сети.