Snapmaker2-Controller is the firmware for Snapmaker 2.0 3-in-1 3D Printers. It's based on the popular Marlin firmware with optimized FreeRTOS support.
Snapmaker2-Controller builds on the codebase of Marlin 2.0, we also added some new features:
To read more documentations about Snapmaker2-Controller, you can checkout the Snapmaker2-Controller Overview or Hardware Link for further reading.
As of recommended in Marlin's development settings, we use Visual Studio Code and PlatformIO IDE to develop Snapmaker2-Controller.
Follow Setting up Visual Studio Code to install and setup VSCode.
Follow the guide to install PlatformIO extension in VSCode.
Clone Snapmaker2-Controller repo using Git to your local folder.
> git clone git@github.com:Snapmaker/Snapmaker2-Controller.git
SHORT_BUILD_VERSION
or your changes will not be loaded when flashing the firmware.NOTE: if you build the source for first time, PlatformIO will download the relative libraries and toochains. It may take a few minutes.
After PlatformIO finishing the build, you will get two images:
(PROJECT FOLDER)/.pioenvs/GD32F105/firmware.bin
: image to be programmed into main controller(PROJECT FOLDER)/.pioenvs/GD32F105/firmware.elf
: image used to debug the firmware (in online debug tools like Ozone) To clean previous build, just click the clean icon, or type command pio run -t clean in the terminal.
After building, type below command in VSCode terminal
> pio run -t pack
Then you will get below firmwares in the folder (PROJECT FOLDER)/release
:
firmware.bin
: raw binary of firmware.firmware.elf
: firmware with debug information.SM2_MC_APP_{xxx such as V4.0.0}_{xxx such as 20201222}.bin
: minor image of module, can be used to generate major imageSnapmaker_{xxx: version such as V4.0.0}_{xxx: date such as 20201222}.bin
: major image which can be used to upgrade modules with USB stickFinally, copy the major image to your USB stick and upgrade your machine follow the instructions in How to update Firmware section.
You need to install Luban to package the compiled firmware.
First, Open Settings -> Firmware Tool in Luban, upload the compiled firmware.bin
, click Compile and Export. You will get a file with name like Snapmaker2_V3.2.0_20201117.bin
, this is the packaged update file to be programmed.
Then, Update your firmware via USB follow the instructions in How to update Firmware section.
Snapmaker2-Controller is released under terms of the GPL-3.0 License.
Terms of the license can be found in the LICENSE file or at https://www.gnu.org/licenses/gpl-3.0.en.html.