LilyGo T-Display-S3

An ESP32-S3 development board equipped with a 1.9-inch LCD color screen and two programmable buttons, suitable for display-based applications.

USB-C Native USB
LilyGo T-Display-S3 board
62.5 × 25.4 mm
ESP32-S3
MCU
240MHz
clock
16MB
flash
512KB
SRAM
13· 10 ADC
GPIO
BLE 5.0+ WiFi
radio
On this page

Pinout

20 pins · 2.54 mm pitch
View:
LilyGo T-Display-S3 pinout diagram
PinGPIOLabelsStatusCapabilitiesNotes
1-3V3V3power-Left header (P2); 3.3V output
21GPIO1TOUCH1ADC1_CH0safeadc · touch · pwmLeft header (P2); ADC1_CH0, capacitive touch
32GPIO2TOUCH2ADC1_CH1safeadc · touch · pwmLeft header (P2); ADC1_CH1, capacitive touch
43GPIO3TOUCH3ADC1_CH2strappingadc · touch · pwmLeft header (P2); ADC1_CH2, capacitive touch; ESP32-S3 strapping pin
510GPIO10SPI_CSADC1_CH9strappingadc · touch · pwm · spiLeft header (P2); FSPI CS, ADC1_CH9, touch
611GPIO11SPI_DADC2_CH0strappingadc · touch · pwm · spiLeft header (P2); FSPI MOSI, ADC2_CH0, touch
712GPIO12SPI_CLKADC2_CH1strappingadc · touch · pwm · spiLeft header (P2); FSPI CLK, ADC2_CH1, touch
813GPIO13SPI_QADC2_CH2strappingadc · touch · pwm · spiLeft header (P2); FSPI MISO, ADC2_CH2, touch
9-GNDground-Left header (P2)
10-5Vpower-Left header (P2); 5V (VBUS) input/output
11-GNDground-Right header (P1)
12-GNDground-Right header (P1)
1343GPIO43CLK_OUT1U0TXDstrappinguart · pwmRight header (P1); default UART0 TX; also on the bottom 4-pin JST
1444GPIO44CLK_OUT2U0RXDstrappinguart · pwmRight header (P1); default UART0 RX; also on the bottom 4-pin JST
1518GPIO18SDAU1RXDADC2_CH7uartadc · i2c · uart · pwmRight header (P1); board default I2C SDA (touch controller on Touch variant), ADC2_CH7
1617GPIO17SCLU1TXDADC2_CH6uartadc · i2c · uart · pwmRight header (P1); board default I2C SCL (touch controller on Touch variant), ADC2_CH6
1721GPIO21safepwmRight header (P1); general IO; touch-controller reset on Touch variant
1816GPIO16ADC2_CH5safeadc · pwmRight header (P1); ADC2_CH5; touch-controller INT on Touch variant
19-GNDground-Right header (P1)
20-3V3V3power-Right header (P1); 3.3V output

Start with these

6 pins with no boot or system involvement
GPIO1TOUCH1GPIO2TOUCH2GPIO18SDAGPIO17SCLGPIO21GPIO16ADC2_CH5

Freely assignable - no strapping, flash, USB or JTAG duties. Ideal first picks for buttons, sensors and LEDs.

Fine - with a little care

sampled at boot or shared with debug/serial
PinLabelWhat to knowRole
GPIO3GPIO3Sampled at reset to select JTAG interface (USB Serial/JTAG controller vs. external pins). Improper use can disable external JTAG or alter debug interface.Strapping
GPIO10FSPICS0IO 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.Other
GPIO11FSPIDIO 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.Other
GPIO12FSPICLKIO 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.Other
GPIO13FSPIQIO 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.Other
GPIO43U0TXD (GPIO43)Used for bootloader output and UART console logs. If repurposed, you will lose the default serial output (and programming via UART0).Other
GPIO44U0RXD (GPIO44)Used for bootloader input (download mode via serial). If repurposed, you cannot use the default UART0 download mode for programming the chip.Other
These are recommendations, not hard rules - with the right pull-ups, timing and boot-state awareness most pins can be made to work. When in doubt, start green.
Pinout notes The LilyGo T-Display-S3 pinout brings out 20 pins at a 2.54 mm pitch - 13 usable GPIO alongside the 3V, GND and 5V power rails. Peripheral wiring is…

