ESP32-S3-Touch-LCD-3.49 出厂固件使用说明
本节介绍 ESP32-S3-Touch-LCD-3.49 出厂固件中各应用(APP)的功能和使用方法。
电池单独供电时,按住 PWR 按键约 2 秒,等待设备启动后再松开,即可开机。
如使用 18650 电池无法开机,请保持电池连接,同时接入 Type-C 电源,激活充电保护电路后重试。开机后可断开 Type-C,继续使用电池供电。
出厂固件采用 640 × 172 横屏桌面,集成 11 个 APP,包含显示测试、设置、小智 AI、相册、天气、音乐、传感器、麦克风测试、按键测试、电子徽章和数字时钟。小智 AI 在当前固件内运行,无需切换固件或重启;Wi-Fi 使用 2.4 GHz 频段。
本说明对应 V2 版本,PCB 带有 Rev1.1 丝印,外壳 QC 标签标有 V2。V1 与 V2 的背光及部分控制引脚不同,请使用与硬件版本匹配的固件。
器件准备
- ESP32-S3-Touch-LCD-3.49 V2 开发板 ×1。
- USB Type-C 数据线 ×1,用于供电和烧录。
- 配套 3.7 V 锂电池 ×1,使用电池供电或查看电池电压时需要。
- 喇叭 ×1,使用音乐播放、录音回放和小智 AI 时需要。
- Micro SD 卡 ×1,使用音乐和相册时需要,使用 FAT32 格式。
首次使用
- 上电前接好喇叭;如需播放音乐或浏览照片,先插入准备好文件的 Micro SD 卡。
- 使用 USB Type-C 数据线连接开发板与电脑,或使用配套电池供电。
- 系统初始化完成后进入 640 × 172 横屏 APP 桌面,左右滑动切换两页桌面,第一页显示 6 个图标,第二页显示 5 个图标。
- 按下文完成联网设置,即可使用天气、联网校时和小智 AI。Badge 通过手机连接开发板热点传图,无需 SD 卡或互联网。


SD 卡目录
在 SD 卡根目录准备以下文件夹,文件准备完成后在开发板上电前插入 SD 卡:
SD 卡根目录
├── music
│ └── music1.mp3
└── photo
└── photo1.jpg
music:存放 MP3 音乐文件。photo:存放 JPG/JPEG 图片,建议使用 640 × 172 像素的横向图片。- Mic Test 录音临时保存在内存中,无需 SD 卡;Badge 图片保存在内部 Flash 中,也无需 SD 卡。
读写 SD 卡时请勿拔卡;更换文件后重新打开对应 APP。
Wi-Fi 设置
ESP32-S3 支持 2.4 GHz Wi-Fi,可通过以下两种方法联网。已保存的网络优先于默认热点。
方法一:通过手机连接页面配网
- 打开 "Settings" > "Connect Wi-Fi",进入 "Phone connection" 页面。
- 使用手机扫描屏幕上的二维码,或手动连接开发板热点
S3-LCD-3.49-xxxxxx,热点密码为12345678。热点名称以开发板实际显示为准;二维码用于加入热点。 - 连接后打开设备管理首页;若未自动打开,在浏览器中访问 ESP32-S3-Touch-LCD-3.49 设备管理首页。手机提示“无互联网”时,保持连接开发板热点。
- 在首页选择 "Wi-Fi Setup",点击 "Scan nearby networks" 扫描附近网络,在 "Nearby networks" 中选择自己的 2.4 GHz Wi-Fi,或在 "Network name (SSID)" 中手动填写网络名称。
- 输入网络密码,点击 "Connect and Save"。正常连接并保存后,下次上电会优先连接该网络。



