LilyGo T-Display-S3 AMOLED Touch Pinout
21 pins · 2.54 mm pitch
| Pin | GPIO | Labels | Status | Capabilities | Notes |
|---|---|---|---|---|---|
| 1 | - | 3V33.3V | power | - | 3.3V regulated output |
| 2 | - | GND | ground | - | Ground |
| 3 | - | VSYSVBUS | power | - | USB 5V / system power rail |
| 4 | 1 | IO1 | safe | adc · touch · pwm | Left header; ADC1_CH0, capacitive-touch capable |
| 5 | 2 | IO2SCL | safe | adc · touch · i2c · pwm | Left header; I2C SCL - shared with CST816 touch controller |
| 6 | 3 | IO3SDA | strapping | adc · touch · i2c · pwm | Left header; I2C SDA - shared with CST816 touch controller (strapping pin) |
| 7 | 10 | IO10SS | strapping | adc · touch · spi · pwm | Left header; default FSPI CS (SS), ADC1_CH9 |
| 8 | 11 | IO11MOSI | strapping | adc · touch · spi · pwm | Left header; default FSPI MOSI, ADC2_CH0 |
| 9 | 12 | IO12SCK | strapping | adc · touch · spi · pwm | Left header; default FSPI SCK, ADC2_CH1 |
| 10 | 13 | IO13MISO | strapping | adc · touch · spi · pwm | Left header; default FSPI MISO, ADC2_CH2 |
| 11 | 14 | IO14 | strapping | adc · touch · pwm | Left header; ADC2_CH3, capacitive-touch capable |
| 12 | 15 | IO15 | safe | adc · pwm | Left header; ADC2_CH4, U0RTS |
| 13 | 16 | IO16 | safe | adc · pwm | Left header; ADC2_CH5, U0CTS |
| 14 | 39 | IO39 | strapping | pwm | Right header; MTCK (JTAG) |
| 15 | 40 | IO40 | strapping | pwm | Right header; MTDO (JTAG) |
| 16 | 41 | IO41 | strapping | pwm | Right header; MTDI (JTAG) |
| 17 | 42 | IO42 | strapping | pwm | Right header; MTMS (JTAG) |
| 18 | 43 | IO43TX | uart | uart · i2c · pwm | Right header; UART0 TX (U0TXD), also on Qwiic/STEMMA QT I2C connector |
| 19 | 44 | IO44RX | uart | uart · i2c · pwm | Right header; UART0 RX (U0RXD), also on Qwiic/STEMMA QT I2C connector |
| 20 | 45 | IO45 | strapping | pwm | Right header; strapping pin |
| 21 | 46 | IO46 | strapping | pwm | Right header; strapping pin |
Start with these
4 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
14 pins · 10 things to knowIO3 Bootstrapping pin (controls JTAG signal source) Strapping
Sampled at reset to select JTAG interface (USB Serial/JTAG controller vs. external pins). Improper use can disable external JTAG or alter debug interface.
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)
IO39 JTAG test clock (MTCK); IO MUX alternates CLK_OUT3 and SUBSPICS1 (chip select on the alternative SUBSPI memory bus, unused on standard modules) JTAG
Default JTAG TCK - keep it free if you debug over JTAG. It is not a flash or PSRAM line on standard modules: those sit on GPIO26-37.
IO40 JTAG test data out pin (MTDO) JTAG
Default JTAG TDO output for debugging. Using it as GPIO will interfere with JTAG debugging functionality.
IO41 JTAG test data in pin (MTDI) JTAG
Default JTAG TDI input for debugging. Should be reserved for JTAG or left unused if JTAG is to remain available.
IO42 JTAG test mode select pin (MTMS) JTAG
Default JTAG TMS signal for debugging. Using this pin for other purposes will disable the JTAG interface (unless JTAG is rerouted to USB).
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.
IO45 Bootstrapping pin (selects VDD_SPI flash voltage) Strapping
Determines flash/PSRAM power voltage (3.3 V vs 1.8 V) at boot. Must match hardware configuration; using as GPIO can upset flash supply setting.
IO46 Bootstrapping pin (used with GPIO0 for boot mode; controls ROM log output) Strapping
Must be at a defined level during reset (with GPIO0) to select normal or download boot and UART/USB print mode. This pin is input-only (no output drive), so it should be left for its intended strapping function.
Across 21 pins (2.54 mm pitch), the LilyGo T-Display-S3 AMOLED Touch exposes 18 GPIO plus 3V3, GND and VSYS for power.
For peripherals, I²C is mapped to SDA on GPIO3 and SCL on GPIO2; the SPI bus (MOSI, MISO, SCK, SS) is broken out in full; TX/RX on GPIO43 and GPIO44 cover serial logging and flashing.
On the analog side there are 10 ADC-capable pins for sensors and battery monitoring, PWM on every GPIO and 8 capacitive-touch inputs.
If you want zero surprises, IO1, IO2, IO15 and IO16 are free of any such role - the safest first picks. 14 of the exposed pins carry boot-time or system duties on the ESP32-S3 (IO3, IO10, IO11 and 11 more).
Getting started
flash your first firmware in ~2 minutesBoard: ESP32S3 Dev Module USB CDC On Boot: Enabled Flash Size: 16MB (128Mb) 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_amoled_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 × 25.5 mm · vs other ESP32 chips →Dimensions
About this board
At its core is the ESP32-S3 - a dual-core Xtensa with vector extensions suited to AI workloads.
Expect to pay about $33.98 - above the ~$29 typical for ESP32-S3 boards.
Only 18 GPIO are left for your own hardware - the display and onboard peripherals claim the rest.
Onboard you'll find 8MB (OPI) PSRAM, an AMOLED 1.91" 240x536 display with touch, battery charging via JST 1.25 and Boot/Reset 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 AMOLED Touch is a cutting-edge development board featuring an ESP32-S3 chip with integrated WiFi and Bluetooth 5 capabilities. It boasts a 1.91-inch AMOLED display with a resolution of 536x240 pixels, driven by an RM67162 controller, offering vibrant visuals for embedded applications. Now featuring capacitive touch support for intuitive user interactions.
Where to buy
prices are typical street pricesResources
Similar boards
