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.

2. Specifications

| Feature | Detail |
|---|---|
| MCU | ESP32-S3FN16R8 Dual-core LX7 microprocessor |
| Wireless Connectivity | 2.4 GHz Wi-Fi & Bluetooth 5 (LE) |
| Development Environment | Arduino, PlatformIO-IDE, Micropython |
| Memory | Flash: 16MB, PSRAM: 8MB |
| Battery ADC PIN | 1004 |
| Onboard Functions | Trackball, Microphone, Speaker |
| LCD Display | 2.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 Weight | 0.13 kg |
| Package Dimensions | Length: 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.)


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

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.