The LilyGo T-Display-S3 pinout brings out 20 pins at a 2.54 mm pitch - 13 usable GPIO alongside the 3V, GND and 5V power rails.

Peripheral wiring is straightforward: I²C is mapped to SDA on GPIO18 and SCL on GPIO17.

Beyond plain digital I/O you get 10 ADC-capable pins for sensors and battery monitoring, PWM on every GPIO and 7 capacitive-touch inputs.

7 of the exposed pins carry boot-time or system duties on the ESP32-S3 (GPIO3, GPIO10, GPIO11 and 4 more) - check the guidance above before wiring anything to them. GPIO1, GPIO2, GPIO18, GPIO17 and 2 more are free of any such role - the safest first picks.

Getting started

flash your first firmware in ~2 minutes
Tool:
1
Connect over USB
Native USB - shows up as a port right away, no driver needed. Not detected? Hold BOOT while plugging in.
2
Match & flash
Set the Tools options shown, then click Upload.
3
Verify it runs
GPIO1 toggles - wire an LED and resistor to it, or change the pin to your board's own LED.
Set these in Tools · leave everything else at default
Arduino IDE 2.x - Tools Copy
Board: "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)" (default)
Upload Speed: "921600"
▸ every other Tools option - leave at default
Board: 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
Find it: Tools ▸ Board ▸ ESP32 Arduino ▸ ESP32S3 Dev Module
blink.ino Copy
// 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);
}
board to selectesp32-s3-devkitc-1⧉ copy
platformio.ini Copy
[env:lilygo_t_display_s3]
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_PSRAM
Find it: PlatformIO Home ▸ Boards, search esp32-s3-devkitc-1 - or type it after board =.
board to selectesp32-s3-devkitc-1⧉ copy
device.yaml Copy
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_out
Find it: search ESPHome's board list for esp32-s3-devkitc-1 (same ids as PlatformIO).
esptool doesn't pick board settings - a prebuilt .bin already has them baked in. This is just the raw flash command.
terminal Copy
esptool.py --chip esp32s3 --port /dev/ttyACM0 \
  --baud 921600 write_flash 0x0 firmware.bin
--port = your /dev/tty* (macOS/Linux) or COMx (Windows).
Build details: sketch space 3145728 B · data 327680 B · DIO

Specifications

ESP32-S3 · 62.5 × 25.4 mm · vs other ESP32 chips →
Compute
MCU
ESP32-S3
Clock
240 MHz
SRAM · Flash
512 KB · 16MB · 8MB (OPI) PSRAM
Radio
Wi-Fi
802.11 b/g/n
Bluetooth
5.0 LE
Antenna
PCB
I/O
GPIO · ADC
13 · 10
UART · I²C · SPI
3 · 2 · 2
PWM
8 channels
Power
USB
USB-C
Serial
Native (CDC)
Boot address
0x0
Display
Screen
LCD · 1.9" · 170x320
Driver
ST7789V
Touch
No
Flashing
Upload · OTA
esptool_py · esp_ota
Flash · Boot mode
DIO · QIO
Sketch · Data
3 MB · 320 KB
25.4 mm62.5 mm
62.5 × 25.4 mm · pin pitch 2.54 mm
The LilyGo T-Display-S3 uses esptool_py for firmware uploads, esp_ota for over-the-air (OTA) updates. Flash mode is DIO with QIO boot mode. The maximum sketch size is 3 MB with 320 KB available for data.

About this board

Inside sits the ESP32-S3 - a dual-core Xtensa with vector extensions suited to AI workloads.

At $23.00 it's cheaper than most ESP32-S3 boards, which usually run around $29.

Only 13 GPIO are broken out, where most ESP32-S3 boards manage about 22 - worth checking the pinout covers what you need.

Around the module: 8MB (OPI) PSRAM, an LCD 1.9" 170x320 display, a STEMMA QT connector, battery charging via JST-GH 1.25mm and Boot/Reset/IO14 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 is a powerful development board featuring an ESP32-S3 chip with integrated WiFi and Bluetooth 5 capabilities. Equipped with a 1.9-inch LCD (170x320) driven by an ST7789V controller, it provides a vibrant display for embedded applications.

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
LilyGo T-Display-S3
LilyGo T-Display-S3
$23.00per unit, typical
As an Amazon Associate, ESPboards earns from qualifying purchases.

Resources

Similar boards