LilyGo T-Display-S3 Touch
by LilyGo
Similar to the T-Display-S3 but with a touch-enabled 1.9-inch display, enhancing interactivity for user interfaces.

On this page
LilyGo T-Display-S3 Touch Pinout
42 pins · 2.54 mm pitch| Pin | GPIO | Labels | Status | Capabilities | Notes |
|---|---|---|---|---|---|
| 1 | - | 3V3V3 | power | - | P2 header pin 12; 3.3V output from the AP2112K LDO (LilyGO: keep the load under 100mA) |
| 2 | 1 | IO1TOUCH1ADC1_CH0 | safe | adc · touch · pwm | P2 header pin 11; ADC1_CH0, capacitive touch |
| 3 | 2 | IO2TOUCH2ADC1_CH1 | safe | adc · touch · pwm | P2 header pin 10; ADC1_CH1, capacitive touch |
| 4 | 3 | IO3TOUCH3ADC1_CH2 | strapping | adc · touch · pwm | P2 header pin 9; ADC1_CH2, capacitive touch; ESP32-S3 strapping pin (JTAG source) |
| 5 | 10 | IO10SPI_CSTOUCH10ADC1_CH9 | strapping | adc · touch · pwm · spi | P2 header pin 8; FSPI CS, ADC1_CH9, capacitive touch |
| 6 | 11 | IO11SPI_DTOUCH11ADC2_CH0 | strapping | adc · touch · pwm · spi | P2 header pin 7; FSPI MOSI, ADC2_CH0, capacitive touch (SD CLK on the optional SD shield) |
| 7 | 12 | IO12SPI_CLKTOUCH12ADC2_CH1 | strapping | adc · touch · pwm · spi | P2 header pin 6; FSPI CLK, ADC2_CH1, capacitive touch (SD D0 on the optional SD shield) |
| 8 | 13 | IO13SPI_QTOUCH13ADC2_CH2 | strapping | adc · touch · pwm · spi | P2 header pin 5; FSPI MISO, ADC2_CH2, capacitive touch (SD CMD on the optional SD shield) |
| 9 | - | NC | - | P2 header pin 4; printed NC - the pad is not connected | |
| 10 | - | NC | - | P2 header pin 3; printed NC - the pad is not connected | |
| 11 | - | GND | ground | - | P2 header pin 2; ground |
| 12 | - | 5V | power | - | P2 header pin 1; +5V, the USB-C VBUS rail (input or output) |
| 13 | - | GND | ground | - | P1 header pin 12; ground |
| 14 | - | GND | ground | - | P1 header pin 11; ground |
| 15 | 43 | IO43U0TXDCLK_OUT1 | uart | uart · i2c · pwm | P1 header pin 10; default UART0 TX; also on the 4-pin JST-SH (G 3V 43 44), the STEMMA QT / Qwiic SDA position |
| 16 | 44 | IO44U0RXDCLK_OUT2 | uart | uart · i2c · pwm | P1 header pin 9; default UART0 RX; also on the 4-pin JST-SH (G 3V 43 44), the STEMMA QT / Qwiic SCL position |
| 17 | 18 | IO18SDAU1RXDADC2_CH7 | uart | adc · i2c · uart · pwm | P1 header pin 8; I2C SDA to the CST816 through the display FPC, 10K pull-up on the board - other I2C devices can share the bus, but not another use of the pin |
| 18 | 17 | IO17SCLU1TXDADC2_CH6 | uart | adc · i2c · uart · pwm | P1 header pin 7; I2C SCL to the CST816 through the display FPC, 10K pull-up on the board - other I2C devices can share the bus, but not another use of the pin |
| 19 | 21 | IO21TP_RST | safe | pwm | P1 header pin 6; CST816 reset (ESP_TP_RESET on the schematic) |
| 20 | 16 | IO16TP_INTADC2_CH5 | safe | adc · pwm | P1 header pin 5; CST816 interrupt (ESP_TP_INT), 100K pull-up on the board; ADC2_CH5 |
| 21 | - | NC | - | P1 header pin 4; printed NC - the pad is not connected | |
| 22 | - | GND | ground | - | P1 header pin 3; ground |
| 23 | - | GND | ground | - | P1 header pin 2; ground |
| 24 | - | 3V3V3 | power | - | P1 header pin 1; 3.3V output |
| 25 | 0 | IO0BOOT | strapping | pwm | the BOOT button beside the USB-C; strapping pin; reaches no header |
| 26 | 14 | IO14KEY | strapping | pwm | the IO14 user button on the other side of the USB-C (KEY on the schematic, 100K pull-up); reaches no header |
| 27 | 4 | IO4BAT_ADCADC1_CH3 | safe | adc | battery voltage through a 100K / 100K divider (read x2); LilyGO: reads only while USB is unplugged |
| 28 | 15 | IO15PWR_ON | safe | - | LCD / peripheral power enable: drive HIGH on battery or 5V-header power or the panel stays dark |
| 29 | 38 | IO38LCD_BL | safe | pwm | backlight enable into the AW9364 LED driver |
| 30 | 5 | IO5LCD_RES | safe | - | LCD reset |
| 31 | 6 | IO6LCD_CS | safe | - | LCD chip select (8080 parallel bus) |
| 32 | 7 | IO7LCD_DC | safe | - | LCD data / command |
| 33 | 8 | IO8LCD_WR | safe | - | LCD write strobe |
| 34 | 9 | IO9LCD_RD | strapping | - | LCD read strobe |
| 35 | 39 | IO39LCD_D0 | strapping | - | LCD data 0 |
| 36 | 40 | IO40LCD_D1 | strapping | - | LCD data 1 |
| 37 | 41 | IO41LCD_D2 | strapping | - | LCD data 2 |
| 38 | 42 | IO42LCD_D3 | strapping | - | LCD data 3 |
| 39 | 45 | IO45LCD_D4 | strapping | - | LCD data 4; strapping pin (VDD_SPI voltage) |
| 40 | 46 | IO46LCD_D5 | strapping | - | LCD data 5; strapping pin |
| 41 | 47 | IO47LCD_D6 | strapping | - | LCD data 6 |
| 42 | 48 | IO48LCD_D7 | strapping | - | LCD data 7 |
Start with these
2 pins with no boot or system involvementFreely assignable - no strapping, flash, USB or JTAG duties. Ideal first picks for buttons, sensors and LEDs.
Fine - with a little care
15 pins · 10 things to knowIO3 Bootstrapping pin (controls JTAG signal source) Strapping
Selects the JTAG interface (USB Serial/JTAG controller vs. external pins), but only once the EFUSE_STRAP_JTAG_SEL eFuse is burnt; until then it is ignored. No internal pull, floating by default.
IO10IO11IO12IO13IO14 General-purpose SPI2 (FSPI) IO MUX pins Other
IO MUX pin of the general-purpose SPI2 (FSPI) bus, not of the in-package flash - that sits on GPIO26-32. The datasheet lists it as a priority-2 pin ("can be freely used without restrictions"), so it is only taken if your board wires flash, an SD card or a display to FSPI.
- IO10General-purpose SPI2 (FSPI) IO MUX pin - chip select (FSPICS0)
- IO11General-purpose SPI2 (FSPI) IO MUX pin - data in (FSPID)
- IO12General-purpose SPI2 (FSPI) IO MUX pin - clock (FSPICLK)
- IO13General-purpose SPI2 (FSPI) IO MUX pin - data out (FSPIQ)
- IO14General-purpose SPI2 (FSPI) IO MUX pin - write-protect/data line (FSPIWP)
IO43 UART0 transmit pin (U0TXD), default serial console TX UART
Used for bootloader output and UART console logs. If repurposed, you will lose the default serial output (and programming via UART0).
IO44 UART0 receive pin (U0RXD), default serial console RX UART
Used for bootloader input (download mode via serial). If repurposed, you cannot use the default UART0 download mode for programming the chip.
IO18IO17 Used by the CST816 touch controller (I2C) onboard hardware
Wired to the CST816 touch controller (I2C) on this board. The pin is yours if you give that up, but nothing else can share it.
- IO18P1 header pin 8; I2C SDA to the CST816 through the display FPC, 10K pull-up on the board - other I2C devices can share the bus, but not another use of the pin
- IO17P1 header pin 7; I2C SCL to the CST816 through the display FPC, 10K pull-up on the board - other I2C devices can share the bus, but not another use of the pin
IO21 P1 header pin 6; CST816 reset (ESP_TP_RESET on the schematic) onboard hardware
Wired to the CST816 touch controller (reset) on this board. The pin is yours if you give that up, but nothing else can share it.
IO16 P1 header pin 5; CST816 interrupt (ESP_TP_INT), 100K pull-up on the board; ADC2_CH5 onboard hardware
Wired to the CST816 touch controller (interrupt) on this board. The pin is yours if you give that up, but nothing else can share it.
IO0 Bootstrapping pin (Chip boot mode selection) Strapping
Must be pulled high (default) or low (to enter UART download mode) at reset. Using it for other functions can interfere with boot mode configuration.
IO4 battery voltage through a 100K / 100K divider (read x2); LilyGO: reads only while USB is unplugged onboard hardware
Wired to the battery-voltage divider on this board. The pin is yours if you give that up, but nothing else can share it.
IO38 backlight enable into the AW9364 LED driver onboard hardware
Wired to the display backlight on this board. The pin is yours if you give that up, but nothing else can share it.
Only if you know the tricks
14 pins · 2 things to knowIO15 LCD / peripheral power enable: drive HIGH on battery or 5V-header power or the panel stays dark onboard hardware
Wired to the peripheral power switch on this board, which is soldered down. Driving it from your own code breaks that function.
IO5IO6IO7IO8IO9IO39IO40IO41IO42IO45IO46IO47IO48 Used by Display (ST7789) onboard hardware
Wired to Display (ST7789) on this board, which is soldered down. Driving it from your own code breaks that function.
- IO5LCD reset
- IO6LCD chip select (8080 parallel bus)
- IO7LCD data / command
- IO8LCD write strobe
- IO9LCD read strobe
- IO39LCD data 0
- IO40LCD data 1
- IO41LCD data 2
- IO42LCD data 3
- IO45LCD data 4; strapping pin (VDD_SPI voltage)
- IO46LCD data 5; strapping pin
- IO47LCD data 6
- IO48LCD data 7
The LilyGo T-Display-S3 Touch breaks out 42 pins in total: 31 GPIO for your project, with 3V, GND and 5V handling power.
Peripheral wiring is straightforward: I²C is mapped to SDA on GPIO18 and SCL on GPIO17.
Beyond plain digital I/O you get 11 ADC-capable pins for sensors and battery monitoring, PWM on 16 pins and 7 capacitive-touch inputs.
15 of the exposed pins carry boot-time or system duties on the ESP32-S3 (IO3, IO10, IO11 and 12 more) - check the guidance above before wiring anything to them. IO1 and IO2 are free of any such role - the safest first picks.
Getting started
flash your first firmware in ~2 minutesBoard: ESP32S3 Dev Module USB CDC On Boot: Enabled Flash Size: 16MB (128Mb) Flash Mode: DIO PSRAM: OPI PSRAM Partition Scheme: 16M Flash (3MB APP/9.9MB FATFS) Upload Speed: 921600
// toggle GPIO1 - wire an LED and resistor to it
void setup() {
pinMode(1, OUTPUT);
}
void loop() {
digitalWrite(1, HIGH); delay(500);
digitalWrite(1, LOW); delay(500);
}[env:lilygo_t_display_s3_touch]
platform = espressif32
board = esp32-s3-devkitc-1
framework = arduino
monitor_speed = 115200
upload_speed = 921600
board_build.arduino.memory_type = qio_opi
build_flags = -DBOARD_HAS_PSRAMesp32-s3-devkitc-1 - or type it after board =.esp32:
board: esp32-s3-devkitc-1
variant: esp32s3
framework:
type: esp-idf
psram:
mode: octal
speed: 80MHz
# blink - GPIO1
output:
- platform: gpio
pin: 1
id: led_out
light:
- platform: binary
name: "LED"
output: led_outesp32-s3-devkitc-1 (same ids as PlatformIO).esptool.py --chip esp32s3 --port /dev/ttyACM0 \
--baud 921600 write_flash 0x0 firmware.bin--port = your /dev/tty* (macOS/Linux) or COMx (Windows).Specifications
ESP32-S3 · 60.8 × 25.5 mm · vs other ESP32 chips →Dimensions
About this board
Inside sits the ESP32-S3 - a dual-core Xtensa with vector extensions suited to AI workloads.
At $35.00 it's on the expensive side for an ESP32-S3 board - most land around $29.
With 31 GPIO broken out, you get more pins to play with than most ESP32-S3 boards offer.
Around the module: 8MB (OPI) PSRAM, an LCD 1.9" 170x320 display with touch, a Qwiic connector, battery charging (TP4065) via JST-GH 1.25mm and Reset/Boot buttons.
It flashes over native USB - no serial-converter driver needed, which isn't a given among ESP32-S3 boards.
The LilyGo T-Display-S3 Touch is the touch version of the T-Display-S3: the same ESP32-S3 board and 1.9-inch LCD (170x320, ST7789V), with a CST816 capacitive touch panel on top. The touch glass is 32 mm wide, so it overhangs the 25.5 mm board by about 3 mm on each side.
The touch controller uses I2C on GPIO18 (SDA) and GPIO17 (SCL), with reset on GPIO21 and interrupt on GPIO16. These pins also stay on the header, so avoid them for other jobs if you use touch.
With WiFi 802.11 b/g/n and Bluetooth 5 (LE), it offers seamless wireless connectivity for IoT projects. Its 8MB PSRAM and 16MB Flash memory ensure ample storage and performance.
Designed with multiple GPIOs, PWM, ADC, I2C, and SPI support, it is suitable for various applications, including sensor interfacing, graphical user interfaces, and wireless communication.
Where to buy
prices are typical street prices
Resources
Similar boards




