Giter Club home page Giter Club logo

bigtreetech-touchscreenfirmware's Introduction

BigTreeTech Touchscreen Firmware

GitHub GitHub contributors GitHub Release Date Build Status

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

Table of Contents

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 three elements:

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

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

Copy

Place SD card with the BIGTREE_TFT*_V*.*.*.bin, theTFT* folder and the config.ini 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 ⚠️

Update Process shown on TFT Screen

A successful update looks like this on the screen:

Screenshot 2020-09-26 at 22 10 04

... and the name of the elements on the SD card changes to this:

After Update

⚠️ Errors during the update can not be ignored and must be solved before using the TFT ⚠️

After the update is done and the files are renamed, it is possible to reuse them again. To do so, change the name of the element(s) to the pre-update name and start the update process again.

Configuration

The Firmware can be configured using the config.ini file from from one of these folders: Copy to SD Card root directory to update or Copy to SD Card root directory to update - Unified Menu Material theme

Editing configuration (config.ini) file

To edit the config.ini file follow the instruction here: Detailed Instructions here

Updating Firmware Configuration

To update the Firmware configuration:

  1. Edit the settings in config.ini.
  2. Copy the config.ini file to the root of the SD card. (The SD card capacity should be less than or equal to 8GB and formatted as FAT32)
  3. Insert the SD card in the TFT's SD card slot and restart the TFT by pressing the reset buttion or disconnecting and connecting the power cable.
  4. The TFT will update and store the configuration form config.ini file.

The config.ini can be edited using a simple text editor (make sure to use UTF encoding) and uploaded again - without the need to upload the firmware or the TFT folder - as long as the firmware is the same version number.

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
    ;MKS_28_V1_0
    

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

bigtreetech-touchscreenfirmware's People

Contributors

3darena avatar acenotass avatar amp-man avatar antoszhun avatar arminth avatar bigtreetech avatar bryan065 avatar chzj333 avatar digant73 avatar geminiserver avatar guilouz avatar guruathwal avatar happycodingrobot avatar lt1010 avatar mak0t0san avatar mangavalk avatar mikey2692 avatar moimemeici avatar msq001 avatar oldman4u avatar radek8 avatar rebel1 avatar robbycandra avatar seangould avatar subcircuit avatar teknolim avatar thisiskeithb avatar traffic-light avatar unknownhero99 avatar wololo3d avatar

Watchers

 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.