1. Introducció
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. Producte acabatview
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
- Connectivitat sense fils: 2.4 GHz Wi-Fi, Bluetooth 5 (LE)
- Visualització: 2.8 inch ST7789 SPI Interface IPS LCD (320x240 resolution)
- Onboard Functions: Trackball, Microphone, Speaker
- Development Support: Arduino, PlatformIO-IDE, Micropython
- Memòria: 16MB PSRAM, 8MB Flash

Figura 2.1: Davant i darrere view of the LILYGO T-Deck ESP32-S3 Development Board, showcasing the LCD, keyboard, and main components on the PCB.
3. Contingut del paquet
Si us plau, verifiqueu que tots els elements siguin presents al vostre paquet:
- 1 x LILYGO T-Deck Development Board
- 1 x 6-pin Header
- 1 x cable d'alimentació

Figure 3.1: Contents of the LILYGO T-Deck package, showing the main board, a 6-pin header, and a power cable.
4. Guia de configuració
Follow these steps for the initial setup of your LILYGO T-Deck:
- Connexió d'alimentació: Connect the provided power cable to the appropriate port on the T-Deck. Ensure the power source meets the board's voltage requisits.
- 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.
- 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.
- Primer arrencada: Once powered, the LCD should illuminate. If pre-flashed with firmware, it may display initial information or a demo.

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. Instruccions de funcionament
The LILYGO T-Deck is designed for custom application development. Its operation largely depends on the firmware loaded onto it. Here are general guidelines:
- Encès/apagat: Connect or disconnect the power cable. Some boards may have a dedicated power button or switch.
- Pantalla LCD: 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).
- Àudio: The onboard speaker and microphone allow for audio input and output, depending on your application's requirements.
- Connectivitat: Utilize Wi-Fi and Bluetooth for wireless communication with other devices or networks.
- Actualitzacions de firmware: Regularly check the LILYGO GitHub repository for the latest firmware, examples, and documentation to enhance functionality and address any known issues.
6. Manteniment
To ensure the longevity and optimal performance of your LILYGO T-Deck, follow these maintenance guidelines:
- Mantenir net: Use a soft, dry cloth to gently clean the board and display. Avoid using liquid cleaners or abrasive materials.
- Manejar amb cura: The board contains sensitive electronic components. Avoid dropping or subjecting it to physical shock.
- Emmagatzematge: Store the T-Deck in a cool, dry environment, away from direct sunlight, extreme temperatures, and high humidity.
- Font d'alimentació: Always use a stable and appropriate power supply to prevent damage to the board.
- Gestió de firmware: Keep your firmware updated to benefit from bug fixes and new features. Back up your custom code before flashing new firmware.
7. Solució De Problemes
If you encounter issues with your LILYGO T-Deck, consider the following troubleshooting steps:
- La placa no s'encén:
- Assegureu-vos que el cable d'alimentació estigui ben connectat.
- Verify that the power source is providing the correct voltage i corrent.
- 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.
- Problemes de connectivitat (Wi-Fi/Bluetooth):
- Verify your firmware includes the necessary Wi-Fi/Bluetooth libraries and configurations.
- Ensure correct network credentials are provided in your code.
- Comproveu si hi ha interferències d'altres dispositius sense fil.
- Errors de programació:
- 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. Especificacions tècniques
| Característica | Especificació |
|---|---|
| MCU | ESP32-S3FN16R8 Dual-core LX7 microprocessor |
| Connectivitat sense fil | 2.4 GHz Wi-Fi, Bluetooth 5 (LE) |
| Mostra | 2.8 inch ST7789 SPI Interface IPS LCD, 320x240 resolution, Full viewangle de ing |
| Memòria Flash | 16 MB |
| PSRAM | 8 MB |
| Onboard Peripherals | Trackball, Microphone, Speaker |
| Battery ADC Pin | IO04 |
| Dimensions (aprox.) | Height: 10cm, Width: 6.8cm, Thickness: 1.1cm |
| Suport del sistema operatiu | Linux (for development environment) |

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

Figure 8.2: LILYGO T-Deck showing approximate dimensions (Height: 10cm, Width: 6.8cm, Thickness: 1.1cm).
9. Assistència i garantia
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





