1. Introduction
The LILYGO T-Beam is a versatile ESP32 development board designed for Internet of Things (IoT) and communication projects. It integrates an ESP32 dual-core processor, SX1262 LoRa wireless module, NEO-M8N GPS module, WiFi, and Bluetooth capabilities. This manual provides essential information for setting up, operating, and maintaining your T-Beam board.

2. Key Features
- Powerful Processor and Storage: Equipped with an ESP32 dual-core Xtensa LX6 processor, 8MB PSRAM, and 4MB SPI Flash for robust performance and ample storage.
- Clear Display: Features a 1.3-inch OLED display (SH1106 I2C driver) with three customizable buttons (IO36, IO39, IO25) for intuitive interaction.
- Seamless Connectivity: Supports 802.11 b/g/n WiFi up to 150 Mbps and Bluetooth 4.2 Classic and LE, with a 3D antenna soldered on the PCB for stable wireless connections.
- LoRa Communication: Utilizes the Semtech SX1262 transceiver for 433/868/915MHz LoRa radio communication with an IPEX antenna, offering +22 dBm high-efficiency PA and low RX current (4.6 mA).
- Accurate Positioning: Integrated Ublox NEO-M8N GNSS module with a ceramic antenna provides -167 dBm sensitivity and supports simultaneous use of GPS, GLONASS, BeiDou, and Galileo for precise location tracking.
- Convenient Debugging and Programming: Micro USB port with CH9102 chip facilitates easy debugging and programming.
- Powerful Power Management: AXP2101 Power Management Unit ensures efficient and stable operation, supporting 5V USB power and an 18650 battery (not supplied).

3. Technical Specifications
| Component | Detail |
|---|---|
| MCU | ESP32 dual-core Xtensa LX6 processor |
| Memory | 8MB PSRAM |
| Storage | 4MB SPI Flash |
| Display | 1.3-inch OLED (SH1106 I2C driver) with 3 buttons (IO36, IO39, IO25) |
| WiFi | 802.11 b/g/n up to 150 Mbps, 3D antenna on PCB |
| Bluetooth | 4.2 Classic and LE, 3D antenna on PCB |
| LoRa Transceiver | Semtech SX1262 via SPI interface |
| LoRa Frequencies | 433MHz, 868MHz, 915MHz (with IPEX antenna) |
| LoRa Power Output | +22 dBm High Efficiency PA |
| LoRa RX Current | 4.6 mA (Low Power) |
| GNSS Module | Ublox NEO-M8N with ceramic antenna |
| GNSS Sensitivity | -167 dBm |
| GNSS Support | GPS, GLONASS, BeiDou, Galileo (simultaneous use) |
| Debugging/Programming | Micro USB port with CH9102 chip |
| Power Management Unit | AXP2101 |
| Power Supply | 5V USB, 18650 battery (not supplied) |
| Supply Voltage | 5V |
| Type | Module |
| Origin | Mainland China |
| Condition | New |
Product Dimensions

4. What's in the Box?
Your LILYGO T-Beam package includes:
- 1 x T-Beam Module
- 1 x 1.3-inch OLED
- 1 x LoRa Antenna (IPEX)
- 2 x Male Pin headers
- 2 x Female Pin headers
⚠️ Product Notice:
- The screen of this product is not soldered to the T-Beam. Soldering is required for assembly.
- Product images are for reference only. Pins are not soldered upon dispatch. If soldering is required, please contact customer service.
5. Initial Setup
Follow these steps to prepare your T-Beam board for use:
- Solder the OLED Display: The 1.3-inch OLED display is not pre-soldered. Carefully solder the OLED module to the designated pins on the T-Beam board. Refer to the pinout diagram for correct orientation. If you are not comfortable with soldering, seek professional assistance.
- Attach LoRa Antenna: Connect the provided LoRa antenna to the IPEX connector on the T-Beam board. Ensure a secure connection.
- Power Supply: Connect the T-Beam board via the micro USB port to a 5V power source. Alternatively, insert an 18650 battery (not supplied) into the battery holder. Ensure the battery is correctly oriented according to polarity markings.
- Connect to Computer: For programming and debugging, connect the T-Beam board to your computer using a micro USB cable.


