1. Introduction
This document provides a guide for setting up the basic software development environment and operating the LILYGO® SoftRF T-Beam SUPREME ESP32-S3 LoRa Development Board. This board is designed for developing applications and can function independently.
The T-Beam SUPREME is a collaborative development board produced by LILYGO and SoftRF. The CORE is comprised of an ESP32-S3 microcontroller, a LoRa SX1262 module, and a GPS module (with the option of U-blox MAX-M10S-00B or L76K chip). The CORE can be replaced to suit various experimental requirements, with UBLOX and L76K versions currently available.
At its core, the module features the ESP32S3R8 chip, integrating Wi-Fi (2.4 GHz band) and Bluetooth 5.0 solutions on a single chip. It includes dual high-performance cores and versatile peripherals, providing a robust platform for efficient power usage, compact design, and security. This product is intended for verification test experiments as a development board module.
Note: Please ensure compliance with local wireless management regulations when purchasing and select a frequency that complies with local laws and regulations.


2. Setup
2.1. Preparation
To develop applications for the ESP32-S3, you will need the following:
- A PC loaded with either Windows, Linux, or Mac operating system.
- A toolchain to build the application for ESP32-S3.
- Arduino software, which contains the API for ESP32-S3 and scripts to operate the toolchain.
- CH9102 serial port driver.
- The ESP32-S3 board itself and a USB cable to connect it to the PC.
2.2. Download and Install Arduino Software (IDE)
The Arduino Software (IDE) is a cross-platform application written in Java, derived from the Processing programming language. It allows users to develop applications on Windows, Linux, or macOS. Windows 10 is recommended for optimal use.
- Download Arduino IDE: Visit the official Arduino website to download the software.
- Installation Steps (Windows Example):
During installation, select the components you wish to install. It is recommended to install Arduino software, USB driver, and create shortcuts.

2.3. Download Git
Download and install the Git.exe installation package from the official Git website.
2.4. Pre-build Configuration and Repository Cloning
- Right-click the Arduino icon and select "Open folder where".
- Navigate to the hardware folder.
- Right-click in the folder and select "Git Bash Here".
- In the Git Bash terminal, execute the following commands:
$ mkdir espressif
$ cd espressif
$ git clone --recursive https://github.com/espressif/arduino-esp32.git esp322.5. Connect the Board
Connect the ESP32-S3 board to your PC using a USB cable. Verify that the board is visible under a serial port and that serial communication is functional.
3. Operating Instructions
3.1. Test Demo (WiFiScan)
To test the basic functionality, you can use the WiFiScan example:
- In the Arduino IDE, go to
File >> Examples >> WiFi >> WiFiScan. - This will open the WiFiScan sketch.

3.2. Upload Sketch
Before uploading, ensure the correct board is selected:
- Go to
Tools >> Board >> ESP32S3 Dev Module. - Then, go to
Sketch >> Uploadto compile and flash the sketch to your board.
3.3. Serial Monitor
To view the output from your board, use the Serial Monitor:
- Go to
Tools >> Serial Monitor. - Ensure the baud rate matches your sketch (e.g., 115200 baud).

