aureleduda / bigtreetech-touchscreenfirmware

support TFT35 V1.0/V1.1/V1.2/V2.0/V3.0, TFT28, TFT24 V1.1

BigTreeTech Touchscreen Firmware

Firmware for BigTreeTech's dual-mode touchscreen 3D printer controllers

Table of Contents

• Menus and Themes
• Update TFT Firmware
• Customization
  • Bootscreen and Icons
  • Firmware
• Troubleshooting
• Version History
• CNC Targeted Modifications

Menus and Themes

Classic Menu & Icon Theme	Unified Menu & Material Icon Theme
Use firmware, icons, and fonts from the Copy to SD Card root directory to update folder	Use firmware, icons, and fonts from the Copy to SD Card root directory to update - Unified Menu Material theme folder

Update TFT Firmware

TFT firmware updates are comprised of two parts:

1. The firmware binary (BIGTREE_TFT*_V*.*.*.bin). Example: BIGTREE_TFT35_V3.0.25.2.bin:
   • BIGTREE_TFT_35: model
   • V3.0: hardware version
   • 25.2: software version
2. Fonts and Icons (TFT* folder):
   • TFT*/font: fonts
   • TFT*/bmp: icons

Copy both the BIGTREE_TFT*_V*.*.*.bin and TFT* folder to the root of a blank SD card that is <8GB and formatted as FAT32:

Place SD card with BIGTREE_TFT*_V*.*.*.bin & TFT* folder into the TFT's SD card reader and power cycle your printer to start the update process.

⚠️ Failing to update your icons & fonts will result in missing icons and/or unreadable text ⚠️

Customization

Bootscreen and Icons

See Customization guides for detailed information.

Firmware

View full instructions

1. Setup Visual Studio Code with PlatformIO instructions
2. Click on the PlatformIO icon (①) and then click on Open Project (②):
3. Find the BIGTREETECH firmware source directory , then click Open:
4. After opening the project, edit platformio.ini and change the default_envs to one that matches your TFT model and version:

   ;BIGTREE_TFT35_V1_0
   ;BIGTREE_TFT35_V1_1
   ;BIGTREE_TFT35_V1_2
   ;BIGTREE_TFT35_V2_0
   ;BIGTREE_TFT35_V3_0
   ;BIGTREE_TFT35_E3_V3_0
   ;BIGTREE_TFT28_V1_0
   ;BIGTREE_TFT28_V3_0
   ;BIGTREE_TFT24_V1_1
   ;MKS_32_V1_4
   ;MKS_32_V1_4_NOBL
   [platformio]
   src_dir      = TFT
   boards_dir   = buildroot/boards
   default_envs = BIGTREE_TFT35_V3_0

5. Click the check mark (✓) at the bottom of VSCode or press Ctrl+Alt+B (Windows) / Ctrl+Option+B (macOS) to compile.

   

6. A BIGTREE_TFT*_V*.*.*.bin file will be generated in the hidden .pio\build\BIGTREE_TFT*_V*_* folder. Follow the update process outlined in the About TFT Firmware section above to update your TFT to the latest version.

Troubleshooting

To reset the TFT's touch screen calibration, create a blank file named reset.txt and place in root folder of the sd card. Insert the SD card into the TFT's SD card reader and power cycle your printer to start the reset process.

Version History

See BIGTREETECH-TouchScreenFirmware/releases for a complete version history.

CNC Targeted Modifications

1. Possibility to define CNC_MENU in Configuration.h in order to configure the SW for CNC purposes
2. Introduced new language and icons tags for CNC specific menu items (no impact on 3D printer tags)
3. Added some specific bitmaps (from BlomsD / MPCNC-TFT35-V2.0)
4. Introduced a new menu spindle.c in order to add spindle start/stop control
5. Removed Bed and Extruder Heating menu items from Mainpage.c
6. Forced configuration in order to remove persistent Bed/Extruder temperature indication on all the pages
7. Modified the Home menu in order to support G28 XY and G28 Z and Zero axes
8. Possibility to define CNC_LASER in configuration.h in order to introduce menù for laser management (instead of fan)

See:

1.TFT35 Home Menu (Home XY)

2.TFT35 Home Menu (Home Z - Zero 0)

3.TFT35 Home Spindle (Spindle ON/OFF)