LilyGo T-Beam Supreme

A development board combining ESP32-S3 with LoRa and GPS capabilities, ideal for tracking and remote sensing applications.

USB-C Native USB
LilyGo T-Beam Supreme board
114.6 × 28 mm
ESP32-S3
MCU
240MHz
clock
8MB
flash
512KB
SRAM
12· 2 ADC
GPIO
BLE 5.0+ WiFi
radio
On this page

Pinout

24 pins · 2.54 mm pitch
View:
LilyGo T-Beam Supreme pinout diagram
PinGPIOLabelsStatusCapabilitiesNotes
1-VBATpower-18650 battery input (left edge header)
2-VBUS5Vpower-5V input from USB-C (left edge header)
3-GNDground-Ground (left edge header)
4-VSYSpower-5V output, 500mA (left edge header)
5-GNDground-Ground (left edge header)
6-B-LDO2power-AXP2101 PMU rail B-LDO2, 0.5-3.3V programmable, 300mA (left edge header)
7-DC4power-AXP2101 PMU rail DC4, 0.6-1.84V, up to 2A (left edge header)
8-GNDground-Ground (left edge header)
9-DC5power-AXP2101 PMU power rail DC5, also feeds the M.2 socket (left edge header)
10-DC13V3power-AXP2101 3.3V rail, 500mA, also powers the ESP32-S3 (left edge header)
11-RSTcontrol-Reset / EN (left edge header)
1244RXDU1RXDstrappinguart · i2cUART1 RX; also on the external QWIIC socket, usable as I2C (left edge header)
1343TXDU1TXDstrappinguart · i2cUART1 TX; also on the external QWIIC socket, usable as I2C (left edge header)
1417SDAsafei2cShared I2C SDA (bus 0 with OLED, QMC6310 magnetometer, BME280) (right edge header)
1518SCLsafei2cShared I2C SCL (bus 0 with OLED, QMC6310 magnetometer, BME280) (right edge header)
16-A-LDO2power-AXP2101 PMU rail A-LDO2, 0.5-3.3V programmable, 300mA (right edge header)
1746IO46strappingpwmGPIO46 (strapping pin) (right edge header)
1845IO45strappingpwmGPIO45 (strapping pin) (right edge header)
1939IO39strappingpwmGPIO39 (right edge header)
2038IO38strappingpwmGPIO38 (right edge header)
212IO2safeadc · touch · pwmGPIO2, ADC1_CH1, touch capable (strapping pin) (right edge header)
223IO3strappingadc · touch · pwmGPIO3, ADC1_CH2, touch capable (strapping pin) (right edge header)
2321IO21safepwmGPIO21 (right edge header)
2448IO48strappingpwmGPIO48 (right edge header)

Start with these

4 pins with no boot or system involvement
SDASCLIO2IO21

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
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
TXDU0TXD (GPIO43)Used for bootloader output and UART console logs. If repurposed, you will lose the default serial output (and programming via UART0).Other
IO46GPIO46Must 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.Strapping
IO45GPIO45Determines 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.Strapping
IO39MTCK (GPIO39)Default JTAG debugging TCK pin. If JTAG is needed, this pin must be free; it may also be used internally for PSRAM chip select on certain modules, so avoid repurposing it.Other
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

Only if you know the tricks

wired to flash or USB - expect a fight
PinLabelWhat to knowRole
IO38FSPIWPOn flash-equipped chips, this pin is tied to the flash’s WP# (or D3) line. It should be avoided for other use, as it’s needed for flash operations.Flash
IO48SPICLK_NUsed only on variants with Octal SPI interface, as the negative leg of the differential clock&. On such chips it operates at 1.8 V; it should be avoided for GPIO to prevent conflicts with the octal flash/PSRAM clock.Flash
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-Beam Supreme breaks out 24 pins in total: 12 GPIO for your project, with VBAT , VBUS , GND , VSYS , B-LDO2 , DC4 , DC5 , DC1 and A-LDO2 handling…

The LilyGo T-Beam Supreme breaks out 24 pins in total: 12 GPIO for your project, with VBAT, VBUS, GND, VSYS, B-LDO2, DC4, DC5, DC1 and A-LDO2 handling power.

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

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

