LILYGO T-Beam V1.2

Contents

LILYGO® T-Beam V1.2 ESP32 LoRa Module User Manual

Model: T-Beam V1.2

1. Introduction

The LILYGO® T-Beam V1.2 is a versatile, low-power development board designed for advanced IoT applications. It integrates an ESP32 microcontroller, LoRa long-range communication, and GPS/GNSS capabilities, along with Wi-Fi and Bluetooth for short-range connectivity. This module is ideal for projects requiring robust wireless communication and precise location tracking.

The T-Beam V1.2 features an upgraded power management unit (PMU) to AXP2101 (replacing the AXP192), offering improved power efficiency. It also includes a reverse battery protection module for enhanced safety. Depending on the version, it supports various LoRa frequencies (433MHz, 868MHz, 915MHz, 923MHz) and GPS/GNSS modules (NEO-6M or NEO-M8N).

2. Specifications

2.1. T-Beam V1.2 Core Specifications

T-Beam V1.2 Specifications

Image: T-Beam V1.2 Specifications including MCU, Flash, PSRAM, Driver, Wireless protocol, PMU, Onboard functions, and Power Supply Mode.

  • MCU: ESP32
  • Flash: 4MB
  • PSRAM: 8MB
  • Serial Chip Driver: CH9102F
  • Wireless Protocol: Wi-Fi + Bluetooth 4.2
  • PMU: AXP2101 (Note: Older versions may have AXP192; new versions will be AXP2101)
  • Onboard Functions: 3 Buttons (Power, IO38, Reset)
  • Power Supply Mode: Support USB / 18650 battery
  • Package: Yes
  • High-concerned chemical: None
  • Certification: CE, FCC

2.2. LoRa Module Comparison

LoRa Module Comparison Table

Image: Comparison table for LoRa modules SX1278, SX1276, SX1268, and SX1262, detailing Chip, Frequency, Power Amplifiers, TX/RX current, Programmable Bit, and Oscillator.

2.3. GPS/GNSS Module Comparison

GPS Module Comparison NEO-6M vs NEO-M8N

Image: Comparison table for GPS modules NEO-6M and NEO-M8N, detailing Module, Support System, Parallel processing, GPS max update frequency, and Oscillator type.

2.4. Dimensions

Product Size Picture with Dimensions

Image: Technical drawing showing the dimensions of the T-Beam V1.2 board, with measurements in millimeters.

3. Package Contents

The standard package for the LILYGO® T-Beam V1.2 typically includes the following components:

  • LILYGO® T-Beam V1.2 ESP32 LoRa Module
  • LoRa Antenna (SMA or IPEX, frequency dependent)
  • GPS Antenna (NEO-6M or NEO-M8N, type dependent)
  • Pin Headers
  • Mounting Nuts (for SMA antenna)
LILYGO T-Beam V1.2 package contents

Image: A visual representation of the typical components included in the LILYGO T-Beam V1.2 package, showing the main board, an SMA antenna, and pin headers.

4. Setup Instructions

4.1. Antenna Connection

The T-Beam V1.2 supports different antenna types (SMA or IPEX) and frequencies. Ensure you use the correct antenna for your module's frequency band (e.g., 433MHz, 868MHz, 915MHz, 923MHz).

LoRa Antenna Types and Rotation

Image: Illustrates different LoRa antenna types (915/923MHz and 433/868MHz) and their rotational flexibility. Note: LoRa Antenna ships based on the version you purchased. Please select according to the frequency band supported by your country.

LILYGO T-Beam V1.2 front and back view

Image: Front and back view of the LILYGO T-Beam V1.2 board, showing the battery holder and various components.

4.2. Battery Installation

The board is designed to be powered by an 18650 battery. Carefully insert the battery into the holder, paying close attention to the correct polarity (the '+' and '-' markings on the holder). The board includes reverse battery protection.

4.3. Optional OLED Display Connection

The T-Beam V1.2 can be used with an external OLED display for visual feedback. These displays typically connect via pin headers. Ensure proper pin alignment before connecting.

OLED Display Modules

Image: Shows two types of OLED modules: one with integrated buttons and a standard OLED display, both compatible with the T-Beam.

4.4. Pin Diagram and Power Introduction

Refer to the pin diagram for detailed information on GPIOs, power pins, and peripheral connections. This diagram is crucial for custom wiring and development.

T-Beam ESP32 SX1262 LoRa NEO-M8N Pin Diagram

Image: Detailed pin diagram for the T-Beam ESP32 SX1262 LoRa NEO-M8N, illustrating GPIOs, power pins, LoRa connections, NEO GPS connections, and LED indicators (Charging Indicator, Working Indicator). It also highlights the AXP2101 for programmable power supply.

