WLED/usermods/TTGO-T-Display
Def3nder c01dd232c5
FIX IR_PIN to IRPIN (#1394)
...in cfg.cpp the if statement used "IRPIN" (which is consistent to all other PIN names), but on the declaration-side "IR_PIN" was used.

Changed all occurences of "IR_PIN" to "IRPIN".
2020-11-29 20:47:13 +01:00
..
assets [ImgBot] Optimize images (#1238) 2020-10-09 12:48:19 +02:00
platformio_override.ini FIX IR_PIN to IRPIN (#1394) 2020-11-29 20:47:13 +01:00
README.md Updated Readme.md file (#965) 2020-06-05 14:22:03 +02:00
usermod.cpp New usermod to support the TTGO T-Display (ESP32 based board with integrated TFT display) (#957) 2020-05-30 09:22:31 +02:00

TTGO T-Display ESP32 with 240x135 TFT via SPI with TFT_eSPI

This usermod allows use of the TTGO T-Display ESP32 module with integrated 240x135 display for controlling WLED and showing the following information:

  • Current SSID
  • IP address if obtained
    • in AP mode and turned off lightning AP password is shown
  • Current effect
  • Current palette

Usermod based on a rework of the ssd1306_i2c_oled_u8g2 usermod from the WLED repo.

Hardware

Hardware

Github reference for TTGO-Tdisplay

Requirements

Functionality checked with:

  • TTGO T-Display
  • PlatformIO
  • Group of 4 individual Neopixels from Adafruit, and a full string of 68 LEDs.

Platformio Requirements

Platformio.ini changes

Under the root folder of the project, in the platformio.ini file, uncomment the TFT_eSPI line within the [common] section, under lib_deps:

# platformio.ini
...
[common]
...
lib_deps =
    ...
  #For use of the TTGO T-Display ESP32 Module with integrated TFT display uncomment the following line  
    #TFT_eSPI
...

Also, while in the platformio.ini file, you must change the environment setup to build for just the esp32dev platform as follows:

Comment out the line described below:

# Travis CI binaries (comment this out when building for single board)
; default_envs = travis_esp8266, esp01, esp01_1m_ota, travis_esp32

and UNCOMMENT the following line in the 'Single binaries' section:

default_envs = esp32dev

Save the platformio.ini file. Once this is saved, the required library files should be automatically downloaded for modifications in a later step.

Platformio_overrides.ini (added)

Copy the platformio_overrides.ini file which is contained in the usermods/TTGO-T-Display/ folder into the root of your project folder. This file contains an override that remaps the button pin of WLED to use the on-board button to the right of the USB-C connector (when viewed with the port oriented downward - see hardware photo).

TFT_eSPI Library Adjustments (board selection)

We need to modify a file in the TFT_eSPI library to select the correct board. If you followed the directions to modify and save the platformio.ini file above, the User_Setup_Select.h file can be found in the /.pio/libdeps/esp32dev/TFT_eSPI_ID1559 folder.

Modify the User_Setup_Select.h file as follows:

  • Comment out the following line (which is the 'default' setup file):
//#include <User_Setup.h>           // Default setup is root library folder
  • Uncomment the following line (which points to the setup file for the TTGO T-Display):
#include <User_Setups/Setup25_TTGO_T_Display.h>    // Setup file for ESP32 and TTGO T-Display ST7789V SPI bus TFT

Run the build and it should complete correctly. If you see a failure like this:

xtensa-esp32-elf-g++: error: wled00\wled00.ino.cpp: No such file or directory
xtensa-esp32-elf-g++: fatal error: no input files

Just try building again - I find that sometimes this happens on the first build attempt and subsequent attempts will build correctly.

Arduino IDE

  • UNTESTED