/Frankenprinter

Source Code for ZONESTAR/TRONXY 3d Frankenprinter

Primary LanguageCGNU General Public License v3.0GPL-3.0

Language / Translate


ZONESTAR 3D Printer Firmware Source Code

Configured machines list

Config Model Control board
D805S_ZM3E4 D805S(M2/R2) ZM3E4
D805S_ZRIB D805S(M2/R2) ZRIB
P802N_ZM3E4 P802N_ZM3E4 ZM3E4
P802QR2_ZM3E4 P802QR2 ZM3E4
P802QR2_ZRIB P802QR2 ZRIB
Z5S_ZM3E2 Z5S(M2/R2) ZM3E2
Z5X_ZM3E2 Z5X(M2/R2) ZM3E2
Z5X_ZMIB Z5X(M2/R2) ZMIB
Z5XM3_ZM3E4 Z5X(M3/R3) ZM3E4
Z6_ZMIB Z6 ZMIB
Z8P_ZM3E4 Z8P(M3/R3) ZM3E4
Z8R3_ZRIB Z8X(R3) ZRIB
Z8T_ZM3E4 Z8T(M3) ZM3E4
Z8T_ZRIB Z8T(M3) ZRIB
Z8XM2_ZM3E4 Z8X(M2/R2) ZM3E4
Z9M3_ZM3E4 Z9M3(R3) ZM3E4
Z9M3_ZRIB Z9M3(R3) ZRIB
Z9M4_ZM3E4 Z9M4 ZM3E4
Z9V5 Z9V5(Pro)-MK1(2) ZM3E4
Z9V5_MK3 Z9V5Pro-MK3 ZM3E4
Z9V5_MK4 Z9V5Pro-MK4 ZM3E4
Z10M2_ZRIB Z10M2 ZRIB
Z10M2_ZM3E4 Z10M2 ZM3E4
Z10R2_ZM3E4 Z10R2 ZM3E4

How to build firmware

1. Prepare the compilation environment

  1. Install "Visual Studio Code: Visit the Setting up Visual Studio Code page to download and install the latest Visual Studio Code for your particular platform.
  2. Install the PlatformIO IDE: Head over to the Get PlatformIO IDE page to learn how to install PlatformIO IDE in Visual Studio Code.
    More detail, please refer to Install marlin compilation environment

2. Prepare firmware source code

  1. Download firmware source code to your PC and unzip it.
  2. Choose and replace config files
    • Find the configuration files of your machine from the "config" directory.
    • Copy and replace configuration.h and configuration_adv.h to "marlin" directory.
    • Copy and replace platformio.ini to root directory of the source code.
    • Modify "configuration.h" and "configuration_adv.h" according to the setting of your machine if need.
  3. Open the project in Visual Stuido Code
    Use the "Open Folder…" command in the Visual Studio Code "File" menu to open the source code directory which you stored, e.g. "main".

3. Compile firmware

  1. Run the "Run build task" command in the Visual Studio Code "Terminal" menu, and then choose "PlatformIO:build" task to build the firmware bin (or Hex) file.
    • 32bits control board(ZM3E2/ZM3E4): firmware.bin file.
    • 8bits control board(ZMIB/ZRIB): firmware.hex file.
  2. Wait for the build finished.
  3. Find the firmware.bin (32-bits control board) or firmware.HEX (8-bits control board) file in the ".pio/build/{board}" of the source code directory.
    👉ZONESTAR 3D Printer firmware Bin/Hex file

4. Patchs


Upload firmware to your 3d printer

  1. For 32 bits control board, you can copy the firmware.bin file to SD card and upload the firmware from the SD card.
  2. For 8bits control board, you need to upload firmwre to the control board by PC (from USB cable), about detail, please refer to upload firmware

License

Marlin is published under the GPL license because we believe in open development. The GPL comes with both rights and obligations. Whether you use Marlin firmware as the driver for your open or closed-source product, you must keep Marlin open, and you must provide your compatible Marlin source code to end users upon request. The most straightforward way to comply with the Marlin license is to make a fork of Marlin on Github, perform your modifications, and direct users to your modified fork.

While we can't prevent the use of this code in products (3D printers, CNC, etc.) that are closed source or crippled by a patent, we would prefer that you choose another firmware or, better yet, make your own.