LilyGo T4-S3

A versatile ESP32-S3 board by LilyGo, suitable for a wide range of IoT and embedded projects.

USB-C Native USB
LilyGo T4-S3 board
56 × 44 mm
ESP32-S3
MCU
240MHz
clock
16MB
flash
512KB
SRAM
16· 6 ADC
GPIO
BLE 5.0+ WiFi
radio
On this page

Pinout

20 pins
View:
LilyGo T4-S3 pinout diagram
PinGPIOLabelsStatusCapabilitiesNotes
1-3V33.3Vpower-3.3V power - 2x15 header and both Qwiic connectors
2-VBUS5Vpower-5V from USB-C (VBUS) - 2x15 header
3-BATVBATpower-Battery voltage (VBAT) - 2x15 header
4-GNDground-Ground - 2x15 header and both Qwiic connectors
51IO1SD_CSsafeadc · touch · spimicroSD chip select - 2x15 header (shared with microSD slot)
62IO2SD_MOSIsafeadc · touch · spimicroSD MOSI - 2x15 header (shared with microSD slot)
73IO3SD_SCKstrappingadc · touch · spimicroSD SCK - 2x15 header (shared with microSD slot)
84IO4SD_MISOsafeadc · touch · spimicroSD MISO - 2x15 header (shared with microSD slot)
96SDAIO6safeadc · touch · i2cI2C SDA - 2x15 header and Qwiic (shared with CST226SE touch and SY6970 PMU)
107SCLIO7safeadc · touch · i2cI2C SCL - 2x15 header and Qwiic (shared with CST226SE touch and SY6970 PMU)
1121IO21safe-Free GPIO - 2x15 header
1238IO38safe-Free GPIO - 2x15 header
1339IO39strapping-Free GPIO - 2x15 header
1440IO40strapping-Free GPIO - 2x15 header
1541IO41strapping-Free GPIO - 2x15 header
1642IO42strapping-Free GPIO - 2x15 header
1743TXDIO43strappinguartUART0 TX - 2x15 header and UART Qwiic connector
1844RXDIO44strappinguartUART0 RX - 2x15 header and UART Qwiic connector
1947IO47strapping-Free GPIO - 2x15 header
2048IO48strapping-Free GPIO - 2x15 header

Start with these

7 pins with no boot or system involvement
IO1SD_CSIO2SD_MOSIIO4SD_MISOSDAIO6SCLIO7IO21IO38

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
IO3GPIO3Sampled at reset to select JTAG interface (USB Serial/JTAG controller vs. external pins). Improper use can disable external JTAG or alter debug interface.Strapping
IO39MTCK (GPIO39)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.Other
IO40MTDO (GPIO40)Default JTAG TDO output for debugging. Using it as GPIO will interfere with JTAG debugging functionality.Other
IO41MTDI (GPIO41)Default JTAG TDI input for debugging. Should be reserved for JTAG or left unused if JTAG is to remain available.Other
IO42MTMS (GPIO42)Default JTAG TMS signal for debugging. Using this pin for other purposes will disable the JTAG interface (unless JTAG is rerouted to USB).Other
TXDU0TXD (GPIO43)Used for bootloader output and UART console logs. If repurposed, you will lose the default serial output (and programming via UART0).Other
RXDU0RXD (GPIO44)Used for bootloader input (download mode via serial). If repurposed, you cannot use the default UART0 download mode for programming the chip.Other
IO47SPICLK_POnly the 1.8 V octal parts (ESP32-S3R8V, ESP32-S3R16V) run the differential memory clock here, and on those the pin works at 1.8 V instead of 3.3 V. On the common 3.3 V modules it is a normal GPIO - several devkits drive their RGB LED from GPIO48.Other
IO48SPICLK_NOnly the 1.8 V octal parts (ESP32-S3R8V, ESP32-S3R16V) run the differential memory clock here, and on those the pin works at 1.8 V instead of 3.3 V. On the common 3.3 V modules it is a normal GPIO - several devkits drive their RGB LED from GPIO48.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 T4-S3 breaks out 20 pins in total: 16 GPIO for your project, with 3V3, VBUS, BAT and GND handling power. For peripherals, I²C is mapped to SDA on…

The LilyGo T4-S3 breaks out 20 pins in total: 16 GPIO for your project, with 3V3, VBUS, BAT and GND handling power.

For peripherals, I²C is mapped to SDA on GPIO6 and SCL on GPIO7.

On the analog side there are 6 ADC-capable pins for sensors and battery monitoring and 6 capacitive-touch inputs.

If you want zero surprises, IO1, IO2, IO4, SDA and 3 more are free of any such role - the safest first picks. 9 of the exposed pins carry boot-time or system duties on the ESP32-S3 (IO3, IO39, IO40 and 6 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_t4_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 · 56 × 44 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
u.FL
I/O
GPIO · ADC
16 · 6
UART · I²C · SPI
3 · 2 · 2
PWM
8 channels
Power
USB
USB-C
Serial
Native (CDC)
Boot address
0x0
Display
Screen
AMOLED · 2.41" · 450x600
Driver
RM690B0
Touch
CST226SE
Flashing
Upload · OTA
esptool_py · esp_ota
Flash · Boot mode
DIO · QIO
Sketch · Data
3 MB · 320 KB
44 mm56 mm
56 × 44 mm
The LilyGo T4-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

At its core is the ESP32-S3 - a dual-core Xtensa with vector extensions suited to AI workloads.

Expect to pay about $58.99 - above the ~$29 typical for ESP32-S3 boards.

Only 16 GPIO are left for your own hardware - the display and onboard peripherals claim the rest.

Onboard you'll find 8MB (OPI) PSRAM, an AMOLED 2.41" 450x600 display with touch, battery charging (SY6970) via JST 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 T4-S3 is an ESP32-S3-based development board designed for high-performance IoT applications. Featuring a large 2.41-inch AMOLED display and low-power consumption, it is ideal for smart display projects.

With WiFi 802.11 b/g/n and Bluetooth 5 (LE), it supports seamless wireless communication, making it perfect for remote monitoring and embedded systems.

The T4-S3 comes with 8MB PSRAM and 16MB Flash, providing ample memory for complex applications.

Where to buy

prices are typical street prices
LilyGo T4-S3
LilyGo T4-S3
$58.99per unit, typical

Resources

Similar boards