ESP32-C5-Touch-LCD-2.8 出厂固件使用说明
本节介绍 ESP32-C5-Touch-LCD-2.8 出厂固件中各应用(APP)的功能和使用方法。
以下说明对应 12 APP 出厂固件,支持 2.4 GHz 和 5 GHz Wi-Fi。请按完整产品型号选择固件。
器件准备
- ESP32-C5-Touch-LCD-2.8 ×1。
- USB 数据线 ×1,用于供电和烧录。
- 喇叭 ×1,使用音乐播放、录音回放和小智 AI 时需要。
- Micro SD 卡 ×1,使用音乐播放器和电子相册时需要;使用 FAT32 格式,容量不超过 64 GB。
- 配套电池 ×1(可选,用于电池供电)。
首次使用
- 上电前接好喇叭;如需播放音乐或浏览照片,先插入准备好文件的 Micro SD 卡。
- 使用 USB 数据线连接开发板与电脑,或接入配套电池供电。
- 系统初始化完成后进入 APP 桌面,左右滑动可切换页面,每页显示 4 个 APP 图标。
- 按下文完成联网设置,即可使用天气、联网校时和小智 AI。
SD 卡目录
将需要浏览的 JPG/JPEG 图片放入 SD 卡根目录的 photo 文件夹,将 MP3 音频放入根目录的 music 文件夹。
SD 卡根目录
├── music
│ ├── music1.mp3
│ └── music2.mp3
└── photo
├── photo1.jpg
└── photo2.jpeg
music:存放 MP3 音乐文件。photo:存放 JPG/JPEG 图片,建议使用 240 × 320 像素图片以减少内存占用。- 应用只读取上述文件夹中的文件,不扫描下级目录。更换文件或重新插卡后,请重新打开对应 APP。
- 读写 SD 卡时请勿拔卡。Mic Test 录音保存在内存中,无需 SD 卡。
文件准备完成后,在开发板上电前插入 SD 卡。
Wi-Fi 设置
出厂固件支持连接 2.4 GHz 和 5 GHz Wi-Fi,可通过以下两种方法联网。已保存的网络优先于默认热点。
方法一:通过配网页面连接网络
- 打开 "Settings" > "Wi-Fi setup",开发板会开启配网热点。
- 使用手机扫描屏幕上的二维码,或按屏幕显示的热点名称和密码连接开发板热点。
- 连接后进入配网页面;若未自动打开,请在浏览器中访问 开发板配网页面。
- 填写要连接的 Wi-Fi 名称和密码并提交,可使用 2.4 GHz 或 5 GHz 网络。
- 查看开发板屏幕上的连接状态。连接成功后保存网络信息,并在稍后关闭配网热点;退出配网页面也会关闭热点。


右图为手机配网页面操作示意,借用 S3-3.5 图片;C5-2.8 实际支持 2.4 GHz 和 5 GHz Wi-Fi。
开发板的配网热点与目标网络共用无线信道。连接 5 GHz 网络时,手机可能与配网热点断开,请查看开发板屏幕上的连接状态,或重新连接配网热点。
方法二:连接指定热点
未保存其他网络时,开发板会尝试连接以下热点。可在上电前开启手机热点,并保持名称和密码完全一致:
| 项目 | 设置 |
|---|---|
| 热点名称 | weather-wifi |
| 热点密码 | 12345678 |
| 频段 | 2.4 GHz 或 5 GHz |
连接可访问互联网的网络后,桌面时间会同步为北京时间,Weather APP 可获取深圳天气。桌面时间未完成同步时显示 --:--。
固件下载与烧录
下载入口见 ESP32-C5-Touch-LCD-2.8 相关资料。新版工程的出厂源码位于 examples/factory,合并固件位于 firmware 目录。烧录方法参见 ESP32-C5-Touch-LCD-2.8 固件烧录教程。
若烧录时无法识别端口,请断开 USB,按住 BOOT 后将开发板连接到电脑,再松开 BOOT。下载完成后重新上电运行程序。
APP 使用说明
点击桌面图标进入对应 APP。除 Display Test 使用双击退出外,可从屏幕底部中间向上滑动返回桌面;部分 APP 也提供返回按钮。
同一时间只运行一个 APP。退出 Music、Mic Test 或 AIChats 后会停止对应音频功能,Music 不会在后台继续播放。
Display Test APP
- 打开后按红、绿、蓝、黄、白的顺序循环显示,每种颜色保持约 1 秒。
- 可检查异常线条、局部闪烁、缺显等显示问题。正常的颜色切换不属于异常闪烁。
- 双击屏幕任意位置退出。开机后进入桌面,需要手动打开此 APP。





