LilyGo T-Display-S3 AMOLED
by LilyGo
An upgraded version of the T-Display-S3 with a 1.91-inch AMOLED screen, offering improved resolution and color vibrancy.

On this page
LilyGo T-Display-S3 AMOLED Pinout
43 pins · 2.54 mm pitch| Pin | GPIO | Labels | Status | Capabilities | Notes |
|---|---|---|---|---|---|
| 1 | - | 3V3 | power | - | Left header; 3.3V regulator (RT9080) output |
| 2 | 1 | IO1 | safe | adc · touch · pwm | Left header; ADC1_CH0, TOUCH1 |
| 3 | 2 | IO2 | safe | adc · touch · pwm | Left header; ADC1_CH1, TOUCH2 |
| 4 | 3 | IO3 | strapping | adc · touch · pwm | Left header; ADC1_CH2, TOUCH3 |
| 5 | 10 | IO10FSPICS0 | strapping | adc · touch · spi · pwm | Left header; ADC1_CH9, TOUCH10, default FSPI CS |
| 6 | 11 | IO11FSPID | strapping | adc · touch · spi · pwm | Left header; ADC2_CH0, TOUCH11, default FSPI MOSI |
| 7 | 12 | IO12FSPICLK | strapping | adc · touch · spi · pwm | Left header; ADC2_CH1, TOUCH12, default FSPI SCK |
| 8 | 13 | IO13FSPIQ | strapping | adc · touch · spi · pwm | Left header; ADC2_CH2, TOUCH13, default FSPI MISO |
| 9 | 14 | IO14FSPIWP | strapping | adc · touch · spi · pwm | Left header; ADC2_CH3, TOUCH14, default FSPI WP |
| 10 | 15 | IO15U0RTS | uart | adc · uart · pwm | Left header; ADC2_CH4, UART0 RTS |
| 11 | - | GND | ground | - | Left header ground |
| 12 | - | VSYS | power | - | Left header; VSYS - USB 5V or the LiPo, each through a DSK24 Schottky (D2 / D3), so about 0.3 V below either; LilyGO's pinout image calls it VBUS, the silk and schematic VSYS |
| 13 | - | VSYS | power | - | Left header; VSYS, the same rail as L12 |
| 14 | 16 | IO16U0CTS | uart | adc · uart · pwm | Left header; ADC2_CH5, UART0 CTS |
| 15 | - | GND | ground | - | Right header ground |
| 16 | - | GND | ground | - | Right header ground |
| 17 | 46 | IO46 | strapping | pwm | Right header; strapping pin |
| 18 | 45 | IO45 | strapping | pwm | Right header; strapping pin (VDD_SPI select) |
| 19 | 44 | IO44RXU0RXD | uart | uart · i2c · pwm | Right header; UART0 RX, also on the 4-pin JST SH socket (silk G 3V3 43 44 - UART0, not I2C) |
| 20 | 43 | IO43TXU0TXD | uart | uart · i2c · pwm | Right header; UART0 TX, also on the 4-pin JST SH socket (silk G 3V3 43 44 - UART0, not I2C) |
| 21 | 42 | IO42MTMS | strapping | pwm | Right header; JTAG MTMS |
| 22 | 41 | IO41MTDI | strapping | pwm | Right header; JTAG MTDI |
| 23 | 40 | IO40MTDO | strapping | pwm | Right header; JTAG MTDO |
| 24 | - | GND | ground | - | Right header ground |
| 25 | - | GND | ground | - | Right header ground |
| 26 | - | 3V3 | power | - | Right header; 3.3V output |
| 27 | - | 3V3 | power | - | Right header; 3.3V output |
| 28 | 39 | IO39MTCK | strapping | pwm | Right header; JTAG MTCK |
| 29 | 0 | IO0GPIO0BOOT | strapping | pwm | the BOOT button beside the USB-C on the display face; strapping pin; reaches no header |
| 30 | 21 | IO21GPIO21KEY | safe | pwm | the IO21 user key beside the USB-C (10K pull-up, R13); reaches no header |
| 31 | 4 | IO4GPIO4BAT_VOLT | safe | adc | battery voltage through a 10K / 10K divider (R15 / R16), ADC1_CH3; reaches no header |
| 32 | 38 | IO38GPIO38LED | safe | pwm | green LED D1 through 2K (R10), on the display face beside the USB-C; reaches no header |
| 33 | 6 | IO6GPIO6LCD_CS | safe | spi | AMOLED QSPI chip select |
| 34 | 47 | IO47GPIO47LCD_SCK | strapping | spi | AMOLED QSPI clock |
| 35 | 18 | IO18GPIO18LCD_D0 | safe | spi | AMOLED QSPI data 0 (MOSI in SPI mode) |
| 36 | 7 | IO7GPIO7LCD_D1 | safe | spi | AMOLED QSPI data 1 (DC in SPI mode) |
| 37 | 48 | IO48GPIO48LCD_D2 | strapping | spi | AMOLED QSPI data 2 |
| 38 | 5 | IO5GPIO5LCD_D3 | safe | spi | AMOLED QSPI data 3 |
| 39 | 17 | IO17GPIO17LCD_RST | safe | - | AMOLED reset |
| 40 | 9 | IO9GPIO9LCD_TE | strapping | - | AMOLED tearing-effect output |
| 41 | 8 | IO8GPIO8LCD_SDO | safe | spi | AMOLED serial data out (read-back) |
| 42 | 19 | IO19GPIO19USB_D- | uart | - | native USB D- to the USB-C |
| 43 | 20 | IO20GPIO20USB_D+ | uart | - | native USB D+ to the USB-C |
Start with these
5 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
17 pins · 13 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)
IO46 Bootstrapping pin (used with GPIO0 for boot mode; controls ROM log output) Strapping
Must be LOW (its default pull-down) with GPIO0 LOW to enter download mode, and sets the ROM log together with an eFuse. This pin is input-only (no output drive), so it should be left for its intended strapping function.
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.
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.
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).
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).
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.
IO40 JTAG test data out pin (MTDO) JTAG
Default JTAG TDO output for debugging. Using it as GPIO will interfere with JTAG debugging functionality.
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.
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 10K / 10K divider (R15 / R16), ADC1_CH3; reaches no header 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 green LED D1 through 2K (R10), on the display face beside the USB-C; reaches no header onboard hardware
Wired to the green user LED on this board. The pin is yours if you give that up, but nothing else can share it.
Only if you know the tricks
11 pins · 2 things to knowIO6IO47IO18IO7IO48IO5IO17IO9IO8 Used by Display (RM67162 AMOLED) onboard hardware
Wired to Display (RM67162 AMOLED) on this board, which is soldered down. Driving it from your own code breaks that function.
- IO6AMOLED QSPI chip select
- IO47AMOLED QSPI clock
- IO18AMOLED QSPI data 0 (MOSI in SPI mode)
- IO7AMOLED QSPI data 1 (DC in SPI mode)
- IO48AMOLED QSPI data 2
- IO5AMOLED QSPI data 3
- IO17AMOLED reset
- IO9AMOLED tearing-effect output
- IO8AMOLED serial data out (read-back)
IO19IO20 Used by the USB-C (native USB) onboard hardware
Wired to the USB-C (native USB) on this board, which is soldered down. Driving it from your own code breaks that function.
- IO19native USB D- to the USB-C
- IO20native USB D+ to the USB-C
The LilyGo T-Display-S3 AMOLED breaks out 43 pins in total: 33 GPIO for your project, with 3V3, GND and VSYS handling power.
For peripherals, TX/RX on GPIO43 and GPIO44 cover serial logging and flashing.
On the analog side there are 11 ADC-capable pins for sensors and battery monitoring, PWM on 21 pins and 8 capacitive-touch inputs.
If you want zero surprises, IO1, IO2, IO15, IO16 and 1 more are free of any such role - the safest first picks. 17 of the exposed pins carry boot-time or system duties on the ESP32-S3 (IO3, IO10, IO11 and 14 more).
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_amoled]
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 · 58.78 × 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 $32.50 - in line with other ESP32-S3 boards.
33 GPIO are broken out - more than most ESP32-S3 boards, so the pin budget is rarely the constraint.
Onboard you'll find 8MB (OPI) PSRAM, an AMOLED 1.91" 536x240 display, battery charging (TP4065) via JST 1.25mm and Reset/Boot/IO21 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 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.
With support for WiFi 802.11 b/g/n and Bluetooth 5 (LE), it ensures seamless wireless connectivity for IoT projects. The board is equipped with 8MB PSRAM and 16MB Flash memory, providing 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.
This page shows the original board (the user key on GPIO21, the green LED on GPIO38). LilyGo now also ships a Basic version on its newer, shorter PCB: that is the T-Display-S3 AMOLED Touch board without the touch panel, where GPIO21 and GPIO38 do different jobs - check which PCB you have before wiring.
Where to buy
prices are typical street prices
Resources
Similar boards




