T-Display-S3深拆：自带屏的ESP32-S3

这块板子把屏幕焊死在了身上

今天中午我们刚拆过乐鑫官方的 ESP32-S3-DevKitC-1，那是一块纯粹的"裸芯+调试"板。如果你嫌还得自己接屏、自己配驱动太麻烦，LilyGO 的 T-Display-S3 就是另一个思路：直接把一块 1.9 寸彩屏焊在 ESP32-S3 上，到手就是一台能显示的小终端。本文参数全部对照官方仓库 Xinyuan-LilyGO/T-Display-S3 的 README 与原理图资料，截至2026年11月14日。

T-Display-S3板子实拍

先给一个整体定位：它不是"性能最强"的 ESP32-S3 板，而是"开箱即带屏"的板。适合做桌面小仪表、便携测控终端、复古游戏机这类项目，省掉了选屏、画排线、调时序这一整套琐事。

核心参数：ESP32-S3R8 + 16MB Flash + 8MB PSRAM

逐项对照 README 规格表：

主控：ESP32-S3R8，双核 Xtensa LX7，主频最高 240MHz；
Flash：16MB；
PSRAM：8MB，OPI 方式（八线），跑 LVGL 这类需要大缓冲的图形库很宽裕；
无线：2.4GHz WiFi 与蓝牙 BLE 5（ESP32-S3 芯片原生能力）；
USB：Type-C 接口，支持 CDC 和 JTAG 两种 USB 模式；
屏幕：1.9 英寸，分辨率 320x170，驱动 IC 为 ST7789V。

价格方面，官方仓库没有标价，lilygo.cc 商店页有变体链接但本次抓取未取到稳定价格数字，这里如实写：官方未公布统一零售价，以 lilygo.cc 实时页面为准（截至2026年11月14日）。

屏幕与引脚：GPIO15 是第一个坑

屏幕侧占了十多个 GPIO：背光 GPIO38，数据线 D0-D7 用的是 GPIO39/40/41/42/45/46/47/48，CS、DC、WR、RD 分别挂在 GPIO6/7/8/9，复位是 GPIO5。用的是 8080 并口，刷新率有保证，ST7789 这颗 IC 也是开源图形库支持最全的型号之一。

T-Display-S3引脚分配图

板上还有两个实体按键：GPIO0 是 BOOT 键，GPIO14 是自定义按键。I2C 引脚为 SCL=17、SDA=18，触摸中断 GPIO16、触摸复位 GPIO21（Touch 版本）。如果想扩展存储，SD 卡的 CMD/CLK/D0 是 GPIO13/11/12，但注意：标准版板上并没有 SD 卡槽，这些引脚只有装上 TF Shield 扩展板后才可用。

T-Display-S3 Touch触摸版

新手最容易踩的坑是 GPIO15。它是外设电源总开关，用电池或 5V 排针供电时，必须先拉高 GPIO15，否则屏幕不亮：

void setup() {
    pinMode(15, OUTPUT);
    digitalWrite(15, HIGH);
}

这句话官方 FAQ 里写了不止一遍，因为 USB 供电时屏幕默认能亮，一切换电池供电就"黑屏"，很多人会误判成硬件坏了。

电源：电池接口齐全，ADC 有条件

电源参数照抄 README 的电气参数表：USB-C 输入 5V；电池电压 3.7V~4.2V；电池座是 JST 1.25mm；排针提供 VBUS 5V 和 VBAT 4.2V；3V 排针负载不要超过 100mA。默认充电电流 500mA，想改充电电流要去 issue 区找官方给的调整方法。

板载电池电压检测走 GPIO4 的 ADC。但有个限制要记牢：只有拔掉 USB-C 时才能读到电池电压，插着 USB 时这个通道读不出数值。板上还有两颗状态灯：红色充电指示灯（充电时常亮、充满熄灭）和绿色 V3V 指示灯（USB 供电时常亮）。

WiFi天线切换电阻位置示意

WiFi 天线默认用板载天线，想换外置天线得转动板上指定位置的电阻来切换。

软件支持：Arduino、PlatformIO、MicroPython 都有路

驱动这块生态相当成熟。TFT_eSPI 官方内置了配置文件 Setup206_LilyGo_T_Display_S3，在 User_Setup_Select.h 里注释掉默认配置、放开这一行就能用：

#include "User_Setups/Setup206_LilyGo_T_Display_S3.h"

仓库自带的示例覆盖面很广：TFT_eSPI 和 Arduino_GFX 两套图形库的演示、LVGL demo、NES 模拟器、OTA 升级、电池电压读取、I2C 扫描、触摸测试，还有一整族 MIDI 示例（BLE MIDI 收发、USB MIDI 桥、和弦可视化），把这块屏能玩的场景基本铺满了。

IDE 配置有几个硬性要求：CPU 频率选 240MHz (WiFi)，Flash 选 QIO 80MHz、16MB，PSRAM 选 OPI PSRAM，分区表选 16M Flash (3M APP/9.9MB FATFS)。README 特别提醒 Arduino-esp32 核心目前用 2.0.14 版本测试，更高的版本可能与 TFT_eSPI 冲突，遇到编译问题先降级。MicroPython 方面官方指向 russhughes/st7789s3_mpy 和 lilygo-micropython 两个仓库，ESP-IDF 用户则可以去 LilyGo-Display-IDF 找对应例程。