LILYGO T-Deck

Download PDF
Contents

LILYGO T-Deck ESP32-S3 Development Board User Manual

Model: T-Deck

1. Introduction

Welcome to the user manual for the LILYGO T-Deck ESP32-S3 Development Board. This document provides essential information for setting up, operating, maintaining, and troubleshooting your device. The LILYGO T-Deck is a versatile development board featuring an ESP32-S3FN16R8 dual-core LX7 microprocessor, 2.4 GHz Wi-Fi, Bluetooth 5 (LE) connectivity, and a 2.8-inch LCD, designed for various embedded projects and applications.

2. Product Overview

The LILYGO T-Deck combines a powerful microcontroller with a compact form factor, including a keyboard and display, making it suitable for portable and interactive projects. Key features include:

  • MCU: ESP32-S3FN16R8 Dual-core LX7 microprocessor
  • Wireless Connectivity: 2.4 GHz Wi-Fi, Bluetooth 5 (LE)
  • Display: 2.8 inch ST7789 SPI Interface IPS LCD (320x240 resolution)
  • Onboard Functions: Trackball, Microphone, Speaker
  • Development Support: Arduino, PlatformIO-IDE, Micropython
  • Memory: 16MB PSRAM, 8MB Flash
LILYGO T-Deck ESP32-S3 Development Board front and back view

Figure 2.1: Front and back view of the LILYGO T-Deck ESP32-S3 Development Board, showcasing the LCD, keyboard, and main components on the PCB.

3. Package Contents

Please verify that all items are present in your package:

  • 1 x LILYGO T-Deck Development Board
  • 1 x 6-pin Header
  • 1 x Power Cable
LILYGO T-Deck package contents including the board, pin header, and power cable

Figure 3.1: Contents of the LILYGO T-Deck package, showing the main board, a 6-pin header, and a power cable.

4. Setup Guide

Follow these steps for the initial setup of your LILYGO T-Deck:

  1. Power Connection: Connect the provided power cable to the appropriate port on the T-Deck. Ensure the power source meets the board's voltage requirements.
  2. Pin Header Installation (Optional): If your project requires external connections, solder or attach the 6-pin header to the designated GPIO pins on the board. Refer to the pinout diagram for correct orientation and pin assignments.
  3. Development Environment Setup: To program the T-Deck, you will need to set up a development environment. LILYGO T-Deck supports Arduino IDE, PlatformIO-IDE, and Micropython. Detailed instructions and example code can be found on the official LILYGO GitHub repository: github.com/Xinyuan-LilyGO/T-Deck.
  4. First Boot: Once powered, the LCD should illuminate. If pre-flashed with firmware, it may display initial information or a demo.
LILYGO T-Deck Pinmap and Board Function Diagram

Figure 4.1: Detailed pinout diagram and board function overview for the LILYGO T-Deck, showing connections for LCD, TF Card, USB, and various GPIOs.

5. Operating Instructions

The LILYGO T-Deck is designed for custom application development. Its operation largely depends on the firmware loaded onto it. Here are general guidelines:

  • Power On/Off: Connect or disconnect the power cable. Some boards may have a dedicated power button or switch.
  • LCD Display: The 2.8-inch LCD provides visual output for your applications. Its 320x240 resolution and full viewing angle make it suitable for displaying text, graphics, and simple user interfaces.
  • Keyboard and Trackball: Interact with your applications using the integrated keyboard and trackball. The trackball typically provides navigation (up, down, left, right, press).
  • Audio: The onboard speaker and microphone allow for audio input and output, depending on your application's requirements.
  • Connectivity: Utilize Wi-Fi and Bluetooth for wireless communication with other devices or networks.
  • Firmware Updates: Regularly check the LILYGO GitHub repository for the latest firmware, examples, and documentation to enhance functionality and address any known issues.

6. Maintenance

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

  • Keep Clean: Use a soft, dry cloth to gently clean the board and display. Avoid using liquid cleaners or abrasive materials.
  • Handle with Care: The board contains sensitive electronic components. Avoid dropping or subjecting it to physical shock.
  • Storage: Store the T-Deck in a cool, dry environment, away from direct sunlight, extreme temperatures, and high humidity.
  • Power Supply: Always use a stable and appropriate power supply to prevent damage to the board.
  • Firmware Management: Keep your firmware updated to benefit from bug fixes and new features. Back up your custom code before flashing new firmware.

7. Troubleshooting

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

  • Board Not Powering On:
    • Ensure the power cable is securely connected.
    • Verify that the power source is providing the correct voltage and current.
    • Check for any visible damage to the power port or cable.
  • LCD Not Displaying:
    • Confirm the board is powered on.
    • If you've flashed custom firmware, ensure the display initialization code is correct.
    • Check the display ribbon cable connection to the main board.
  • Connectivity Issues (Wi-Fi/Bluetooth):
    • Verify your firmware includes the necessary Wi-Fi/Bluetooth libraries and configurations.
    • Ensure correct network credentials are provided in your code.
    • Check for interference from other wireless devices.
  • Programming Errors:
    • Ensure you have the correct board selected in your IDE (Arduino, PlatformIO).
    • Install all required drivers for the USB-to-serial converter.
    • Check your code for syntax errors or logical flaws.

For more specific issues or advanced troubleshooting, refer to the LILYGO GitHub repository or community forums.

8. Technical Specifications

FeatureSpecification
MCUESP32-S3FN16R8 Dual-core LX7 microprocessor
Wireless Connectivity2.4 GHz Wi-Fi, Bluetooth 5 (LE)
Display2.8 inch ST7789 SPI Interface IPS LCD, 320x240 resolution, Full viewing angle
Flash Memory16MB
PSRAM8MB
Onboard PeripheralsTrackball, Microphone, Speaker
Battery ADC PinIO04
Dimensions (Approx.)Height: 10cm, Width: 6.8cm, Thickness: 1.1cm
Operating System SupportLinux (for development environment)
LILYGO T-Deck detailed specifications and board functions

Figure 8.1: Detailed technical specifications and a visual representation of the LILYGO T-Deck's key components and functions.

LILYGO T-Deck with dimensions indicated

Figure 8.2: LILYGO T-Deck showing approximate dimensions (Height: 10cm, Width: 6.8cm, Thickness: 1.1cm).

9. Support and Warranty

For any questions, suggestions, or technical support regarding your LILYGO T-Deck, please feel free to contact LILYGO directly. You can often find support resources, including forums and contact information, on the official LILYGO website or their GitHub page.

While specific warranty details may vary, LILYGO is committed to providing quality products. If you experience any manufacturing defects or issues not covered by troubleshooting, please reach out to the seller or manufacturer for assistance.

For the latest information and community support, visit: github.com/Xinyuan-LilyGO/T-Deck

© 2024 LILYGO. All rights reserved.

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.