5. Operating Instructions

5.1. Powering On/Off

The board can be powered via the USB-C port or an installed 18650 battery. Use the designated Power button to turn the module on or off. The onboard LEDs provide status indications:

  • LED1: Charging Indicator
  • LED2: Working Indicator

5.2. Firmware and Development

The T-Beam V1.2 is a development board, requiring custom firmware for specific applications. LILYGO provides resources and examples on their GitHub repository. It supports various firmware like SoftRF, Meshtastic, and Helium, depending on the specific LoRa module and GPS configuration.

For detailed programming guides and example code, please refer to the official LILYGO T-Beam GitHub repository: https://github.com/Xinyuan-LilyGO/LilyGO-T-Beam

AXP192 vs AXP2101 PMU Code Comparison

Image: Code snippets comparing PMU initialization for AXP192 and AXP2101, with QR codes linking to GitHub resources for each. This illustrates the software changes required for the different PMU versions.

5.3. LoRa Communication

The integrated LoRa module enables long-range, low-power wireless communication. Configuration of frequency, spreading factor, bandwidth, and coding rate is done via firmware. Ensure your LoRa antenna is correctly connected and matched to the module's frequency.

5.4. GPS/GNSS Functionality

The GPS/GNSS module provides location data. For optimal performance, ensure the GPS antenna has a clear view of the sky. The NEO-M8N module supports GPS, Beidou, and GLONASS for enhanced accuracy and faster fixes.

5.5. Wi-Fi and Bluetooth

The ESP32 microcontroller provides standard Wi-Fi and Bluetooth 4.2 capabilities for local network connectivity, data transfer, and configuration.

6. Maintenance

  • Keep Dry: Avoid exposing the module to moisture or humidity.
  • Cleanliness: Keep the board free from dust and debris. Use a soft, dry brush or compressed air for cleaning.
  • Handle with Care: Electronic components are sensitive. Avoid dropping or subjecting the board to physical shock.
  • Firmware Updates: Regularly check the official LILYGO GitHub repository for firmware updates and bug fixes to ensure optimal performance and security.

7. Troubleshooting

7.1. General Issues

  • Module not powering on:
    - Check battery polarity. The board has reverse battery protection, but incorrect insertion can still prevent operation.
    - Ensure the 18650 battery is charged or try powering via the USB-C port.
  • LoRa communication issues:
    - Verify the LoRa antenna is securely connected to the correct port (SMA or IPEX).
    - Confirm the antenna frequency matches the module's operating frequency.
    - Check firmware configuration for correct LoRa parameters (frequency, spreading factor, etc.).
  • GPS not getting a fix:
    - Ensure the GPS antenna has a clear, unobstructed view of the sky.
    - Verify the GPS antenna is properly connected.
    - Allow sufficient time for the GPS module to acquire satellites, especially during the first use or after a long period of inactivity.
  • Wi-Fi/Bluetooth connectivity problems:
    - Ensure the ESP32 firmware is correctly configured for Wi-Fi/Bluetooth operation.
    - Check for interference from other 2.4GHz devices.

7.2. Frequently Asked Questions (FAQ)

  • Q: Is the antenna frequency software configurable?
    A: No, the operating frequency (e.g., 433MHz, 868MHz, 915MHz) is determined by the hardware version of the LoRa module. You must order the correct frequency for your region. The antenna length is also specific to the frequency.
  • Q: Can I replace the antenna connector with a different type?
    A: While technically possible for experienced users, modifying the antenna connector (e.g., replacing IPEX with SMA) involves soldering and can affect RF performance. Such modifications are at the user's own risk and may void any warranty.
  • Q: Does the OLED screen need to be soldered?
    A: No, the optional OLED displays typically connect to the T-Beam V1.2 via pin headers, allowing for easy attachment without soldering.

8. User Tips

  • Power Management: The AXP2101 PMU offers advanced power management. Explore its features in the firmware to optimize battery life for your specific application.
  • Antenna Selection: Always use the correct antenna for your module's frequency band. Using an unmatched antenna can severely degrade LoRa performance.
  • Development Resources: LILYGO maintains an active GitHub repository with examples, documentation, and community support. This is an invaluable resource for development.
  • Battery Protection: The T-Beam V1.2 includes reverse battery protection, a significant improvement. However, always double-check battery polarity during installation to prevent potential issues.

9. Warranty and Support

For technical support, warranty claims, or further inquiries, please contact LILYGO Official Store directly through their official channels. Refer to the product packaging or the official LILYGO website for specific contact information and warranty terms.

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.