Introducción del proyecto
El Lilygo T-Display S3 es una placa de desarrollo basada en el ESP32-S3, equipada con una pantalla TFT de 1,9 pulgadas. Este proyecto proporciona guías de configuración detalladas y múltiples códigos de ejemplo para ayudar a los desarrolladores a comenzar rápidamente y utilizar esta placa de desarrollo para el desarrollo.
Ejemplo de proyecto T-Display S3
Preparación del medio ambiente
Instalar Arduino IDE
Asegúrese de tener instalada la última versión de Arduino IDE.
Instale el soporte de la placa ESP32
- En Arduino IDE, vaya a archivo -> preferencias, y agregue la siguiente URL a URL de administrador de tableros adicionales:
https://dl.espressif.com/dl/package_esp32_index.json

- Abierto Herramientas -> Tableros -> Gerente de tableros, busque «ESP32» e instale el soporte.

Descargar código de proyecto:
Descargar a través de la página web de GitHub (para principiantes)
- Visite la página del proyecto: https://github.com/teastainGit/LilyGO-T-display-S3-setup-and-examples.
- Click Código botón (a la derecha), luego seleccione descargar zip para obtener un archivo comprimido.

- Descomprima el archivo descargado en una carpeta local después de completarlo.
Descargar a través de la línea de comandos Git (para desarrolladores)
- instalar git:
- ventanas: descargar Git para Windows e instálalo.
- MacOS/Linux: Git suele estar preinstalado. De lo contrario, utilice un administrador de paquetes (por ejemplo,
sudo apt instalar giten Linux).
- Abra un símbolo del sistema/terminal:
- ventanas: Lanzamiento balazo (incluido con la instalación de Git).
- MacOS/Linux: Abra la aplicación Terminal.
- Ejecutar el comando Clonar:
git clone https://github.com/teastainGit/LilyGO-T-display-S3-setup-and-examples.git
Esto descargará el código a su directorio actual de línea de comandos.
Configurar la placa de desarrollo
- En Arduino IDE, seleccione Herramientas -> Tablero -> ESP32 Arduino -> Módulo de desarrollo ESP32S3.
- Seleccione el puerto correcto (generalmente
/dev/cu.usbserial-*ocom3, etc.).

Subir código de ejemplo
- Abre el LilyGo T-Display-S3 Setup.txt archivar en el proyecto y seguir las instrucciones.
- Tome el código de ejemplo ESPNOW_FOR_T_DISPLAY Como ejemplo:
// Example Code: ESPNOW_for_T_Display
#include <esp_now.h>
#include <WiFi.h>
void setup() {
Serial.begin(115200);
WiFi.mode(WIFI_STA);
if (esp_now_init() != ESP_OK) {
Serial.println("Error initializing ESP-NOW");
return;
}
}
void loop() {
// Main loop code
}
A través de este tutorial, puede comenzar rápidamente con la placa de desarrollo Lilygo T-Display S3 y aprovechar sus abundantes códigos de ejemplo para el desarrollo. ¡Esperamos que encuentres diversión e inspiración en este proyecto!
Nota:
Si necesitas el tablero, puedes comprarlo en su sitio: Pantalla en T S3
Lilygo T-Display S3 Configuración del proyecto y lista de verificación GPIO
De verdad Proyectos Lilygo T-Display S3, Los problemas más comunes son la selección de paquetes de placas, la configuración del controlador TFT, el comportamiento de los CDC/JTAG USB, la medición de la batería y los conflictos de GPIO con los pines de flejado de arranque. Verifique esto antes de agregar Wi-Fi, BLE, LVGL, sensores o código MQTT.
Verificaciones de proyectos antes de compilar ejemplos
| Elemento | Verificación recomendada | Síntoma típico |
|---|---|---|
| Perfil de placa | Selecciona ESP32S3 Dev Module o el perfil LILYGO correspondiente, habilita PSRAM si está instalada | El sketch compila pero falla durante gráficos o asignación LVGL |
| Controlador de pantalla | Confirma los pines ST7789, el pin de retroiluminación, la rotación y la configuración de TFT_eSPI o Arduino_GFX | Pantalla blanca, interfaz reflejada o colores incorrectos |
| Modo USB | Verifica USB CDC al arrancar, USB JTAG y los permisos del puerto serie | La subida funciona una vez pero el monitor serie desaparece |
| Alimentación y batería | Mide el divisor VBAT, el comportamiento del IC de carga, la corriente de reposo y la fuente de activación | El porcentaje de la batería es incorrecto o el modo de suspensión profunda consume demasiada energía |
Para un trabajo personalizado basado en PCB en el ESP32-S3, reserve los pasadores de flejado, mantenga las pistas de la pantalla corta SPI y pruebe la retención de la antena antes de ejecutar el diseño.




