This project is a fork from davidtgbe effort to try to adapt the Anet ET4/ET5 motherboard and display for use with Marlin. I've made only config changes to make it work with Labists implementation of the ET4 and as such all credit should go to davidtgbe.
- XYZ Steppers
- Extruder
- SD Card
- USB comunication / pronterface
- TFT
- Filament runout detector.
- EEPROM
- Powerloss. See issues tab.
- PC/SD firmware load/update: I've managed to get working OpenBLT, (PC-USB / SD / DFU) updates. I'm still looking for a way to do a first time flash without flasher. Even so, a hardware flasher is very recommended for its price.
- All files on path "Marlin\buildroot\share\PlatformIO\variants\ET4" should be adapted to ET4/5 Board. Specially peripheralPins.c, variant.cpp, variant.h etc..
I have enabled issues tab. Please, try to be detailed regarding use cases and other useful information like hardware and software context. To get help on creating an issue see this.
DISCLAIMER: Not for production use. This is an unfinished project and under development. I am not responsible for what may happen to the motherboard or printer. Use only at your own risk.
Currently you can only flash this firmware using a flasher (stlink, jlink, bmp etc), unless you already have flashed the openblt bootloader (BL).
First time, I recommend making a backup of your firmware. At least your bootlaoder (addresses from 0x08000000 to 0x08010000). This way, you can always recover/return to stock firmware by:
- flashing the bootloader backup, from address 0x08000000 to 0x8010000.
- flashing any of the available firmwares from address 0x08010000 onwards.
Keep in mind that my origina firmware backup didn't restore properly. The Firmware images are for the Anet ET models provided by davidtgbe
You have two options to install/update this firmware:
- Option A > Not using a bootloader (BL)
- Firmware (Marlin) starts directly when you switch on the printer.
- You need the flasher to perform firmware installation/updates.
- Option B > Using a bootloader along with this firmware
- When you switch on the printer, bootloader (BL) starts first, and, if there are not any firmware updates incomming (on SD or through PC-USB), it loads the firmware (Marlin).
- You need the flasher to flash the BL the first time. Once it is flashed, you MUST install/update your FW through your BL, either by SD card or USB-PC. You MUST NOT use the flasher to install/update the FW, as it will not work.
-
Download or clone this repo. Ensure you build the firmware with latest sources, as firmware.srec file will not be built with older sources.
-
Changes are already made to config.h and config_adv.h according to Labists ET4 model
- Fine tunning could be needed (e.g. XYZE steps or offsets, Jerks, JD, LA, etc).
- If you are going to take option B from considerations section (using a BL), you can skip this step. Otherwise, you need to offset the firmware back to 0x08000000. That is achieved by commenting a line in platform.ini file. It is uncommented by default:
#
# Anet ET4
#
[env:ET4]
...
...
# Uncomment next line to build for use with bootloader. Offset depends on BL used.
board_build.offset = 0x10000
...
...
Change "board_build.offset = 0x10000" to
#board_build.offset = 0x10000
- Build project with platform.io on VS code is recommended. There are many tutorials on the web. You can follow them, ADAPTING steps to build this project. This one here in spanish made by davidtgbe, and just another one here.
- If everything went well, you will find binary files firmware.[elf|bin|srec], generated in the build output folder:
<src_code_base_folder>\.pio\build\ET4\
There are several tutorials available for stlink/j-link flashers. Take a look to them.
You have two options to install/update this firmware:
- Option A > If you are going to use the firmware without bootloader:
- It is assumed you have built your firmware with no offset (followed step 1.3) .
- As the firmware has been built without offset, and lacks of a bootloader, you have to just flash your firmware binary file (step 1.5) with your preferred flasher from address 0x8000000.
- Option B > If you are going to use the firmware with bootloader:
- You need to flash the bootloader from address 0x08000000. This step needs to be performed just once, so, you can skip this step if you have already done so. You can download the precompiled bootloader binary, or, you can build it yourself from source code using STM32 Cube IDE.
- After flashing the BL, you can disconnect your flasher, it will not be used anymore.
- Now it is time to install de firmware. BL will assist us in this task, so, you must use a SD-CARD OR USB-PC/microboot to flash perform this step.
- SD-CARD -> Copy file firmware.srec from build folder (step 1.5) in the root folder of the SD-CARD.
- USB-PC/microboot ->
- Download microboot software. It is uploaded to github and you can download it from here.
- Extract the .zip file you have just downloaded and browse to the folder openblt/Host/. You will find the microboot.exe executable.
- Connect your printer via USB to your PC and get the COM port number.
- Open microboot.exe executable and configure COM port number and speed (115200) through settings button. Then, click browse and search for the file firmware.srec. You will find it in the output build folder (step 1.5).
- Switch off and then switch on the printer to begin the installation/update process.
- Screen will be white during the process, and, after 3 or 4 minutes, Marlin will appear on the screen.
You can connect with pronterface to corresponding COM port @115200bps.
If you use bootloader, you must not use the flasher to install/update the FW. The bootloader inserts a special checksum in the firmware during the install/update process. Bootloader checks for this checksum before jumping to the firmware. If you use your flasher to install the firmware, this checksum is not written, and, therefore, bootloader will not boot the firmware, and your screen will be white.
*White screen usually means, printer is on bootloader mode, waiting for incoming installation/update.
DFU mode (Device Firmware Upgrade) has been added to the bootloader. You can enter to it just by pressing touchscreen while switching printer on. By using DFU mode you can even update your bootloader without needing a hardware flasher, just using the PC-USB and the right tool.
More info:
SD-CARD update process
PC-USB update process
MCU: STM32F407VGT6 ARM CORTEX M4
DRIVERS: TMC2208 (silent) / A4988 (noisy)
USB TO SERIAL CONVERTER: CH340G
SERIAL FLASH MEMORY: WINBOND W25Q128JVSQ (128M-bit)
EEPROM: AT24C04C (ATMLH744 04CM) 4 Kb
LCD ET4: ST7789 @ 320x240 | STP320240_0280E2T (40P/1,5): ST7789 (YT280S008) | ST7789V
LCD ET5: ST7796S @ 480x320
TOUCH: XPT2046
MOSFETS (BED/HOTEND): G90N04
CLK: JF8.000 (8MHZ MCU EXT CLK)
CLK: JF12.000 (12 MHZ USB-UART CLK)
SCHOTTKY DIODE: SS56
REGULATOR: AMS1117 3.3 DN811
MOSFET: 030N06
MOSFET: A19T
STEP DOWN DC CONVERTER: XL2596S -5.0E1 83296
VOLTAGE COMPARATOR: 293 STG9834 / LM293DT
E-STEP => PB9
E-DIR => PB8
E-ENABLE => PE0
X-STEP => PB6
X-DIR => PB5
X-ENABLE => PB7
Y-STEP => PB3
Y-DIR => PD6
Y-ENABLE => PB4
Z-STEP => PA12
Z-DIR => PA11
Z-ENABLE => PA15
Y-LIMIT => PE12
X-LIMIT => PC13
Z-LIMIT => PE11
TEMP_BED => PA4
TEMP_EXB1 => PA1
END_FAN => PE1
LAY_FAN => PE3
END_CONTROL => PA0
BED_CONTROL => PE2
LV_DET => PC3
MAT_DET1 => PA2
POWER_LOSS_DET => PA8 (provided by ANET)
SDIO_D2 => PC10
SDIO_D3 => PC11
SDIO_CMD => PD2
SDIO_CLK => PC12
SDIO_D0 => PC8
SDIO_D1 => PC9
TF_DET => PD3
USB_USART1_TX => PA9
USB_USART1_RX => PA10
RESET_BTN => NRST (14)
LED_D2 => PD12
WINBOND_CS => PB12
WINBOND_DO => PB14
WINBOND_DI => PB15
WINBOND_CLK => PB13
EEPROM_A1 => GND
EEPROM_A2 => GND
EEPROM_SDA => PB11
EEPROM_SCL => PB10
P1_1_LCD_9_CSX => PD7
P1_2_LCD_11_WRX => PD5
P1_3_TOUCH_15_/CS => PB2
P1_4_TOUCH_14_DIN => PE5
P1_5_TOUCH_12_DOUT => PE4
P1_6_TOUCH_16_DCLK => PB0
P1_7_TOUCH_11_/PENIRQ => PB1
P1_8_LCD_12_RDX => PD4
P1_9 => GND
P1_10 => 3.3V
P2_1_LCD_15_RESX => PE6
P2_2_LCD_10_DCX => PD13
P2_3_LCD_26_DB9 => PD15
P2_4_LCD_25_DB8 => PD14
P2_5_LCD_28_DB11 => PD1
P2_6_LCD_27_DB10 => PD0
P2_7_LCD_30_DB13 => PE8
P2_8_LCD_29_DB12 => PE7
P2_9_LCD_32_DB15 => PE10
P2_10_LCD_31_DB14 => PE9
ET4 Telegram Spanish Group Resources
ET4 Board and specs
- To the mates of the Telegram Anet ET4 spanish group, specially to @Solidnon, who lent his board for testing when the project was not even started.
- To @uwe and @mubes from Black Magic Probe team, and to Ebiroll (BMP/ESP32).
- To all contributors and testers of this branch and, specially, of Marlin master branch.
Additional documentation can be found at the Marlin Home Page. Please test this firmware and let us know if it misbehaves in any way. Volunteers are standing by!
Not for production use. Use with caution!
Marlin 2.0 takes this popular RepRap firmware to the next level by adding support for much faster 32-bit and ARM-based boards while improving support for 8-bit AVR boards. Read about Marlin's decision to use a "Hardware Abstraction Layer" below.
This branch is for patches to the latest 2.0.x release version. Periodically this branch will form the basis for the next minor 2.0.x release.
Download earlier versions of Marlin on the Releases page.
To build Marlin 2.0 you'll need Arduino IDE 1.8.8 or newer or PlatformIO. We've posted detailed instructions on Building Marlin with Arduino and Building Marlin with PlatformIO for ReArm (which applies well to other 32-bit boards).
Marlin 2.0 introduces a layer of abstraction so that all the existing high-level code can be built for 32-bit platforms while still retaining full 8-bit AVR compatibility. Retaining AVR compatibility and a single code-base is important to us, because we want to make sure that features and patches get as much testing and attention as possible, and that all platforms always benefit from the latest improvements.
| board | processor | speed | flash | sram | logic | fpu |
|---|---|---|---|---|---|---|
| Arduino AVR | ATmega, ATTiny, etc. | 16-20MHz | 64-256k | 2-16k | 5V | no |
| boards | processor | speed | flash | sram | logic | fpu |
|---|---|---|---|---|---|---|
| Arduino Due, RAMPS-FD, etc. | SAM3X8E ARM-Cortex M3 | 84MHz | 512k | 64+32k | 3.3V | no |
| board | processor | speed | flash | sram | logic | fpu |
|---|---|---|---|---|---|---|
| ESP32 | Tensilica Xtensa LX6 | 240MHz | --- | --- | 3.3V | --- |
| boards | processor | speed | flash | sram | logic | fpu |
|---|---|---|---|---|---|---|
| Re-ARM | LPC1768 ARM-Cortex M3 | 100MHz | 512k | 32+16+16k | 3.3-5V | no |
| MKS SBASE | LPC1768 ARM-Cortex M3 | 100MHz | 512k | 32+16+16k | 3.3-5V | no |
| Selena Compact | LPC1768 ARM-Cortex M3 | 100MHz | 512k | 32+16+16k | 3.3-5V | no |
| Azteeg X5 GT | LPC1769 ARM-Cortex M3 | 120MHz | 512k | 32+16+16k | 3.3-5V | no |
| Smoothieboard | LPC1769 ARM-Cortex M3 | 120MHz | 512k | 64k | 3.3-5V | no |
| boards | processor | speed | flash | sram | logic | fpu |
|---|---|---|---|---|---|---|
| Adafruit Grand Central M4 | SAMD51P20A ARM-Cortex M4 | 120MHz | 1M | 256k | 3.3V | yes |
| boards | processor | speed | flash | sram | logic | fpu |
|---|---|---|---|---|---|---|
| Arduino STM32 | STM32F1 ARM-Cortex M3 | 72MHz | 256-512k | 48-64k | 3.3V | no |
| Geeetech3D GTM32 | STM32F1 ARM-Cortex M3 | 72MHz | 256-512k | 48-64k | 3.3V | no |
| boards | processor | speed | flash | sram | logic | fpu |
|---|---|---|---|---|---|---|
| STEVAL-3DP001V1 | STM32F401VE Arm-Cortex M4 | 84MHz | 512k | 64+32k | 3.3-5V | yes |
| boards | processor | speed | flash | sram | logic | fpu |
|---|---|---|---|---|---|---|
| Teensy++ 2.0 | AT90USB1286 | 16MHz | 128k | 8k | 5V | no |
| boards | processor | speed | flash | sram | logic | fpu |
|---|---|---|---|---|---|---|
| Teensy 3.2 | MK20DX256VLH7 ARM-Cortex M4 | 72MHz | 256k | 32k | 3.3V-5V | yes |
| boards | processor | speed | flash | sram | logic | fpu |
|---|---|---|---|---|---|---|
| Teensy 3.5 | MK64FX512VMD12 ARM-Cortex M4 | 120MHz | 512k | 192k | 3.3-5V | yes |
| Teensy 3.6 | MK66FX1M0VMD18 ARM-Cortex M4 | 180MHz | 1M | 256k | 3.3V | yes |
| boards | processor | speed | flash | sram | logic | fpu |
|---|---|---|---|---|---|---|
| Teensy 4.0 | IMXRT1062 ARM-Cortex M7 | 600MHz | 1M | 2M | 3.3V | yes |
| Teensy 4.1 | IMXRT1062 ARM-Cortex M7 | 600MHz | 1M | 2M | 3.3V | yes |
Proposed patches should be submitted as a Pull Request against the (bugfix-2.0.x) branch.
- This branch is for fixing bugs and integrating any new features for the duration of the Marlin 2.0.x life-cycle.
- Follow the Coding Standards to gain points with the maintainers.
- Please submit your questions and concerns to the Issue Queue.
The current Marlin dev team consists of:
- Scott Lahteine [@thinkyhead] - USA Donate / Flattr:
- Roxanne Neufeld [@Roxy-3D] - USA
- Chris Pepper [@p3p] - UK
- Bob Kuhn [@Bob-the-Kuhn] - USA
- João Brazio [@jbrazio] - Portugal
- Erik van der Zalm [@ErikZalm] - Netherlands
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.