LILYGO T-Beam 1W

Version History:

Purchase Links

Table of Contents

• Overview
• Functional Block Diagram
• Specifications
• Quick Start
• Pin Mapping
• Electrical Parameters
• Buttons and LED Description
• RF Parameters and Precautions
• FAQ
• Resource Downloads

Overview

T-Beam-1W is a high-performance IoT development board integrating ESP32-S3 dual-core processor, LoRa SX1262 module, GPS L76K positioning module, SH1106 OLED screen, and AXP2101 power management chip. Onboard TF card slot, QWIIC interface, external antenna interface, supporting Wi-Fi, Bluetooth 5.0 and LoRa communication, suitable for long-distance communication, positioning tracking, environmental monitoring, and other application scenarios.

Usage Notes:

1. This board does not charge external 7.4V batteries, only powered by batteries.
2. Always connect the antenna before transmission to avoid damaging the RF module.
3. GPIOs marked with * in the pin table are already connected to internal modules and cannot be reused.
4. The maximum output power of the RF module on this board is 32dBm.

Physical Image

Specifications

Quick Start

PlatformIO Environment Setup

1. Install Visual Studio Code and Python
2. Search for and install the PlatformIO plugin in Visual Studio Code extensions
3. After installation is complete, you need to restart Visual Studio Code
4. After restarting, select File -> Open Folder -> select the LilyGo-LoRa-Series directory
5. Wait for third-party dependency libraries to install
6. Click to open the platformio.ini file, under the platformio section
7. Under default_envs, select the development board name you want to use and uncomment it
8. Uncomment one line of src_dir = xxxx to ensure only one line is active. Please note the example comments, which explain which features are available and which are not.
9. Click the (✔) symbol at the bottom left to compile
10. Connect the development board to the computer using a USB-C cable (Micro-USB interface is for module firmware upgrade)
11. Click (→) to upload firmware
12. Click (plug symbol) to monitor serial output
13. If unable to write or USB device keeps flashing, please check the FAQ below

Arduino IDE Environment Setup

1. Install Arduino IDE
2. Install Arduino ESP32
3. Copy all folders in the lib directory to the Sketchbook location directory. To find your own library location, refer to: https://support.arduino.cc/hc/en-us/articles/4415103213714-Find-sketches-libraries-board-cores-and-other-files-on-your-computer

• Windows: C:\Users\{username}\Documents\Arduino
• macOS: /Users/{username}/Documents/Arduino
• Linux: /home/{username}/Arduino

4. Open the corresponding example

• Open the downloaded LilyGo-LoRa-Series
• Open examples
• Select the example file and open the file ending with ino

5. Select the corresponding development board in the Arduino IDE Tools menu, and click the corresponding option in the list below to select.

6. Please uncomment the utilities.h file of each sketch according to your board model (e.g., T_BEAM_1W), otherwise compilation will report an error
7. Upload the example

Pin Mapping

Note:

• LDO EN is the module internal enable pin, high level turns on Radio.
• LoRa Ctrl is the internal LNA control pin, high level during reception, low level during transmission/sleep.

Electrical Parameters

Tip: Recommended battery discharge capability ≥ 2A, otherwise high-power transmission may trigger protection.

Buttons and LED Description

Related Tests

Important Reminders:

1. Always connect the antenna before transmission.
2. Recommended PA stabilization time > 800us.
3. Switch RF Switch to TX channel in advance before transmission, otherwise PA may be damaged.

RF Block Diagram

VCC=+5V, 400M~520MHz module output power dBm and current

VCC=+5V, 830M~950MHz module output power dBm and current

FAQ

• Q. Why does the USB device keep flashing during flashing?
  A. Please check if the correct development board model is selected, and ensure the macro definition in utilities.h is enabled.

• Q. Why is the LoRa transmission distance very short?
  A. Please confirm that the antenna is connected, RF Switch is correctly switched, and output power is set reasonably.

• Q. Why does it not power on when using battery power?
  A. Please check if the battery voltage is around 7.4V and if the battery discharge capability is sufficient.

• Q. GPS positioning slow or no signal?
  A. Please ensure use in an outdoor open environment and check antenna connection.

• RF Block Diagram

Resource Downloads

• Schematic PDF
• SX1262 Datasheet
• AXP2101 Datasheet
• Example Code Repository