KJX ENGINEERING GUIDE · 03
离线语音展项:从词表到一次可靠响应
把一条语音指令拆成识别、串口事件和场景输出。先用原厂组合验证,再增加中文词表、外壳和演示负载,让每一步都能单独检查。
原厂方案参考 · 场景待实测
接口与场景集成
参考学习时长 按词表与现场安排
核查 2026-10-13
Unit ASR U194 · CoreS3 · UART
公开资料核对,不使用未经确认的整机照片。
适用说明:本手册用于 M5Stack Unit ASR U194 / CI-03T 与 CoreS3 参考组合;M5Unit-ASR 固定修订 79290d93de53e024fb9edcac7a34c1577b2ea7e6。实施时请以目标板卡、固件和外设的实际版本为准;正式交付的功能、资料与验收标准以订单或技术协议为准。
准备与目标
适用范围M5Stack Unit ASR U194 / CI-03T 与 CoreS3 参考组合;M5Unit-ASR 固定修订 79290d93de53e024fb9edcac7a34c1577b2ea7e6
实施方式原厂方案参考 · 场景待实测;按目标硬件执行并记录结果
开始前准备
- U194 与 CoreS3 的准确版本、原厂连接线和供电
- 一种语言、五条以内初始指令与预期动作表
- 一种低压演示负载、合适驱动与独立停止入口
完成后应得到
- 指令、串口 ID、反馈和动作一一对应
- 保存模块固件和主控工程的独立版本
- 完成正常、未知、重复及中断场景记录
01 · 先定词表与使用场景
用少量清晰动作建立第一版,而不是先堆命令数量。
- 写下使用者、环境噪声、操作距离和预期动作;初版只选开、关、切换、停止等少量独立指令,并定义手动操作方式。
- U194 出厂预设是英文;中文需要配置对应固件。当前定制流程一次使用一种语言,不能把支持四种语言写成同时混合识别。
- 在指令表中记录唤醒方式、反馈、UART ID、重复触发与未知指令策略。模块最多 300 条的能力上限不是本项目的已交付词表。
✓ 单语言与指令数量明确✓ 每条指令有预期结果✓ 停止和未知指令策略齐全
02 · 单独验证模块与串口
先看到正确事件,再连接负载。
- 断电核对 U194、CoreS3、Grove 针序及接口电平;按实际端口修改原厂示例,不只依据线色或连接器外形判断。
- 锁定 M5Unit-ASR 79290d93de53e024fb9edcac7a34c1577b2ea7e6 和依赖版本。先使用原厂指令读取 UART 结果,记录未知输入及连续输入时的行为。
- 需要中文时,按原厂在线平台生成单语言固件,并保存配置、固件校验和恢复方法;经授权再烧录。模块固件与主控工程分别编号。
✓ 串口事件能独立复现✓ 模块和主控版本分别保存✓ 中文固件与实际词表对应
停止条件:在线生成固件与运行时离线识别是两件事;不要把固定指令模块宣传为自由对话大模型。
03 · 接入界面与低压输出
语音只负责提出操作,输出层仍要验证条件。
- 先在屏幕显示当前指令与结果,再接一种低压灯光负载。负载经额定驱动和保护供电,不由识别模块或 GPIO 直接带大电流设备。
- 定义上电默认状态、重复事件去重、最长动作时间和手动停止优先级;未知 ID、串口断连或程序重启不应产生非预期动作。
- 改变距离、噪声、说话速度和摆放方向,记录成功、漏识别和误唤醒;说明测试次数与条件,不能用一次成功演示代替统计。
✓ 界面与输出结果一致✓ 异常输入不误动作✓ 手动停止优先且可复测
04 · 在安装位置复测与交接
外壳和现场噪声可能改变识别表现。
- 安装后复查麦克风开孔、扬声器位置、固定结构和走线;用同一词表复测安静、噪声、断电重启与断连恢复。
- 交接配件清单、固件与词表、主控源码修改记录、启动恢复说明和现场测试结果。U194 内含连接线与现有设备只补缺项。
- 分发 M5Unit-ASR 库时保留 MIT 版权与许可;识别引擎、厂家固件和硬件不能仅凭驱动库许可证宣称完全开源。
✓ 现场条件和结果有记录✓ 资料与安装版本一致✓ 内含与补购无重复
故障定位
| 现象 | 常见原因 | 建议动作 |
|---|---|---|
| 能识别英文但不能识别中文 | 可能仍使用原厂英文预设固件 | 核对模块固件及单语言配置,先验证少量中文命令,不在主控回调中假设已完成语言适配。 |
| 收到指令但灯光不响应 | ID 映射、主控回调或负载驱动可能不同步 | 先比较原始串口 ID 与屏幕事件,再断电核对驱动接线;不要反复提高供电电压。 |
| 装入外壳后误唤醒增加 | 开孔、反射和扬声器回声可能改变声学条件 | 回到不带负载的识别测试,比较安装前后样本,调整位置后重新记录结果。 |
验收与归档
- 固定语言、词表和固件一致
- 未知及重复事件处理符合约定
- 上电和断连状态无非预期输出
- 手动停止、负载保护和现场识别已测试
- 源码、模块固件与许可范围分开交接
建议随订单保存:板卡/PCB 版本、固件与依赖版本、BOM 修订号、操作人、测试日期、原始日志、异常样本和最终结论,方便后续复现、维护与售后。