开头:一次扎实的补课式更新

小智 AI(xiaozhi-esp32)在 10 月 11 日发布了 v2.5.2 版本。这个版本不是憋大招的大更新,更像一次扎实的补课:188 个固件变体覆盖 154 个板型目录,全部改用 ESP-IDF 6.1.0 构建,新增了几块板子的支持,同时修掉了一批实际使用中能感知到的 bug。

先说这次值得关注的点。

新增的板子

v2.5.2 一共进了 5 个新板型,最值得说的是乐鑫官方的 ESP-Mosaico。这是乐鑫自家的新开发板,从发布起就直接进了小智主线,后面买这块板子玩小智会很省事。

其他几块:

• Guition JC4827W543:4.3 寸 480×272 屏的 ESP32-S3 板子,做语音面板类项目挺合适
• LILYGO T-Circle-S3 V1.1:老用户手里的 1.1 版硬件终于有对应固件了
• LC-S3-WIFI:1.54 寸 TFT 的小尺寸 ESP32-S3 板
• chd 系列三块板:chd-esp32s3-box、chd-esp32s3-box-lcd35、chd-esp32s3-eye,一次进来一整个系列

另外 FoloToy AI Passport 加了分级空闲功耗策略,待机时功耗会阶梯式下降,对电池供电的设备是实打实的续航提升。

还有一个对开发者有用的重构:墨水屏(epaper)显示驱动被抽成了公共类。以前各家板子的墨水屏代码各写各的,现在收敛到一处,后面想给自己的墨水屏板子适配小智,工作量会小不少。

修掉的问题

这版的修复列表看着琐碎,但好几条是普通用户能直接感知到的:

• MQTT 发送 UDP 音频不再持有 channel_mutex_ 锁。这条对语音对话流畅度影响最大,之前锁竞争会造成语音卡顿。
• OTA 版本解析不再抛异常。之前遇到非标准版本号格式,升级流程可能直接挂掉。
• ESP-Vocat 板子软复位后 PCB 版本检测稳定了,外设 I2C 偶发读取失败也能容忍,不会影响启动。
• GC0308 摄像头的一个 Kconfig 拼写笔误被修掉。这个笔误直接导致 BOX3 的摄像头驱动没被编进固件,用到 BOX3 视觉功能的朋友建议更新。
• 其他还有:websocket hello 阶段的字段判空、主题颜色过短不再触发 abort、cJSON 打印自定义消息后的内存释放、ogg 结尾零长度 lace 包的边界处理、微雪 3.5b 屏软件旋转时的缓冲区索引修正。

这版有 11 位贡献者是第一次给小智提 PR,从 websocket 到墨水屏,基本每个修复背后都是有人被实际问题烦到了才动手的。这种社区节奏也是小智能一直保持活跃的原因。

怎么刷?

Release 页面每个板型一个 zip,里面是 merged-binary.bin 合并固件,附了 SHA-256 校验文件和完整的变体清单,188 个构建全部通过。官方也照例提醒:构建通过不等于硬件验证过,动手刷之前最好看一下自己板型对应的 issue 区。

如果你不想折腾 Python 环境、idf.py 和驱动,可以用在线烧录:鹿戴马平台已经同步更新了 v2.5.2 全系固件,基于 Web Serial 直连芯片,不用装 Python、不用装 esptool、不用装任何驱动软件(Chrome / Edge 浏览器即可)。

第一步:打开 16302.com/xiaozhiinit,选好你的板子型号:

第二步:用 Type-C 线把设备连到电脑,点击「连接设备」,浏览器弹出串口授权框选中设备,自动识别出芯片型号。

第三步:点一下开始烧录,工具自动完成擦除和固件烧录,进度实时显示,看到完成提示后断开设备,配网就能开始和小智对话了。

Windows、Mac、Linux 的浏览器都能用,手里有 ESP32-S3 开发板还没玩过小智的,从打开页面到听到小智开口说话,大概就十分钟的事。

在线烧录入口(v2.5.2 全系固件已同步,需 Chrome/Edge 支持 Web Serial):https://www.16302.com/xiaozhiinit
发布说明:https://github.com/78/xiaozhi-esp32/releases/tag/v2.5.2