LILYGO T-Deck

Contents

LILYGO® T-Deck ESP32-S3 LoRa Module Development Board User Manual

Model: T-Deck

1. Introduction

The LILYGO T-Deck is a compact and versatile development board designed for a wide range of applications. It features an ESP32-S3 dual-core processor, a 2.8-inch IPS LCD display, and a mini QWERTY keyboard. Depending on the version, it may also include an SX1262 LoRa transceiver for long-range communication. This device is ideal for developers looking to create custom programming solutions, standalone messaging devices, or other embedded projects leveraging its Wi-Fi, Bluetooth, and LoRa capabilities.

LILYGO T-Deck front and back view with keyboard and LCD
Figure 1: LILYGO T-Deck front and back view.

2. Specifications

T-Deck detailed specifications including MCU, wireless, display, and LoRa
Figure 2: T-Deck detailed specifications.
Table 1: Technical Specifications
FeatureDetail
MCUESP32-S3FN16R8 Dual-core LX7 microprocessor
Wireless Connectivity2.4 GHz Wi-Fi & Bluetooth 5 (LE)
Development EnvironmentArduino, PlatformIO-IDE, Micropython
MemoryFlash: 16MB, PSRAM: 8MB
Battery ADC PIN1004
Onboard FunctionsTrackball, Microphone, Speaker
LCD Display2.8 inch ST7789 SPI Interface IPS LCD, Resolution: 320 x 240, Full viewing angle
LoRa Transceiver (Optional)SX1262 LoRa Transceiver, Transmit power: +22dBm, Frequency Options: 433/868/915MHz
Dimensions (approx.)Width: 6.8cm, Height: 10cm, Thickness: 1.1cm
Package Weight0.13 kg
Package DimensionsLength: 15cm, Width: 8cm, Height: 4cm

3. Package Contents

Please verify that all items are present and in good condition upon opening the package.

  • 1 x LILYGO T-Deck Development Board
  • 1 x Male Pin (6pin)
  • 1 x Power Cable
  • 1 x LoRa Antenna (Note: "No LoRa" versions do not include a LoRa antenna. The 433MHz and 868/915MHz LoRa antennas differ in appearance.)
Image showing the contents of the T-Deck package: T-Deck board, male pin, power cable, and LoRa antenna.
Figure 3: Package contents.
Comparison of 433MHz and 868/915MHz LoRa antennas.
Figure 4: Different types of LoRa antennas.

4. Setup and Assembly

The LILYGO T-Deck is designed for ease of use, but some initial setup may be required depending on your project. Familiarize yourself with the board's components using the pin diagram.

4.1 Component Overview and Pinmap

LILYGO T-Deck Pinmap diagram showing ESP32-S3, LoRa, LCD, Trackball, and various pins like TF Card, Mic, Speaker, USB, Battery, Reset, and GPIOs.
Figure 5: LILYGO T-Deck Pinmap Diagram.

Key components include:

  • ESP32-S3 Module: The main processing unit.
  • 2.8 inch ST7789 LCD: Display interface.
  • Mini Keyboard: For user input.
  • Trackball: For navigation (Press Down for BOOT).
  • SX1262 LoRa Module (Optional): For long-range communication.
  • TF Card Slot: For external storage.
  • USB Port: For power and data communication.
  • BAT Connector: For external battery power.
  • Speaker and Microphone: For audio input/output.
  • GPIO Pins: For connecting external sensors and modules.

4.2 Connecting the LoRa Antenna (if applicable)

If your T-Deck version includes a LoRa module, carefully connect the provided LoRa antenna to the designated LoRa Antenna Seat on the board. Ensure a secure connection to optimize signal transmission and reception. Refer to Figure 5 for the antenna seat location.

4.3 Powering the Device

The T-Deck can be powered via the USB port or an external battery connected to the BAT connector. For initial setup and programming, using the USB connection is recommended.

