LilyGo T-Display-S3 AMOLED

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

USB-C Native USB
LilyGo T-Display-S3 AMOLED board
58.78 × 25.5 mm
ESP32-S3
MCU
240MHz
clock
16MB
flash
512KB
SRAM
33· 11 ADC
GPIO
BLE 5.4+ WiFi
radio
On this page

LilyGo T-Display-S3 AMOLED Pinout

43 pins · 2.54 mm pitch
LilyGo T-Display-S3 AMOLED pinout diagram
PinGPIOLabelsStatusCapabilitiesNotes
1-3V3power-Left header; 3.3V regulator (RT9080) output
21IO1safeadc · touch · pwmLeft header; ADC1_CH0, TOUCH1
32IO2safeadc · touch · pwmLeft header; ADC1_CH1, TOUCH2
43IO3strappingadc · touch · pwmLeft header; ADC1_CH2, TOUCH3
510IO10FSPICS0strappingadc · touch · spi · pwmLeft header; ADC1_CH9, TOUCH10, default FSPI CS
611IO11FSPIDstrappingadc · touch · spi · pwmLeft header; ADC2_CH0, TOUCH11, default FSPI MOSI
712IO12FSPICLKstrappingadc · touch · spi · pwmLeft header; ADC2_CH1, TOUCH12, default FSPI SCK
813IO13FSPIQstrappingadc · touch · spi · pwmLeft header; ADC2_CH2, TOUCH13, default FSPI MISO
914IO14FSPIWPstrappingadc · touch · spi · pwmLeft header; ADC2_CH3, TOUCH14, default FSPI WP
1015IO15U0RTSuartadc · uart · pwmLeft header; ADC2_CH4, UART0 RTS
11-GNDground-Left header ground
12-VSYSpower-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-VSYSpower-Left header; VSYS, the same rail as L12
1416IO16U0CTSuartadc · uart · pwmLeft header; ADC2_CH5, UART0 CTS
15-GNDground-Right header ground
16-GNDground-Right header ground
1746IO46strappingpwmRight header; strapping pin
1845IO45strappingpwmRight header; strapping pin (VDD_SPI select)
1944IO44RXU0RXDuartuart · i2c · pwmRight header; UART0 RX, also on the 4-pin JST SH socket (silk G 3V3 43 44 - UART0, not I2C)
2043IO43TXU0TXDuartuart · i2c · pwmRight header; UART0 TX, also on the 4-pin JST SH socket (silk G 3V3 43 44 - UART0, not I2C)
2142IO42MTMSstrappingpwmRight header; JTAG MTMS
2241IO41MTDIstrappingpwmRight header; JTAG MTDI
2340IO40MTDOstrappingpwmRight header; JTAG MTDO
24-GNDground-Right header ground
25-GNDground-Right header ground
26-3V3power-Right header; 3.3V output
27-3V3power-Right header; 3.3V output
2839IO39MTCKstrappingpwmRight header; JTAG MTCK
290IO0GPIO0BOOTstrappingpwmthe BOOT button beside the USB-C on the display face; strapping pin; reaches no header
3021IO21GPIO21KEYsafepwmthe IO21 user key beside the USB-C (10K pull-up, R13); reaches no header
314IO4GPIO4BAT_VOLTsafeadcbattery voltage through a 10K / 10K divider (R15 / R16), ADC1_CH3; reaches no header
3238IO38GPIO38LEDsafepwmgreen LED D1 through 2K (R10), on the display face beside the USB-C; reaches no header
336IO6GPIO6LCD_CSsafespiAMOLED QSPI chip select
3447IO47GPIO47LCD_SCKstrappingspiAMOLED QSPI clock
3518IO18GPIO18LCD_D0safespiAMOLED QSPI data 0 (MOSI in SPI mode)
367IO7GPIO7LCD_D1safespiAMOLED QSPI data 1 (DC in SPI mode)
3748IO48GPIO48LCD_D2strappingspiAMOLED QSPI data 2
385IO5GPIO5LCD_D3safespiAMOLED QSPI data 3
3917IO17GPIO17LCD_RSTsafe-AMOLED reset
409IO9GPIO9LCD_TEstrapping-AMOLED tearing-effect output
418IO8GPIO8LCD_SDOsafespiAMOLED serial data out (read-back)
4219IO19GPIO19USB_D-uart-native USB D- to the USB-C
4320IO20GPIO20USB_D+uart-native USB D+ to the USB-C
33 GPIOs broken out 5 free · 17 need care · 11 to avoid

Start with these

5 pins with no boot or system involvement
IO1IO2IO15IO16IO21

Freely 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 know
IO3 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 know
IO6IO47IO18IO7IO48IO5IO17IO9IO8 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
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.

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 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_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_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 · 58.78 × 25.5 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.4 LE
Antenna
PCB
I/O
GPIO · ADC
33 · 11
UART · I²C · SPI
3 · 2 · 2
PWM
8 channels
Power
USB
USB-C
Serial
Native (CDC)
Boot address
0x0
Electrical
Input
5V USB · 3.7V LiPo
Consumption
-
Regulator
RT9080
Display
Screen
AMOLED · 1.91" · 536x240
Driver
RM67162
Touch
No
Flashing
Upload · OTA
esptool_py · esp_ota
Flash · Boot mode
DIO · QIO
Sketch · Data
3 MB · 320 KB

Dimensions

25.5 mm58.78 mm
58.78 × 25.5 mm · pin pitch 2.54 mm
The LilyGo T-Display-S3 AMOLED 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

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

Resources

Similar boards