项目标题里的 ESP32S31大概率是把 ESP32-S3 多打了一个 1。名称不准确没关系核心问题是这颗芯片驱动屏幕之后的实际刷屏表现点亮顺不顺、刷新卡不卡、内存够不够、批量测试能不能自动化。这篇文章按实际项目推进顺序来写先回答能不能用再给出接线、编译、烧录、测试和排错的全套操作。这次验证以一块常见的 SPI 屏为例比如 ST7789 驱动的 240x320 屏幕。同样流程适用于 ILI9341、ST7735、GC9A01 等驱动 IC 的屏如果你用的是 RGB 接口屏思路不变但接线和显存策略要调整。你不需要现在就有 LVGL 基础我会先给一个不依赖复杂图形库的刷屏测试程序再在此基础上加串口命令、批量烧录和性能观察。读完你至少能知道自己的板子和屏能不能点亮、刷一帧大概耗时多少、卡顿主要卡在哪一步、多块板子批量烧录怎么处理。这篇文章适合刚拿到 ESP32-S3 开发板想快速验证屏幕效果的嵌入式开发者也适合准备把屏幕功能做进产品的前期选型。1. 核心能力速览能力项说明芯片型号ESP32-S3题目里的 ESP32S31 大概率是笔误处理器双核 Xtensa LX7公开规格显示主频可达 240 MHz内存配置内置 SRAM常见模组分为不带 PSRAM、带 2MB/8MB/16MB PSRAM 等版本以实际购买型号为准Flash常见 4MB / 8MB / 16MB以具体模组丝印和购买页参数为准显示接口SPI、并行 8080、RGB 等常见 SPI 驱动 IC 有 ST7789、ILI9341、ST7735、GC9A01典型分辨率240x240、240x320、320x480、480x272 等取决于屏幕类型和驱动方式开发方式Arduino IDE、VS Code PlatformIO、ESP-IDF图形库TFT_eSPI、Arduino_GFX、LovyanGFX、LVGL调试方式串口日志、Web 控制、逻辑分析仪测 SPI 时序批量能力支持批量烧录、串口批量测试、多板自动化适合场景桌面摆件、传感器数据面板、智能家居控制面板、小型人机交互屏再强调一点刷屏效果不只看芯片屏幕接口、SPI 频率、是否开 RGB 接口、是否用 PSRAM都会影响体验。所以后面测试的目标是“在固定硬件配置下找到一组能稳定运行的参数”。2. 适用场景与使用边界2.1 适合谁快速原型验证用 Arduino 或 PlatformIO 点亮屏幕验证显示方案是否可行。小型 UI 面板温湿度计、时钟、开关面板、桌面卡片屏。批量产测多块板子批量烧录批量跑刷屏用例。LVGL 交互界面滚轮菜单、仪表盘、简单触摸交互。2.2 不适合什么不要指望它在 1080P RGB 屏上做复杂视频级界面内存和总线带宽都不够。没有 PSRAM 的版本跑大分辨率的 LVGL 界面会非常紧张。复杂动效、大图片、大量本地字体都需要提前考虑资源优化否则刷屏会明显变卡。2.3 使用边界与合规提醒使用 TFT_eSPI、LVGL 等开源库时注意对应的开源许可证。屏幕取模工具生成的 C 数组如果来自第三方固件或商业方案需要确认授权。产品中如果涉及用户数据、人脸、声音等隐私内容按相关法规处理。测试固件不要直接拿到产线批量刷写先保证引脚定义和电源设计经过验证。3. 环境准备与前置条件3.1 硬件清单ESP32-S3 开发板 1 块最好带 USB 串口芯片例如 CP2102 或 CH340。SPI 屏幕 1 块本文以 ST7789 的 240x320 为例。杜邦线若干用于连接开发板和屏幕。USB 数据线 1 根注意部分线只能供电不能传数据。可选面包板、独立 3.3V 电源模块。如果屏幕是 5V 供电版本需要单独处理电平转换不要直接把 5V 引脚接到 ESP32-S3 的 3.3V 系统上。3.2 接线关系SPI 屏幕常见引脚定义VCC - 3.3VGND - GNDSCL / SCK / CLK - SPI 时钟SDA / MOSI / DIN - SPI 数据CS - 片选DC / RS - 数据/命令选择RES / RST - 复位BLK / LED - 背光控制以下是示例接线不代表所有开发板都适用请以你手上的板子丝印和原理图为准。屏幕引脚ESP32-S3 GPIO备注VCC3V3确认模块支持 3.3VGNDGND必须共地SCLGPIO12SPI ClockSDAGPIO11SPI MOSICSGPIO10片选DCGPIO9数据/命令选择RSTGPIO8复位BLKGPIO7背光也可直接接 3V3接线完成后先量一遍 VCC 和 GND 是否短路避免上电烧模块。3.3 软件准备Arduino IDE 2.x 或 VS Code PlatformIO 插件。ESP32 开发板支持包即 Arduino 的 esp32 by Espressif。TFT_eSPI 库用于 SPI 屏幕驱动。LVGL 库做复杂 UI 时使用。串口驱动CP210x 或 CH340 对应驱动。准备过程中先确认三件事系统能否识别 USB 串口Windows 下对应 COM 号Linux 下通常是 /dev/ttyUSB0。开发板指示灯是否正常供电是否稳定。数据线是否真的支持数据传输而不是纯充电线。4. 安装部署与启动方式4.1 选择开发方式开发方式优点缺点Arduino IDE上手快库多适合快速验证工程管理弱复杂 UI 调试不便VS Code PlatformIO工程化依赖清晰批量烧录方便首次下载工具链时间较长ESP-IDFLVGL 集成度高适合产品级开发学习成本高需要更多配置如果只是验证刷屏效果推荐 PlatformIO。它能把库依赖写入工程配置文件换一台电脑也能很快恢复环境。4.2 PlatformIO 工程示例在 VS Code 里创建新工程platformio.ini可以写成这样[env:esp32-s3-devkitc-1] platform espressif32 board esp32-s3-devkitc-1 framework arduino monitor_speed 115200 lib_deps bodmer/TFT_eSPI说明board要根据自己的开发板型号调整。第一次编译会下载工具链和库耐心等待。monitor_speed是串口监视器的波特率要和代码里的Serial.begin(115200)一致。4.3 TFT_eSPI 引脚配置TFT_eSPI 默认有一套引脚配置但不同开发板差异很大。推荐改动工程配置而不是去改库文件里的User_Setup.h。在platformio.ini中追加build_flags -DUSER_SETUP_LOADED1 -DST7789_DRIVER1 -DTFT_WIDTH240 -DTFT_HEIGHT320 -DTFT_MOSI11 -DTFT_SCLK12 -DTFT_CS10 -DTFT_DC9 -DTFT_RST8 -DTFT_BL7 -DSPI_FREQUENCY40000000这里的引脚是示例必须按 3.2 节的接线表修改。如果出现花屏优先降低SPI_FREQUENCY比如改成 20000000。如果用 Arduino IDE可以直接编辑库目录下的User_Setup.h步骤类似但不同版本库文件位置不一样。4.4 烧录与运行在 PlatformIO 中点击 Upload或命令行执行pio run -t upload烧录完成后打开串口监视器pio device monitor如果上传失败通常是进入下载模式的问题。按住 BOOT 键同时按一下 RESET松开 BOOT再上传一次。烧录完成后屏幕应该能点亮并显示内容串口能正常输出日志。到这里基础运行链路已经通了。5. 功能测试与效果验证5.1 基础点亮测试目的验证屏幕能否正常初始化、背光是否工作、颜色填充是否正确。测试代码#include TFT_eSPI.h TFT_eSPI tft TFT_eSPI(); uint16_t testColors[] {TFT_RED, TFT_GREEN, TFT_BLUE, TFT_WHITE, TFT_BLACK}; const char* colorNames[] {RED, GREEN, BLUE, WHITE, BLACK}; void setup() { Serial.begin(115200); tft.init(); tft.setRotation(1); tft.fillScreen(TFT_BLACK); } void loop() { for (int i 0; i 5; i) { tft.fillScreen(testColors[i]); tft.setTextColor(testColors[i] TFT_BLACK ? TFT_WHITE : TFT_BLACK, testColors[i]); tft.setCursor(10, 10); tft.setTextFont(4); tft.print(colorNames[i]); delay(500); } }预期结果红、绿、蓝、白、黑五色切换正常颜色均匀没有花屏和闪烁。判断标准颜色边界清晰。字符位置正确。背光无频闪。如果白屏先查背光引脚和复位时序。如果花屏先查接线再降低 SPI 频率。5.2 文字显示测试目的确认屏幕旋转方向、英文字体显示和位置坐标。操作步骤用setRotation(0)到setRotation(3)切换方向观察文字方向是否和屏幕安装方向一致。用drawString或print显示数字、字母、符号。如果显示中文TFT_eSPI 默认不自带中文字库需要用取模工具生成字模或者改用 LVGL 加载字库。预期结果英文字符清晰。字符间距正常。旋转后的坐标符合预期。5.3 滚动刷屏与帧耗时测试目的观察高频刷新时是否卡顿并量化每帧耗时。代码#include TFT_eSPI.h TFT_eSPI tft TFT_eSPI(); void setup() { Serial.begin(115200); tft.init(); tft.setRotation(1); tft.fillScreen(TFT_BLACK); tft.setTextFont(4); } void loop() { static uint32_t counter 0; uint32_t start millis(); tft.fillScreen(TFT_NAVY); tft.setTextColor(TFT_WHITE, TFT_NAVY); tft.setCursor(10, 20); tft.print(ESP32-S3 Screen); tft.setTextColor(TFT_YELLOW, TFT_NAVY); tft.setCursor(10, 80); tft.print(Count: ); tft.println(counter); uint32_t elapsed millis() - start; uint32_t fps 1000 / (elapsed 0 ? elapsed : 1); tft.setTextColor(TFT_GREEN, TFT_NAVY); tft.setCursor(10, 140); tft.print(Frame ms: ); tft.println(elapsed); Serial.printf(frame: %u ms, fps: %u\n, elapsed, fps); delay(100); }预期结果屏幕上的计数器持续递增。串口输出能看到每帧耗时。数值没有突变说明刷新稳定。如果帧耗时明显波动要检查是否有其他任务抢占 CPU比如 Wi-Fi 连接或日志输出。高频刷屏时太频繁的Serial.printf本身就会影响帧耗时。5.4 LVGL 界面切换测试如果准备接入 LVGL不要一上来就做复杂界面先创建两个页面自动交替切换。操作步骤初始化 LVGL 和屏幕 ESP32-S3驱动SPI屏刷屏测试：从接线到性能优化全攻略
项目标题里的 ESP32S31大概率是把 ESP32-S3 多打了一个 1。名称不准确没关系核心问题是这颗芯片驱动屏幕之后的实际刷屏表现点亮顺不顺、刷新卡不卡、内存够不够、批量测试能不能自动化。这篇文章按实际项目推进顺序来写先回答能不能用再给出接线、编译、烧录、测试和排错的全套操作。这次验证以一块常见的 SPI 屏为例比如 ST7789 驱动的 240x320 屏幕。同样流程适用于 ILI9341、ST7735、GC9A01 等驱动 IC 的屏如果你用的是 RGB 接口屏思路不变但接线和显存策略要调整。你不需要现在就有 LVGL 基础我会先给一个不依赖复杂图形库的刷屏测试程序再在此基础上加串口命令、批量烧录和性能观察。读完你至少能知道自己的板子和屏能不能点亮、刷一帧大概耗时多少、卡顿主要卡在哪一步、多块板子批量烧录怎么处理。这篇文章适合刚拿到 ESP32-S3 开发板想快速验证屏幕效果的嵌入式开发者也适合准备把屏幕功能做进产品的前期选型。1. 核心能力速览能力项说明芯片型号ESP32-S3题目里的 ESP32S31 大概率是笔误处理器双核 Xtensa LX7公开规格显示主频可达 240 MHz内存配置内置 SRAM常见模组分为不带 PSRAM、带 2MB/8MB/16MB PSRAM 等版本以实际购买型号为准Flash常见 4MB / 8MB / 16MB以具体模组丝印和购买页参数为准显示接口SPI、并行 8080、RGB 等常见 SPI 驱动 IC 有 ST7789、ILI9341、ST7735、GC9A01典型分辨率240x240、240x320、320x480、480x272 等取决于屏幕类型和驱动方式开发方式Arduino IDE、VS Code PlatformIO、ESP-IDF图形库TFT_eSPI、Arduino_GFX、LovyanGFX、LVGL调试方式串口日志、Web 控制、逻辑分析仪测 SPI 时序批量能力支持批量烧录、串口批量测试、多板自动化适合场景桌面摆件、传感器数据面板、智能家居控制面板、小型人机交互屏再强调一点刷屏效果不只看芯片屏幕接口、SPI 频率、是否开 RGB 接口、是否用 PSRAM都会影响体验。所以后面测试的目标是“在固定硬件配置下找到一组能稳定运行的参数”。2. 适用场景与使用边界2.1 适合谁快速原型验证用 Arduino 或 PlatformIO 点亮屏幕验证显示方案是否可行。小型 UI 面板温湿度计、时钟、开关面板、桌面卡片屏。批量产测多块板子批量烧录批量跑刷屏用例。LVGL 交互界面滚轮菜单、仪表盘、简单触摸交互。2.2 不适合什么不要指望它在 1080P RGB 屏上做复杂视频级界面内存和总线带宽都不够。没有 PSRAM 的版本跑大分辨率的 LVGL 界面会非常紧张。复杂动效、大图片、大量本地字体都需要提前考虑资源优化否则刷屏会明显变卡。2.3 使用边界与合规提醒使用 TFT_eSPI、LVGL 等开源库时注意对应的开源许可证。屏幕取模工具生成的 C 数组如果来自第三方固件或商业方案需要确认授权。产品中如果涉及用户数据、人脸、声音等隐私内容按相关法规处理。测试固件不要直接拿到产线批量刷写先保证引脚定义和电源设计经过验证。3. 环境准备与前置条件3.1 硬件清单ESP32-S3 开发板 1 块最好带 USB 串口芯片例如 CP2102 或 CH340。SPI 屏幕 1 块本文以 ST7789 的 240x320 为例。杜邦线若干用于连接开发板和屏幕。USB 数据线 1 根注意部分线只能供电不能传数据。可选面包板、独立 3.3V 电源模块。如果屏幕是 5V 供电版本需要单独处理电平转换不要直接把 5V 引脚接到 ESP32-S3 的 3.3V 系统上。3.2 接线关系SPI 屏幕常见引脚定义VCC - 3.3VGND - GNDSCL / SCK / CLK - SPI 时钟SDA / MOSI / DIN - SPI 数据CS - 片选DC / RS - 数据/命令选择RES / RST - 复位BLK / LED - 背光控制以下是示例接线不代表所有开发板都适用请以你手上的板子丝印和原理图为准。屏幕引脚ESP32-S3 GPIO备注VCC3V3确认模块支持 3.3VGNDGND必须共地SCLGPIO12SPI ClockSDAGPIO11SPI MOSICSGPIO10片选DCGPIO9数据/命令选择RSTGPIO8复位BLKGPIO7背光也可直接接 3V3接线完成后先量一遍 VCC 和 GND 是否短路避免上电烧模块。3.3 软件准备Arduino IDE 2.x 或 VS Code PlatformIO 插件。ESP32 开发板支持包即 Arduino 的 esp32 by Espressif。TFT_eSPI 库用于 SPI 屏幕驱动。LVGL 库做复杂 UI 时使用。串口驱动CP210x 或 CH340 对应驱动。准备过程中先确认三件事系统能否识别 USB 串口Windows 下对应 COM 号Linux 下通常是 /dev/ttyUSB0。开发板指示灯是否正常供电是否稳定。数据线是否真的支持数据传输而不是纯充电线。4. 安装部署与启动方式4.1 选择开发方式开发方式优点缺点Arduino IDE上手快库多适合快速验证工程管理弱复杂 UI 调试不便VS Code PlatformIO工程化依赖清晰批量烧录方便首次下载工具链时间较长ESP-IDFLVGL 集成度高适合产品级开发学习成本高需要更多配置如果只是验证刷屏效果推荐 PlatformIO。它能把库依赖写入工程配置文件换一台电脑也能很快恢复环境。4.2 PlatformIO 工程示例在 VS Code 里创建新工程platformio.ini可以写成这样[env:esp32-s3-devkitc-1] platform espressif32 board esp32-s3-devkitc-1 framework arduino monitor_speed 115200 lib_deps bodmer/TFT_eSPI说明board要根据自己的开发板型号调整。第一次编译会下载工具链和库耐心等待。monitor_speed是串口监视器的波特率要和代码里的Serial.begin(115200)一致。4.3 TFT_eSPI 引脚配置TFT_eSPI 默认有一套引脚配置但不同开发板差异很大。推荐改动工程配置而不是去改库文件里的User_Setup.h。在platformio.ini中追加build_flags -DUSER_SETUP_LOADED1 -DST7789_DRIVER1 -DTFT_WIDTH240 -DTFT_HEIGHT320 -DTFT_MOSI11 -DTFT_SCLK12 -DTFT_CS10 -DTFT_DC9 -DTFT_RST8 -DTFT_BL7 -DSPI_FREQUENCY40000000这里的引脚是示例必须按 3.2 节的接线表修改。如果出现花屏优先降低SPI_FREQUENCY比如改成 20000000。如果用 Arduino IDE可以直接编辑库目录下的User_Setup.h步骤类似但不同版本库文件位置不一样。4.4 烧录与运行在 PlatformIO 中点击 Upload或命令行执行pio run -t upload烧录完成后打开串口监视器pio device monitor如果上传失败通常是进入下载模式的问题。按住 BOOT 键同时按一下 RESET松开 BOOT再上传一次。烧录完成后屏幕应该能点亮并显示内容串口能正常输出日志。到这里基础运行链路已经通了。5. 功能测试与效果验证5.1 基础点亮测试目的验证屏幕能否正常初始化、背光是否工作、颜色填充是否正确。测试代码#include TFT_eSPI.h TFT_eSPI tft TFT_eSPI(); uint16_t testColors[] {TFT_RED, TFT_GREEN, TFT_BLUE, TFT_WHITE, TFT_BLACK}; const char* colorNames[] {RED, GREEN, BLUE, WHITE, BLACK}; void setup() { Serial.begin(115200); tft.init(); tft.setRotation(1); tft.fillScreen(TFT_BLACK); } void loop() { for (int i 0; i 5; i) { tft.fillScreen(testColors[i]); tft.setTextColor(testColors[i] TFT_BLACK ? TFT_WHITE : TFT_BLACK, testColors[i]); tft.setCursor(10, 10); tft.setTextFont(4); tft.print(colorNames[i]); delay(500); } }预期结果红、绿、蓝、白、黑五色切换正常颜色均匀没有花屏和闪烁。判断标准颜色边界清晰。字符位置正确。背光无频闪。如果白屏先查背光引脚和复位时序。如果花屏先查接线再降低 SPI 频率。5.2 文字显示测试目的确认屏幕旋转方向、英文字体显示和位置坐标。操作步骤用setRotation(0)到setRotation(3)切换方向观察文字方向是否和屏幕安装方向一致。用drawString或print显示数字、字母、符号。如果显示中文TFT_eSPI 默认不自带中文字库需要用取模工具生成字模或者改用 LVGL 加载字库。预期结果英文字符清晰。字符间距正常。旋转后的坐标符合预期。5.3 滚动刷屏与帧耗时测试目的观察高频刷新时是否卡顿并量化每帧耗时。代码#include TFT_eSPI.h TFT_eSPI tft TFT_eSPI(); void setup() { Serial.begin(115200); tft.init(); tft.setRotation(1); tft.fillScreen(TFT_BLACK); tft.setTextFont(4); } void loop() { static uint32_t counter 0; uint32_t start millis(); tft.fillScreen(TFT_NAVY); tft.setTextColor(TFT_WHITE, TFT_NAVY); tft.setCursor(10, 20); tft.print(ESP32-S3 Screen); tft.setTextColor(TFT_YELLOW, TFT_NAVY); tft.setCursor(10, 80); tft.print(Count: ); tft.println(counter); uint32_t elapsed millis() - start; uint32_t fps 1000 / (elapsed 0 ? elapsed : 1); tft.setTextColor(TFT_GREEN, TFT_NAVY); tft.setCursor(10, 140); tft.print(Frame ms: ); tft.println(elapsed); Serial.printf(frame: %u ms, fps: %u\n, elapsed, fps); delay(100); }预期结果屏幕上的计数器持续递增。串口输出能看到每帧耗时。数值没有突变说明刷新稳定。如果帧耗时明显波动要检查是否有其他任务抢占 CPU比如 Wi-Fi 连接或日志输出。高频刷屏时太频繁的Serial.printf本身就会影响帧耗时。5.4 LVGL 界面切换测试如果准备接入 LVGL不要一上来就做复杂界面先创建两个页面自动交替切换。操作步骤初始化 LVGL 和屏幕