LILYGO SoftRF T-Beam-S3

Contents

LILYGO® SoftRF T-Beam SUPREME ESP32-S3 LoRa Development Board User Manual

Model: SoftRF T-Beam-S3

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.

LILYGO T-Beam SUPREME board with antenna
LILYGO® SoftRF T-Beam SUPREME ESP32-S3 LoRa Development Board with antenna.
Dimensions of LILYGO T-Beam SUPREME board
Dimensions of the T-Beam SUPREME board: L:114.6mm, H:28mm, W:33mm.

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.

  1. Download Arduino IDE: Visit the official Arduino website to download the software.
  2. 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.
Arduino IDE installation options
Arduino IDE installation options, showing components to select.

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

  1. Right-click the Arduino icon and select "Open folder where".
  2. Navigate to the hardware folder.
  3. Right-click in the folder and select "Git Bash Here".
  4. In the Git Bash terminal, execute the following commands:
$ mkdir espressif
$ cd espressif
$ git clone --recursive https://github.com/espressif/arduino-esp32.git esp32

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

  1. In the Arduino IDE, go to File >> Examples >> WiFi >> WiFiScan.
  2. This will open the WiFiScan sketch.
Arduino IDE WiFiScan example selection
Selecting the WiFiScan example in Arduino IDE.

3.2. Upload Sketch

Before uploading, ensure the correct board is selected:

  1. Go to Tools >> Board >> ESP32S3 Dev Module.
  2. Then, go to Sketch >> Upload to compile and flash the sketch to your board.

3.3. Serial Monitor

To view the output from your board, use the Serial Monitor:

  1. Go to Tools >> Serial Monitor.
  2. Ensure the baud rate matches your sketch (e.g., 115200 baud).
Arduino IDE Serial Monitor output
Example output from the Serial Monitor showing WiFi scan results.

3.4. SSC Command Reference

Here are some common Wi-Fi commands to test the module:

CommandDescriptionExample
opSet and query the Wi-Fi mode (STA, AP, STA+AP).op -Q (Query mode)
op -S -o wmode (Set mode)
staScan STA network interface, connect/disconnect AP, query status.sta -S scan (Scan APs)
sta -Q (Query status)
apSet AP network interface parameters (SSID, password, encryption).ap -S -s ssid -p password (Set AP)
ap -Q (Show AP parameters)
macQuery the MAC address of the network interface.mac -Q [-o mode]
dhcpEnable or disable DHCP server/client.dhcp -S [-o mode] (Start DHCP)
dhcp -Q [-o mode] (Show DHCP status)
ipSet and query the IP address of the network interface.ip -Q [-o mode] (Show IP)
ip -S [-i ip] (Set IP)
rebootReboot the board.reboot
ramQuery the size of the remaining heap in the system.ram

4. Specifications

FeatureSpecification
MCUESP32-S3FN8 Dual-core LX7 microprocessor
Wireless Connectivity2.4 GHz Wi-Fi & Bluetooth 5 (LE)
Development EnvironmentArduino, PlatformIO-IDE, Micropython
Onboard FunctionsBoot (I000) + Reset + Power Button
Flash Memory8MB
PSRAM8MB
IMUSix-axis IMU QMI8658
OLED Display1.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
Weight100g
T-Beam SUPREME V3 specifications
Detailed specifications for T-Beam SUPREME V3.
L76K GNSS vs Ublox GNSS comparison
Comparison of L76K and Ublox MAX-M10S-00B GNSS modules.

4.1. Product Pin Diagram

LILYGO T-Beam-S3Core PINMAP Front
Front view of the LILYGO T-Beam-S3Core PINMAP.
LILYGO SoftRF T-Beam-S3 SUPREME Pinout
Comprehensive pinout diagram for LILYGO SoftRF T-Beam-S3 SUPREME.
LILYGO SoftRF T-Beam-S3 SUPREME 2.4G Pinout
Comprehensive pinout diagram for LILYGO SoftRF T-Beam-S3 SUPREME 2.4G.

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

18650 battery recommendation
Note on using standard length 18650 batteries.

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:

Ask a question about this manual

Ask about setup, troubleshooting, compatibility, parts, safety, or missing instructions. Manuals+ will review the question and use this page’s manual context to help answer it.

After a successful submission, we securely hash the supplied account or form email before sending it to Microsoft Advertising for conversion attribution. Privacy details.