Documentation

English

中文

English

中文

Appearance

T-Beam Supreme get it now ​

T-Beam Supreme front view
T-Beam Supreme physical image
T-Beam Supreme component overview

Overview ​

T-Beam-Supreme V3.0 is a high-performance multifunctional IoT development board based on the ESP32-S3FN8 dual-core processor, supporting Wi-Fi 802.11 b/g/n and Bluetooth 5.0. It integrates a SX1262 LoRa module (433/868/915/923 MHz), selectable MAX-M10S or L76K GPS module, 1.3-inch SH1106 OLED (128 × 64), AXP2101 power management, and onboard sensors including a six-axis IMU (QMI8658), environmental sensor (BME280), and magnetometer (QMC6309/6310). Equipped with 8 MB PSRAM and 8 MB Flash, TF card slot, QWIIC interface, and 3.7 V 18650 battery support.

Suitable for smart hardware, environmental monitoring, LoRa long-range communication, and IoT node development scenarios.

Quick Start ​

Example Support ​

ExamplePlatformIO/ArduinoESP-IDFDescription
LilyGo-LoRa-Series✓LoRa, GPS, OLED, Sensor examples
Available examples
./examples/
├── ArduinoLoRa          # SX1276/SX1278 only
├── GPS                  # TinyGPS, UBlox examples
├── LoRaWAN              # LMIC_Library_OTTA, RadioLib_OTAA
├── OLED                 # SH1106 display examples
├── PMU                  # Power management examples
├── RadioLibExamples     # SX1262/LR1121 Transmit/Receive
├── Sensor               # BME280, QMI8658, QMC6310, PCF8563
└── Factory              # Factory test examples

PlatformIO ​

  1. Install Visual Studio Code and Python
  2. Search for and install the PlatformIO IDE extension in VS Code
  3. After restarting VS Code, click File → Open Folder → select the LilyGo-LoRa-Series directory
  4. Wait for dependency libraries to install
  5. Open platformio.ini, under default_envs uncomment your board name
  6. Uncomment one src_dir = xxxx line (only one active at a time)
  7. Click ✓ to compile, then connect via USB-C and click → to upload

Arduino ​

  1. Install Arduino IDE
  2. Install Arduino ESP32
  3. Copy all folders from the lib directory to your Arduino libraries folder:
    • Windows: C:\Users\{Username}\Documents\Arduino
    • macOS: /Users/{Username}/Documents/Arduino
    • Linux: /home/{Username}/Arduino
  4. Open the example sketch from the examples directory
  5. In Tools → Board, configure:
Arduino IDE SettingValue
BoardESP32S3 Dev Module
PortYour port
USB CDC On BootEnable
CPU Frequency240MHZ(WiFi)
Core Debug LevelNone
USB DFU On BootDisable
Erase All Flash Before Sketch UploadDisable
Events Run OnCore1
Flash ModeQIO 80MHZ
Flash Size8MB(64Mb)
Arduino Runs OnCore1
USB Firmware MSC On BootDisable
Partition Scheme8M Flash(3M APP/1.5MB SPIFFS)
PSRAMQSPI PSRAM
Upload ModeUART0/Hardware CDC
Upload Speed921600
USB ModeCDC and JTAG
ProgrammerEsptool
  1. In utilities.h, uncomment your board model (T_BEAM_S3_SUPREME_SX1262 or T_BEAM_S3_SUPREME_LR1121)
  2. Click Upload

Development Platforms ​

  1. Arduino IDE
  2. PlatformIO
  3. ESP-IDF
  4. MicroPython

Video ​

Key Features ​

  • ESP32-S3FN8 dual-core LX7 @ 240 MHz, Wi-Fi + Bluetooth 5.0
  • SX1262 LoRa (433/868/915/923 MHz) or LR1121 (Sub-1G + 2.4G)
  • Selectable GPS: MAX-M10S (high accuracy) or L76K (cost-optimized)
  • 1.3-inch SH1106 OLED display (128 × 64)
  • Six-axis IMU: QMI8658
  • Environmental sensor: BME280 (temperature, humidity, pressure)
  • Magnetometer: QMC6309 / QMC6310U / QMC6310N
  • RTC: PCF85063ATL
  • AXP2101 power management, supports 3.7 V 18650 battery
  • 8 MB Flash + 8 MB PSRAM + TF card slot
  • QWIIC / STEMMA QT expansion interface

