Прошивка Marlin — это открытое программное обеспечение, которое управляет работой большинства FDM-принтеров, от бюджетных Creality Ender 3 до профессиональных Prusa i3. Её установка позволяет расширить функционал устройства: добавить автокалибровку стола, улучшить управление экструдером, оптимизировать скорость печати и даже реализовать нестандартные функции вроде Linear Advance или Input Shaping. Однако процесс прошивки часто вызывает сложности у новичков — ошибки компиляции, несовместимость с железом или "окирпичивание" принтера становятся частыми последствиями неправильных действий.

В этом руководстве мы разберём весь процесс от выбора версии Marlin до финальной калибровки, учитывая нюансы разных контроллеров (например, SKR Mini E3 или Creality 4.2.7) и типичные ошибки. Вы узнаете, как избежать распространённых проблем, какие настройки критично проверить перед прошивкой, и что делать, если принтер перестал реагировать на команды. А для тех, кто обновляет прошивку впервые, мы добавили FAQ-блок с ответами на самые частые вопросы.

1. Почему Marlin, а не другие прошивки?

На рынке существует несколько популярных прошивок для 3D-принтеров: Klipper, RepRapFirmware, Smoothieware и даже проприетарные решения от производителей (например, Creality Sprinter). Однако Marlin остаётся лидером по ряду причин:

  • 🔧 Широкий список поддерживаемых контроллеров: от устаревших RAMPS 1.4 до современных BTT SKR и Duet.
  • 📜 Открытый исходный код с активным сообществом на GitHub, где регулярно выходят обновления и патчи.
  • 🎛️ Гибкая настройка: возможность тонко настроить ускорения, ток двигателей, PID-регуляторы и даже добавить кастомные функции через Configuration.h.
  • 🔄 Совместимость с большинством принтеров, включая Creality, Anycubic, Prusa (клонированные модели) и самосборные RepRap.

Тем не менее, у Marlin есть и недостатки. Например, она не поддерживает многопоточную обработку команд (в отличие от Klipper), что может ограничивать скорость печати на высокопроизводительных машинах. Также для некоторых контроллеров (например, Duet 2 WiFi) требуется ручная компиляция с специфичными драйверами.

⚠️ Внимание: Если ваш принтер оснащён 32-битным контроллером (например, STM32 или LPC1768), убедитесь, что вы скачиваете версию Marlin с поддержкой ARM-архитектуры. Прошивка для 8-битных контроллеров (например, ATmega2560) несовместима и может привести к повреждению оборудования.
📊 Какой контроллер установлен в вашем 3D-принтере?
8-битный (ATmega2560, ATmega1280)
32-битный (SKR, BigTreeTech, Duet)
Не знаю
Другой

2. Подготовка: что понадобится перед прошивкой

Прежде чем приступать к установке, соберите всё необходимое. Отсутствие хотя бы одного компонента может прервать процесс на критичном этапе.

Оборудование и программы

  • 💻 Компьютер с Windows 10/11, macOS или Linux (для компиляции прошивки).
  • 🔌 USB-кабель (лучше оригинальный, без повреждений). Для некоторых контроллеров (например, SKR) может потребоваться USB-Type C.
  • 📁 Arduino IDE (версия 1.8.19+) или PlatformIO (для опытных пользователей).
  • 📥 Последняя версия Marlin с официального репозитория GitHub (ссылка в следующем разделе).
  • 🔧 Драйверы для контроллера (например, CH340 для клонов Arduino или STM32Cube для SKR).
  • 🔋 Источник бесперебойного питания (ИБП) или ноутбук с заряженной батареей — обрыв питания во время прошивки может вывести контроллер из строя.

Резервное копирование текущей прошивки

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

  1. Через Pronterface или OctoPrint: подключите принтер к ПК и выполните команду M503, чтобы получить текущие настройки. Сохраните вывод в текстовый файл.
  2. Через Arduino IDE: если у вас есть исходный код текущей прошивки, скопируйте папки Configuration.h и Configuration_adv.h.
⚠️ Внимание: Если ваш принтер был куплен с предустановленной прошивкой от производителя (например, Creality 1.1.6), её исходный код может отсутствовать в открытом доступе. В этом случае резервное копирование настроек через M503 — единственный способ сохранить критичные параметры вроде PID-значений для хотэнда.

☑️ Подготовка к прошивке Marlin

Выполнено: 0 / 5

3. Выбор версии Marlin: стабильная vs. "bugfix"

