====== New TFT GUI for Meshtastic ======

There's an improved GUI for Meshtastic that is actually designed for larger touchscreen devices.

(FIXME add some screenshots and pictures)

Targeted devices:

  * Lilygo T-Deck/[[https://www.lilygo.cc/products/t-deck-plus|T-Deck Plus]]
  * Lilygo T-Watch
  * [[https://unphone.net/|unPhone]]
  * [[http://www.pemi.technology/ARMACHAT|ARMACHAT]]

Unfortunately, it takes over the channel used for the Bluetooth/Web UI so Bluetooth functionality is lost.

===== Download from GitHub CI =====

:!: Instructions no longer valid as image generation disabled :!:

Here's how to obtain and flash it:

  - You must be logged in on [[https://github.com/|GitHub]] for the download link to appear
  - [[https://github.com/meshtastic/firmware/pull/3259/checks|fancy T-Deck / T-Watch / unPhone / PICOmputer-S3 TFT screen #3259 → Checks]]
  - On the left sidebar, click **CI**
  - Scroll down to the **Artifacts (Produced during runtime)** section
  - Find the zip file for your particular device and click the download symbol to the right of it (if you don't see the download symbol, check that you are logged in)
  - Use the [[https://www.espressif.com/en/support/download/other-tools|Espressif Flash Download Tools]] to flash the extracted ''.bin'' file (not the ''-update.bin'')
    * ChipType: ESP32-S3, WorkMode: Develop, LoadMode: (any, I used USB)
    * First line is the .bin file, address @ 0x0
    * SPI SPEED: 80MHz; SPI MODE: QIO, BAUD: 921600 and don't forget to select the correct COM port

===== Build Firmware =====

==== Prerequisites ====

Instructions are written for [[https://docs.platformio.org/en/latest/core/installation/index.html|PlatformIO core]]. [[https://docs.platformio.org/en/latest/integration/ide/vscode.html#ide-vscode|The same build can be done in PlatformIO IDE for Visual Studio Code]] at the last step (i.e. after cloning the git repository and updating submodules).

==== Build ====

  - ''%%git clone --depth=1 --single-branch --branch tft-gui-work https://github.com/meshtastic/firmware.git meshtastic-firmware-tft-gui-work%%''
  - ''cd meshtastic-firmware-tft-gui-work''
  - ''git submodule init''
  - ''git submodule update''
  - ''pio run -e t-deck''
  - Follow same flashing instructions as for download, firmware is in ''./.pio/build/t-deck/firmware.bin''