前言

在离线语音模块的开发和量产过程中，开发者经常会遇到各种棘手问题。本文基于真实用户案例，系统性地总结了从固件烧录到语音识别全流程中常见的 5 大类问题，并提供详细的排查思路和解决方案。

本文涵盖问题来源：

• 自制模块烧录不稳定问题
• 命令词误识别/识别错误问题
• 免唤醒命令词灵敏度优化
• 播放时无法语音识别问题
• 泛化词配置导致识别异常

一、烧录问题：第一次能烧录，第二次失败

1.1 问题现象

用户反馈：使用自制的 CI13241/CI13242 模块进行串口烧录时，第一次烧录成功，后续烧录失败。 设备信息：

• 模块：CI13241/CI13242 芯片（SU-03T 系列）
• 烧录方式：串口烧录
• 硬件：自研模块，参考官方原理图设计
• 词条容量：SU-03T 支持 50 条命令词（推荐值）

1.2 原因分析

| 可能原因         | 说明                         | 排查方法                      |

| ------------------ | ------------------------------ | ------------------------------- |

| 烧录器兼容性     | 不同烧录器的驱动能力存在差异 | 更换不同品牌/型号的烧录器测试 |

| 硬件连接不稳定   | 自制模块的连接器接触不良     | 检查焊接质量，确保连接稳定    |

| 电源供电不足     | 烧录过程中电流需求较大       | 确保供电充足，使用外部电源    |

| 芯片进入异常状态 | 烧录后芯片未正常复位         | 完全断电后重新上电尝试        |

1.3 解决方案

方案 1：更换烧录器 部分用户反馈使用某些型号的 USB 转 TTL 烧录器会出现"一下能烧一下不能烧"的情况，建议：

• 优先使用官方推荐的烧录器
• 尝试更换不同品牌的烧录器（如 CH340、CP2102、FT232）
• 检查烧录器驱动是否为最新版本

方案 2：硬件连接检查

检查清单：
□ 烧录引脚（TX/RX）连接正确
□ GND 共地连接稳固
□ 供电电压稳定（3.6-5.5V）
□ 波特率设置正确（115200）
□ 连接线长度合理（建议 <30cm）

方案 3：使用升级狗烧录 对于量产场景，建议使用升级狗进行脱机烧录：

• 支持多片同时烧录
• 烧录稳定性更高
• 适合批量生产

二、命令词误识别问题

2.1 问题现象

用户反馈：配置了"开灯"、"打开灯光"、"开启灯光"等多个命令词，但说任何一句都被识别成"关灯"。 设备信息：

• 模块：CI13241
• 识别方式：命令词 + 泛化词
• 串口输出：均返回 F3 3B（关灯的行为 ID）

2.2 问题原因

根本原因：泛化词配置不当 该用户将"开"字作为泛化词配置，导致所有包含"开"字的命令词都被错误识别。

2.3 解决方案

正确的配置方式

错误配置：
┌─────────┬──────────────┬────────────┐
│ 命令词  │ 泛化词       │ 行为ID     │
├─────────┼──────────────┼────────────┤
│ 关灯    │ -            │ F3 3B     │
│ 开灯    │ 开、打开、开启│ F3 3A     │
└─────────┴──────────────┴────────────┘
问题：泛化词"开"会匹配所有含"开"的输入
正确配置：
┌─────────┬──────────────┬────────────┐
│ 命令词  │ 泛化词       │ 行为ID     │
├─────────┼──────────────┼────────────┤
│ 关灯    │ -            │ F3 3B     │
│ 开灯    │ 打开、开启   │ F3 3A     │
└─────────┴──────────────┴────────────┘
修改：将"开"字放入主命令词，不作为泛化词

配置原则

| 原则         | 说明           | 示例                               |

| -------------- | ---------------- | ------------------------------------ |

| 避免单字泛化 | 单字容易误匹配 | 不用"开"作为泛化词                 |

| 泛化词完整   | 使用完整词汇   | 用"打开"而非"开"                   |

| 差异化明显   | 命令词间差异大 | "开灯" vs "关灯"，而非"开" vs "关" |

| 测试验证     | 配置后逐个测试 | 确保每个命令词正确响应             |

三、免唤醒命令词灵敏度优化

3.1 问题现象

用户反馈：免唤醒命令词识别不够灵敏，设备挂高 3 米左右有回音时不应答。 设备信息：

• 产品类型：报警器
• 使用场景：挂装，3 米识别距离
• 有回声环境

3.2 问题分析

| 因素       | 影响                   | 说明                         |

| ------------ | ------------------------ | ------------------------------ |

| 安装高度   | 高度增加，距离远       | 3 米距离信号衰减明显         |

| 回声干扰   | 多径反射导致识别困难   | 声波多次反射干扰识别         |

| 免唤醒模式 | 本身识别率低于唤醒模式 | 无唤醒词前置，误识别控制严格 |

3.3 解决方案

方案 1：调整识别阈值 在平台「优化配置」中调整命令识别阈值：

| 阈值设置       | 效果               | 适用场景                 |

| ---------------- | -------------------- | -------------------------- |

| 低（-40\~-30） | 识别严格，误触发少 | 安静环境、对误触发要求高 |

| 中（-20 左右） | 平衡               | 一般室内环境（默认）     |

| 高（-10\~0）   | 容易识别，误触发多 | 嘈杂环境、远距离识别     |

