10分钟点亮ESP32屏幕：esp32-smartdisplay从克隆到首次显示的9步完整上手教程

10分钟点亮ESP32屏幕：esp32-smartdisplay从克隆到首次显示的9步完整上手教程

【免费下载链接】esp32-smartdisplayPlatformIO library LVGL Drivers for Sunton Smart display boards (CYD Cheap Yellow Display). This library supports these boards without any effort. ESP32-2432S024N/R/C, ESP32-2432S028R/C, ESP32-3248S035R/C, ESP32_8048S070N/C项目地址: https://gitcode.com/gh_mirrors/es/esp32-smartdisplay

esp32-smartdisplay是一款专为 Sunton 系列 ESP32 屏幕开发板（也就是大家常说的 CYD "Cheap Yellow Display" 小黄板）打造的LVGL 屏幕驱动库。它把屏幕、触摸、背光、RGB 灯、光线传感器统统封装好，让你不用再和 TFT 引脚配置较劲，克隆仓库后按 9 个步骤走一遍，10 分钟即可点亮你的 ESP32 液晶屏并显示 LVGL 界面 🎉。

为什么需要 esp32-smartdisplay 这个库？

很多新手第一次买 ESP32 屏幕板（如 ESP32-2432S024C），打开官方示例却发现：

• 要配置一大堆引脚参数才能显示；
• 第三方图形库（TFT_eSPI、LovyanGFX）夹带大量无关代码；
• 触摸驱动、旋转、LVGL 集成都要自己接。

而esp32-smartdisplay基于乐鑫官方的esp_lcd接口重写驱动，依赖 LVGL 9.2+，开箱即用。它支持以下常见小黄板（N=无触摸、R=电阻触摸、C=电容触摸）：

下面是使用该库的 Demo 程序在实际屏幕上的首次显示效果，可以看到 FPS 与内存监控浮层：

准备工作：安装 PlatformIO（第 1 步）

本库基于PlatformIO使用，这是嵌入式开发中非常流行的构建工具（可装在 VS Code 里当插件）。只需确认你的 PlatformIO 能正常编译一个任意 ESP32 工程，就可以进入下一步了。

克隆 esp32-smartdisplay 仓库（第 2 步）

打开终端，执行下面命令克隆仓库。注意带上--recurse-submodules参数，否则boards/目录下的开发板定义不会被拉取，PlatformIO 就认不出你的小黄板：

git clone --recurse-submodules https://gitcode.com/gh_mirrors/es/esp32-smartdisplay

如果之前已经克隆过，可以在仓库目录里补执行：

git submodule init git submodule update

放置开发板定义（第 3 步）

boards/目录里存放着全部小黄板的 JSON 定义文件。PlatformIO 会自动识别项目根目录下的boards/文件夹。

• 新建项目：把克隆仓库的boards/作为子模块加进你的项目；
• 已有项目：直接把定义文件复制到~/.platformio/platforms/espressif32/boards/也可全局可用。

创建工程并添加库（第 4 步）

用 PlatformIO 新建一个工程（新安装里可能看不到这些板子，先用任意 ESP32 板创建，稍后修改即可），然后在工程根目录的platformio.ini中加入：

lib_deps = rzeldent/esp32_smartdisplay

这一行会自动下载 esp32-smartdisplay 库及其依赖的 LVGL 图形库。

创建 LVGL 配置文件 lv_conf.h（第 5 步）

LVGL 需要一个配置文件lv_conf.h。做法：

1. 打开 LVGL 库自带的模板文件（编译后位于.pio/libdeps/<board>/lvgl/lv_conf_template.h）；
2. 复制到项目的include目录，改名为lv_conf.h，并把开头的#if 0改为#if 1；
3. 确认颜色深度为 16

【免费下载链接】esp32-smartdisplayPlatformIO library LVGL Drivers for Sunton Smart display boards (CYD Cheap Yellow Display). This library supports these boards without any effort. ESP32-2432S024N/R/C, ESP32-2432S028R/C, ESP32-3248S035R/C, ESP32_8048S070N/C项目地址: https://gitcode.com/gh_mirrors/es/esp32-smartdisplay