LILYGO T-Deck Plus

Contents

LILYGO T-Deck Plus LoRa Mesh Radio User Manual

This manual provides detailed instructions for the setup, operation, and maintenance of your LILYGO T-Deck Plus LoRa Mesh Radio. This device is an all-in-one portable LoRa terminal featuring a full-color display, long-lasting battery, ESP32-S3 chipset, GPS, and QWERTY keyboard, designed for Meshtastic and LoRaWAN communication.

1. Introduction

The LILYGO T-Deck Plus is a versatile LoRa Mesh Radio designed for off-grid communication and tracking. It integrates an ESP32-S3 microcontroller, GPS, and LoRaWAN capabilities, making it an ideal pocket tracker node for Meshtastic networks. With its full-color large display, QWERTY keyboard, and long-lasting 3000mAh Lithium-ion battery with Type-C fast charging, it offers efficient text communication and real-time GPS location updates.

The device supports open-source Meshtastic firmware, enabling you to utilize inexpensive LoRa radios for remote communication in areas without existing or reliable communication infrastructure. It's a community-driven, open-source project that provides ultra-long-range, low-power data transmission.

2. What's in the Box

Upon unboxing your LILYGO T-Deck Plus, you should find the following components:

  • LILYGO T-Deck Plus Device
  • External LoRa Antenna
  • Product Information Card

Watch the unboxing and initial setup video:

Video: Unboxing and initial setup of the LILYGO T-Deck Plus, demonstrating antenna attachment and power-on sequence.

A visual representation of the device and its packaging:

LILYGO T-Deck Plus device with antenna and packaging card

Image: LILYGO T-Deck Plus device, antenna, and product card.

3. Setup

3.1 Attaching the Antenna

  1. Carefully remove the LILYGO T-Deck Plus from its packaging.
  2. Locate the antenna connector on the top of the device.
  3. Screw the provided external LoRa antenna clockwise onto the connector until it is finger-tight. Do not overtighten.
Front and back view of the LILYGO T-Deck device with antenna attached

Image: Front and back view of the LILYGO T-Deck with antenna attached.

3.2 Initial Power-On and Configuration

  1. Press and hold the power button (usually located on the side) until the screen illuminates.
  2. The device will display the Meshtastic boot screen.
  3. Follow the on-screen prompts to set your frequency band (e.g., 868MHz or 915MHz) and device name. Use the QWERTY keyboard for input and navigation buttons to select options.

Refer to the product video for a visual guide on initial power-on and configuration steps.

4. Operating Instructions

4.1 Meshtastic Communication

The LILYGO T-Deck Plus is pre-loaded with Meshtastic firmware, enabling peer-to-peer communication over LoRa. The device's screen displays key information such as message status, number of online nodes, uptime, LoRa frequency, Signal-to-Noise Ratio (SNR), and Received Signal Strength Indicator (RSSI).

  • Sending Messages: Use the QWERTY keyboard to type messages and send them to other nodes in your Meshtastic network.
  • Receiving Messages: New messages will appear on the device's display.
  • Node Status: Monitor the network status, including the number of active nodes, directly from the device's interface.
LILYGO T-Deck Plus Meshtastic interface and smartphone app displaying GPS location

Image: LILYGO T-Deck Plus displaying Meshtastic interface with network status.

4.2 GPS Positioning

The integrated GPS module provides real-time location data. This information can be viewed on the device itself or transmitted to a paired smartphone via the Meshtastic app.

  • Real-time Location: The device can display its current latitude and longitude.
  • Map Integration: When connected to a smartphone running the Meshtastic app, your location and the location of other nodes can be visualized on a map.
LILYGO T-Deck Meshtastic Tracker highlighting LoRa Communications, GPS Positioning, and Extra-Long Battery Life

Image: Meshtastic app on a smartphone showing GPS location tracking.

4.3 Connectivity

The LILYGO T-Deck Plus supports multiple connectivity options:

  • LoRa: For long-range, low-power mesh communication.
  • Bluetooth: To connect with smartphones for app integration.
  • Wi-Fi: For network connectivity and potential firmware updates.
  • USB: For charging, data transfer, and firmware flashing.
Diagram illustrating Meshtastic Tracker functionality with LoRa, Bluetooth, and USB connections

Image: Connectivity options for the LILYGO T-Deck Plus.

5. Software Installation

The LILYGO T-Deck Plus is highly customizable and supports firmware development using PlatformIO or Arduino IDE.

5.1 PlatformIO Quick Start

  1. Install VisualStudioCode and Python.
  2. Search for the PlatformIO plugin in the VisualStudioCode extension marketplace and install it.
  3. After the installation is complete, you may need to restart VisualStudioCode.
  4. After restarting VisualStudioCode, select File in the upper left corner of VisualStudioCode -> Open Folder -> select the T-Deck directory.
  5. Click on the platformio.ini file, and in the platformio column, uncomment the sample line that needs to be used. Please make sure that only one line is valid.
  6. Click the (✔) symbol in the lower left corner to compile.
  7. Connect the board to the computer via USB.
  8. Click (→) to upload firmware.
  9. Click (plug symbol) to monitor serial output.