На официальном GitHub-репозитории Marlin доступно несколько веток прошивки:

Ветка Описание Для кого подходит Риски
2.1.x Стабильная версия с базовым функционалом. Новички, владельцы стандартных принтеров (Ender 3, CR-10). Минимальные, но отсутствуют новые фичи.
bugfix-2.1.x Обновлённая стабильная ветка с исправлениями ошибок. Пользователи, которым нужны минорные улучшения без риска. Возможны незначительные баги в новых фичах.
dev Разрабатываемая версия с экспериментальными функциями. Опытные пользователи, тестеры. Высокий риск нестабильной работы.

Для большинства пользователей оптимальный выбор — ветка bugfix-2.1.x. Она содержит все критичные исправления, но при этом прошла тестирование сообществом. Скачать её можно по ссылке (кликните Code → Download ZIP).

Если вы владелец принтера с нестандартным контроллером (например, BTT Octopus или Duet Maesto), проверьте совместимость на официальной странице. Некоторые платы требуют дополнительных библиотек или ручной правки platformio.ini.

💡

Если вы обновляете прошивку на принтере с TMC-драйверами (например, TMC2209), убедитесь, что в Configuration.h включены опции #define HAVE_TMC2208 или #define HAVE_TMC2209. Без этого двигатели могут работать некорректно или перегреваться.

4. Настройка конфигурационных файлов

После скачивания архива с Marlin распакуйте его и откройте папку в Arduino IDE. Главные файлы, которые нужно настроить:

  • Configuration.h — основные параметры принтера (размер стола, количество экструдеров, тип термистора).
  • Configuration_adv.h — расширенные настройки (управление вентиляторами, Linear Advance, Input Shaping).

Для начала скопируйте в папку с Marlin файлы конфигурации из резервной копии (если она есть). Если нет — используйте шаблоны из папки config/examples. Например, для Creality Ender 3 подойдёт файл Creality/Ender-3/Configuration.h.

Критичные параметры для проверки

Даже если вы используете готовый конфиг, обязательно проверьте следующие настройки:

// Размер рабочей области (для Ender 3: 235x235x250)

#define X_BED_SIZE 235


#define Y_BED_SIZE 235


#define Z_MAX_POS 250



// Тип термистора хотэнда (обычно 1 для EPCOS 100K)


#define TEMP_SENSOR_0 1



// Тип драйверов шаговых двигателей (например, TMC2209)


#define X_DRIVER_TYPE TMC2209


#define Y_DRIVER_TYPE TMC2209


#define Z_DRIVER_TYPE TMC2209


#define E0_DRIVER_TYPE TMC2209



// Направление вращения двигателей (если принтер движется в обратную сторону)


#define INVERT_X_DIR false


#define INVERT_Y_DIR true


#define INVERT_Z_DIR false


#define INVERT_E0_DIR false

После редактирования сохраните файлы и перейдите к компиляции.

⚠️ Внимание: Если вы используете BLTouch или другой датчик автокалибровки, убедитесь, что в Configuration.h раскомментирована строка #define BLTOUCH и указаны правильные координаты offsets (например, #define NOZZLE_TO_PROBE_OFFSET {10, 10, 0}). Неправильные offsets приведут к тому, что сопло будет биться о стол при калибровке.
Как найти правильные значения для NOZZLE_TO_PROBE_OFFSET?

1. Разместите сопло над центром стола и запишите координаты (например, X=115, Y=115).

2. Переместите сопло в сторону и установите щуп BLTouch над центром стола. Запишите новые координаты (например, X=105, Y=105).

3. Offset по X = 115 - 105 = 10, по Y = 115 - 105 = 10. Впишите эти значения в конфиг как {10, 10, 0}.

4. Для Z-offset используйте листок бумаги: опустите сопло до касания и запишите значение, затем поднимите на 0.1 мм и проверьте срабатывание датчика.

5. Компиляция и прошивка через Arduino IDE

