跳到主要内容

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(可选,用于电池供电)。

首次使用​

  1. 上电前接好喇叭;如需播放音乐或浏览照片,先插入准备好文件的 Micro SD 卡。
  2. 使用 USB 数据线连接开发板与电脑,或接入配套电池供电。
  3. 系统初始化完成后进入 APP 桌面,左右滑动可切换页面,每页显示 4 个 APP 图标。
  4. 按下文完成联网设置,即可使用天气、联网校时和小智 AI。

SD 卡目录​

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,可通过以下两种方法联网。已保存的网络优先于默认热点。

方法一:通过配网页面连接网络​

  1. 打开 "Settings" > "Wi-Fi setup",开发板会开启配网热点。
  2. 使用手机扫描屏幕上的二维码,或按屏幕显示的热点名称和密码连接开发板热点。
  3. 连接后进入配网页面;若未自动打开,请在浏览器中访问 开发板配网页面。
  4. 填写要连接的 Wi-Fi 名称和密码并提交,可使用 2.4 GHz 或 5 GHz 网络。
  5. 查看开发板屏幕上的连接状态。连接成功后保存网络信息,并在稍后关闭配网热点;退出配网页面也会关闭热点。

C5-2.8 Wi-Fi setup 热点二维码

手机扫码后的 Wi-Fi 配网页面操作示意

右图为手机配网页面操作示意,借用 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 下载模式

若烧录时无法识别端口,请断开 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 地址。

左上角返回箭头在子页面返回设置首页,在设置首页返回桌面。

Settings 设置主页

SD 卡容量信息

Wi-Fi 扫描结果

AIChats APP​

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

AIChats 小智 AI

Touch Test APP​

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

Touch Test 触摸绘画

GravityBall APP​

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

GravityBall 重力小球

Photos APP​

  • 上电前插入 SD 卡,将 JPG/JPEG 图片放在根目录的 photo 文件夹中。
  • 打开 APP 浏览图片,左右滑动切换上一张、下一张,图片按比例缩放显示。
  • 单张文件不超过 1 MB;大尺寸图片还受解码内存限制,加载失败时可缩小至 240 × 320 像素后重试。

Weather APP​

  • 联网后获取并显示深圳天气,点击刷新按钮可重新获取数据。
  • 使用前确认所连接的网络可访问互联网;Wi-Fi 已连接但无法访问天气服务时,天气数据仍可能更新失败。

Weather 深圳天气

Music APP​

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

Music 音乐播放器

Sensor APP​

  • PCF85063 实时时钟:显示硬件 RTC(Real-Time Clock,实时时钟)的日期和时间,按秒更新。
  • SHTC3 温湿度传感器:显示环境温度和相对湿度,约每秒更新一次。
  • QMI8658 六轴传感器:显示三轴加速度和角速度,转动或倾斜开发板可观察数据变化。
  • 传感器读取异常时,对应数据会显示 --,并显示状态信息。
桌面时间与 RTC 时间

桌面显示联网同步的北京时间,Sensor 显示硬件 RTC 的时间,两者独立。联网校时不会自动覆盖硬件 RTC,不要求两处时间一致。

Sensor 实时时钟、六轴和温湿度数据

2048 APP​

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

2048 游戏

Mic Test APP​

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

Mic Test 麦克风录音测试

Button Test APP​

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

Button Test BOOT 按键测试