首页的两个入口共用同一个地址:"Wi-Fi Setup" 进入 /wifi 配网,"Transfer Images" 进入 /badge 管理徽章图片。两个页面均可通过 "Device home" 返回首页。
配网成功后热点继续保留,可返回首页继续传图。传图完成后点击网页 "Done" 返回首页,再切换配网;图片编辑期间暂停接受配网和扫描请求。完成操作后,可在首页点击 "Disconnect & close hotspot" 关闭热点。网页连续十分钟没有请求时会释放会话,需要时重新打开开发板的手机连接页面。
方法二:连接指定热点
未保存其他网络时,开发板会尝试连接以下热点。可在上电前开启手机热点,并保持名称和密码完全一致:
| 项目 | 设置 |
|---|---|
| 热点名称 | weather-wifi |
| 热点密码 | 12345678 |
| 频段 | 2.4 GHz |
连接可访问互联网的网络后,Weather APP 可获取深圳天气。开机时系统先从硬件 RTC 读取时间,联网校时成功后使用北京时间(UTC+8),并把时间写回 RTC。桌面与 Watch 使用同一系统时钟,Sensor 显示硬件 RTC 日历。
固件下载与烧录
烧录方法见 ESP32-S3-Touch-LCD-3.49 固件烧录教程。恢复完整出厂功能时,应烧录包含应用、分区表和语音模型的完整合并固件,烧录地址为 0x0,参数为 DIO / 80 MHz / 16 MB。
完整合并固件会清除已保存的 Wi-Fi 等设置,烧录后需重新配网。请勿将单独的 APP 固件当作完整合并固件烧录;两者的烧录地址不同。
若烧录时无法识别端口,请按住 BOOT,单击 RESET 后松开 BOOT,再选择对应串口烧录。下载完成后复位或重新上电运行程序。
APP 使用说明
点击桌面图标进入对应 APP。多数 APP 可通过返回箭头或从屏幕底部中间向上滑动返回桌面;Display Test 使用双击或 BOOT 退出。小智 AI 通过界面返回箭头返回桌面。
Music、Mic Test 和 AIChats 共用音频硬件,使用其他音频 APP 前,请先退出当前音频 APP。离开 Music 后停止播放。
| APP | 功能 |
|---|---|
| Display Test | 五色屏幕显示测试 |
| Settings | 亮度、音量、网络、SD 卡及设备信息 |
| AIChats | 小智 AI 激活与语音对话 |
| Photos | 浏览 SD 卡中的 JPG/JPEG 图片 |
| Weather | 获取深圳天气 |
| Music | 播放 SD 卡中的 MP3 音乐 |
| Sensor | 读取 RTC 时间和六轴传感器数据 |
| Mic Test | 双麦克风电平监测、录音及独立回放 |
| Button Test | BOOT 和 PWR 按键测试 |
| Badge | 通过手机上传和管理最多六张静态徽章图片 |
| Watch | 数字时钟、日期和校时状态 |
Display Test APP
- 打开后按红、绿、蓝、黄、白的顺序循环显示,每种颜色保持约 1 秒。
- 可检查异常线条、局部闪烁、缺显等显示问题。正常的颜色切换不属于异常闪烁。
- 双击屏幕同一位置或按 BOOT 退出。
Settings APP
- "Brightness":调节屏幕亮度,范围为 20~100%。
- "Volume":调节音量,范围为 0~100%。
- "Wi-Fi scan":扫描附近网络,仅用于扫描,不用于连接网络;通过左右箭头翻页查看结果。
- "Connect Wi-Fi":开启开发板热点,扫描二维码连接手机,再在设备管理首页选择配网或传图。
- "SD card":查看 SD 卡容量、文件系统容量及剩余空间,点击 "Refresh" 重新读取。
- "Device info":查看固件和 ESP-IDF 版本、屏幕分辨率、Flash、PSRAM、MAC 地址及电池电压。
亮度和音量设置可保存,重启后恢复;详情页面可上下滑动查看未显示的内容。

AIChats APP
- 使用前先联网,并按屏幕提示完成小智 AI 激活。
- 说出“你好小智”或点击 "Talk" 开始对话;点击 "Stop" 停止。
- 小智回复时,说出“你好小智”可打断回复并开始新一轮对话。
- 支持通过语音调节屏幕亮度和音量。
- 对话文字和激活说明支持上下滚动查看。
- 点击界面返回箭头返回桌面,无需切换固件或重启。
Photos APP
- 将 JPG/JPEG 图片放入 SD 卡根目录的
photo文件夹。 - 打开后全屏显示图片,左右滑动切换,到末尾后循环;图片按比例缩放并居中裁剪,铺满 640 × 172 显示区域。
- 建议提前将图片裁剪为 640 × 172 像素,避免主体被裁掉。单张文件不超过 1 MB;加载失败时可缩小图片后重新导出为普通 JPEG。
- 从屏幕底部向上滑动返回桌面。
Weather APP
- 联网后获取并显示深圳天气,包括日期、温度、天气状况、湿度、风速和风向,点击右上角刷新按钮可重新获取。
- 天气数据约每 5 分钟自动更新一次;显示的是固定城市深圳的天气,不根据设备位置自动切换城市。
- 断网后可显示本次运行中已获取的天气读数;尚未获取数据时提示等待联网。
- 使用前确认网络可以访问互联网;更新失败时,检查网络及天气服务是否可访问。
Music APP
- 上电前接好喇叭,将 MP3 文件放入 SD 卡根目录的
music文件夹。 - 打开后可播放、暂停,并切换上一首、下一首。
- 界面显示曲目、播放时间和进度,离开 APP 后停止播放。
Sensor APP
- PCF85063 实时时钟:显示硬件 RTC(Real-Time Clock,实时时钟)的日期和时间,约每秒更新一次。
- QMI8658 六轴传感器:显示三轴加速度和角速度,倾斜或转动开发板可观察数据变化。底部温度为六轴传感器内部温度,不作为环境温度测量值。
- RTC 读取异常时显示
--:--:--和 "RTC unavailable";六轴读取异常时,对应数据显示--。 - RTC 与系统时间同步:开机从 RTC 恢复系统时间,联网校时成功后再把北京时间写回 RTC。Sensor 读取硬件日历,桌面与 Watch 读取系统时钟。
- 有效 RTC 日期在重启后保留;只有检测到停振或无效日期时,才初始化为 2025 年 1 月 1 日 12:00:00。持续计时期间需保持 RTC 供电。

