LILYGO Meshtastic T-Beam V1.2

Contents

LILYGO® TTGO Meshtastic T-Beam V1.2 ESP32 LoRa Development Board User Manual

Model: Meshtastic T-Beam V1.2

1. Product Overview

The LILYGO® TTGO Meshtastic T-Beam V1.2 is a versatile development board designed for long-range, low-power communication and location tracking. It integrates an ESP32 microcontroller for Wi-Fi and Bluetooth Low Energy (BLE) connectivity, a LoRa module for mesh networking, and a NEO-6M GPS module for precise positioning. An onboard 0.96-inch OLED display provides real-time information. This board is ideal for Meshtastic applications, enabling off-grid communication and data exchange.

Note on PMU: Due to component availability, the Power Management Unit (PMU) may be either AXP192 or AXP2101. Both versions provide similar functionality for power management.

LILYGO TTGO Meshtastic T-Beam V1.2 front view
Front view of the LILYGO TTGO Meshtastic T-Beam V1.2 development board with OLED display and LoRa antenna.
LILYGO TTGO Meshtastic T-Beam V1.2 back view
Back view of the LILYGO TTGO Meshtastic T-Beam V1.2, showing the 18650 battery holder.

2. Specifications

2.1. Meshtastic T-Beam Core Specifications

Feature Detail
MCUESP32
Flash4MB
Serial ChipCH9102
PMUAXP2101 (replaces AXP192)
Wireless ProtocolWi-Fi + Bluetooth 4.2
Onboard Functions3 Buttons (Power + IO38 + Reset)
Power Supply ModeSupport USB / 18650 Battery
NEO-6M GPS ModulesSupport GPS Protocol, Onboard RTC Crystal, Support Interrupt / Wakeup

2.2. Long Range Low Power LoRa Transceiver

Feature Detail
High Sensitivity-148 dBm
Transceive Rate300 kbps
Optional VersionSX1278 / SX1276
Power Amplifiers+14dBm
TX Current120mA
RX Current9.9mA
Programmable Bit300 kbps
OscillatorTCXO

2.3. LoRa Frequency Band Comparison

Hardware Software (Meshtastic)
SX1278433MHz Version
SX1276868/915/923 MHz Version

2.4. 0.96 Inch OLED Parameters

Parameter Value Parameter Value
Size0.96 inchHigh resolution128 * 64
Driver ICSSD1306ColorWhite

2.5. Physical Dimensions

LILYGO TTGO Meshtastic T-Beam V1.2 dimensions
Technical drawing showing the dimensions of the T-Beam V1.2 board (approx. 95.10mm x 32.89mm).

3. Package Contents

The contents of your package may vary slightly depending on whether the OLED display is pre-soldered and the chosen frequency band. Please refer to the specific variant you purchased.

3.1. Not Soldered OLED Version

Item Quantity
Meshtastic T-Beam Board1
LoRa Antenna (frequency specific)1
0.96-inch OLED Display1
Pin Headers2
Package contents for Not Soldered OLED version
Example package contents for the 'Not Soldered OLED' variant, showing the board, antenna, separate OLED, and pin headers.

3.2. Soldered OLED Version

Item Quantity
Meshtastic T-Beam Board (with OLED soldered)1
LoRa Antenna (frequency specific)1
Pin Headers2

4. Setup Instructions

4.1. Antenna Connection

Carefully screw the provided LoRa antenna onto the SMA connector on the board. Ensure it is finger-tight to avoid damage. The antenna length varies by frequency band:

  • 433-868MHz: 5cm antenna
  • 915MHz: 10.8cm antenna
  • 923MHz: 19.5cm antenna
Antenna size and orientation guide
Antenna size comparison and recommended orientation for optimal signal.

4.2. OLED Display Installation (if not soldered)

If your board came with a separate OLED display, carefully align the pin headers of the OLED with the corresponding female headers on the T-Beam board and gently press them together. Ensure correct orientation to prevent damage.

OLED display comparison
Comparison of OLED display types (0.96 inch SSD1306 is used on this board).

4.3. Battery Installation

The T-Beam V1.2 supports power via USB or a single 18650 Li-ion battery. Insert a standard length 18650 battery (18mm*65mm, flat head) into the battery holder on the back of the board, observing correct polarity.

