1. Introduction
The LILYGO T-Deck Plus is an advanced development board featuring the ESP32-S3 microcontroller, integrated LoRaWAN capabilities, and a low-power design for long-distance wireless communication. This versatile module is designed for developers and enthusiasts looking to create projects involving IoT, wireless data transmission, and location-based services. It combines a powerful dual-core processor with Wi-Fi, Bluetooth, LoRa, and GNSS functionalities, all within a compact form factor with a keyboard and display.
2. Product Overview
2.1. Key Features
- Microcontroller: ESP32-S3FN16R8 Dual-core LX7 microprocessor.
- Wireless Connectivity: Integrated 2.4 GHz Wi-Fi and Bluetooth 5 (LE).
- LoRa Transceiver: SX1262 LoRa chip (optional), supporting 433MHz, 868MHz, and 915MHz frequencies.
- GNSS: Onboard GPS functionality for location services.
- Display: 2.8-inch ST7789 SPI Interface IPS LCD with 320x240 resolution and full viewing angle.
- Memory: 16MB Flash, 8MB PSRAM.
- Peripherals: TF Card slot, Microphone, Speaker, Keyboard, Trackball.
- Development Environment Support: Arduino, PlatformIO-IDE, Micropython.
- Power: Battery ADC PIN: 1004.
2.2. Device Layout and Dimensions
The T-Deck Plus features a compact design with a full QWERTY keyboard and a trackball for navigation. Various ports and components are strategically placed for ease of use and development.
3. Setup
3.1. Package Contents
Ensure all items are present in your package:
- LILYGO T-Deck Plus device
- Antenna (external or internal, depending on model)
- Protective case (may vary)
3.2. Initial Device Preparation
- Antenna Connection: If your model includes an external antenna, carefully screw it into the designated connector on the device. Ensure it is finger-tight to avoid damage.
Figure 8: T-Deck Plus with external antenna. - Power On: Press and hold the power button (usually located on the side) until the screen illuminates.
- TF Card Insertion: If you plan to use a TF card for storage, carefully insert it into the TF card slot.
3.3. Development Environment Setup
The LILYGO T-Deck Plus is a development board and requires firmware to be flashed for specific functionalities. It supports development using Arduino, PlatformIO-IDE, and Micropython.
For detailed instructions on setting up your development environment and flashing firmware, please refer to the official GitHub repository:
4. Operating Instructions
The operation of the T-Deck Plus largely depends on the firmware loaded onto it. The device is equipped with a keyboard and a trackball for user interaction, and a 2.8-inch LCD for display output.
4.1. Basic Interaction
- Keyboard: Use the integrated QWERTY keyboard for text input and command execution, as defined by your loaded firmware.
- Trackball: Navigate menus and select options using the trackball. The trackball typically supports UP, DOWN, LEFT, RIGHT movements and a central press (BOOT) for selection.
- Display: The 320x240 IPS LCD provides visual feedback and displays information from your applications.
4.2. LoRa Communication
The integrated SX1262 LoRa transceiver enables long-distance, low-power wireless communication. Firmware examples often include functionalities such as:
- TX (Transmit): Sending data packets over LoRa.
- RX (Receive): Receiving data packets.
- Noise Detection: Monitoring LoRa channel activity.
- MP3 Playback: Some applications may utilize the speaker for audio feedback.
Refer to the sample code and documentation on the GitHub repository for specific LoRa application usage.
5. Specifications
Below are the detailed technical specifications for the LILYGO T-Deck Plus:
| Feature | Detail |
|---|---|
| Brand | LILYGO |
| Model Number | T-Deck Plus |
| MCU | ESP32-S3FN16R8 Dual-core LX7 microprocessor |
| Wireless Connectivity | 2.4 GHz Wi-Fi & Bluetooth 5 (LE) |
| LoRa Transceiver | SX1262 (Chip Optional) |
| LoRa Transmit Power | +22dBm |
| LoRa Frequency Options | 433MHz, 868MHz, 915MHz |
| GNSS | Onboard GPS (L76K or Ulbox, depending on version) |
| Display | 2.8 inch ST7789 SPI Interface IPS LCD |
| Display Resolution | 320 x 240 |
| Flash Memory | 16MB |
| PSRAM | 8MB |
| Onboard Functions | TF Card, Microphone, Speaker, Keyboard, Trackball |
| Battery ADC PIN | 1004 |
| Battery Capacity | 2000mAh (typical) |
| Dimensions (L x W x H) | 115mm x 72mm x 20mm |
| Compatible Audio & Video Equipment Style | Amplifier, player, Professional Audio Equipment, Display Equipment |
| Type | Bluetooth, WIFI |
| Origin | Mainland China |
6. User Tips
- LoRa Frequency Configuration: The LoRa chip supports both 868MHz and 915MHz frequency bands. The desired band can be configured in the device's settings or firmware. For regions like Australia (AS923) or other specific frequencies, ensure your firmware is configured correctly for compliance and optimal performance.
- Antenna Selection: Depending on your chosen model (internal or external antenna), ensure the correct antenna is used or connected. External antennas often provide better range and flexibility.
- Battery Life: The device typically includes a 2000mAh battery. Optimize your firmware for low power consumption to maximize operating time, especially for LoRaWAN applications.
- Development Resources: Always refer to the official GitHub repository for the latest sample code, libraries, and technical documentation to get the most out of your T-Deck Plus.
7. Troubleshooting
- Green Screen / No Functionality: If the device powers on but only displays a green screen or shows no functionality, it likely indicates an issue with the loaded firmware. Re-flash the firmware using the instructions on the official GitHub page. Ensure you are using compatible and correctly compiled firmware for your specific T-Deck Plus variant.
- LoRa Communication Issues:
- Verify the LoRa frequency configured in your firmware matches the frequency band allowed in your region and the capabilities of your device (433MHz, 868MHz, or 915MHz).
- Ensure the antenna is securely connected (if external) and is appropriate for the operating frequency.
- Check for local interference using the noise detection feature if available in your firmware.
- GPS Not Working:
- Ensure the device has a clear view of the sky for satellite acquisition.
- Verify that the GPS module is enabled and correctly configured in your firmware.
- Check the pin diagram for correct GPS connections if you are working with custom hardware.
- Meshtastic Pre-installation: The LILYGO T-Deck Plus is a development board and typically does not come with Meshtastic pre-installed. Users need to flash the Meshtastic firmware themselves if they wish to use it. Refer to the Meshtastic project documentation for flashing instructions.
- CE Certification: As a development board, the LILYGO T-Deck Plus is primarily intended for prototyping and experimentation. It may not carry a full CE certification as a finished consumer product. Individual components may be certified, but the assembled board's compliance depends on the final application and user's implementation.
8. Maintenance
- Cleaning: Use a soft, dry cloth to clean the device. Avoid using liquids or abrasive cleaners.
- Storage: Store the device in a cool, dry place away from direct sunlight and extreme temperatures.
- Handling: Handle the device with care to prevent physical damage to the screen, keyboard, or internal components. Avoid dropping the device or exposing it to excessive force.
- Firmware Updates: Regularly check the official GitHub repository for firmware updates and security patches to ensure optimal performance and functionality.
9. Warranty and Support
For any questions, technical support, or assistance with customization, please contact LILYGO customer service. As an open-source development board, a wealth of information and community support is also available through the official GitHub repository.
- Official GitHub Repository: https://github.com/Xinyuan-LilyGO/T-Deck
- Customer Service: Refer to the LILYGO Official Store for contact information.
