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 · 先定词表与使用场景

用少量清晰动作建立第一版,而不是先堆命令数量。

3 个步骤
  1. 写下使用者、环境噪声、操作距离和预期动作;初版只选开、关、切换、停止等少量独立指令,并定义手动操作方式。
  2. U194 出厂预设是英文;中文需要配置对应固件。当前定制流程一次使用一种语言,不能把支持四种语言写成同时混合识别。
  3. 在指令表中记录唤醒方式、反馈、UART ID、重复触发与未知指令策略。模块最多 300 条的能力上限不是本项目的已交付词表。
✓ 单语言与指令数量明确✓ 每条指令有预期结果✓ 停止和未知指令策略齐全

02 · 单独验证模块与串口

先看到正确事件,再连接负载。

3 个步骤
  1. 断电核对 U194、CoreS3、Grove 针序及接口电平;按实际端口修改原厂示例,不只依据线色或连接器外形判断。
  2. 锁定 M5Unit-ASR 79290d93de53e024fb9edcac7a34c1577b2ea7e6 和依赖版本。先使用原厂指令读取 UART 结果,记录未知输入及连续输入时的行为。
  3. 需要中文时,按原厂在线平台生成单语言固件,并保存配置、固件校验和恢复方法;经授权再烧录。模块固件与主控工程分别编号。
✓ 串口事件能独立复现✓ 模块和主控版本分别保存✓ 中文固件与实际词表对应
停止条件:在线生成固件与运行时离线识别是两件事;不要把固定指令模块宣传为自由对话大模型。

03 · 接入界面与低压输出

语音只负责提出操作,输出层仍要验证条件。

3 个步骤
  1. 先在屏幕显示当前指令与结果,再接一种低压灯光负载。负载经额定驱动和保护供电,不由识别模块或 GPIO 直接带大电流设备。
  2. 定义上电默认状态、重复事件去重、最长动作时间和手动停止优先级;未知 ID、串口断连或程序重启不应产生非预期动作。
  3. 改变距离、噪声、说话速度和摆放方向,记录成功、漏识别和误唤醒;说明测试次数与条件,不能用一次成功演示代替统计。
✓ 界面与输出结果一致✓ 异常输入不误动作✓ 手动停止优先且可复测

04 · 在安装位置复测与交接

外壳和现场噪声可能改变识别表现。

3 个步骤
  1. 安装后复查麦克风开孔、扬声器位置、固定结构和走线;用同一词表复测安静、噪声、断电重启与断连恢复。
  2. 交接配件清单、固件与词表、主控源码修改记录、启动恢复说明和现场测试结果。U194 内含连接线与现有设备只补缺项。
  3. 分发 M5Unit-ASR 库时保留 MIT 版权与许可;识别引擎、厂家固件和硬件不能仅凭驱动库许可证宣称完全开源。
✓ 现场条件和结果有记录✓ 资料与安装版本一致✓ 内含与补购无重复

故障定位

现象常见原因建议动作
能识别英文但不能识别中文可能仍使用原厂英文预设固件核对模块固件及单语言配置,先验证少量中文命令,不在主控回调中假设已完成语言适配。
收到指令但灯光不响应ID 映射、主控回调或负载驱动可能不同步先比较原始串口 ID 与屏幕事件,再断电核对驱动接线;不要反复提高供电电压。
装入外壳后误唤醒增加开孔、反射和扬声器回声可能改变声学条件回到不带负载的识别测试,比较安装前后样本,调整位置后重新记录结果。

验收与归档

  • 固定语言、词表和固件一致
  • 未知及重复事件处理符合约定
  • 上电和断连状态无非预期输出
  • 手动停止、负载保护和现场识别已测试
  • 源码、模块固件与许可范围分开交接

建议随订单保存:板卡/PCB 版本、固件与依赖版本、BOM 修订号、操作人、测试日期、原始日志、异常样本和最终结论,方便后续复现、维护与售后。