Optional: You can upload the assets contents for the speaker demo, using the "Upload Filesystem Image" on PlatformIO menu.

5.2 Arduino IDE Setup

  1. Install Arduino IDE.
  2. In Arduino Preferences, on the Settings tab, enter the https://raw.githubusercontent.com/espressif/arduino-esp32/gh-pages/package_esp32_index.json URL in the "Additional boards manager URLs" input box. Please pay attention to the version. The test phase is using 2.0.14. It is not certain that versions above 2.0.14 can run. If the operation is abnormal, please downgrade to a version below 2.0.14. As of 2024/08/02, TFT_eSPI does not work on versions higher than 2.0.14, see TFT_eSPI/issue3329.
  3. Copy all the folders in the T-Deck/lib directory to <C:\Users\UserName\Documents\Arduino\libraries>. If there is no libraries directory, please create a new one. Please note that you are not copying the lib directory, but copying the folders within the lib directory.
  4. Open Arduino IDE, Tools, and select the appropriate board:
    • T-Deck(ESP32S3)
    • T-Keyboard (ESP32C3)

6. Specifications

FeatureSpecification
Model NumberLILYGO T-Deck Plus
ChipsetESP32-S3
Frequency Options868MHz, 915MHz (LoRa)
ConnectivityLoRa, Bluetooth, Wi-Fi
GPSIntegrated GPS Positioning
DisplayFull-color LCD Display
InputQWERTY Keyboard
Battery3000mAh Lithium-ion (Type-C Fast Charging)
Dimensions (with antenna)Approx. 28.8 cm (11.34 in) Height x 7.3 cm (2.87 in) Width x 2 cm (0.79 in) Thickness
WeightApprox. 150g
PackageYes
OriginMainland China
Dimensions of the LILYGO T-Deck device with antenna

Image: Device dimensions with antenna.

LILYGO T-Deck Meshtastic Tracker, showing dimensions and weight

Image: Device dimensions and weight (150g).

7. Troubleshooting

  • Screen Display Issues: If the screen display is incorrect, verify that your TFT_eSPI initialization sequence is consistent with the latest updates. As of 2024/08/02, TFT_eSPI versions higher than 2.0.14 may have compatibility issues. Consider downgrading to a version below 2.0.14 if you experience abnormal operation with Arduino IDE.
  • No Power: Ensure the device is fully charged using the Type-C port. Check the power button for proper function.
  • No LoRa Signal/Communication: Verify the antenna is securely attached. Ensure both devices are within range and on the same frequency band (868MHz or 915MHz). Obstacles like dense foliage can significantly reduce LoRa range.
  • GPS Not Locking: Ensure the device has a clear view of the sky. GPS signal acquisition can take longer in certain environments or after a long period of inactivity.
  • Connectivity Problems (Bluetooth/Wi-Fi): Check device settings to ensure Bluetooth/Wi-Fi is enabled. For app connections, ensure the Meshtastic app is updated and permissions are granted.

8. User Tips

  • Meshtastic Firmware: The device typically comes with Meshtastic software pre-installed, allowing for immediate use.
  • Wi-Fi and GPS: Yes, the LILYGO T-Deck Plus is equipped with both Wi-Fi and GPS capabilities.
  • LoRa vs. Satellite Communication: LoRa is a terrestrial radio technology designed for long-range, low-power communication between devices. It is not a satellite communication system like Zoleo. While effective for off-grid communication, its range can be affected by terrain and dense obstacles like forests, unlike satellite systems which offer broader coverage.
  • Firmware Updates: Regularly check the official LILYGO GitHub repository or Meshtastic project for the latest firmware updates to ensure optimal performance and access to new features.
  • Battery Life: To maximize battery life, consider adjusting screen brightness and LoRa transmission power settings if available in the firmware.

9. Maintenance

  • Cleaning: Use a soft, dry cloth to clean the device. Avoid using harsh chemicals or abrasive materials.
  • Storage: Store the device in a cool, dry place away from direct sunlight and extreme temperatures.
  • Battery Care: For optimal battery longevity, avoid fully discharging the battery frequently. If storing for extended periods, charge the device to about 50-70% and recharge every few months.
  • Antenna Care: Handle the antenna carefully to prevent bending or damage. Ensure it is securely attached during use.

10. Warranty and Support

For detailed warranty information and technical support, please refer to the official LILYGO documentation or contact their customer service. A comprehensive user manual in PDF format is also available for download:

Download User Manual (PDF)

Link: Official User Manual (PDF) for additional guides and documents.

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.