18650 battery dimensions and recommendation
Recommended 18650 battery dimensions for proper fit and power supply.

4.4. Pinout Diagram

Refer to the pinout diagram for detailed information on GPIOs, power connections, and other interfaces for advanced development and debugging.

ESP32 TTGO T-Beam V1.2 Pinout Diagram
Detailed pinout diagram for the ESP32 TTGO T-Beam V1.2 board.

4.5. Firmware Flashing

The T-Beam V1.2 is primarily designed for Meshtastic firmware. You can find the latest firmware and flashing instructions on the official Meshtastic GitHub repository. For specific LILYGO T-Beam resources, refer to the LILYGO GitHub.

Meshtastic GitHub QR Code LilyGO T-Beam GitHub QR Code
Scan for Meshtastic and LILYGO T-Beam GitHub resources.

For PMU-specific code examples (AXP192 vs AXP2101), refer to the provided code snippets:

AXP192 vs AXP2101 PMU code snippets
Code examples for initializing AXP192 and AXP2101 PMUs.

5. Operating Instructions

5.1. Power On/Off

The board features three buttons: Power, IO38, and Reset. Use the Power button to turn the device on or off. The IO38 and Reset buttons are typically used for firmware interaction and resetting the device, respectively.

5.2. Meshtastic Application

Once the Meshtastic firmware is flashed, the T-Beam V1.2 acts as a node in a mesh network. You can interact with it via a mobile application (available for Android and iOS) or a web interface. The OLED display will show network status, GPS coordinates, and messages.

Meshtastic App QR Code
Scan to download the Meshtastic App.

5.3. GPS Functionality

The integrated NEO-6M GPS module provides location data. Ensure the device has a clear view of the sky for optimal GPS signal reception. The OLED display will show GPS status and coordinates when available.

6. Maintenance

  • Keep the board clean and free from dust and moisture.
  • Avoid exposing the board to extreme temperatures.
  • When using battery power, ensure the 18650 battery is in good condition and correctly inserted.
  • Regularly check for firmware updates on the Meshtastic and LILYGO GitHub pages to ensure optimal performance and access to new features.

7. Troubleshooting

  • Device not powering on: Check battery installation and charge level. Ensure USB power is connected if not using a battery.
  • OLED display not working: If your OLED was not pre-soldered, verify it is correctly seated on the pin headers. Check firmware for proper display initialization.
  • No LoRa communication: Ensure the antenna is securely connected. Verify that the correct frequency band firmware is flashed for your region and hardware version. Check for obstructions between devices.
  • GPS not acquiring fix: Ensure the device has a clear view of the sky. GPS acquisition can take several minutes, especially on first use or after a long period of inactivity.
  • Firmware flashing issues: Double-check your flashing tools and drivers. Refer to the specific flashing instructions on the Meshtastic or LILYGO GitHub.

8. User Tips

  • Battery Recommendation: For reliable power, use a standard length 18650 Li-ion battery (18mm*65mm, flat head). The battery is typically not included in the package.
  • Frequency Selection for Europe: For users in Europe, the official frequencies are 868MHz and 433MHz. Ensure you select the correct hardware version for your region.
  • LoRa Range: The effective range of LoRa communication can vary significantly. It works best with a clear line of sight for long distances. In areas with many other LoRa devices, the network density can enhance overall range and connectivity.
  • Frequency Switching: It is generally not possible to switch between different LoRa frequency bands (e.g., 868MHz and 915MHz) on the same board, as the hardware's output chain is optimized for its stated frequency.
  • GPS Performance: The integrated GPS module typically performs well for location tracking.
  • No Case Included: The product usually ships as a bare board with components; a protective case is not typically included.
  • Regional Frequencies: Always verify the legal LoRa frequency bands for your specific country or region before operation.

9. Warranty & Support

For any inquiries regarding your LILYGO® TTGO Meshtastic T-Beam V1.2, please contact the LILYGO Official Store customer service. When contacting support, please provide details of your issue and, if applicable, clear pictures of the product and packaging.

  • If you receive a damaged package due to external force or transportation, please provide clear pictures of the logistics label, carton, and damaged product.
  • For customization needs or bulk purchases, please reach out to customer service.

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.