This firmware is being put out as a courtesy for people who want to use the EZBoard in their custom printer. Setup and usage of this firmware is *not* covered under the technical support included with the EZBoard. Using the EZBoard in a custom printer is an advanced setup for users who know what they are doing.
EZFirmware Site #
This firmware can be used with our EZFirmware compile site. Just edit and upload the Configuration.h file to the config file upload page here: https://ezfirmware.th3dstudio.com/upload/. Editing this configuration the EZFirmware site is not and will not be added to the EZFirmware site as it is an advanced, non-supported configuration.
Compatible LCDs #
This firmware is set up to use specific LCDS
- Single Cable (EXP3) Creality LCD
- TH3D 12864 LCD with the Dual Cable LCD adapter board (standard version)
- BTT TFT35-E3 with serial+EXP3 plugs
- For the BTT TFT35-E3 wiring and warnings see our guide here: EZBoard – Lite V1.X – BTT TFT35-E3 Wiring and Firmware Setup
SD Card Slot #
Regardless if your LCD has an SD slot or not the onboard SD slot will always be the one used
Z Homing Direction #
This firmware only supports homing Z to the MIN position (not MAX) at this time.
Mounting the EZBoard #
The EZBoard is compatible, in terms of mounting, with the following board mounting holes/positions. This means that parts for these boards on places like Thingiverse will also work with the EZBoard.
- Creality V1.1.X
- Creality V2.X
- MKS E3P/E3D
- SKR E3 Mini Series (V1.0, V1.2, V1.3)
If you are looking for a generic mount, this is one we’ve used for builds. BTT SKR mini E3 V1.2 mounting plates by Speedy_67 – Thingiverse
Unified 2 DIY Firmware for EZBoard Lite V1 #
Using the Firmware #
Video Guide #
We now have a video guide you can follow as well.
Opening the firmware in Visual Studio Code #
Once the files are extracted you will need to open the folder in Visual Studio Code. You must open the folder named Firmware and not any other one. Failure to open the firmware at the correct folder level will result in it not working.
First time using our firmware or having issues? Watch our video that is intended to clear up common mistakes people make when opening and using the firmware here: Unified 2 VSCode Tips for Noobs | EZTip #8 – YouTube
Once the folder is opened, you will expand the Marlin folder on the left and side and then double click on the file called “Configuration.h”. This file is where you will set up the firmware for your specific printer.
Editing The Configuration.h File #
In the configuration.h file there are printer models you can uncomment to tell the firmware what machine you are setting it up for. Uncomment means removing the // in front of a setting and you will be left with #define XXXXXX if an option is enabled.
There are many other options in the firmware for setting up upgrades, tuning, and other features. Read through the files configuration section to see all the features we’ve put in the firmware for you.
We have an article here with more details about the use of the configuration.h file.
Testing the Firmware Settings #
Once you have all the options you want and your printer model setting uncommented now it’s time to make sure it compiles with no issues. To do that just click the ✓ at the bottom-left of Visual Studio Code and it will build the firmware.
If the build succeeds it is ready for you to upload to your printer. You will know if it was successfully built because it will show a SUCCESS in green at the bottom of the window in Visual Studio Code.
Flashing the Firmware #
Upload the firmware to your board (SD Card Method) #
Now that we have the firmware tested we can upload it to your printer. Your particular printer uses a SD Card to upload it to the printer board. The firmware will be in a folder that matches the CPU name in .pio > build > CPUNAME. There will only be ONE folder in the Build folder so you just open that folder. Your folder name may be different from the picture shown below. You can open the folder by right-clicking on the folder for your board’s CPU and clicking “Reveal in File Explorer”.
Different printers/boards will have different .bin file names but they will all end in the .bin file extension.
Once you locate the .bin file for your board copy this to your SD card. This SD card MUST be formatted with FAT or FAT32 file system and most boards prefer a 4096 allocation byte size. Smaller cards (16GB or less) are better to use than larger ones for the best compatibility.
Power off your printer and put the SD card into your printer’s SD slot. Turn the power on. This will cause the printer to flash the firmware from the SD card to your printer CPU. This may take up to 1 minute on some boards.
DO NOT UNPLUG THE PRINTER. Interrupting the flashing can “brick” your board and if this happens you will need to reflash the bootloader with a programmer before you can flash again.
When the printer boots you may see the TH3D logo on your LCD, printers with low-end CPUs may not show a TH3D logo but all will show a Marlin screen with TH3D Studio showing on the version information.
Reset your EEPROM! #
Make sure to reset your EEPROM on your printer after flashing any firmware. You can do this from your printer LCD by going to Configuration -> Reset EEPROM or by sending an M502 followed by M500 with your favorite Gcode sender application.