6. Pinout Diagram
Understanding the pinout is crucial for connecting external components and programming the T-Beam board. The following diagram illustrates the various GPIOs, power pins, and dedicated connections for LoRa and GPS modules.


7. Power Management
The T-Beam board incorporates the AXP2101 Power Management Unit (PMU) for efficient power distribution and battery charging. It supports two primary power sources:
- 5V USB: Connect a standard micro USB cable to power the board and charge an attached 18650 battery.
- 18650 Battery: The board includes a holder for an 18650 battery (not supplied). Ensure correct polarity when inserting the battery. The AXP2101 manages battery charging and discharge.
The board features LED indicators for charging status (LED1 - Charging Indicator) and working status (LED2 - Working Indicator).
8. Operating Instructions
8.1. Programming
The T-Beam board can be programmed using the Arduino IDE or ESP-IDF framework. Connect the board to your computer via the micro USB port. The CH9102 chip acts as a USB-to-serial converter.
For sample code and detailed programming guides, refer to the official LILYGO GitHub repository:
8.2. LoRa Communication
The integrated SX1262 LoRa module allows for long-range, low-power wireless communication. You will need to implement LoRaWAN or peer-to-peer LoRa protocols in your code. Ensure the LoRa antenna is securely connected for optimal performance.

8.3. GPS Functionality
The NEO-M8N GNSS module provides accurate positioning data. You can access GPS data through your programmed application. The module supports multiple satellite systems for enhanced accuracy.

8.4. OLED Display and Buttons
The 1.3-inch OLED display can be used to show sensor data, status information, or menu options. The three customizable buttons (IO36, IO39, IO25) can be programmed to interact with your application.

9. Maintenance
- Cleaning: Use a dry, soft cloth to clean the board. Avoid using liquids or solvents.
- Storage: Store the board in a dry, anti-static environment when not in use.
- Handling: Handle the board by its edges to avoid touching components, especially the sensitive antenna and display.
- Firmware Updates: Regularly check the LILYGO GitHub repository for firmware updates and improvements.
10. Troubleshooting
10.1. Common Issues
- Board not powering on with 18650 battery: Ensure the 18650 battery is fully charged and inserted with correct polarity. Some configurations might require a brief USB connection to initiate battery power if the battery was completely drained or newly inserted. Check the battery holder contacts for any obstructions.
- OLED display not working: Verify that the OLED display is correctly soldered to the board. Check for cold solder joints or incorrect pin connections. Ensure your code initializes the SH1106 I2C driver correctly.
- LoRa communication issues: Confirm the LoRa antenna is securely attached to the IPEX connector. Check your code for correct frequency settings (433/868/915MHz) and LoRa parameters. Ensure there are no physical obstructions for radio signals.
- GPS not acquiring a fix: Ensure the ceramic antenna is unobstructed and has a clear view of the sky. Allow sufficient time for the GPS module to acquire satellites, especially during the first use or after a long period of inactivity.
- Programming errors: Double-check your USB cable connection. Ensure the correct board and COM port are selected in your IDE. Install necessary drivers for the CH9102 chip if programming fails.
11. User Tips
- Software for GPS/LoRa: For GPS and LoRa applications, consider exploring open-source projects like 'Paxcounter' on GitHub. These often provide ready-to-use firmware and examples for common use cases.
- LoRaWAN Gateway: Any standard LoRaWAN gateway should be compatible with the T-Beam for receiving data from your LoRa nodes.
- Battery Choice: While the board supports 18650 batteries, consider using high-quality, protected cells for safety and longevity.
12. Warranty and Support
This product comes with a 1-year warranty from the date of purchase. For technical support, programming resources, and community discussions, please refer to the official LILYGO GitHub repository and community forums.
If you require further assistance or have specific questions regarding your product, please contact the seller or LILYGO customer service.