Settings APP
- "Brightness":调节屏幕亮度。
- "Volume":调节音量。
- "Wi-Fi scan":扫描附近网络,仅用于扫描,不用于连接或更改已保存的网络。
- "Wi-Fi setup":开启配网热点,通过手机配置网络。
- SD 卡页面:查看容量、剩余空间和文件系统信息,点击 "Refresh" 刷新。
- "About":查看产品型号、固件信息和 MAC 地址。
左上角返回箭头在子页面返回设置首页,在设置首页返回桌面。



AIChats APP
- 集成小智 AI 对话功能,使用前先联网,并按屏幕提示完成激活。
- 说出“你好小智”或点击 "Talk" 开始对话,点击 "Stop" 停止。
- 支持通过语音调节屏幕亮度和音量。
- 从屏幕底部中间向上滑动可退出,无需切换或重新烧录其他固件。

Touch Test APP
- 在屏幕上滑动手指进行绘画,红色笔迹随触摸位置显示。
- 可覆盖屏幕四周边缘和四个角落,检查有无断触或位置偏移。
- 点击左上角返回按钮或按 BOOT 可退出,也可使用底部上滑手势返回桌面。

GravityBall APP
- 打开前将开发板水平静置,等待约 2 秒完成校准。
- 倾斜开发板,小球会随倾斜方向移动,可移动至屏幕四周。
- 按 BOOT 可重新校准,校准时保持开发板水平静止。

Photos APP
- 上电前插入 SD 卡,将 JPG/JPEG 图片放在根目录的
photo文件夹中。 - 打开 APP 浏览图片,左右滑动切换上一张、下一张,图片按比例缩放显示。
- 单张文件不超过 1 MB;大尺寸图片还受解码内存限制,加载失败时可缩小至 240 × 320 像素后重试。
Weather APP
- 联网后获取并显示深圳天气,点击刷新按钮可重新获取数据。
- 使用前确认所连接的网络可访问互联网;Wi-Fi 已连接但无法访问天气服务时,天气数据仍可能更新失败。

Music APP
- 上电前接好喇叭,并将 MP3 文件放入 SD 卡根目录的
music文件夹。 - 打开 APP 后可播放、暂停,并切换上一首、下一首。
- 界面显示曲目、播放时间和播放进度。退出 APP 后停止播放。

Sensor APP
- PCF85063 实时时钟:显示硬件 RTC(Real-Time Clock,实时时钟)的日期和时间,按秒更新。
- SHTC3 温湿度传感器:显示环境温度和相对湿度,约每秒更新一次。
- QMI8658 六轴传感器:显示三轴加速度和角速度,转动或倾斜开发板可观察数据变化。
- 传感器读取异常时,对应数据会显示
--,并显示状态信息。
桌面显示联网同步的北京时间,Sensor 显示硬件 RTC 的时间,两者独立。联网校时不会自动覆盖硬件 RTC,不要求两处时间一致。

2048 APP
- 上下左右滑动合并相同数字的方块,界面显示当前分数和最佳分数。
- 点击 "New" 重新开始。退出后再次进入可继续当前棋盘,断电后的进度不保留。

Mic Test APP
- 对着板载麦克风说话,观察音量条和数值随声音变化。
- 点击 "Record" 开始录音,点击 "Stop" 停止,点击 "Play" 回放;使用回放前先接好喇叭。
- 单次最长录音 10 秒,录音临时保存在内存中,无需 SD 卡,退出 APP 后清除。
- 音量条监测时不会实时通过喇叭播放麦克风声音。

Button Test APP
- 此 APP 仅检测 BOOT(GPIO28),不包含 BAT_PWR 按键检测。
- 先松开 BOOT,再短按并松开一次。状态随按下、松开变化,完成一次操作后计数加 1,并显示 "PASS"。
- 测试通过后显示 "1 / 1 button passed",点击 "Test again" 可清零重测。
