README.md

Mks-Robin-Nano-Marlin2.0-Firmware

Features

The firmware of MKS Robin Nano V1.x/V2.0/V3.x, and MKS Eagle, based on Marlin2.0.x, added the LittlevGL, supporting colourful GUI and touch screen. It is developed on PlatformIO, we hope more and more developers will participate the development of this repository.

Build

As the firmware is based on Marlin2.0.x which is built on the core of PlatformIO, the buid compiling steps are the same as Marlin2.0.x. You can directly using PlatformIO Shell Commands, or using IDEs contain built-in PlatformIO Core(CLI), for example, VSCode and Atom. VSCode is recommended.

About the gcode file preview

The images should be added to gcode file when slicing, and MKS has developed the plugin for Cura to make it.

About the image conversion

• Open LVGL online image converter tool.
• Open bmp images.
• Enter the saved file name.
• Choose color format:True color.
• Choose file output format:Binary RGB565.
• Start convertion.
• Save bin file.
• Copy the converted bin file to the assets folder.
• Copy the assets folder to the SD card.
• SD card is connected to the motherboard, and you can see the update interface after powering on.

Firmware Can be run on Robin Nano V1.x / V2.x boards and V3.x boards

MKS Robin Nano V1.x build and update firmware

1. Build config:

• platformio.ini:

  default_envs = mks_robin_nano35

• Configuration.h:
  #define SERIAL_PORT 3
  #define MKS_ROBIN_TFT35
  #define MOTHERBOARD BOARD_MKS_ROBIN_NANO
  #define TFT_LVGL_UI
  #define TOUCH_SCREEN

• Configuration_adv.h:
  //#define USB_FLASH_DRIVE_SUPPORT
  //#define MULTI_VOLUME

2. Update firmware:

• Enter the .pio\build\mks_robin_nano35 directory, copy the assets folder and Robin_nano35.bin to the sd card
• Insert SD card to the motherboard, and you can see the update interface after power on.

MKS Robin Nano V1.3 & Nano-S V1.3 build and update firmware

1. Build config:

• platformio.ini:

  default_envs = mks_robin_nano_v1_3_f4

• Configuration.h:
  #define SERIAL_PORT 3
  #define MKS_ROBIN_TFT35
  #define MOTHERBOARD BOARD_MKS_ROBIN_NANO_V1_3_F4 #define TFT_LVGL_UI
  #define TOUCH_SCREEN

• Configuration_adv.h:
  //#define USB_FLASH_DRIVE_SUPPORT
  //#define MULTI_VOLUME

2. Update firmware:

• Enter the .pio\build\mks_robin_nano35 directory, copy the assets folder and Robin_nano35.bin to the sd card
• Insert SD card to the motherboard, and you can see the update interface after power on.

MKS Robin Nano V2.x build and update firmware

1. Build config:

• platformio.ini:

  default_envs = mks_robin_nano35

• Configuration.h:
  #define SERIAL_PORT 3
  #define MKS_TS35_V2_0
  #define MOTHERBOARD BOARD_MKS_ROBIN_NANO_V2
  #define TFT_LVGL_UI
  #define TOUCH_SCREEN

• Configuration_adv.h:
  //#define USB_FLASH_DRIVE_SUPPORT
  //#define MULTI_VOLUME

2. Update firmware:

• Enter the .pio\build\mks_robin_nano35 directory, copy the assets folder and Robin_nano35.bin to the sd card
• Insert SD card is to the motherboard, and you can see the update interface after power on.

MKS Robin Nano V3.x build and update firmware

1. Build config:

• platformio.ini:

  default_envs = mks_robin_nano_v3_usb_flash_drive

• Configuration.h:
  #define SERIAL_PORT -1
  #define MKS_TS35_V2_0
  #define MOTHERBOARD BOARD_MKS_ROBIN_NANO_V3
  #define TFT_LVGL_UI
  #define TOUCH_SCREEN

• Configuration_adv.h:
  After 2021.6.7, you can use the multi-volume function.
  Use the TF card and USB disk together:
  #define USB_FLASH_DRIVE_SUPPORT
  Only use TF card:
  // #define USB_FLASH_DRIVE_SUPPORT

2. Update firmware:

• Enter the .pio\build\mks_robin_nano35 directory, copy the assets folder and Robin_nano_v3.bin to the sd card or usb disk
• Insert sdcard or usb disk to the motherboard, and you can see the update interface after power on.

3. Example build config:

• Open the example configuration file.
• Modify the parameters, replace configuration.h and configuration_adv.h in the Marlin path of the source code.
• Compile the firmware.

4. Prebuilt *.bin firmware for update

• We have prebuilt the robin nano v3 firmware for some type of printers and some extended usage.

MKS Eagle build and update firmware

1.Build config:

• platformio.ini:

  default_envs = mks_eagle_usb_flash_drive

• Configuration.h:

  #define SERIAL_PORT -1
  #define MKS_TS35_V2_0
  #define MOTHERBOARD BOARD_MKS_EAGLE
  #define TFT_LVGL_UI
  #define TOUCH_SCREEN

• Configuration_adv.h:
  After 2021.6.7, you can use the multi-volume function.
  Use the TF card and USB disk together:
  #define USB_FLASH_DRIVE_SUPPORT
  Only use TF card:
  // #define USB_FLASH_DRIVE_SUPPORT

2、Update firmware:

• Enter the .pio\build\mks_eagle_usb_flash_drive directory, copy the assets folder and mks_eagle.bin to the sd card or usb disk
• Insert sdcard or usb disk to the motherboard, and you can see the update interface after power on.

For more function configuration, please refer to Robin nano series Wiki

• MKS Robin Nano V1.x Wiki.
• MKS Robin Nano V2.x Wiki.
• MKS Robin Nano V3.x Wiki.

More information about the Robin Nano V1.X

Please refer to MKS Robin Nano github.

More information about the Robin Nano V2.X

Please refer to MKS Robin Nano V2 github.

More information about the Robin Nano V3.X

Please refer to MKS Robin Nano V3 github.

Note

• Thank you for using MKS products. If you have any questions during use, please contact us in time and we will work with you to solve it.
• For more product dynamic information and tutorial materials, you can always follow MKS's Facebook/Twitter/Discord/Reddit/Youtube and Github. Thank you!
• MKS Github: https://github.com/makerbase-mks
• MKS Facebook: https://www.facebook.com/Makerbase.mks/
• MKS Twitter: https://twitter.com/home?lang=en
• MKS Discord: https://discord.gg/4uar57NEyU
• MKS Reddit: https://www.reddit.com/user/MAKERBASE-TEAM/