介绍
LilyGO T-Display S3是一款基于ESP32-S3的开发板,配备1.9英寸TFT显示屏。本工程提供了详细的设置指南和多个示例代码,旨在帮助开发者快速上手并使用该开发板进行开发。
T-Display S3项目示例
环境准备
安装Arduino IDE
请确保已安装最新版本的Arduino IDE。
安装ESP32板子支持
- 在Arduino IDE中,转到文件 -> 偏好设置,并将以下URL添加到附加板子管理器URL:
https://dl.espressif.com/dl/package_esp32_index.json
- 打开工具 -> 板子 -> 板子管理器,搜索“esp32”并安装支持。
下载项目代码:
通过GitHub网页下载(适合初学者)
- 访问项目页面:https://github.com/teastainGit/LilyGO-T-display-S3-setup-and-examples。
- 点击代码按钮(在右侧),然后选择下载ZIP以获取压缩文件。
- 下载完成后,解压文件到本地文件夹。
通过Git命令行下载(适合开发者)
步骤:
- 安装Git:
- Windows:下载Git for Windows并安装。
- macOS/Linux:Git通常预装。如果没有,请使用包管理器(例如,
sudo apt install git在Linux上)。
- 打开命令提示符/终端:
- Windows:启动Git Bash(随Git安装)。
- macOS/Linux:打开终端应用程序。
- 运行克隆命令:
git clone https://github.com/teastainGit/LilyGO-T-display-S3-setup-and-examples.git
这将把代码下载到您的当前命令行目录。
配置开发板
- 在Arduino IDE中,选择工具 -> 板子 -> ESP32 Arduino -> ESP32S3 Dev Module。
- 选择正确的端口(通常是
/dev/cu.usbserial-*或COM3等)。
上传示例代码
- 打开项目中的LilyGO T-Display-S3 Setup.txt文件,并按照说明操作。
- 以ESPNOW_for_T_Display为例:
// 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
}
通过本教程,您可以快速上手LilyGO T-Display S3开发板,并利用其丰富的示例代码进行开发。我们希望您在这个项目中找到乐趣和灵感!
注意:
Se hai bisogno della scheda, puoi acquistarla dal loro sito: T-Display S3
Setup progetti LILYGO T-Display S3 e checklist GPIO
Nei progetti LILYGO T-Display S3, gli errori tipici riguardano profilo scheda, driver TFT, USB CDC/JTAG, misura batteria e conflitti GPIO con boot strapping pins. Verificare prima di aggiungere Wi-Fi, BLE, LVGL, sensori o MQTT.
Controlli prima di compilare gli esempi
| Voce | Controllo | Sintomo |
|---|---|---|
| Board profile | ESP32S3 Dev Module o profilo LILYGO, PSRAM se presente | Compila ma crasha con grafica o LVGL |
| Display driver | Pin ST7789, backlight, rotation, TFT_eSPI o Arduino_GFX | Schermo bianco, UI specchiata o colori errati |
| USB mode | USB CDC on boot, USB JTAG e permessi seriale | Upload una volta, poi sparisce il serial monitor |
| Power e batteria | VBAT divider, charging IC, sleep current, wake source | Percentuale errata o deep sleep troppo alto |
Per un PCB custom ESP32-S3, riservare gli strapping pins, tenere corte le piste SPI display e verificare l’antenna keep-out.