6 of the exposed pins carry boot-time or system duties on the ESP32-S3 (RXD, TXD, IO46 and 3 more) - check the guidance above before wiring anything to them. SDA, SCL, IO2 and IO21 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
The onboard LED on GPIO17 blinks - swap the pin if your board's LED differs.
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: "8MB (64Mb)"
Flash Mode: "DIO"
PSRAM: "QSPI PSRAM"
Partition Scheme: "8M with spiffs (3MB APP / 1.5MB SPIFFS)" (default)
Upload Speed: "921600"
▸ every other Tools option — leave at default
Board: ESP32S3 Dev Module
USB CDC On Boot: Enabled
Flash Size: 8MB (64Mb)
Flash Mode: DIO
PSRAM: QSPI PSRAM
Partition Scheme: 8M with spiffs (3MB APP / 1.5MB SPIFFS)
Upload Speed: 921600
Find it: Tools ▸ Board ▸ ESP32 Arduino ▸ ESP32S3 Dev Module
blink.ino Copy
// blink the onboard LED
void setup() {
  pinMode(17, OUTPUT);
}
void loop() {
  digitalWrite(17, HIGH); delay(500);
  digitalWrite(17, LOW);  delay(500);
}
board to selectesp32-s3-devkitc-1⧉ copy
platformio.ini Copy
[env:lilygo_t_beam_supreme]
platform = espressif32
board = esp32-s3-devkitc-1
framework = arduino
monitor_speed = 115200
upload_speed = 921600
board_build.arduino.memory_type = qio_qspi
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: lilygo_t_beam_supreme
  framework:
    type: esp-idf
psram:
  mode: quad
  speed: 80MHz

# blink - GPIO17
output:
  - platform: gpio
    pin: 17
    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 · 114.6 × 28 mm
Compute
MCU
ESP32-S3
Clock
240 MHz
SRAM · Flash
512 KB · 8MB · 8MB (QSPI) PSRAM
Radio
Wi-Fi
802.11 b/g/n
Bluetooth
5.0 LE
Antenna
External
I/O
GPIO · ADC
12 · 2
UART · I²C · SPI
3 · 2 · 4
PWM
8 channels
Power
USB
USB-C
Serial
Native (CDC)
Boot address
0x0
Display
Screen
OLED · 1.3" · 128x64
Driver
SH1106
Touch
No
Flashing
Upload · OTA
esptool_py · esp_ota
Flash · Boot mode
DIO · QIO
Sketch · Data
3 MB · 320 KB
28 mm114.6 mm
114.6 × 28 mm · pin pitch 2.54 mm
The LilyGo T-Beam Supreme 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 $49.99 it's on the expensive side for an ESP32-S3 board - most land around $30.

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

Around the module: 8MB (QSPI) PSRAM, an OLED 1.3" 128x64 display, a microSD slot, a Qwiic connector, LoRa (SX1262), GPS (u-blox MAX-M10S), a QMI8658 IMU, a PCF8563 RTC, an environmental sensor (BME280), battery charging (AXP2101) via 18650 holder and Reset/Boot/Power buttons.

It flashes over native USB - no serial-converter driver needed, which isn't a given among ESP32-S3 boards.


The LilyGo T-Beam Supreme is an advanced ESP32-S3-based development board designed for LoRa and GPS applications. It integrates an ESP32-S3 dual-core processor with WiFi and Bluetooth 5, offering seamless connectivity.

Featuring an onboard LoRa transceiver (SX1262), the T-Beam Supreme supports long-range communication at 433/868/915 MHz. It also includes an upgraded Ublox GPS module for enhanced location tracking capabilities.

The board is equipped with 8MB Flash and 8MB PSRAM, along with a 18650 Li-ion battery holder for portable applications, making it ideal for IoT, tracking, and telemetry projects.

  • 18650 Li-ion battery holder on the underside
  • QMC6310 3-axis magnetometer / e-compass
  • GPS variant: u-blox MAX-M10S or Quectel L76K
  • LoRa variant: SX1262 (sub-GHz) or LR1121 (multi-band)
  • SMA connector for external LoRa antenna

Where to buy

prices are typical street prices
LilyGo T-Beam Supreme
LilyGo T-Beam Supreme
$49.99per unit, typical

Resources

Similar boards