Теперь перейдём к самому ответственному этапу — компиляции и загрузке прошивки на контроллер. Следуйте инструкции шаг за шагом:

  1. Откройте проект в Arduino IDE:
    • Запустите Arduino IDE.
    • Перейдите в Файл → Открыть и выберите файл Marlin.ino из распакованной папки.
  2. Выберите плату и порт:
    • В меню Инструменты → Плата выберите ваш контроллер. Например:
      • Для Creality 4.2.7 (STM32): STM32F1xx/Generic STM32F103C series.
      • Для RAMPS 1.4 (ATmega2560): Arduino Mega 2560.
      • Для BTT SKR Mini E3: LPC1768 (если используется PlatformIO).
    • В Инструменты → Порт выберите COM-порт вашего принтера (например, COM3).
  3. Установите дополнительные библиотеки (если требуется):

    Для некоторых контроллеров (например, STM32) нужно доустановить библиотеки через Инструменты → Управлять библиотеками. Ищите STM32duino или LPC1768.

  4. Компиляция и загрузка:
    • Нажмите кнопку Загрузить (стрелка вправо) или Ctrl+U.
    • Дождитесь завершения компиляции (может занять 5–15 минут).
    • Если появится ошибка, проверьте логи в чёрном окне внизу Arduino IDE.

После успешной загрузки принтер должен перезагрузиться. Если экран не включается или принтер издаёт необычные звуки (например, пищит или дергает двигателями), немедленно отключите питание и проверьте настройки.

💡

