Skip to content
My Account

Reference

LILYGO T-Display-S3 Pinout

The real pin reference for LILYGO's T-Display-S3: an ESP32-S3 board with a built-in 1.9-inch color LCD, two buttons, and battery-monitoring support.

1 min read

No ratings yet, be the first.

The T-Display-S3 is LILYGO’s ESP32-S3 board with a built-in 1.9-inch, 170×320 ST7789 color LCD wired straight to the board, no separate display module or wiring needed. Pin data below is sourced from LILYGO’s own GitHub repository for this board.

System-on-chip and board

Built on an ESP32-S3R8 (the PSRAM-equipped S3 variant): 16MB flash, 8MB octal PSRAM, plenty of headroom for a color UI. The onboard display uses an 8-bit parallel interface (not SPI), which is why it needs so many dedicated GPIOs, those pins aren’t available for your own use.

Built-in display pins

FunctionGPIO
Backlight38
Chip select (CS)6
Data/command (DC)7
Write (WR)8
Read (RD)9
Reset5
Data bus D0–D739–48
Peripheral power enable15

GPIO15 must be set HIGH in your code before the display (and other onboard peripherals) will work at all. This is the single most common “blank screen” mistake with this board.

Buttons, battery, and other interfaces

FunctionGPIO / pinNotes
Button 1 (BOOT)GPIO0Also the flashing boot-mode button
Button 2GPIO14General-purpose, no fixed function by default
Battery voltage (ADC)GPIO4Only reads correctly while USB-C is unplugged
I²C SCLGPIO17
I²C SDAGPIO18
Touch interruptGPIO16Header-exposed, not used by the onboard display itself
Touch resetGPIO21
VBUS header pin5V, present while USB-connected
VBAT header pin4.2V, from an attached LiPo battery
3V3 header pinRegulated output, 100mA maximum load

An optional expansion shield adds a microSD slot on GPIO11 (CMD), GPIO12 (CLK) and GPIO13 (D0), only relevant if you’ve fitted that shield.

Conclusion

The built-in display makes this a genuinely different board from a bare breakout, most of its GPIOs are already spoken for by the screen, plan your project’s wiring around what’s actually left rather than assuming the ESP32-S3’s full pin count is available. For a board with the same chip and no display, more free GPIOs, see the AI-S3.

Advertisement

Related

All guides

More guides

Keep building.

From ESP32 HomeKit accessories to Arduino and ATtiny reference guides, there’s more where this came from.

All guides