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

LilyGo T-Beam Supreme Pinout

24 pins · 2.54 mm pitch
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)
1244RXDU1RXDuartuart · i2cUART1 RX; also on the external QWIIC socket, usable as I2C (left edge header)
1343TXDU1TXDuartuart · 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)
2038IO38safepwmGPIO38 (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)
12 GPIOs broken out 5 free · 7 need care · 0 to avoid

Start with these

5 pins with no boot or system involvement
SDAGPIO17SCLGPIO18IO38IO2IO21

Freely assignable - no strapping, flash, USB or JTAG duties. Ideal first picks for buttons, sensors and LEDs.

Fine - with a little care

7 pins · 7 things to know
RXDGPIO44 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.

TXDGPIO43 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).

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.

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.

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.

IO3 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.

IO48 Octal SPI differential clock negative leg (SPICLK_N_DIFF), used only by the 1.8 V octal flash/PSRAM variants Other

Only 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.

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-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.

7 of the exposed pins carry boot-time or system duties on the ESP32-S3 (RXD, TXD, IO46 and 4 more) - check the guidance above before wiring anything to them. SDA, SCL, IO38, IO2 and 1 more 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
GPIO17 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: "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
// toggle GPIO17 - wire an LED and resistor to it
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: esp32s3
  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 · vs other ESP32 chips →
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 · 2
PWM
8 channels
Power
USB
USB-C
Serial
Native (CDC)
Boot address
0x0
Electrical
Input
5V USB-C · 3.7V 18650 battery
Consumption
-
Regulator
-
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

Dimensions

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 $29.

Only 12 GPIO are broken out, where most ESP32-S3 boards manage about 23 - 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