Product Parameters ​

FeatureSpecification
MCUESP32-S3FN8 @ Dual-core LX7, 240 MHz
Flash8 MB
PSRAM8 MB (QSPI)
Wi-Fi2.4 GHz 802.11 b/g/n
BluetoothBluetooth 5.0 LE
LoRaSX1262 (433/868/915/923 MHz) / LR1121
GPSMAX-M10S or L76K (selectable)
Display1.3-inch SH1106 OLED, 128 × 64, I2C
IMUQMI8658 (6-axis)
Environmental SensorBME280 (temperature / humidity / pressure)
MagnetometerQMC6309 / QMC6310U / QMC6310N
RTCPCF85063ATL (I2C)
Power ManagementAXP2101
USB Input3.9 V – 6 V (USB-C)
Battery3.7 V 18650
Storage ExpansionTF card slot
Dimensions114 × 33 × 28 mm

I2C Device Addresses ​

Device7-bit AddressBus
OLED (SH1106)0x3C / 0x3DI2C Bus 0
MAG (QMC6310U / QMC6310N)0x1C / 0x3CI2C Bus 0
MAG (QMC6309)0x7CI2C Bus 0
BME2800x77I2C Bus 0
RTC (PCF8563)0x51I2C Bus 1
PMU (AXP2101)0x34I2C Bus 1

AXP2101 Power Channels ​

ChannelPeripheral
DC1ESP32-S3
DC3 / DC4 / DC5External M.2 Socket
ALDO1BME280 + Display + MAG Sensor
ALDO2Sensor
ALDO3Radio
ALDO4GPS
BLDO1SD Card
BLDO2External pin header

GPS backup power is provided by the 18650 battery. Remove the battery and GPS hot start will not be available.

Pin Diagram ​

T-Beam Supreme pin diagram

Pin Mapping ​

Pin NameGPIOAvailable
Uart1 TX43 (QWIIC)✅
Uart1 RX44 (QWIIC)✅
I2C SDA17❌
I2C SCL18❌
SPI MOSI35❌
SPI MISO37❌
SPI SCK36❌
SD CS47❌
GNSS TX8❌
GNSS RX9❌
GNSS PPS6❌
GNSS Wake-up (L76K only)7❌
LoRa SCK12❌
LoRa MISO13❌
LoRa MOSI11❌
LoRa RESET5❌
LoRa DIO1/DIO91❌
LoRa BUSY4❌
LoRa CS10❌
IMU (QMI8658) CS34❌
IMU (QMI8658) INT33❌
RTC INT14❌
BOOT Button0❌
PMU IRQ40❌
PMU SDA42❌
PMU SCL41❌

Dimension Diagram ​

Schematic ​

Datasheet ​

Software Development ​

Dependent Libraries ​

FAQ ​

  • Q. How to choose between GPS module versions? A. MAX-M10S has higher accuracy and lower power consumption; L76K has better cost advantage. Choose based on positioning accuracy requirements and budget.

  • Q. LoRa communication distance is not ideal? A. Check antenna connection, ensure use in open environment, and adjust LoRa parameters (spreading factor, bandwidth, etc.).

  • Q. Battery life is short? A. Enable deep sleep mode, disable unused sensors and peripherals, and select low-power operation modes.

  • Q. Cannot flash the program? A. Ensure USB CDC On Boot is enabled. Hold the BOOT button and click RESET to enter download mode.

  • Q. T-Beam Supreme has three magnetometer variants? A. Yes: QMC6310N, QMC6310U, and QMC6309, each with a different I2C device address. Check the label on your board.

Version History ​

VersionRelease DateUpdate Description
T-Beam-Supreme V3.0—Initial release