Skip to content

Commit

Permalink
update README.md
Browse files Browse the repository at this point in the history
  • Loading branch information
solawc committed Oct 18, 2021
1 parent c03dfaf commit e2080e8
Show file tree
Hide file tree
Showing 3 changed files with 80 additions and 38 deletions.
2 changes: 1 addition & 1 deletion Marlin/Configuration.h
Original file line number Diff line number Diff line change
Expand Up @@ -139,7 +139,7 @@

// Choose the name from boards.h that matches your setup
#ifndef MOTHERBOARD
#define MOTHERBOARD BOARD_MKS_ROBIN_NANO_V3
#define MOTHERBOARD BOARD_MKS_EAGLE
#endif

// Name displayed in the LCD "Ready" message and Info menu
Expand Down
114 changes: 78 additions & 36 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,16 +1,21 @@
# Mks-Robin-Nano-Marlin2.0-Firmware

## Features

The firmware of MKS Robin Nano, based on [Marlin2.0.x](https://github.com/MarlinFirmware/Marlin), added the [LittlevGL](https://github.com/littlevgl/lvgl), supporting colourful GUI and touch screen. It is developed on PlatformIO, we hope more and more developers will participate the development of this repository.

![](https://github.com/makerbase-mks/Mks-Robin-Nano-Marlin2.0-Firmware/blob/master/Images/MKS_Robin_Nano_printing.png)

## 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](https://docs.platformio.org/en/latest/core/installation.html#piocore-install-shell-commands), or using IDEs contain built-in PlatformIO Core(CLI), for example, [VSCode](https://docs.platformio.org/en/latest/integration/ide/vscode.html#ide-vscode) and [Atom](https://docs.platformio.org/en/latest/integration/ide/atom.html). 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](https://github.com/makerbase-mks/mks-wifi-plugin) to make it.

## About the image conversion

- Open [LVGL online image converter tool](https://lvgl.io/tools/imageconverter).
- Open bmp images.
- Enter the saved file name.
Expand All @@ -23,75 +28,79 @@ The images should be added to gcode file when slicing, and MKS has developed the
- 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

default_envs = mks_robin_nano35

- Configuation.h:
#define SERIAL_PORT 3
#define MKS_ROBIN_TFT35
#define MOTHERBOARD BOARD_MKS_ROBIN_NANO
#define TFT_LVGL_UI
#define TOUCH_SCREEN
#define SERIAL_PORT 3
#define MKS_ROBIN_TFT35
#define MOTHERBOARD BOARD_MKS_ROBIN_NANO
#define TFT_LVGL_UI
#define TOUCH_SCREEN

- Configuation_adv.h:
//#define USB_FLASH_DRIVE_SUPPORT
//#define MULTI_VOLUME
//#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

default_envs = mks_robin_nano35

- Configuation.h:
#define SERIAL_PORT 3
#define MKS_TS35_V2_0
#define MOTHERBOARD BOARD_MKS_ROBIN_NANO_V2
#define TFT_LVGL_UI
#define TOUCH_SCREEN
#define SERIAL_PORT 3
#define MKS_TS35_V2_0
#define MOTHERBOARD BOARD_MKS_ROBIN_NANO_V2
#define TFT_LVGL_UI
#define TOUCH_SCREEN

- Configuation_adv.h:
//#define USB_FLASH_DRIVE_SUPPORT
//#define MULTI_VOLUME
//#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_msc

default_envs = mks_robin_nano_v3_usb_flash_drive

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

- Configuation_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
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.

Expand All @@ -106,17 +115,50 @@ The images should be added to gcode file when slicing, and MKS has developed the
- We have prebuilt the robin nano v3 [firmware](https://github.com/makerbase-mks/MKS-Robin-Nano-V3.X/tree/main/firmware/Marlin-bugfix2.0.x-MKS-2.1.2) 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

- Configuation.h:

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

- Configuation_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](https://github.com/makerbase-mks/MKS-Robin-Nano-V1.X/wiki).
- [MKS Robin Nano V2.x Wiki](https://github.com/makerbase-mks/MKS-Robin-Nano-V2.X/wiki).
- [MKS Robin Nano V3.x Wiki](https://github.com/makerbase-mks/MKS-Robin-Nano-V3.X/wiki).

## More information about the Robin Nano V1.X

Please refer to [MKS Robin Nano github](https://github.com/makerbase-mks/MKS-Robin-Nano-V1.X).

## More information about the Robin Nano V2.X

Please refer to [MKS Robin Nano V2 github](https://github.com/makerbase-mks/MKS-Robin-Nano-V2).

## More information about the Robin Nano V3.X

Please refer to [MKS Robin Nano V3 github](https://github.com/makerbase-mks/MKS-Robin-Nano-V3.X).

2 changes: 1 addition & 1 deletion platformio.ini
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@
[platformio]
src_dir = Marlin
boards_dir = buildroot/share/PlatformIO/boards
default_envs = mks_robin_nano_v3_usb_flash_drive
default_envs = mks_eagle_usb_flash_drive
include_dir = Marlin
extra_configs =
ini/avr.ini
Expand Down

0 comments on commit e2080e8

Please sign in to comment.