5. Operating Instructions

The LILYGO T-Deck is a development board, meaning its functionality is primarily defined by the software you load onto it. It supports various development environments, including Arduino, PlatformIO-IDE, and Micropython.

5.1 Initial Power-Up

Once powered, the LCD will typically display information based on the pre-loaded firmware or your custom code. Use the trackball for navigation and the mini keyboard for text input, as programmed.

5.2 Programming the T-Deck

To develop custom applications for your T-Deck, you will need to set up a development environment on your computer. LILYGO provides sample code and resources on their GitHub repository, which is an excellent starting point for understanding the board's capabilities and programming it.

GitHub Repository for Sample Code: https://github.com/Xinyuan-LilyGO/T-Deck

Follow the instructions in the repository to compile and upload your code to the ESP32-S3 module via the USB connection.

6. User Tips

  • Versatile Use: The T-Deck is a highly versatile development board. While it resembles an old-style phone, its primary purpose is for custom programming. Users have explored applications such as standalone messaging devices (using LoRa), GPS trackers (with an external GPS module), and even MP3 players, all depending on the firmware loaded.
  • Case Included: The T-Deck typically comes with a clear protective case, as shown in the product images. This helps protect the board during use and handling.
  • Battery: An external battery is generally not included in the package. The board is designed to be powered via its USB-C port or an external battery connected to the BAT connector.
  • Keyboard Layouts: Be aware that there are different keyboard layouts (e.g., English, other languages) and these may be shipped randomly.

7. Troubleshooting

If you encounter issues with your LILYGO T-Deck, consider the following troubleshooting steps:

  • No Power/Display:
    • Ensure the USB cable is securely connected and providing power, or that an external battery is properly connected and charged.
    • Verify the power source is adequate.
  • Firmware Issues:
    • If the device is not behaving as expected, the firmware might be corrupted or incompatible. Try re-uploading a known-good firmware from the official GitHub repository.
    • Ensure you are using the correct development environment and libraries for your chosen firmware.
  • LoRa Communication Problems:
    • Check if the LoRa antenna is securely attached to the board.
    • Verify that the LoRa frequency configured in your software matches the frequency of your LoRa module (433MHz, 868MHz, or 915MHz).
  • Keyboard/Trackball Unresponsive:
    • This is typically software-controlled. Ensure your loaded firmware includes drivers and logic for the keyboard and trackball.
    • Check for any physical obstructions or damage.
  • General Technical Support: For more in-depth technical assistance, refer to the official LILYGO GitHub repository or contact LILYGO customer service.

8. Maintenance

To ensure the longevity and optimal performance of your LILYGO T-Deck, follow these maintenance guidelines:

  • Handle with Care: The T-Deck is an electronic device. Avoid dropping it or subjecting it to strong impacts.
  • Keep Dry: Protect the device from moisture and liquids, which can cause damage to electronic components.
  • Clean Gently: If cleaning is necessary, use a soft, dry cloth. Avoid harsh chemicals or abrasive materials.
  • Firmware Updates: Regularly check the official LILYGO GitHub repository for firmware updates and improvements. Keeping your device updated can enhance functionality and fix bugs.
  • Storage: When not in use, store the T-Deck in a cool, dry place, preferably in its original packaging or a protective case.

9. Warranty and Support

LILYGO products are designed for developers and hobbyists. Support is primarily community-driven and available through official channels.

  • Technical Support: For technical inquiries, programming assistance, and community discussions, please refer to the official LILYGO GitHub repository: https://github.com/Xinyuan-LilyGO/T-Deck.
  • Customer Service: For questions regarding product customization, bulk purchases, or any other product-related inquiries, please contact LILYGO customer service directly.
  • Damaged Goods: If your package arrives damaged due to external force or transportation, please provide clear pictures of the logistics label, carton/bag, and the damaged product. LILYGO will investigate with the logistics service provider and offer a solution.

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.