Mic Test APP
- 对着板载麦克风说话,分别观察 MIC1 和 MIC2 的音量条及数值变化。
- 点击 "Record" 同时录制两路麦克风,最长 5 秒后自动结束,也可点击 "Stop" 提前停止。
- 录音完成后,分别点击 MIC1、MIC2 回放对应麦克风的录音,可检查两路是否均有声音。
- 录音采用 16 kHz、16 位格式,临时保存在 PSRAM 中,无需 SD 卡。重新录音会覆盖上一段;暂停 APP 时保留已完成的录音,关闭 APP 或断电后清除。
- 回放音量使用 Settings 中的音量设置。
Button Test APP
- 检测 **BOOT(GPIO0)**和 **PWR(GPIO16)**两个按键。
- 先松开按键,再分别短按并松开一次。按下显示 "PRESSED",松开显示 "RELEASED";完成一次操作后对应计数加 1,并显示 "PASS"。
- 两个按键均通过后显示 "2 / 2 buttons passed",点击 "Test again" 可清零重测。
- 测试 PWR 时请短按后松开,不要长按约 2 秒,否则会触发关机。

Badge APP
Badge 在开发板内部 Flash 中保存并显示最多 六张静态图片,无需 SD 卡和互联网。正常重启后保留图片及当前选择;图片保持显示,不自动轮播。
首次添加图片
- 打开 "Badge"。尚未保存图片时显示引导页,点击 "Add images" 进入 "Manage images"。
- 手机连接屏幕显示的开发板热点,密码为
12345678,在浏览器中访问http://192.168.4.1。 - 在设备管理首页选择 "Transfer Images",打开 "Badge Manager"。也可先在 "Settings" > "Connect Wi-Fi" 开启热点,再从网页进入传图,无需提前打开 Badge APP。
- 在 "Slots" 中点击要写入的槽位,确认该槽位被选中。
- 在 "Editor" 中点击 "Choose File" 选择图片,拖动预览调整裁剪位置,通过 "Zoom" 调节缩放,按需设置 "Background" 背景颜色。
- 点击 "Upload To Selected Slot" 上传。成功后对应槽位显示缩略图;点击槽位可切换当前徽章图片。
- 添加完成后,点击网页 "Done" 返回设备管理首页,点击开发板上的 "Done" 返回图片显示。


网页支持选择 JPEG、PNG 或 WebP,浏览器会按横屏预览生成 640 × 172 像素 JPEG 后上传,单张上传上限为 256 KB。Badge 仅显示静态图片,不提供 GIF 动画播放。
替换图片前先选中目标槽位,上传验证成功后才替换原图;网页也可删除槽位中的图片。整片擦除 Flash 或覆盖存储图片的 assets 分区会删除已保存图片。
切图、管理与退出
- 全屏显示时左右滑动切换有图片的槽位,到末尾后循环;只有一张图片时不会变化。
- 轻点屏幕打开控制菜单,显示当前图片预览、图片数量和分页圆点。长按屏幕或长按后松手均不会打开菜单。
- 点击左右箭头切图,选择 "Manage images" 重新添加、替换或删除图片。
- 点击 "Close" 收起菜单;点击 "Exit" 返回桌面。全屏显示图片时,也可从底部边缘向上滑动退出。
- 开发板上的 "Done" 返回图片显示,手机已打开的编辑页仍可继续使用;退出 Badge APP 不会中断手机网页持有的编辑会话。
Watch APP
- 打开后全屏显示横向大数字时钟,包含小时、分钟、闪烁冒号和日期。
- 离线启动时读取硬件 RTC,联网后自动校时为北京时间(UTC+8),并把时间写回 RTC,供下次离线启动使用。
- 右下角 "UTC+8 / RTC" 表示时间来自 RTC,"UTC+8 / NTP SYNC" 表示本次运行已完成网络校时;校时后断网仍继续走时。
- RTC 和网络时间均不可用时显示占位符及 "RTC unset / Wi-Fi",可联网后等待校时。
- 从底部边缘向上滑动,或按 BOOT 返回桌面;无需 SD 卡。