注意：SmartPi 平台的识别阈值范围为 -40 到 0，数值越大越灵敏。建议从默认值逐步调整，找到识别率与误触发的平衡点。

建议：逐步提高阈值，测试识别效果与误触发率的平衡点。 方案 2：使用唤醒 + 命令词模式 如果免唤醒模式无法满足需求，考虑使用唤醒 + 命令词模式：

• 识别率更高
• 误触发更容易控制
• 支持更复杂的交互逻辑

方案 3：硬件优化

方案 4：更换支持双麦降噪的模块 对于高噪声/回声环境，建议使用：

• CI-03T2（双麦）
• CI-33T（双麦）
• SU-32T（双麦，嘈杂环境优化）

四、播放时无法语音识别问题

4.1 问题现象

用户需求：SU-03T 收到串口命令后循环播放提示音，用户说出"停止"命令结束播放。 实际现象：播放音乐时，语音命令无效。

4.2 问题原因

SU-03T 不支持 AEC（声学回声消除）功能

| 模块         | AEC 支持 | 播放时识别能力               |

| -------------- | ---------- | ------------------------------ |

| SU-03T       | ✗       | 播放时无法识别               |

| CI-03T1/03T2 | ✓       | 支持播放时识别（需启用 AEC） |

| CI-33T       | ✓       | 支持播放时识别               |

| JX-A7T       | ✓       | 支持播放时识别               | AEC（Acoustic Echo Cancellation）技术用于消除扬声器播放声音对麦克风的影响，没有 AEC 的模块在播放时无法进行语音识别。

4.3 解决方案

方案 1：通过串口命令控制

// MCU 端实现逻辑
// 1. 收到启动命令 → 发送串口命令让模块播放
// 2. 定时 30 秒 → 发送串口命令让模块停止播放
串口命令示例：
播放：F3 01 [播放参数]
停止：F3 02

方案 2：使用定时器功能 SU-03T 支持定时器功能，可以实现延时停止：

1. 在平台配置中添加定时器
2. 设置延时时间（如 30 秒）
3. 定时器到期时停止播放

参考视频： SU-03T 定时器应用案例 方案 3：更换支持 AEC 的模块 如果必须使用语音命令停止播放，需要更换为支持 AEC 的模块：

• CI-03T1：单麦，支持 AEC
• CI-03T2：双麦，支持 AEC 和降噪
• CI-33T：双麦，支持 AEC，更多指令数

五、AEC 打断功能选择建议

5.1 AEC 功能配置选项

在平台「产品特性」中，AEC 相关选项包括：

| 选项                         | 说明       | 适用场景                 |

| ------------------------------ | ------------ | -------------------------- |

| 仅语音识别                   | 不启用 AEC | 不需要播放时识别         |

| 语音识别 +AEC 打断(限单 MIC) | 单麦 AEC   | 单麦模块，支持播放时识别 |

| 唤醒 + 命令词打断            | 双麦 AEC   | 双麦模块，完整打断支持   |

5.2 选择建议

推荐配置：唤醒 + 命令词打断 这是最完整的 AEC 打断方案，支持：

• 唤醒打断：播放时说出唤醒词立即响应
• 命令词打断：播放时说出命令词立即执行
• 最佳用户体验：无需等待播报结束

六、快速排查流程图

语音识别问题
                          │
                          ▼
              ┌─────────────────────┐
              │   能否正常烧录？     │
              └─────────────────────┘
                    │          │
                   否          是
                    │          │
                    ▼          ▼
          ┌─────────────┐  ┌─────────────────────┐
          │更换烧录器/  │  │  识别错误还是无响应？ │
          │检查硬件连接 │  └─────────────────────┘
          └─────────────┘       │          │
                              错误        无响应
                               │          │
                               ▼          ▼
                    ┌──────────────┐  ┌──────────────────┐
                    │检查泛化词配置 │  │调整识别阈值/     │
                    │避免单字泛化  │  │检查AEC是否启用   │
                    └──────────────┘  └──────────────────┘
                               │          │
                               ▼          ▼
                    ┌────────────────────────────────┐
                    │   播放时无法识别？               │
                    │   → 检查是否支持AEC              │
                    │   → SU-03T需用串口命令控制       │
                    └────────────────────────────────┘

七、常见问题速查表

| 问题               | 可能原因       | 快速检查             |

| -------------------- | ---------------- | ---------------------- |

| 烧录失败           | 烧录器不兼容   | 更换烧录器测试       |

| 全部识别成一个命令 | 泛化词配置错误 | 检查是否有单字泛化   |

| 免唤醒不灵敏       | 阈值设置过低   | 提高识别阈值         |

| 远距离识别差       | 环境噪声/回声  | 使用双麦模块         |

| 播放时无法识别     | 不支持 AEC     | 更换模块或用串口控制 |

| 偶尔误触发         | 灵敏度过高     | 降低识别阈值         |

八、总结

离线语音模块的问题排查需要系统性的方法：

1. 硬件层：检查供电、连接、模块型号
2. 配置层：检查命令词、泛化词、阈值设置
3. 功能层：确认模块支持的功能（AEC、双麦等）
4. 环境层：考虑安装位置、回声、噪声等因素

大多数问题都可以通过以上排查步骤解决。如问题持续存在，建议：

• 提供详细的测试日志
• 说明具体的使用场景
• 联系技术支持获取帮助

关键词：离线语音、烧录问题、命令词识别、泛化词、AEC 打断、免唤醒、识别灵敏度 最后更新：2026-01-15