3.4. SSC Command Reference
Here are some common Wi-Fi commands to test the module:
| Command | Description | Example |
|---|---|---|
op | Set and query the Wi-Fi mode (STA, AP, STA+AP). | op -Q (Query mode)op -S -o wmode (Set mode) |
sta | Scan STA network interface, connect/disconnect AP, query status. | sta -S scan (Scan APs)sta -Q (Query status) |
ap | Set AP network interface parameters (SSID, password, encryption). | ap -S -s ssid -p password (Set AP)ap -Q (Show AP parameters) |
mac | Query the MAC address of the network interface. | mac -Q [-o mode] |
dhcp | Enable or disable DHCP server/client. | dhcp -S [-o mode] (Start DHCP)dhcp -Q [-o mode] (Show DHCP status) |
ip | Set and query the IP address of the network interface. | ip -Q [-o mode] (Show IP)ip -S [-i ip] (Set IP) |
reboot | Reboot the board. | reboot |
ram | Query the size of the remaining heap in the system. | ram |
4. Specifications
| Feature | Specification |
|---|---|
| MCU | ESP32-S3FN8 Dual-core LX7 microprocessor |
| Wireless Connectivity | 2.4 GHz Wi-Fi & Bluetooth 5 (LE) |
| Development Environment | Arduino, PlatformIO-IDE, Micropython |
| Onboard Functions | Boot (I000) + Reset + Power Button |
| Flash Memory | 8MB |
| PSRAM | 8MB |
| IMU | Six-axis IMU QMI8658 |
| OLED Display | 1.3 inch SH1106, Interface: I2C, Resolution: 128 x 64, SDA: I012, SCL: I013 |
| LoRa Module (Optional) | Type1: SX1262 (433/868/915MHz Baud) Type2: LR1121 (868/915 + 2.4GHz Baud) |
| GPS Module (Optional) | U-blox MAX-M10S-00B or L76K |
| Dimensions (WxHxD) | 114.6*28*33mm |
| Weight | 100g |


4.1. Product Pin Diagram



5. Maintenance
5.1. Battery Usage
For optimal power supply, it is recommended to use a standard length 18650 battery (18mm x 65mm) without a protection board (flat head).

5.2. General Care
- Keep the development board in a dry, static-free environment.
- Avoid exposing the board to extreme temperatures or humidity.
- Handle the board with care to prevent physical damage to components or connectors.
6. Troubleshooting
6.1. Common Issues
- No GPS Signal: If you experience issues with GPS signal acquisition, ensure that the antenna cable on the board is properly connected. A loose connection can prevent the GPS module from functioning correctly.
- Unresponsive Board: If the board is unresponsive after flashing or during operation, try re-flashing the firmware. If the issue persists, contact LILYGO customer support for assistance.
6.2. FCC Caution and Interference
Any changes or modifications not expressly approved by the party responsible for compliance could void the user's authority to operate the equipment. This device complies with part 15 of the FCC Rules. Operation is subject to the following two conditions: (1) This device may not cause harmful interference, and (2) this device must accept any interference received, including interference that may cause undesired operation.
This equipment generates, uses, and can radiate radio frequency energy. If not installed and used according to instructions, it may cause harmful interference to radio communications. If interference occurs, try the following measures:
- Reorient or relocate the receiving antenna.
- Increase the separation between the equipment and receiver.
- Connect the equipment into an outlet on a circuit different from that to which the receiver is connected.
- Consult the dealer or an experienced radio/TV technician for help.
6.3. FCC Radiation Exposure Statement
This equipment complies with FCC radiation exposure limits set forth for an uncontrolled environment. This equipment should be installed and operated with a minimum distance of 20cm between the radiator and your body.
7. User Tips
- Meshtastic Firmware: Many users have successfully flashed the latest Meshtastic firmware with no problems, reporting that GPS, Wi-Fi, and Bluetooth functions work well.
- GPS Performance: GPS lock times are generally fast, and the SX1262 radio performs consistently with strong, stable signals.
- Antenna Connection: Always double-check that the GPS and LoRa antenna cables are properly connected to avoid signal issues.
- LR1121 Version for Meshtastic: If you plan to use the board with Meshtastic, be aware that the LR1121 version may not be supported yet by the firmware. Verify compatibility before purchasing if Meshtastic is your primary use case.
- Build Quality: The board is noted for its solid feel and neatly arranged components, with a bright and easy-to-read OLED screen.
8. Warranty and Support
8.1. Official Support
For technical support and inquiries, please refer to the official LILYGO resources. The manufacturer is Shenzhen Xin Yuan Electronic Technology Co., Ltd.
8.2. Item Guides & Documents
A detailed user manual in PDF format is available for further reference:
8.3. Sample Code and Technical Resources
If you need technical support or sample code, please check the following GitHub links for more details: