1. Introducció
The LILYGO T-HMI ESP32-S3 is a versatile development board integrating an ESP32-S3 microcontroller with a 2.8-inch ST7789 LCD touch display. It features Wi-Fi and Bluetooth 5.0 connectivity, a TF card slot, and multiple interfaces for various applications. This manual provides essential information for setting up, operating, and maintaining your T-HMI module.
2. Característiques clau
- Microcontrolador: ESP32-S3R8 Dual-core LX7 microprocessor
- Memòria flaix: 16 MB
- PSRAM: 8 MB
- Visualització: 2.8-inch ST7789 IPS TFT LCD with 240x320 resolution
- Interfície tàctil: Resistive touch screen with included stylus/pen
- Connectivitat sense fils: Wi-Fi and Bluetooth 5 (LE)
- Emmagatzematge: Ranura per a targeta TF
- Interfícies: Type C USB, 5V DC socket, External Button Backup Interface, Grove connectors
- Onboard Functions: Boot, Reset, Power Button
- Programming Platform Support: Arduino-IDE, MicroPython
3. Producte acabatview

Figura 3.1: superior i inferior view of the LILYGO T-HMI ESP32-S3 development board, showcasing the integrated display and various components.

Figura 3.2: Detallada view of the LILYGO T-HMI ESP32-S3 printed circuit board (PCB), highlighting the ESP32-S3 chip, TF card slot, and various connectors.

Figure 3.3: The 2.8-inch ST7789 LCD touch display module with the included resistive stylus, used for precise interaction.

Figure 3.4: Comprehensive pinout diagram for the LILYGO T-HMI, detailing connections for the display, TF card, USB, and Grove interfaces.
4. Guia de configuració
4.1. Donant poder a la junta
The LILYGO T-HMI can be powered via the Type C USB interface or the 5V DC socket. Connect a compatible 5V power supply to either port. A red charging indicator LED will illuminate when power is supplied.
4.2. Instal·lació de la targeta TF
To utilize the TF card functionality, gently insert a microSD card into the designated TF card slot on the board. Ensure the card is inserted in the correct orientation until it clicks into place.
4.3. Arrencada inicial
Upon connecting power, the board will typically boot up and display a pre-loaded test program on the LCD. This program often checks the functionality of PSRAM, Flash, SD card, RSSI, and WiFi, as shown in Figure 3.1 and 3.3.
4.4. Configuració de l'entorn de desenvolupament
For custom programming, refer to the official LILYGO GitHub repository for the T-HMI module. This resource provides necessary drivers, libraries, and example code for Arduino-IDE and MicroPython development environments.
GitHub Repository: github.com/Xinyuan-LilyGO/T-HMI
5. Funcionament
5.1. Using the Touch Display
The 2.8-inch ST7789 LCD features a resistive touch screen. Use the provided stylus or a similar pointed, non-sharp object for accurate input. Avoid using excessive force to prevent damage to the screen.
5.2. Onboard Buttons
The board includes several buttons for control:
- Botó d'arrencada: Used for entering bootloader mode, typically for flashing new firmware.
- Botó de restabliment: Resets the ESP32-S3 microcontroller, restarting the current program.
- Botó d'engegada (ENCÈS/APAGAT): Controls the main power to the board.
5.3. Wireless Connectivity (Wi-Fi & Bluetooth)
The ESP32-S3 supports Wi-Fi and Bluetooth 5.0 (LE) for wireless communication. Functionality will depend on the firmware loaded onto the board. Refer to the development documentation for programming wireless features.
6. Manteniment
To ensure the longevity and optimal performance of your LILYGO T-HMI board, follow these maintenance guidelines:
- Neteja: Use a soft, dry cloth to clean the display and board. For stubborn smudges on the screen, a slightly damp, lint-free cloth can be used. Avoid abrasive cleaners or solvents.
- Emmagatzematge: Guardeu la placa en un lloc fresc i sec, allunyat de la llum solar directa, temperatures extremes i humitat elevada.
- Manipulació: Handle the board by its edges to avoid touching sensitive components. Static electricity can damage electronic components, so consider using anti-static precautions when handling.
- Font d'alimentació: Always use a stable 5V power supply within the specified current limits.
7. Solució De Problemes
If you encounter issues with your LILYGO T-HMI board, consider the following common troubleshooting steps:
7.1. Display Not Lighting Up
- Ensure the power supply is correctly connected and providing 5V.
- Check the Type C USB cable or 5V DC adapter for damage.
- Verify that the board's power switch (if present and used) is in the ON position.
7.2. SD Card Not Detected (FAIL on Test Screen)
- Ensure the TF card is fully inserted into its slot.
- Try a different TF card to rule out card corruption or incompatibility.
- Format the TF card to a compatible file sistema (per exemple, FAT32).
7.3. Wi-Fi/Bluetooth Connectivity Issues (FAIL on Test Screen)
- Ensure the antenna (if external) is properly connected.
- Verify that the firmware loaded on the ESP32-S3 includes the necessary Wi-Fi/Bluetooth drivers and application logic.
- Comproveu si hi ha interferències d'altres dispositius sense fil.
7.4. Board Not Responding
- Premeu el botó Restableix.
- Desconnecteu i torneu a connectar la font d'alimentació.
- If flashing new firmware, ensure the board is in bootloader mode (often by holding the Boot button while powering on or resetting).
8. Especificacions
| Característica | Especificació |
|---|---|
| Marca | LILYGO |
| Model | T-HMI ESP32-S3 |
| Microcontrolador | ESP32-S3R8 Dual-core LX7 microprocessor |
| Memòria Flash | 16 MB |
| PSRAM | 8 MB |
| Tipus de visualització | 2.8 inch ST7789 IPS TFT LCD |
| Resolució de visualització | 240 x 320 píxels |
| Zona LCD | 48.6 x 64.8 mm |
| Pantalla tàctil | Resistent |
| Connectivitat sense fil | Wi-Fi, Bluetooth 5 (LE) |
| Interfícies | USB Type-C, 5V DC Socket, TF Card Slot, Grove Connectors |
| Entrada de potència | 5V DC |
| País d'origen | Xina |

Figure 8.1: Detailed technical specifications and physical dimensions of the LILYGO T-HMI ESP32-S3 module.
9. Suport
For further technical support, documentation, and community resources, please visit the official LILYGO GitHub repository and community forums.
Official GitHub: github.com/Xinyuan-LilyGO/T-HMI
For general inquiries or product information, you may visit the LILYGO store on Amazon:
LILYGO Amazon Store: LILYGO Store





