Guide:Marlin

Установка PlatformIO

root_dir=$PWD
export PLATFORMIO_CORE_DIR=$root_dir/pio
git clone https://github.com/platformio/platformio-core-installer
cd platformio-core-installer && python3 get-platformio.py

Marlin をクローンする

Клонируем версию 2.1.2.1, последнюю на момент написания этой статьи.

git clone -b 2.1.2.1 https://github.com/MarlinFirmware/Marlin marlin
cd $root_dir

Клонируем примеры конфигурации (также для версии 2.1.2.1), чтобы не создавать настройки с нуля.

git clone -b 2.1.2.1 https://github.com/MarlinFirmware/Configurations config

Определение пресета PlatformIO

Необходимо найти пресет (окружение, "цель" билда) для вызова PlatformIO. Мы компилируем прошивку для Ender 3 v4.2.2, поэтому используем пресет STM32F103RE_creality в пункте "Билд с помощью PlatformIO".

Если ваш принтер или плата принтера отличается, то найдите похожие строки в файле ./Marlin/src/pins/pins.h:

grep CREALITY_V422 marlin/Marlin/src/pins/pins.h

./Marlin/src/pins/pins.h:575:  #include "stm32f1/pins_CREALITY_V422.h"
  / STM32F1
  / env:STM32F103RE_creality
  / env:STM32F103RE_creality_xfer
  / env:STM32F103RC_creality
  / env:STM32F103RC_creality_xfer
  / env:STM32F103RE_creality_maple

Выберите пресет, соответствующий плате вашего принтера.

Конфигурация

Необязательно: создайте git branch для вашего принтера, чтобы все изменения можно было легко отследить и обновить.

cd $root_dir/marlin
git checkout -b ender-3

Используйте пример конфигурации для вашего принтера:

cp $root_dir/config/config/examples/Creality/Ender-3/CrealityV422/{_Bootscreen.h,Configuration_adv.h,Configuration.h,_Statusscreen.h} marlin/Marlin/

Необязательно: делайте git commit каждый раз, когда вносите изменения в конфигурацию. Добавьте описание для коммита.

cd $root_dir/marlin
git add Marlin
git commit -m "Ender 3 example config"

Билд с помощью PlatformIO

Используйте пресет PlatformIO, который мы нашли ранее

cd $root_dir/marlin
$root_dir/pio/penv/bin/platformio run -e STM32F103RE_creality

これによりファームウェア ファイルがビルドされ、コンパイル出力ログで確認できます：

RAM:   [=         ]  11.6% (used 7592 bytes from 65536 bytes)
Flash: [===       ]  27.2% (used 142600 bytes from 524288 bytes)
Building .pio/build/STM32F103RE_creality/firmware-20231008-230629.bin

インストール

.pio/build/STM32F103RE_creality/firmware-20231008-230629.binをSDカードにコピーします。 名前を変更しないでください。名前が現在のファームウェアと同じ場合、プリンタがアップデートを拒否する可能性があります。SDカードを挿入し、プリンターをリセットします。 起動中に自動的に更新されるはずです。