Самая частая ошибка при компиляции — нехватка памяти. Если вы видите сообщение "sketch too big", попробуйте отключить ненужные функции в Configuration_adv.h (например, #defineULTRA_LCD или #define AUTO_BED_LEVELING_BILINEAR).

6. Первая проверка и калибровка после прошивки

Успешная прошивка — только половина дела. Теперь нужно убедиться, что принтер работает корректно. Следуйте этому чек-листу:

☑️ Проверка после прошивки

Выполнено: 0 / 5

Тест движения осей

В ручном режиме (Prepare → Move Axis) переместите каретку по всем осям на 10 мм. Проверьте:

  • 🔄 Двигатели вращаются плавно, без рывков.
  • 📏 Направление движения совпадает с командами (например, при нажатии X+ каретка движется вправо).
  • 🔊 Нет посторонних звуков (скрипов, стуков).

Калибровка PID-регуляторов

После прошивки обязательно перекалибруйте PID для хотэнда и стола. Сделать это можно через Pronterface или OctoPrint, отправив команды:

// Для хотэнда (целевая температура 200°C)

M303 E0 S200 C8



// Для стола (целевая температура 60°C)


M303 E-1 S60 C8

После завершения калибровки сохраните результаты командой M500.

Печать тестового объекта

Загрузите в слайсер (например, PrusaSlicer или Cura) простой тестовый объект — куб 20×20×20 мм с толщиной стенки 0.2 мм. Обратите внимание на:

  • 📦 Качество первого слоя (должен быть равномерным, без зазоров).
  • 🔳 Точность размеров (измерьте куб штангенциркулем).
  • 🌀 Отсутствие "слоистости" или артефактов на поверхности.
⚠️ Внимание: Если принтер после прошивки начал "проскакивать" слои или экструдер клинит, проверьте значение DEFAULT_AXIS_STEPS_PER_UNIT в Configuration.h. Неправильные шаги на мм приводят к смещению слоёв. Для Ender 3 стандартные значения: {80, 80, 400, 93} (X, Y, Z, E).

7. Распространённые ошибки и их решения

Даже при точном следовании инструкции могут возникнуть проблемы. Вот самые частые из них и способы их устранения:

Симптом Возможная причина Решение
Экран не включается после прошивки Неправильно выбрана плата в Arduino IDE или повреждён bootloader Проверьте настройки платы. Если не помогает — прошейте bootloader через STM32CubeProgrammer (для STM32) или AVRDUDE (для ATmega)
Двигатели гудят, но не вращаются Неправильно указан тип драйверов или отключены ENABLE-пины Проверьте #define X_DRIVER_TYPE и убедитесь, что в pins.h не закомментированы строки с ENABLE
При печати сопло бьётся о стол Неправильные Z-offset или HOME_OFFSET Откалибруйте Z-offset с помощью листа бумаги или командой M851 Z[значение]
Прошивка не компилируется ("variable not declared") Устаревшая версия Arduino IDE или конфликт библиотек Обновите Arduino IDE до последней версии и удалите старые библиотеки из папки libraries

Если ваша проблема не описана в таблице, проверьте логи ошибок в Arduino IDE или обратитесь на форумы MarlinFW или Reddit/r/3Dprinting. При обращении укажите:

  • Модель принтера и контроллера.
  • Версию Marlin и Arduino IDE.
  • Полный текст ошибки (если есть).

8. Дополнительные улучшения после установки Marlin

Базовая прошивка Marlin уже значительно улучшает работу принтера, но вы можете пойти дальше. Вот несколько полезных доработок:

  • 🔄 Linear Advance: улучшает контроль экструзии на высоких скоростях. Включается в Configuration_adv.h строкой #define LIN_ADVANCE. После включения выполните калибровку командой M900 K0.2 (значение K подбирается экспериментально).
  • 📈 Input Shaping: уменьшает артефакты при печати на высоких скоростях. Требует настройки акселерометра (например, ADXL345) и правки Configuration_adv.h.
  • 🔊 Тихие драйверы: если у вас установлены TMC2209, включите режим StealthChop для бесшумной работы: #define STEALTHCHOP_E.
  • 🖥️ Управление через Wi-Fi: с помощью OctoPrint или Mainsail (для Klipper) можно дистанционно контролировать печать.

Для опытных пользователей также доступны кастомные патчи, например:

  • Marlin Kimbra: оптимизированная версия для Creality с улучшенным меню.
  • JyersUI: альтернативный интерфейс для принтеров с экранами TFT.
⚠️ Внимание: Включение экспериментальных функций вроде Input Shaping или Pressure Advance может потребовать глубокой настройки и тестирования. Начните с консервативных значений и постепенно их корректируйте, наблюдая за качеством печати.

FAQ: Частые вопросы по установке Marlin

Можно ли прошить Marlin на принтер с проприетарной прошивкой (например, Creality 1.1.6)?

Да, но сначала нужно разблокировать bootloader. Для контроллеров на базе STM32 (например, Creality 4.2.7) это делается через STM32CubeProgrammer в режиме DFU. Для ATmega (например, Melzi) может потребоваться паяльник для перемычки BOOT0.

Инструкции по разблокировке ищите для конкретной модели контроллера. Например, для Ender 3 с платой 4.2.7 есть готовые гайды на YouTube (поиск по запросу "unlock bootloader Creality 4.2.7").

Как вернуть старую прошивку, если что-то пошло не так?

Если у вас есть резервная копия (Configuration.h и Configuration_adv.h), просто повторите процесс прошивки с этими файлами. Если копии нет:

  1. Скачайте стоковую прошивку с сайта производителя (например, для Creality — с официальной страницы).
  2. Прошейте её через Arduino IDE или Cura (если доступен файл .hex).
  3. Восстановите настройки через M503 (если они сохранялись в EEPROM).

Для контроллеров STM32 может потребоваться прошивка через DFU-mode (удерживайте кнопку BOOT при подключении USB).

Что делать, если Arduino IDE выдаёт ошибку "avrdude: stk500_recv(): programmer is not responding"?

Эта ошибка означает, что Arduino IDE не может связаться с контроллером. Причины и решения:

  • Не выбран COM-порт: проверьте в Инструменты → Порт.
  • Отсутствует драйвер: для CH340 скачайте драйвер с официального сайта.
  • Занят порт: закройте все программы, которые могут использовать COM-порт (например, Pronterface или OctoPrint).
  • Проблемы с USB-кабелем: попробуйте другой кабель (желательно оригинальный).
  • Повреждён bootloader: если ничего не помогает, прошейте bootloader заново (для ATmega — через USBasp, для STM32 — через ST-Link).
Как узнать, какой контроллер установлен в моём принтере?

Есть несколько способов:

  1. Визуальный осмотр: откройте корпус принтера и найдите маркировку на плате. Например:
    • Creality 4.2.7 — чёрная плата с надписью 4.2.7 и чипом STM32F103.
    • BTT SKR Mini E3 — зелёная плата с логотипом BigTreeTech.
    • RAMPS 1.4 — синяя плата с разъёмами под Arduino Mega.
  2. Через команды: подключитесь к принтеру через Pronterface и отправьте команду M115. В ответе будет строка вроде FIRMWARE_NAME:Marlin 2.0.9.3 (Github) и информация о контроллере.
  3. По модели принтера: у большинства принтеров есть стандартные платы. Например:
    • Ender 3 V2 — Creality 4.2.7.
    • Anycubic i3 Mega — MKS Robin Nano.
    • Prusa i3 MK3S — Einsy RAMBo.
Нужно ли обновлять Marlin, если принтер работает стабильно?

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

  • 🛡️ Исправления безопасности (например, защита от перегрева).
  • 🔧 Новые функции (например, Input Shaping для уменьшения артефактов).
  • 🐞 Исправления багов, которые могут проявляться в специфических сценариях (например, при печати с высоким ускорением).

Если вы решите обновиться, внимательно сравните старые и новые