LilyGO T-Display ESP32 pinout

LilyGO T-Display (ESP32, 1,14″ ST7789), ESP32 (ESP32-D0WDQ6), 3.3 V logic, 25.09×51.49 mm, 24 pins

verified17.10.2026

Which LilyGO T-Display ESP32 pins are safe to use

Free to use

GPIO13, GPIO17, GPIO21, GPIO22, GPIO25-27, GPIO32, GPIO33

Use with care

  • GPIO2, GPIO12, GPIO15: strapping: the level at power-up selects the boot mode.
  • GPIO36-39: input only, no output and no pull-ups.

Important

  • 3.3 V logic, don't put 5 V on the GPIO.
  • Pin labels are printed on the back (the front is covered by the display).
  • The display uses GPIO4, 5, 16, 18, 19, 23: they are not broken out to the header. Use the TFT_eSPI library with the Setup25_TTGO_T_Display setup.
  • Buttons: GPIO0 (BOOT) and GPIO35. Battery voltage: GPIO34 via a divider, the divider is enabled by a high level on GPIO14.
  • 36, 37, 38, 39 are inputs only. 37 and 38 exist only on the bare ESP32-D0WDQ6 chip, boards with a WROOM module do not have them.
  • Strapping pins on the header: 2, 12, 15. Keep GPIO12 low at power-up.
  • Turn off the display backlight (GPIO4) in sleep mode, otherwise the battery drains in hours.
  • AP2112K-3.3 regulator (600 mA); the display backlight draws tens of mA, turn it off on battery (GPIO4).

Revisions and clones

  • T-Display S3 is a different board (ESP32-S3, 1.9″ display, 8-bit bus), the pins are different.
  • Newer boards have a CH9102F instead of the CP2104, the pins are the same.

All pins

LabelNumberFunctionsLimitsCheck
Gpin 24Groundverified
Gpin 23Groundverified
21GPIO21, pin 22interruptPWM (LEDC)I2C SDAnot 5 V tolerantverified
22GPIO22, pin 21interruptPWM (LEDC)I2C SCLnot 5 V tolerantverified
17GPIO17, pin 20interruptPWM (LEDC)UART2 TXnot 5 V tolerantverified
2GPIO2, pin 19interruptPWM (LEDC)ADC2_CH2TOUCH2RTC_GPIO12affects boot (strapping)ADC2 doesn't work with Wi-Fi onnot 5 V tolerantverified
15GPIO15, pin 18interruptPWM (LEDC)ADC2_CH3TOUCH3RTC_GPIO13HSPI CSJTAG MTDOaffects boot (strapping)ADC2 doesn't work with Wi-Fi onnot 5 V tolerantverified
13GPIO13, pin 17interruptPWM (LEDC)ADC2_CH4TOUCH4RTC_GPIO14HSPI MOSIJTAG MTCKADC2 doesn't work with Wi-Fi onnot 5 V tolerantverified
12GPIO12, pin 16interruptPWM (LEDC)ADC2_CH5TOUCH5RTC_GPIO15HSPI MISOJTAG MTDIaffects boot (strapping)ADC2 doesn't work with Wi-Fi onnot 5 V tolerantverified
Gpin 15Groundverified
Gpin 14Groundverified
3Vpin 133.3 Vpower inputpower outputverified
3Vpin 123.3 Vpower inputpower outputverified
36GPIO36, pin 11interruptADC1_CH0RTC_GPIO0SENSOR_VPinput onlynot 5 V tolerantverified
37GPIO37, pin 10interruptADC1_CH1RTC_GPIO1input onlynot 5 V tolerantverified
38GPIO38, pin 9interruptADC1_CH2RTC_GPIO2input onlynot 5 V tolerantverified
39GPIO39, pin 8interruptADC1_CH3RTC_GPIO3SENSOR_VNinput onlynot 5 V tolerantverified
32GPIO32, pin 7interruptPWM (LEDC)ADC1_CH4TOUCH9RTC_GPIO9XTAL_32K_P (32 kHz crystal)not 5 V tolerantverified
33GPIO33, pin 6interruptPWM (LEDC)ADC1_CH5TOUCH8RTC_GPIO8XTAL_32K_N (32 kHz crystal)not 5 V tolerantverified
25GPIO25, pin 5interruptPWM (LEDC)ADC2_CH8RTC_GPIO6DAC1ADC2 doesn't work with Wi-Fi onnot 5 V tolerantverified
26GPIO26, pin 4interruptPWM (LEDC)ADC2_CH9RTC_GPIO7DAC2ADC2 doesn't work with Wi-Fi onnot 5 V tolerantverified
27GPIO27, pin 3interruptPWM (LEDC)ADC2_CH7TOUCH7RTC_GPIO17ADC2 doesn't work with Wi-Fi onnot 5 V tolerantverified
Gpin 2Groundverified
5Vpin 15 Vpower inputpower outputverified

Sources

Every pin is verified against the manufacturer's documents.

Size: from the LilyGO KiCad footprint (silkscreen outline).

FAQ

Which LilyGO T-Display ESP32 pins are I2C, SPI and UART?
By default in arduino-esp32 (board "LilyGo T-Display"): I2C: SDA GPIO21, SCL GPIO22; SPI: MOSI GPIO23, MISO GPIO19, SCK GPIO18, SS GPIO5; UART: TX GPIO1, RX GPIO3.
Are the LilyGO T-Display ESP32 pins 5 V tolerant?
No. The logic is 3.3 V and the pins are not 5 V tolerant: use a divider or a level shifter for 5 V signals.
Does ADC2 on the LilyGO T-Display ESP32 work with Wi-Fi on?
No. ADC2 pins (GPIO2, GPIO12, GPIO13, GPIO15, GPIO25-27) can't read analog while Wi-Fi is on. With Wi-Fi, use GPIO32, GPIO33, GPIO36-39 for the ADC.

You might also need

Similar boards

Next

Need firmware or a device built on ESP32? I'll build it to order