平台与固件 FAQ¶

本页用于整理平台使用和固件相关的问题。

固件管理中的"继承"功能是什么？¶

问题描述：

在智能公元平台的固件管理界面，每个固件版本旁边都有"查看 | 继承 | 下载固件 | 删除"操作选项，需要了解"继承"功能的具体作用和使用场景。

功能说明：

"继承"功能相当于复制当前固件配置创建一个新版本，不是重新生成程序包，而是基于现有配置创建一个可编辑的副本。

继承功能的作用：

• 版本管理：已发布的版本无法直接修改，需要通过继承创建新版本进行编辑
• 配置复用：保留原有配置（唤醒词、命令词、回复语、GPIO配置等），在新版本基础上调整
• 快速迭代：避免从头开始配置，提升开发效率

使用场景：

1. 修改已发布版本的配置
2. 当前版本已发布，提示"继承为新版本才能保存修改的内容"

3. 点击"继承"创建新版本后进行修改

4. 固件生成失败需要重试

5. 固件生成失败时，可继承原版本重新生成

6. 避免重新配置所有参数

7. 创建配置变体

8. 基于同一配置创建多个相似版本
9. 用于对比测试或适配不同产品

操作步骤：

1. 在固件管理界面找到需要继承的固件版本
2. 点击该版本操作列中的"继承"按钮
3. 系统自动创建一个新版本，包含原版本的所有配置
4. 在新版本中进行修改
5. 保存并生成新的固件文件

注意事项：

• 继承只是复制配置，仍需要手动点击"生成"来编译固件
• 继承操作不会影响原版本，原版本仍然可以下载使用
• 建议在测试版本验证功能后再发布正式版本

如何配置延时控制功能避免自动退出？¶

问题描述：

在使用延时控制功能时，即使关闭了超时设置，系统仍会自动退出，无法实现预期的延时控制功能。

解决方案：

• 启用延时设置：在平台配置中勾选"是否延时设置"
• 设置延时时长：根据需要配置延时时长（如500ms或1000ms）
• 选择操作类型：选择"禁止超时退出唤醒"操作

配置示例：

1. 错误配置（会自动退出）：

   • 是否延时设置：启用
   • 延时时长：500ms
   • 操作：进入唤醒

2. 正确配置（正常工作）：

   • 是否延时设置：启用
   • 延时时长：1000ms
   • 操作：禁止超时退出唤醒

注意事项：

• 延时功能必须与"禁止超时退出唤醒"操作配合使用
• 延时时长可根据实际需求调整
• 该功能适用于需要保持唤醒状态的应用场景

免唤醒模式下设备自动退出怎么办？¶

问题描述：

设备上电后可以免唤醒工作，但运行一段时间后语音模块播报"我先退下了"等退出提示，之后必须使用唤醒词才能再次触发命令。

解决方案：

1. 删除退出命令

在智能公元平台配置中：

• 找到触发器配置中的"退出命令"或"自动退出唤醒"相关设置
• 删除或禁用退出命令词条（如"退下"、"再见"、"不用了"等）
• 确认没有配置自动退出唤醒的超时触发

2. 添加延时控制

对于IO口输出控制：

• 在控制输出前添加延时设置（建议300ms左右）
• 延时可以避免输出控制与退出命令冲突

3. 使用完整固件

• SDK编译生成的bin文件可能不包含完整功能
• 需要从平台下载完整的固件文件（release_flash_all.bin）
• 确保固件包含所有必要功能模块

配置要点：

• 上电启动触发：进入唤醒状态
• 禁止超时退出唤醒：防止自动退出
• 必要时删除退出词条

注意事项：

• 免唤醒模式功耗会相对较高
• 如需保持长期唤醒状态，建议配置"禁止超时退出唤醒"
• 检查是否有命令词的回复语包含退出相关内容

VAD 功能从哪里开启？¶

问题描述：

在使用语音模块时，询问 VAD（语音活动检测）功能在哪里开启，如何配置。

解决方案：

VAD 无需单独开启

• VAD（语音活动检测）是离线语音芯片的内置功能，默认自动运行
• 不需要在平台配置中单独"开启"或配置 VAD
• 系统会自动检测环境声音并判断是否为有效语音输入

VAD 工作原理：

1. 分贝检测机制

   • 系统持续检测环境声音分贝
   • 任何达到人类语音分贝的声音都会被检测到
   • 检测到声音后自动进行语音识别

2. 识别结果处理

   • 如果声音能匹配到命令词，识别为对应命令
   • 如果声音无法匹配任何命令词，识别为"不匹配"

注意事项：

• VAD 是基于分贝的检测，并非语义理解
• 环境噪声可能触发 VAD，导致频繁的"不匹配"识别
• 不建议为"不匹配"情况添加语音反馈，这会导致非常频繁的误触发
• 如需优化识别效果，可以调整命令词阈值或进行语音调优

声源定位角度数据如何通过串口输出？¶

问题描述：

声源定位功能已能正常识别并播报角度，但无法通过串口输出声源角度数据，导致无法将角度信息发送给单片机进行处理。

解决方案：

1. 串口配置确认

• 引脚配置：UART1_TX应设置为A2/A3（非B2/B3）
• 硬件连接：检查串口线是否连接到正确的引脚
• 波特率：默认9600，可根据需要调整

2. 变量参数设置

• 正确变量：使用'{chucun}'或'{pd}'获取角度值
• 操作配置：选择"发送16进制数"
• 数据格式：确保参数使用变量而非固定值

3. 执行顺序说明

• 多个操作按延时时长顺序执行
• 延时短的先执行，延时长的后执行
• 相同时延时的操作并行执行

注意事项：

• 串口无输出时先检查硬件连接
• 确认使用的变量名与系统匹配
• 角度数据可通过串口调试工具验证
• 接线错误会导致串口输出乱码：如果串口输出为乱码，通常是TX/RX引脚接反或接错位置导致

TTS 固件是否兼容语音识别功能？¶

问题描述：

需要了解 TTS 固件是否能与语音识别固件兼容，实现同时支持语音识别和文字转语音功能。

解决方案：

TTS 固件与语音识别固件的关系说明：

功能兼容性：

• TTS 固件可以兼容语音识别功能，但需要在平台上进行相应配置
• 更新 TTS 固件后仍能识别语音并支持 AEC 打断功能

接口说明：

• TTS 固件只有一个串口接口用于输入
• 文本需要转换为 GB2312 格式后输出给模块播放
• 如需播报自定义文字，需要在主控编写文本转化程序

使用方式：

1. 平台配置

   • 在平台上配置 TTS 和语音识别功能
   • 两者可以在同一固件中协同工作

2. 文本转换

   • 将需要播报的文本转换为 GB2312 格式
   • 通过串口发送给模块

注意事项：

• TTS 固件和纯语音识别固件是不同的固件版本
• 需要根据实际需求选择合适的固件类型
• 自定义文本播报需要额外的程序开发

如何获取 CI 系列芯片的出厂固件？¶

问题描述：

需要获取 CI 系列芯片的出厂固件进行恢复或参考。

解决方案：

获取渠道：

1. 联系技术支持

   • 通过官方技术支持渠道申请
   • 提供具体型号和需求说明
   • 可能需要提供购买凭证

2. 官方平台下载

   • 登录智能公元平台
   • 在产品页面查找固件下载
   • 选择对应的芯片型号

3. 开发资料包

   • 部分型号的开发资料包包含出厂固件
   • 可从官方文档平台下载
   • 需要注册开发者账号

注意事项：

• 出厂固件通常仅包含基础功能
• 如需特定功能需要自行配置生成
• 建议备份原始固件后再进行修改
• 部分特殊固件可能需要授权

为什么自定义的命令词无法被识别？¶

问题描述：

在使用离线语音识别芯片时，发现自定义的命令词无法被正确识别。

解决方案：

常见原因：

1. 命令词格式问题

   • 命令词中间包含空格
   • 特殊字符或标点符号
   • 命令词过长或过短

2. 配置错误

   • 命令词未正确录入
   • 拼音错误或不准确
   • 命令词重复或冲突

解决步骤：

1. 检查命令词列表，确认格式正确
2. 删除多余的空格或特殊字符
3. 重新录制或输入命令词
4. 测试识别效果

注意事项：

• 命令词应使用简洁的中文表达
• 避免使用同音字或容易混淆的词
• 建议每个命令词录制2-3次提高成功率

能否通过串口动态新增命令词？¶

问题描述：

希望不使用学习模式，而是通过串口直接告诉语音模块新增命令词（如"打开窗帘"）。

解决方案：

不支持通过串口动态新增命令词。

命令词配置方式说明：

1. 预配置方式

   • 命令词必须提前在智能公元平台配置好
   • 所有命令词需要生成固件时一并写入
   • 运行时无法动态添加新的命令词

2. 自学习功能

   • 部分型号支持自学习功能（如CI-33T）
   • 通过语音交互方式学习新命令词
   • 不支持通过串口指令添加

3. 串口的作用

   • 串口可用于触发已配置的命令词行为
   • 串口可用于发送识别结果给外部设备
   • 串口输入可用于触发播放指定语音

替代方案：

1. 预置多条命令词

   • 在开发阶段将所有可能的命令词预配置
   • 通过启用/禁用特定命令词实现功能切换
   • 适用于命令词数量有限且可预知的场景

2. 使用串口输入触发

   • 配置串口输入触发对应的行为
   • 通过串口发送指定数据触发功能
   • 无需语音识别即可执行

3. 选择支持自学习的型号

   • CI-33T等型号支持用户自学习
   • 用户可通过语音交互添加新命令词
   • 适合需要灵活配置的场景

注意事项：

• 不同型号对命令词数量限制不同
• 自学习功能会占用RAM资源，有数量限制
• 预配置方案适用于量产设备，稳定性更高

如何将命令词从一个工程复制到另一个工程？¶

问题描述：

需要将一个工程（如 CI-03T）中已配置的命令词和回复语迁移到另一个工程（如 CI-33T）中。

解决方案：

1. 通过命令词编辑功能复制

在智能公元平台的版本详情页面：

- 进入源工程的"命令词自定义"页面
- 点击"命令词编辑"按钮，打开命令词批量编辑界面
- 界面中显示所有命令词和回复语的配置内容
- 全选并复制编辑框中的所有内容
- 进入目标工程的"命令词自定义"页面
- 点击"命令词编辑"按钮
- 将复制的内容粘贴到编辑框中
- 点击"确定"保存

命令词语法格式：

语法格式: action=命令词1|命令词2...@回复语1|回复语2

示例：

A1=打开窗帘@好的，正在为您打开窗帘
A2=关闭窗帘@好的，正在为您关闭窗帘

重要限制：

• 仅复制命令词和回复语：此方法只迁移命令词词条和对应的回复语内容
• 不包含控制配置：串口输出、GPIO控制、延时动作等控制行为不会被复制
• 需重新配置控制：在目标工程中需要为每个命令词重新配置控制行为

配置建议：

1. 先复制命令词和回复语
2. 逐个命令词添加控制行为
3. 建议使用"复制选中行"功能快速添加类似的命令词
4. 配置完成后进行功能测试

语音模块能否输出 mic 原始音频数据？¶

问题描述：

希望主控 MCU 能够获取语音模块麦克风采集的原始音频数据，用于本地处理或其他用途。

解决方案：

语音模块不支持直接输出 mic 原始音频数据。

数据输出方式说明：

1. 串口输出识别结果

   • 模块识别到语音指令后，通过串口发送 16 进制数据给主控
   • 输出的是识别结果（命令词 ID 或自定义数据），非音频数据
   • 这是大部分客户采用的通信方式

2. 音频数据无法获取

   • 模块内部处理音频后不对外输出原始 PCM 或其他格式数据
   • 无法通过串口或其他接口获取 mic 采集的音频流

3. 使用串口触发的前提

   • 语音内容需要提前录制好并烧录到模块
   • 串口输入只能触发已配置的命令词或播放已录制的语音
   • 无法通过串口实现动态的语音合成（除非使用 TTS 固件）

替代方案：

1. 独立音频采集

   • 如需获取原始音频数据，需使用独立的音频采集模块
   • 将音频数据传输给主控进行处理
   • 语音模块仅负责语音识别功能

2. TTS 固件方案

   • 部分型号支持 TTS（文本转语音）固件
   • 可通过串口发送文本，模块转换成语音播放
   • 适用于需要动态语音内容的场景

注意事项：

• 串口通信需确保波特率、数据位等参数配置正确
• 串口数据格式通常为 16 进制，需在平台配置时定义
• 参考官方串口教程进行配置：CI-03T串口教程、51单片机配合语音模块教程

固件生成过程耗时过长怎么办？¶

问题描述：

平台生成固件过程非常缓慢，已持续近一个小时仍未完成。

解决方案：

• 这是正常现象，复杂配置的固件生成确实需要较长时间
• 可以尝试简化配置（如减少词条数量、禁用复杂功能）
• 检查网络连接是否稳定
• 尝试更换浏览器或清理浏览器缓存
• 生成时间与服务器负载相关，可尝试在任务较少的时段（如清晨）生成

注意事项：

• 生成时间过长不是系统故障，耐心等待即可
• 简化配置可以缩短生成时间
• 如长时间无响应，可尝试重新生成

配置检查通过但仍无法生成固件怎么办？¶

问题描述：

在固件生成流程中，配置检查已通过，但固件仍然生成失败，提示"生成失败，可能是配置原因"。

解决方案：

立即处理：

1. 多次尝试生成

   • 有时是服务器临时问题
   • 多点击几次生成按钮尝试
   • 清除浏览器缓存后重试

2. 简化配置测试

   • 删除部分功能配置
   • 减少命令词数量
   • 使用最简配置验证

3. 检查隐藏问题

   • 自学习功能留空未填
   • 重复命令词过多
   • 语音包过大

深入排查：

如果多次生成仍失败：

1. 导出配置文件

   • 保存当前工程配置
   • 提交给专业技术支持分析
   • 说明具体的错误信息

2. 创建新工程测试

   • 新建一个简单工程
   • 逐步添加原有配置
   • 定位具体问题配置项

注意事项：

• 配置检查通过不代表一定能生成成功
• 服务器负载高时可能导致生成失败
• 保留错误截图便于问题定位
• 必要时联系专业技术支持获取帮助

补充：常见原因与处理流程

可能原因：

1. 配置内容问题

   • 配置中存在空的唤醒词记录
   • 存在空的行为记录
   • 存在空的命令词
   • 命令词和回复语不满足输入格式要求
   • 一些特殊词没有录入

2. 资源限制问题

   • 内存空间用超
   • 命令词数量过多
   • 语音包过大

3. 浏览器兼容性问题

   • 使用了非推荐的浏览器
   • 浏览器版本过旧
   • 缓存数据冲突

4. 配置文件问题

   • JSON配置文件格式错误
   • 配置项存在冲突
   • 超出配置限制

5. 网络连接问题

   • 网络不稳定
   • 服务器临时繁忙
   • 防火墙拦截

解决方法：

1. 更换浏览器

   • 使用谷歌浏览器访问平台
   • 更新浏览器到最新版本
   • 清除浏览器缓存

2. 重新导入配置

   • 退回到上一界面
   • 点击"导出"备份当前配置
   • 重新导入配置文件
   • 再次尝试生成固件

3. 简化配置测试

   • 先使用简单配置测试生成
   • 逐步添加复杂配置项
   • 定位具体的配置问题

固件生成中优化版和快速生成版有什么区别？¶

问题描述：

在自学习固件生成流程中，存在"优化版"和"快速发布版"两个选项，需要了解两者的区别以及对功能或性能的影响。

解决方案：

根据平台界面提示说明：

• 快速发布版：可快速生成SDK，但语音识别效果会差一些
• 优化版：生成时间较长，但语音识别效果更好

功能影响：

两个版本在功能支持上没有差别，主要体现在：

• 识别效果：优化版的语音识别准确率更高
• 生成速度：快速发布版生成速度更快

• 适用场景：

  • 快速发布版：适合开发测试阶段快速验证
  • 优化版：适合产品发布阶段使用

注意事项：

• 在自学习固件上，两个版本的功能基本相同
• 最终产品发布建议使用优化版以获得更好的用户体验
• 开发阶段可使用快速发布版提高效率

优化版生成失败但快速发布版可以成功怎么办？¶

问题描述：

在固件生成时，使用"优化版"提示"生成失败，可能是配置原因"，但切换到"快速发布版"后可以成功生成。

解决方案：

临时处理：

1. 使用快速发布版验证配置

   • 先使用快速发布版确认配置逻辑正确
   • 验证功能是否符合预期
   • 快速发布版生成速度更快，便于调试

2. 排查优化版失败原因

   • 检查是否添加了新的命令词后出现问题
   • 简化配置后尝试生成优化版
   • 逐步添加功能定位问题配置项

3. 使用Pro模型版本

   • 平台建议使用带"Pro"后缀的版本
   • Pro版本通常兼容性更好
   • 可获得更稳定的生成结果

技术说明：

• 优化版进行更深入的模型训练和优化，对配置更敏感
• 快速发布版使用更简化的编译流程，兼容性更好
• 两者在功能上完全一致，仅识别效果有差异

建议：

• 开发调试阶段：使用快速发布版提高效率
• 问题排查：快速发布版成功则说明配置逻辑正确
• 产品发布：如优化版持续失败，可联系技术支持分析具体原因

CI系列Pro模型有快速发布和稳定版的区别吗？¶

问题描述：

在使用CI系列Pro模型时，发现没有"快速发布"和"稳定版"的选项，想知道Pro模型是否也有版本区别。

解决方案：

Pro模型版本说明：

1. CI系列Pro模型特点

   • CI系列Pro模型没有快速发布和稳定版之分
   • Pro模型都是统一的速度，无需选择发布模式
   • 识别效果经过优化，性能稳定

2. 老模型vs新模型

   • 老模型（如"安静环境"）：有快速版和稳定版选项
   • 新Pro模型：无此选项，直接使用优化后的版本

3. 切换模型的注意事项

   • 从老模型切换到新Pro模型后，需要重新生成固件
   • 如果切换后无法唤醒，请检查配置是否完整
   • 芯片本身没有新旧之分，模型是算法层面的区别

故障排查：

如果切换到Pro模型后无法唤醒：

1. 检查配置参数是否正确（唤醒词、命令词等）
2. 尝试烧录一个简单的新版本固件测试
3. 对比老模型和新模型的配置差异
4. 确认使用的固件版本是否支持Pro模型

如何通过串口数据触发语音播放？¶

问题描述：

希望实现语音模块接收特定串口数据后自动播放对应的语音内容，但不确定如何配置触发方式。

解决方案：

配置步骤：

1. 进入触发方式配置

   • 在控制配置页面找到触发方式选项
   • 选择"串口输入"作为触发方式

2. 设置触发参数

   • 选择串口接口（如UART1_RX）
   • 设置对应的消息号（如消息号1）
   • 将串口数据与消息号关联

3. 配置响应动作

   • 为每个消息号设置对应的播放内容
   • 可以是TTS语音或预录制的音频
   • 设置播放音量和其他参数

工作原理：

• 模块持续监听指定串口
• 接收到特定数据时触发对应消息号
• 自动播放该消息号关联的语音内容

注意事项：

• 串口数据格式需要与模块匹配
• 消息号范围有限制，需查看具体型号支持的数量
• 测试时可先用串口助手发送数据验证
• 命令词识别和串口触发可同时工作

在哪里可以获取技术文档和教程视频？¶

问题描述：

需要查找公司的技术文档中心和相关教程视频资源，以便学习和参考。

解决方案：

官方资源链接：

1. 智能公元平台

   • 网址：https://www.smartpi.cn
   • 集成小程序、智能体、豆包平台等功能
   • 在线配置固件、生成下载

2. 智能公元文档中心

   • 网址：https://help.aimachip.com/
   • 包含详细的技术文档、开发指南
   • 提供各型号模块的规格说明、原理图、烧录指南及常见问题

3. 机芯智能B站教程视频

   • 网址：https://space.bilibili.com/1903518159
   • 包含实操演示视频
   • 涵盖平台及产品教程

4. 官方淘宝店铺

   • 网址：https://shop379208868.taobao.com/
   • 芯片、模块、配件等硬件采购

资源内容：

• 硬件设计指南：原理图、PCB设计建议
• 软件开发文档：API说明、配置教程
• 常见问题解答：各类技术问题的解决方案
• 视频教程：手把手教你使用产品

使用建议：

• 先看文档了解理论基础
• 结合视频教程进行实际操作
• 遇到问题时先查阅FAQ
• 最新更新会优先在文档中心发布

固件生成失败如何处理？¶

问题描述：

在智能公元平台生成固件时，显示"生成失败"提示，即使配置检查通过也无法生成固件。

解决方案：

常见失败原因及解决：

1. 自学习功能配置问题

   • 问题：自学习选项留空未填也未删除
   • 解决：填写自学习内容或删除该行
   • 检查所有自学习项，确保没有空项

2. 重复词条过多

   • 问题：命令词中重复词汇过多
   • 解决：减少重复词汇，使用差异化命令词
   • 合理分配词条，避免资源冲突

3. 语音包过大

   • 问题：上传的语音文件过大
   • 解决：压缩语音包，使用更短的语音
   • 删除不必要的语音文件

4. 配置参数错误或冲突

   • 问题：某些配置参数设置不当或存在冲突
   • 解决：生成前仔细检查所有配置项
   • 确认IO口、串口等硬件配置正确
   • 检查是否有功能设置冲突

   • 语言模型生成失败

   • 问题：提示"生成失败: 语言模型生成失败"

   • 解决方法：
   • 刷新页面后重新生成，有时是平台临时卡顿
   • 尝试更换语音模型后再生成
   • 逐个删除最近添加的意图进行测试
   • 检查是否有意图缺少触发方式

排查步骤：

1. 检查配置完整性

   • 逐项检查所有配置页面
   • 确认没有遗漏或冲突的设置
   • 特别关注自学习和命令词配置

2. 简化配置测试

   • 先使用最简配置生成固件
   • 逐步添加功能项，定位问题
   • 找到具体导致失败的功能

3. 更换浏览器尝试

   • 清除浏览器缓存和Cookie
   • 尝试使用Chrome、Firefox等不同浏览器
   • 确保浏览器版本较新

专业技术支持协助：

如果以上方法都无法解决：

1. 提供详细信息

   • 截图保存错误提示
   • 导出配置文件供专业技术支持分析
   • 说明使用的模块型号和配置详情

2. 联系专业技术支持

   • 通过客服渠道提交问题
   • 提供完整的错误信息和配置
   • 等待专业技术支持分析和反馈

注意事项：

• 自学习功能不能留空，必须填写或删除
• 重复词条会影响固件生成，需合理规划
• 语音包大小受限制，需优化音频文件
• 保存配置模板，便于后续修改和使用

固件下载失败怎么办？¶

问题描述：

在智能公元平台生成固件后，点击下载按钮时无法下载固件文件。

解决方案：

1. 网络问题排查

- 确认网络连接稳定
- 避免使用代理或VPN下载
- 尝试更换浏览器或网络环境

2. 配置问题排查

- 检查是否配置了未开放功能
- 确认配置项未超出模块支持范围
- 验证固件配置信息是否正确
- 确认设备已正确注册到平台

3. 设备问题排查

- 开启自学习功能可能导致SU-G3T等设备存储空间不足
- 确认芯片型号选择正确

4. 硬件连接问题

- TTS固件下载时网络线缆易接触不良
- 确保烧录工具与设备连接稳固

5. 固件状态问题

- 避免使用待发布、测试或开发版本的固件
- 确认固件状态为"已生成"或"发布"状态

注意事项：

• 下载前确保固件生成完成且状态正常
• 如频繁失败，建议导出JSON配置文件供技术支持分析
• SU系列模块在高峰期可能因服务器负载导致下载缓慢

图件未生成是什么原因？¶

问题描述：

在平台提交固件生成请求后，图件（固件文件）状态一直显示未生成，或生成失败。

解决方案：

1. 服务器负载问题

- SU系列模块用户多，高峰期服务器处理大量请求需要排队
- 正常等待时间：10-30分钟
- 高峰期可能需要：1-2小时

2. 配置复杂度问题

- 功能配置过于复杂会增加生成时间
- 上传的音频文件过多会延长处理时间
- 特殊功能配置可能导致生成时间延长

3. 数据传输问题

- 网络不稳定可能导致生成过程中数据传输失败
- 生成过程中请勿关闭页面或刷新

4. 工程名称问题

- 工程名称或其他文本含空格等特殊字符可能导致生成异常
- 建议使用纯英文或数字命名

处理方法：

• 如生成卡在"待生成"，正常等待10-30分钟
• 高峰期建议等待1-2小时，避免频繁取消重试
• 等待后仍失败，可删除当前版本重新生成
• 确保工程名称不含空格或特殊字符

注意事项：

• 频繁取消和重新生成会加重服务器负载
• 建议避开高峰时段（工作日白天）生成固件
• 配置从简到繁逐步测试，定位问题配置项

固件生成服务器无响应怎么办？¶

问题描述：

在生成固件/SDK文件时遇到服务器无法生成的问题，SDK状态显示"生成超时"，导致无法快速生成固件。

解决方案：

1. 检查队列状态

平台版本管理界面会显示每个版本的SDK状态： - 生成超时，可重新生成或继续等待：表示任务在队列中排队 - 可选择"继续"等待队列处理完成，或"重新生成"提交新任务

2. 队列任务处理

• 服务器采用队列机制处理SDK/固件生成任务
• 任务按提交顺序依次处理，高峰期可能需要等待
• 非必要不要重复提交：重复提交会增加队列长度，延长等待时间

3. 处理建议

• 首次超时后可尝试"重新生成"
• 如多次超时，建议联系技术支持确认后台状态
• 避开高峰期（工作日白天）进行固件生成

注意事项：

• 服务器高负载时生成任务会排队等待，这是正常现象
• 生成超时不代表失败，任务可能仍在队列中
• 如果持续长时间无法生成（超过24小时），请联系技术支持

如何通过串口控制语音模块的音量大小？¶

问题描述：

不同应用场景下对音量要求不同，有些场景声音偏小，有些场景声音偏大，希望通过串口指令动态调节音量大小，以适应不同使用环境。

解决方案：

平台配置方法：

1. 进入控制配置界面：

   • 在智能公元平台添加控制功能
   • 控制方式选择"系统设置"
   • 类别选择"播放控制"

2. 音量控制选项：

   • 操作类型选择"增加音量"或"减少音量"
   • 可配置多个不同音量级别的控制指令
   • 支持自定义串口指令格式

串口通信实现：

• 通过串口发送特定指令控制音量增减
• 指令格式由平台生成，可在配置界面查看
• 支持实时调节，无需重启模块

应用场景：

• 屏幕按键控制：在触摸屏上增加音量+/-按键
• 远程控制：通过其他设备发送串口指令调节音量
• 自动调节：根据环境噪声自动调整合适音量

平台中配置串口音量控制的界面，可选择增加或减少音量操作

注意事项：

• 音量调节范围受硬件限制，不能超过最大输出功率
• 建议在软件中设置合理的音量步进值
• 音量过大可能导致失真，需要根据实际喇叭规格调整
• 不同批次模块的音量输出可能略有差异，需要实际测试验证
• 重要：如果在平台"发言人配置"中将音量滑块设置为最低，设备将处于静音状态，此时无法通过串口命令或程序动态打开音量。如需通过串口控制音量/静音，请使用"播放控制"中的"设为静音/取消静音"功能，或确保"发言人配置"中的音量值不为0

串口音量控制指令格式：

如需通过串口直接设置音量，可使用以下指令格式：

AA 55 02 [xx] 55 AA

• AA 55：帧头（固定）
• 02：音量控制命令
• xx：音量值参数，范围 00~40（十六进制，即十进制 0~64）
• 55 AA：帧尾（固定）

示例： - AA 55 02 00 55 AA：音量设置为0（静音） - AA 55 02 20 55 AA：音量设置为32（中等音量） - AA 55 02 40 55 AA：音量设置为64（最大音量）

如何通过变量方式设置音量？¶

问题描述：

平台中的音量控制只有"最小音量"、"中等音量"、"最大音量"等固定档位选项，希望能够通过变量动态设置具体的音量数值。

解决方案：

1. 变量方式配置

在平台配置"设置音量"操作时，方式可以选择"变量"而非固定的"数值"：

• 配置路径：添加控制 → 行为控制 → 控制方式（系统设置）→ 类别（播放控制）→ 操作（设置音量）
• 方式选择：选择"变量"而非"数值"
• 变量选择：选择已定义的变量（如串口接收的变量或自定义变量）

配置界面显示"方式"可选择"变量"或"数值"

2. 应用场景

• 串口动态控制：MCU通过串口发送音量数值，模块使用接收到的变量设置音量
• 条件音量调节：根据环境或其他条件动态计算音量值
• 多级音量控制：实现超过预设档位的更多音量级别

3. 配置示例

通过串口变量控制音量的完整流程：

1. 定义串口输入变量（如 vol_value）
2. 配置音量设置行为：
3. 控制方式：系统设置
4. 类别：播放控制
5. 操作：设置音量
6. 方式：变量
7. 选择变量：vol_value
8. MCU发送音量值：通过串口发送 0-100 范围内的数值

注意事项：

• 变量值范围为 0-100，超出范围可能导致异常
• CI系列模块支持此功能
• 确保变量在使用前已被正确赋值

语言设置对命令词输入有何限制？¶

问题描述：

在设置语言为中文后，语音命令词及回复语是否可以使用英文？

解决方案：

1. 语言限制说明

平台对语言设置有严格限制：

• 中文语言：只能使用中文命令词和回复语
• 英文语言：只能使用英文命令词和回复语
• 不能混合使用中英文

2. 规则说明

单条回复语的支持范围：

• 支持中英文混合输入的描述是指规则说明
• 实际配置时必须严格遵守语言选择
• 单条回复语不得超过500个字符
• 支持逗号、句号、问号等标点
• 不能使用阿拉伯数字，需用中文数字代替

3. 配置建议

根据目标用户选择语言：

• 国内用户：选择中文语言，配置中文命令词
• 海外用户：选择英文语言，配置英文命令词
• 需要双语支持：考虑开发两个版本

注意事项：

• 语言设置后所有语音交互都使用该语言
• 命令词识别准确率与语言匹配度相关
• 建议使用目标用户最熟悉的语言进行配置

特殊需求处理：

如需要在中文固件中使用其他语言的命令词（如日文），可通过以下方式实现：

• 谐音字代替：使用中文谐音字近似模拟其他语言发音
• 自学习功能：使用自学习功能逐条录制其他语言命令词
• 更换语言模型：如需完整的其他语言支持，建议在平台中切换到对应语言模型（如日文、韩文等）

如何在低代码平台实现音量控制逻辑？¶

问题描述：

需要在行为控制中实现条件判断：当系统音量小于等于100时增加音量，否则播报"声音已达最大"，同时需要更新音量变量。

解决方案：

1. 变量模拟方案

由于平台无法直接读取系统音量值，需要使用变量模拟：

• 创建Voice变量存储当前音量值
• 变量初始值与发音人配置的音量一致
• 通过条件判断控制变量更新

2. 配置步骤

第一个控制条件：

• 条件：变量 Voice 小于 数值 100
• 操作：增加音量（默认增加20）
• 音量增加后需更新Voice变量

第二个控制条件：

• 条件：变量 Voice 小于 数值 100
• 操作：变量自增（增加20）
• 确保Voice变量与实际音量同步

第三个控制条件：

• 条件：变量 Voice 大于等于 数值 100
• 操作：播报"声音已达最大"
• 提示用户已达音量上限

3. 实现逻辑

if (Voice < 100) {
    增加系统音量;
    Voice += 20;  // 变量自增
} else {
    播报"声音已达最大";
}

4. 注意事项

• 平台条件执行后只能跟一个操作，需要添加多个控制
• 默认增加音量为20，可根据需要调整
• 变量最大值应设置合理上限
• 测试时确认变量与实际音量同步

如何使用系统音量变量实现最大/最小值判断？¶

问题描述：

当音量调节到最大值或最小值时，希望模块播报提示音或停止播报，而不是继续执行音量调节操作。

解决方案：

1. 使用系统音量变量

平台提供内置的"系统音量"变量，可以直接在条件判断中使用：

• 变量名：系统音量
• 变量类型：数值型
• 取值范围：0-100

2. 音量最大值判断配置

当音量达到100时播报提示：

行为：mode_44
是否条件执行：是
条件子项：变量 系统音量 大于等于 数值 100
控制方式：播放语音
语音内容：主音量已加到最大值

3. 音量最小值判断配置

当音量达到0时播报提示：

行为：mode_45
是否条件执行：是
条件子项：变量 系统音量 小于等于 数值 0
控制方式：播放语音
语音内容：主音量已减到最小值

4. 引导用户输入的配置

在音量未达到极值时，引导用户说出具体调节值：

行为：mode_44
是否条件执行：是
条件子项：变量 系统音量 小于 数值 20
控制方式：播放语音
语音内容：请说出主音量加大的值，例如加三，加十

5. 完整配置示例

• 条件1：系统音量 ≥ 100 → 播报"已加到最大值"
• 条件2：系统音量 ≤ 0 → 播报"已减到最小值"
• 条件3：0 < 系统音量 < 100 → 执行音量调节操作

注意事项：

• "系统音量"是平台内置变量，无需在变量定义中手动创建
• 条件判断中的"大于等于"、"小于等于"等比较运算符要正确选择
• 可以组合多个条件实现复杂的判断逻辑
• 该方法同样适用于速度、亮度等其他数值型参数的极值判断

设置语音回复后播报功能还会执行吗？¶

问题描述：

在语音回复设置中已配置了语音回复功能，想知道图二中的播报功能是否还会执行。

解决方案：

1. 功能优先级说明

平台配置的执行顺序：

• 语音回复优先：如果已配置语音回复，优先执行回复
• 播报功能次之：播报功能作为补充，通常在特定条件下触发
• 执行逻辑：根据触发条件和配置决定具体执行内容

2. 配置建议

避免冲突：

• 语音回复和播报功能选择其一配置
• 如需同时使用，确保触发条件不冲突
• 测试时确认实际执行效果

功能选择：

• 语音回复：适合简单的确认反馈
• 播报功能：适合复杂的状态播报
• 组合使用：需要仔细设计触发逻辑

3. 实现方式

如果需要两个功能都工作：

• 设置不同的触发条件
• 使用变量控制播报时机
• 通过条件判断控制执行顺序

注意事项：

• 优先执行语音回复功能
• 播报功能可能被语音回复覆盖
• 建议在平台上实际测试确认行为
• 保留功能配置的测试记录

如何在智能平台实现基于变量的多模式交互逻辑？¶

问题描述：

需要在灯具项目中实现三种模式的交互逻辑：模式一可调节亮度和色温，模式二只能调节亮度，模式三只能调节色温。当前平台似乎只能配置单条语音指令，无法直接实现嵌套的交互逻辑。

解决方案：

使用智能平台的变量功能可以实现复杂的嵌套交互逻辑：

1. 变量设置方法

创建变量：

• 在平台进入"变量定义"页面
• 创建一个变量，如lightmode（灯光模式）

• 设置变量值：

  • 模式一：值为0
  • 模式二：值为1
  • 模式三：值为2

2. 命令词配置

模式设置命令：

• "模式一"：设置变量lightmode=0
• "模式二"：设置变量lightmode=1
• "模式三"：设置变量lightmode=2

亮度控制命令：

• 在每个亮度命令（如"亮度一档"）添加条件执行
• 条件：变量lightmode=0（模式一时允许）
• 条件：变量lightmode=1（模式二时允许）
• 不设置条件时，所有模式都可调节亮度

色温控制命令：

• "色温一档"：添加条件lightmode=0 AND lightmode=2（仅模式一和模式三）
• "色温二档"：添加条件lightmode=0 AND lightmode=2（仅模式一和模式三）
• "色温三档"：添加条件lightmode=0 AND lightmode=2（仅模式一和模式三）

色温控制命令（模式二）：

• 色温调节命令在模式二时不需要条件限制
• 因为模式二允许调节色温

3. 配置步骤

添加控制触发：

• 在命令词配置中点击"附加条件"
• 选择"变量"条件类型
• 设置变量名和条件值
• 添加对应的控制动作

4. 注意事项

• 条件判断从上到下依次执行
• 多个条件用"AND"连接，表示同时满足
• 变量值改变后，后续命令会使用新的条件判断
• 测试时建议逐个验证每个模式的响应

如何在小程序平台中使用变量进行条件控制配置？¶

问题描述：

需要在智能平台中配置基于变量的条件控制逻辑，实现不同模式下的差异化控制，但不清楚变量的定义方法、使用方式和具体要求。

解决方案：

1. 变量定义说明

变量类型：

• 平台支持数值型变量
• 变量名可自定义命名
• 变量值可根据命令动态改变

变量作用：

• 存储当前系统状态
• 在多个命令间传递信息
• 实现复杂的逻辑判断

2. 变量配置步骤

创建变量：

• 进入"变量定义"页面
• 点击"+添加变量"
• 输入变量名称（如：lightmode）
• 设置初始值

变量使用场景：

• 模式切换：命令执行后更新变量值
• 状态记忆：记录当前的工作模式
• 条件判断：根据变量值执行不同操作

3. 条件控制配置

添加条件触发：

• 在命令词配置中启用"是否条件执行"
• 选择"变量"作为条件类型
• 设置条件：变量名、操作符（等于/不等于）、比较值

4. 具体应用示例

变量设置：

• 变量名：lightmode
• 初始值：0

模式切换命令：

• "模式一"：设置lightmode=0，执行对应功能
• "模式二"：设置lightmode=1，执行对应功能
• "模式三"：设置lightmode=2，执行对应功能

条件控制命令：

• "亮度调节"：添加条件lightmode=0时才允许
• "色温调节"：添加条件lightmode=2时才允许

5. 配置技巧

单一变量多用途：

• 一个变量可以控制多个功能
• 通过不同的条件组合实现复杂逻辑
• 减少变量数量，简化配置

条件组合使用：

• 使用AND连接多个条件
• 实现更精确的控制逻辑
• 示例：lightmode=0 AND 命令词="亮度" 等于模式一时

注意事项：

• 变量值改变会影响后续所有条件判断
• 配置时要考虑所有可能的触发场景
• 建议先在测试环境验证逻辑正确性
• 变量命名要有意义，便于后期维护

语音指令配置时如何避免冲突？¶

问题描述：

在配置命令词控制时，如果同一个命令词设置了多个控制项，可能导致预期行为无法正常执行，出现逻辑冲突。

解决方案：

1. 冲突原因分析

• 平台按配置顺序执行控制项
• 多个控制项之间可能存在互斥关系
• 条件判断逻辑错误导致意外的执行路径

2. 避免冲突的最佳实践

单一控制项原则：

• 每个命令词只配置一个核心功能
• 使用复杂条件逻辑替代多个控制项
• 避免同一命令词的重复定义

条件执行优化：

• 将互斥的条件整合到同一个控制项中
• 使用AND、OR逻辑组合条件
• 确保条件之间的逻辑关系正确

3. 配置建议

场景一：模式相关控制

• 不要为"模式切换"、"模式一"等设置独立控制项
• 使用变量记录当前模式，在命令词中判断模式状态
• 通过条件执行实现模式相关功能

场景二：时间或状态相关

• 避免为不同时间段设置多个控制项
• 使用单一控制项配合复杂条件表达式
• 考虑使用延迟或定时器功能

场景三：多步骤操作

• 将相关操作配置在同一控制项的多个动作中
• 按执行顺序排列动作
• 使用"播放-等待-检测-执行"的流程

4. 调试技巧

• 使用语音播报输出中间状态，便于调试
• 记录详细日志，分析执行路径
• 在测试环境验证每个场景的响应
• 逐步添加功能，避免一次性修改过多

5. 注意事项

• 控制项之间避免使用"无条件"和"条件"混合
• 仔细检查条件的优先级和逻辑关系
• 保留配置备份，出现问题时快速恢复
• 复杂逻辑建议先在测试环境验证

语音指令配置时如何避免冲突？¶

问题描述：

在配置条件执行时出现了逻辑冲突：为"色温一档"命令词添加了模式三（lightmode=2）的条件下禁止播放提示语，导致模式一时即使命令词匹配，也无法正常播报"色温已调至一档"。

解决方案：

1. 问题分析

• 同一个命令词配置了两个控制项
• 第一个控制项：直接播放回复语（无条件）
• 第二个控制项：条件执行（模式三时禁止）
• 平台优先匹配条件执行规则，导致直接控制被忽略

2. 解决方案

调整控制项顺序：

• 将条件执行的控制项移动到列表上方
• 将无条件执行的控制项移动到列表下方
• 平台按从上到下的顺序执行，先执行条件判断

或者使用单一控制项：

• 将条件逻辑整合到一个控制项中
• 使用嵌套条件或逻辑表达式
• 避免同一命令词的多个控制项冲突

3. 最佳实践建议

统一配置方式：

• 为每个命令词只设置一个控制项
• 在该控制项中包含所有条件判断逻辑
• 使用"如果-那么-否则"结构处理复杂条件

条件配置示例：

如果 lightmode = 2:
    播放"腔镜模式不能调节色温"
否则:
    播放"色温已调至一档"
    设置PWM1占空比

4. 注意事项

• 控制项的执行顺序会影响最终效果
• 建议在配置完成后进行充分测试
• 复杂逻辑可以拆分为多个命令词
• 保留配置备份，便于后续修改和调试

- 复杂逻辑建议分步实现，先测试基础功能

SDK文件解压后应放置在哪个位置？¶

问题描述：

解压SDK文件后，不清楚应将解压后的文件夹放置在项目根目录的哪个位置，导致无法正确配置开发环境。

解决方案：

• 将解压后的SDK文件夹直接放置在项目根目录下
• 确保lib文件夹位于项目根目录的直接子目录位置
• 项目结构应包含根目录下的lib文件夹及相关的SDK文件

注意事项：

• SDK文件路径配置错误会导致编译失败
• 不要将SDK文件放在深层子目录中
• 确保项目路径不包含中文或特殊字符

SDK生成失败是什么原因？¶

问题描述：

在使用SDK进行开发时，遇到SDK生成失败的问题，提示协议不支持。

解决方案：

问题原因：

• 编码格式不兼容：使用GB2312编码格式，而平台仅支持UTF-8编码
• 协议限制：某些定制协议可能与标准SDK不兼容

解决方法：

1. 转换编码格式

   • 将GB2312编码的文本转换为UTF-8格式
   • 使用专业的编码转换工具
   • 确保所有文本内容使用UTF-8编码

2. 使用标准协议

   • 遵循平台提供的标准串口通信协议
   • 参考官方文档中的协议规范
   • 避免使用不兼容的定制协议

3. 重新生成SDK

   • 确保所有配置使用UTF-8编码
   • 使用标准协议设置
   • 重新生成SDK文件

注意事项：

• 平台仅支持UTF-8编码，不支持GB2312等其他编码格式
• 定制协议开发需要联系专业技术支持团队
• 生成前检查所有文本内容的编码格式
• 保留原始文档备份，防止编码转换丢失信息

CI系列TTS功能支持英文吗？TTS协议可以定制吗？¶

问题描述：

需要了解CI系列芯片的文本转语音功能是否支持英文，以及现有TTS协议是否支持定制化需求。

解决方案：

语言支持限制：

• 仅支持中文：目前CI系列TTS功能只支持中文文本转语音
• 不支持英文：无法处理英文文本的语音合成
• 未来规划：英文支持功能暂无明确时间表

协议定制说明：

• 标准协议可用：视频演示中的TTS串口协议可直接使用
• 定制暂不支持：按文档中的定制协议目前无法实现
• 需求积压：开发资源紧张，新的定制需求暂时无法处理

可用方案：

1. 使用标准TTS协议

   • 参考官方视频中的协议格式
   • 按照标准格式发送文本数据
   • 可实现基本的中文TTS功能

2. 中英混合方案

   • 英文内容通过其他方式处理（如录音播放）
   • 中文内容使用TTS功能
   • 在应用层进行语言判断和分发

3. 等待功能更新

   • 关注官方功能更新通知
   • 英文支持上线后可第一时间使用
   • 提前做好产品规划

注意事项：

• TTS功能目前仅限于中文文本
• 定制协议需要等待开发资源释放
• 建议评估现有功能是否满足项目需求
• 如急需英文支持，可考虑其他替代方案

声控产品在中国国内有哪些标准和认证？¶

问题描述：

声控产品在国内是否有相关的标准及认证，以及CI1302芯片是否具备相关认证。

解决方案：

• 声控产品在国内暂无专门的标准
• CI1302芯片提供REACH认证

• 提供两种REACH认证文件：

  • 芯片 CI1302 REACHSVHC235项认证
  • 芯片CI1302非金属REACHSVHC241+12+1项+金属73项+邻苯DINP认证

注意事项：

• 认证文件可向技术团队索取
• 建议根据产品目标市场要求确定所需认证
• REACH认证主要针对出口欧盟市场

固件生成时间显示不准确怎么办？¶

问题描述：

在使用固件生成平台时，发现固件生成时间显示不准确，且无法根据实际任务量动态调整，导致用户对生成时长的预估不准确。

解决方案：

• 生成时间根据当前排队人数等情况动态显示
• 系统会根据实际情况计算所需时间
• 时间预估会考虑服务器负载和任务复杂度

注意事项：

• 生成时间是预估时间，实际可能有所波动
• 高峰期生成时间会相应延长
• 建议合理安排生成时间，避开高峰期

如何修改固件中的唤醒词和开机播报语音？¶

问题描述：

需要将英文版固件的唤醒词和开机播报语音修改为中文内容。

解决方案：

固件修改流程：

1. 提供原始固件

   • 提供需要修改的固件文件
   • 说明具体修改需求

2. 明确修改内容

   • 唤醒词：如"小薇 小薇"（中文）或"Xiao Wei Xiao Wei"（英文）
   • 开机播报：如中文或英文语音提示

3. 专业专业技术支持处理

   • 技术团队接收固件后进行修改
   • 生成新的固件文件
   • 进行测试验证

4. 获取修改后的固件

   • 下载新生成的固件文件
   • 进行烧录测试
   • 验证唤醒词和播报内容

测试建议：

• 烧录后测试唤醒灵敏度
• 验证开机播报是否清晰
• 如效果不佳可进一步调整

注意事项：

• 固件修改需要专业专业技术支持
• 修改后的固件需要重新测试验证
• 不同语言可能需要不同的语音模型
• 保留原始固件作为备份

能图元平台页面无法打开或显示异常怎么办？¶

问题描述：

访问能图元平台的AI产品管理页面时，页面显示异常或无法正常加载。

解决方案：

临时解决方法：

1. 刷新页面

   • 使用F5或Ctrl+F5强制刷新
   • 清除浏览器缓存后重新访问
   • 尝试使用无痕/隐私模式浏览

2. 检查网络连接

   • 确认网络连接正常
   • 尝试访问其他网站验证网络
   • 重启路由器或切换网络

3. 更换浏览器

   • 尝试使用Chrome、Firefox、Edge等不同浏览器
   • 更新浏览器到最新版本
   • 禁用不必要的浏览器插件

4. 检查平台状态

   • 联系专业技术支持确认平台是否维护
   • 查看官方通知或公告
   • 确认是个人问题还是平台故障

预防措施：

• 定期清理浏览器缓存
• 保持浏览器版本更新
• 收藏正确的平台网址
• 避免同时打开过多标签页

注意事项：

• 页面加载失败通常是临时性问题
• 如问题持续存在，及时反馈给专业技术支持
• 提供具体的错误信息和截图
• 记录问题发生的时间和操作步骤

如何开发英文版本的唤醒词和开机播报功能？¶

问题描述：

需要在现有中文语音系统的基础上，开发英文版本的唤醒词和开机播报功能。

解决方案：

开发流程：

1. 提供需求说明

   • 英文唤醒词：如"Xiao Ke Xiao Ke"、"Xiao Ai Xiao Ai"
   • 英文开机播报：如"Vehicle voice control system activated, you can call me anytime"

2. 基于现有固件修改

   • 在现有中文固件基础上进行英文适配
   • 保持功能不变，仅更换语言版本

3. 技术处理

   • 技术团队进行英文语音模型替换
   • 调整唤醒词识别算法
   • 生成新的英文固件

4. 测试验证

   • 下载新固件进行测试
   • 验证英文唤醒词识别率
   • 确认英文播报清晰度

开发注意事项：

• 英文发音需标准清晰
• 唤醒词建议4个音节以上
• 测试不同口音和语速的识别效果
• 如效果不佳可要求重新调整

时间说明：

• 固件生成需要一定时间
• 技术团队会按订单顺序处理
• 紧急需求可提前沟通

旧款蜂鸟M芯片是否兼容新固件？¶

问题描述：

旧款蜂鸟M（US516P6）芯片是否可以烧录之前版本的固件，而无需重新生成新固件。

解决方案：

固件兼容性说明：

• 完全兼容：旧款蜂鸟M芯片支持新旧固件
• 无需重新生成：可以直接使用之前版本的固件进行烧录
• 向后兼容：新版本固件通常包含旧版本的功能

烧录建议：

1. 使用现有固件：

   • 可以直接使用之前备份的固件文件
   • 无需通过平台重新生成
   • 保持原有的功能和配置

2. 版本确认：

   • 确认固件版本与硬件匹配
   • 检查固件是否包含所需功能
   • 必要时可升级到更新版本

注意事项：

• 旧款芯片的兼容性较好，可支持多种固件版本
• 建议保留固件备份以便后续使用
• 如遇到功能问题，可考虑使用最新版本的固件

固件发布时如何选择"优化版"和"快速发布版"？¶

问题描述：

在固件发布界面无法找到"优化版"选项，以及量产时是否需要更换为Pro模型。

解决方案：

• 点击"发布"按钮前需要先点击"继承"才会弹出选项框
• 选择"优化版"或"快速发布版"进行发布
• 量产建议使用已经通过测试的模型，不建议封样后切换
• 重新发布固件前需要完整测试功能

注意事项：

• 封样后切换模型容易出问题
• Pro模型识别效果更好，但需要充分测试
• 重新发布仅修改发布类型是安全的

生成SDK时提示"Voice值不能为空"怎么办？¶

问题描述：

在生成SDK时，系统提示"Voice值不能为空"错误，导致SDK生成失败。

解决方案：

• 检查前端信号处理配置中的应用场景是否正确切换
• 确认选择的语言模型与应用场景匹配
• 中文固件转换为英文时，需要切换到对应的英文应用场景

注意事项：

• 该错误通常发生在语言切换后未正确更新应用场景
• 生成前仔细检查所有配置项
• 如问题持续，可导出工程文件联系技术团队

固件生成时显示配置失败怎么办？¶

问题描述：

在使用固件生成平台时，配置检查通过后仍显示配置失败，导致固件无法生成。

解决方案：

常见原因及解决方法：

1. 配置项未完全填写

   • 检查所有必填项是否都已配置
   • 特别关注命令词、行为等关键配置
   • 未使用的配置项建议删除，不要留空

2. 命令词配置错误

   • 确认每个命令词都对应了具体行为
   • 检查是否有重复或冲突的命令词
   • 验证命令词格式是否符合要求

3. 平台操作步骤

   • 发布前务必点击"检查配置"
   • 检查通过后，尝试重新发布
   • 如仍失败，导出配置文件供技术分析

4. 特殊功能配置

   • 需要特定逻辑（如指令触发自学习）时，需要在控制配置中设置条件判断
   • 示例：设置"开启配置"命令作为自学习功能的前置条件
   • 确认条件判断的逻辑正确性

排查建议：

• 逐项检查配置，特别注意未使用但仍保留的配置项
• 简化配置测试，先验证基本功能
• 保存配置备份，避免重复修改
• 问题持续时导出配置文件联系技术团队

注意事项：

• 配置检查通过不代表所有设置都正确
• 空的配置项可能导致生成失败
• 复杂逻辑建议分步骤验证

如何配置特定指令触发自学习功能？¶

问题描述：

需要实现唤醒系统后，通过特定指令（如"开启配置"）才进入自学习模式。

解决方案：

配置步骤：

1. 设置唤醒词

   • 配置系统唤醒词
   • 确保唤醒词独立且不易误触发

2. 添加触发指令

   • 创建"开启配置"命令词
   • 设置该命令的行为为"进入自学习模式"
   • 配置对应的GPIO或串口输出指示状态

3. 配置学习模式

   • 在自学习模式下，关闭其他命令识别
   • 只响应学习相关的指令
   • 学习完成后返回正常模式

4. 状态指示

   • 使用LED或其他方式提示当前模式
   • 帮助用户了解系统状态
   • 避免模式混淆

注意事项：

• 确保状态切换的可靠性
• 学习模式需要有明确的退出机制
• 考虑超时自动退出学习模式

智能公元平台无法访问或链接失效怎么办？¶

问题描述：

访问智能公元AI产品零代码平台时页面无法正常加载，或之前保存的访问链接失效。

解决方案：

• 官网已更新，旧的访问链接（如 http://www.smartpi.cn）可能失效
• 使用新的访问地址：http://smartpi.cn/#/
• 通过搜索引擎搜索"智能公元官网"获取最新访问链接

注意事项：

• 建议收藏新的官方链接以避免后续访问问题
• 如遇到页面加载问题，可尝试清除浏览器缓存或更换浏览器
• 平台更新期间可能出现短暂访问不稳定，建议稍后重试

什么是GPIO上电记忆功能？如何配置？¶

问题描述：

需要了解上电记忆功能的含义，以及如何配置GPIO在上电后保持特定电平状态。

解决方案：

上电记忆功能说明：

• 开启后，GPIO引脚在下次上电时会保持断电前的状态
• 关闭后，GPIO引脚每次上电都会恢复到默认状态
• 适用于需要保持设备开关状态的应用场景

电平定义：

• 高电平：GPIO输出高电平（3.3V），可用于驱动LED点亮
• 低电平：GPIO输出低电平（0V），相当于开路状态

GPIO控制配置步骤：

1. 进入控制配置界面

   • 选择"添加控制"
   • 设置控制方式为"端口输出"
   • 选择控制类型为具体的GPIO引脚

2. 配置输出参数

   • 动作选择"设置电平"
   • 参数可选择"高电平"或"低电平"
   • 不需要设置条件子项，直接执行输出

GPIO设置页面中的上电记忆功能开关

添加控制界面，配置GPIO输出参数

注意事项：

• 条件子项用于条件触发，直接控制时无需设置
• GPIO输出能力有限，驱动大功率负载需要外加驱动电路
• 配置完成后需要烧录固件才能生效

GPIO输出配置补充说明：

• 是否延时输出：选择"否"可立即执行输出动作
• 条件子项：用于设置触发条件，直接控制时应留空
• 控制类型与参数：选择要控制的GPIO及目标电平状态

配置GPIO_A0输出高电平，条件子项留空

移除条件子项并设置不延时输出

如何在语音芯片进入睡眠时触发IO控制？¶

问题描述：

希望语音芯片在进入睡眠模式时能够触发IO控制，而不是只在唤醒时触发。

解决方案：

睡眠触发实现方法：

• 配置唤醒源：语音芯片在进入睡眠模式时，可通过配置唤醒源（如GPIO）实现控制
• GPIO唤醒设置：可设置特定IO引脚为唤醒源，当该引脚状态变化时，芯片从睡眠模式唤醒并执行指定操作

• 配置步骤：

  1. 在平台中找到睡眠/唤醒配置选项
  2. 选择GPIO作为唤醒源
  3. 设置触发条件（高/低电平、上升/下降沿）
  4. 配置唤醒后执行的动作

注意事项：

• 具体配置方法需参考芯片手册中的Sleep Mode章节
• 或使用SDK提供的sleep_config函数
• 睡眠模式下部分外设会关闭以降低功耗

平台上可以更改项目的模块型号吗？¶

问题描述：

在平台上已创建的项目，需要将模块型号从CI-03系列更换为CI-73，但目前只能新建项目。

解决方案：

当前平台限制：

• 不支持直接更改：当前平台暂不支持直接更改已创建项目的模块型号
• 需要新建项目：更换模块型号必须创建新项目

操作建议：

1. 创建新项目：

   • 选择目标模块型号（如CI-73）
   • 参考原项目的配置进行设置
   • 确保功能配置与原项目一致

2. 配置迁移：

   • 逐项复制原项目的配置
   • 包括唤醒词、命令词、控制逻辑等
   • 测试新项目的功能完整性

注意事项：

• 未来版本可能支持型号更换功能，建议关注平台更新公告
• 备份原项目配置以防数据丢失
• 新建项目后原项目仍保留，可选择性删除

如何通过串口动态选择唤醒词？¶

问题描述：

生成固件时，希望通过上位机串口动态选择一个唤醒词作为唯一的唤醒词。

解决方案：

动态唤醒词实现方案：

• 串口通信实现：可通过串口通信实现动态选择唤醒词，需在固件中实现串口接收和唤醒词切换逻辑

• 实现步骤：

  1. 在上位机软件中提供唤醒词列表
  2. 通过串口发送选择指令（如SET_WAKEUP_WORD 1）
  3. 语音芯片接收指令后，加载对应唤醒词并更新固件配置

注意事项：

• 需确保唤醒词已预先制作并存储在Flash中
• 必须支持动态加载功能
• 上位机需要开发相应的控制界面

• 重新烧录前请备份原有配置
• 如遇到兼容性问题，请查看版本更新说明

语音模块是否支持越南语等小语种？¶

问题描述：

需要了解语音模块是否支持越南语等非中文语种，以及语种定制的相关费用和流程。

解决方案：

语种支持情况：

1. 支持语种：

   • 支持越南语等多种语种
   • 需要进行语种定制
   • 可根据项目需求开发特定语言支持

2. 定制服务流程：

   • 评估需求：确认语种类型、词条数量和播报内容
   • 需求确认：根据需求复杂度和工作量确认交付范围
   • 开发定制：进行语音模型训练和固件适配
   • 测试验证：提供样品进行功能测试

费用说明：

• 小语种定制服务需根据需求评估，具体请联系官方渠道确认

• 评估通常会参考以下因素：

  • 词条数量（如50条）
  • 播报内容长度
  • 月预期使用量
  • 特殊技术要求

注意事项：

• 语种定制需要一定的开发周期
• 建议提供具体的词条和播报内容清单
• 定制完成后保留技术文档便于后续维护
• 低功耗限制：低功耗产品（如SU系列低功耗型号）暂不支持日语等小语种，小语种仅限CI系列常规功耗产品
• 双模型限制：支持多语种双模型切换的模块一般不支持低功耗模式

自学习功能与识别率有关吗？¶

问题描述：

希望了解网页配置中的自学习功能是什么作用，以及开启该功能是否可以提高语音识别的准确率。

解决方案：

自学习功能说明：

• 功能定义：自学习是语音模块的自主学习功能，用于优化特定用户的语音特征
• 主要作用：适应特定用户的发音习惯，提升个性化体验
• 识别率影响：自学习功能与识别率没有直接关系

识别率关键因素：

1. 硬件设计

   • 麦克风质量和位置
   • 电路设计的合理性
   • 电源稳定性

2. 环境因素

   • 环境噪声控制
   • 说话距离和角度
   • 回声处理

3. 配置优化

   • 命令词的选择和训练
   • 阈值设置
   • 唤醒词的清晰度

自学习使用建议：

• 适用场景：需要个性化优化的场景
• 开启条件：有特殊发音习惯或环境需求时
• 使用方式：按平台指引完成自学习训练
• 效果评估：通过实际测试判断是否带来改善

注意事项：

• 自学习功能主要用于个性化适配，不是通用识别率提升方案
• 识别率更多取决于硬件设计、环境配置和命令词选择
• 建议先优化基础配置，再考虑是否使用自学习
• 自学习完成后需要保存并重新生成固件

• 批量应用时可协商优惠价格

CI13242芯片的词条开发是否需要在公司提供的网上平台进行？¶

问题描述：

需要确认CI13242芯片的词条开发是否必须在公司提供的网上平台进行。

解决方案：

是的，CI13242芯片的词条开发需要在公司提供的网上平台进行。

开发平台说明：

• 官方平台：通过公司提供的在线开发平台进行词条配置
• 零代码开发：无需编写代码，通过可视化界面完成配置
• 一站式服务：从词条定义到固件生成全流程在平台完成

平台优势：

• 操作简便，降低开发门槛
• 提供丰富的开发资源和文档支持
• 支持在线调试和快速验证
• 便于团队协作和版本管理

注意事项：

• 建议使用官方推荐的浏览器版本
• 开发过程中及时保存配置
• 完成配置后需要下载并烧录对应固件

BLE蓝牙和经典蓝牙有什么区别？¶

问题描述：

需要了解BLE蓝牙和经典蓝牙的区别，以及在不同应用场景中的使用差异。

解决方案：

1. 协议区别

• BLE蓝牙（低功耗蓝牙）：

  • 主要用于低功耗场景
  • 传输速率较低，适合小数据量传输
  • 连接建立快，功耗低
  • 主要用于IoT设备、可穿戴设备等

• 经典蓝牙：

  • 传输速率高，支持大数据量传输
  • 功耗相对较高
  • 适合音频流传输等场景
  • 主要用于耳机、音箱等音频设备

2. 应用场景

• 小程序控制：使用BLE蓝牙协议

  • 通过小程序连接和控制设备
  • 实现设备配网、状态查看、控制指令下发

• 音频播放：使用经典蓝牙协议

  • 连接音箱、耳机等音频设备
  • 播放音乐、语音通话等

注意事项：

• BLE和经典蓝牙是两种不同的协议，不能直接互通
• 设备可能同时支持两种协议，但用途不同
• 选择模块时需要根据实际应用场景决定使用哪种蓝牙协议

在线活动时服务器接入用户过多导致服务异常怎么办？¶

问题描述：

在进行最后一节课的在线活动时，遇到服务器接入用户过多导致服务异常的问题，且该问题在特定时间反复出现。

解决方案：

1. 问题识别

• 服务器并发访问量过大
• 特定时段（如最后一节课）用户集中访问
• 服务器负载超出承受能力

2. 缓解措施

• 避开高峰时段进行活动
• 提前预约或错峰使用
• 分批进行在线活动

3. 协调支持

• 联系技术团队预告活动时间
• 请求临时扩容服务器资源
• 获取专用通道或优先级

4. 应急处理

• 准备备用方案（如录播）
• 延迟活动时间避开高峰
• 分组进行减少并发

注意事项：

• 此问题属于服务器容量限制，非设备故障
• 建议提前与技术服务沟通协调
• 重要活动前进行压力测试

平台生成SDK速度较慢怎么办？¶

问题描述：

在平台生成SDK时，等待时间较长，存在明显的延迟现象。

解决方案：

1. 排队现象说明

   • 平台SDK生成采用排队机制，使用量大时会导致排队时间延长
   • 生成速度受当前并发数量影响

2. 缓解措施

   • 刷新页面查看最新状态
   • 避免在高峰时段进行SDK生成
   • 耐心等待排队完成

注意事项：

• 这是正常现象，并非系统故障
• 建议合理安排SDK生成时间
• 如等待时间过长，可联系官方确认状态

固件生成失败提示"配置原因"怎么办？¶

问题描述：

在平台配置产品特性并选择特定应用场景后，固件生成失败，提示"可能是配置原因，请检查配置"。

解决方案：

1. 检查配置冲突

   • 确认选择的"应用场景"和"产品特性"是否兼容
   • 某些新模型（如"中文风扇通用Pro"）可能与特定功能组合存在冲突
   • 尝试使用"安静环境"等基础场景配置

2. 内存容量排查

   • 深度降噪功能占用较多内存空间
   • 选择了过多功能可能导致内存不足
   • 可关闭非必要功能，如AEC打断

3. 配置优化建议

   • 使用老版本模型+特定功能组合
   • 避免同时开启多个高级功能
   • 先生成基础版本测试，确认配置正确

4. 参数配置检查

   • 检查详细控制中的参数设置
   • 删除不必要的高级配置项
   • 使用JSON配置文件导出，逐项检查

5. 替代方案

   • 使用平台导入/导出功能备份配置
   • 尝试使用之前成功生成过的配置
   • 联系官方，提供配置文件分析

注意事项：

• 新模型正在排查中，部分组合可能存在兼容性问题
• 生成失败通常是内存或配置冲突导致
• 保留配置备份，便于问题排查和恢复
• 多次失败建议等待系统优化后再试

如何在音量调节到最大或最小值时，通过语音提示告知用户当前音量状态？¶

问题描述：

需要实现音量调节功能，当音量达到最大值或最小值时，自动播放语音提示当前音量状态。

解决方案：

1. 定义音量控制变量

   • 创建两个变量：volume_up（音量增加）和 volume_down（音量减少）
   • 变量类型设置为 char
   • volume_up 默认值设为0（或当前音量值）
   • volume_down 默认值设为0（或当前音量值）

2. 配置音量增加控制逻辑

   • 创建"增加音量"指令（如A158）
   • 添加条件判断：当 volume_up < 80 时
     • 播放语音："增加音量"
     • 变量操作：volume_up 增加20
   • 添加条件判断：当 volume_up = 80 时
     • 播放语音："已是最大音量"

3. 配置音量减少控制逻辑

   • 创建"减少音量"指令（如A159）
   • 添加条件判断：当 volume_down > 0 时
     • 播放语音："减小音量"
     • 变量操作：volume_down 减少20
   • 添加条件判断：当 volume_down = 0 时
     • 播放语音："已是最小音量"

注意事项：

• 音量调节的步长默认为20，可根据需要调整
• 音量范围通常设置为0-80，具体值根据平台设置而定
• 音量加减操作可以使用同一个变量，分别定义增加和减少操作即可
• 配置时不要设置回复语，直接执行语音播报和变量操作

如何配置音量控制逻辑，实现音量增减的条件判断？¶

问题描述：

需要配置音量控制功能，实现通过语音指令增加或减小音量，并在音量达到最大或最小值时给出相应提示。

解决方案：

1. 定义音量变量

   • voice_up：类型char，默认值0（用于音量增加控制）
   • voice_down：类型char，默认值80（用于音量减少控制）
   • 注意：实际音量范围以平台设置的音量滑块为准

2. 配置增加音量指令（voice_up）

   • 条件1：voice_up < 80
     • 控制方式：播放语音
     • 语音内容："增加音量"
   • 条件2：voice_up = 80
     • 控制方式：播放语音
     • 语音内容："已是最大音量"

   • 变量操作：

     • 控制方式：变量设置
     • 变量：voice_up
     • 操作：增加
     • 数值：20

3. 配置减少音量指令（voice_down）

   • 条件1：voice_down > 0
     • 控制方式：播放语音
     • 语音内容："减小音量"
   • 条件2：voice_down ≤ 0
     • 控制方式：播放语音
     • 语音内容："已是最小音量"

   • 变量操作：

     • 控制方式：变量设置
     • 变量：voice_down
     • 操作：减少
     • 数值：20

注意事项：

• 音量调节步长默认为20，可根据实际需求调整
• 确保变量操作设置在条件判断之后执行
• 音量上下限应与平台音量范围保持一致（通常为0-80）
• 建议使用同一个变量控制音量，避免定义过多变量

固件生成失败，提示"生成的固件超大(8192字节)"怎么办？¶

问题描述：

在生成固件时，系统提示"生成失败，生成的固件超大(8192字节)"，即使配置检查已通过且指令数量较少。

解决方案：

1. 选择更小的模型

   • 进入"应用模型"选择界面
   • 选择占用空间更小的模型（如1M空间的模型）
   • 优先选择带"Pro"后缀的小模型
   • 例如："普通话通用Pro(占1M空间)"

2. 优化配置项

   • 删减不必要的配置项目
   • 删除一些命令词条以减少内存占用
   • 关闭非必需的高级功能
   • 减少语音播报内容的数量
   • 使用组合播报功能替代多个单独播报
   • 选用内存更小的模型

3. 分步验证

   • 先生成基础功能版本
   • 确认通过后再逐步添加功能
   • 每添加一个功能就尝试生成一次

注意事项：

• 8192字节(8KB)是固件大小的限制
• 配置检查通过不代表固件大小符合要求
• 25条指令在默认模型下可能会超限
• 组合播报可以减少固件占用空间

系统控制参数错误导致固件生成失败怎么办？¶

问题描述：

配置产品时，系统提示"行为控制详情中系统设置的参数错误 [行为名: sdjz]"，导致无法正常生成固件。

解决方案：

1. 定位错误参数

   • 查看错误提示中具体的行为名称（如sdjz）
   • 在详细控制配置中找到对应的设置项
   • 检查该行为的参数配置是否超出允许范围

2. 常见错误类型

   • 禁止识别词和学习唤醒词同时启用导致冲突
   • 参数值超出系统允许的范围
   • 必需参数未填写或格式错误
   • 功能组合存在逻辑冲突

3. 解决方法

   • 删除冲突的配置项（如"禁止识别词"和"学习唤醒词"）
   • 使用JSON配置文件检查所有参数
   • 恢复到默认配置后重新设置
   • 使用平台导出/导入功能备份正确配置

4. 配置建议

   • 先生成基础版本，确认功能正常
   • 逐步添加功能，每次生成后测试
   • 保留配置备份，便于问题恢复

注意事项：

• 参数错误通常不影响已生成的固件使用
• 配置冲突是新模型中的常见问题
• 建议使用老版本模型避免复杂配置问题
• 保留错误截图有助于快速定位问题

AEC打断功能是什么作用？¶

问题描述：

在配置产品特性时，对AEC（回声消除）打断功能的作用和使用场景存在疑问。

解决方案：

AEC（Acoustic Echo Cancellation）是回声消除技术的缩写，主要用于以下场景：

1. 功能作用

- 消除喇叭播放声音对麦克风的干扰
- 防止播放的语音被误识别为唤醒词或命令
- 提高在播放过程中的识别准确性

2. 应用场景

- 需要在播放过程中同时进行语音识别
- 播报音量较大或麦克风距离喇叭较近
- 需要快速打断播报并识别新的指令

3. 配置建议

- 安静环境下可以不开启AEC功能
- 喇叭和麦克风距离较近时建议开启
- 播报内容较多或音量较大时推荐使用

4. 与其他功能的关系

- AEC打断与学习模式是独立功能
- 可以单独开启或关闭
- 开启AEC可能略微增加系统资源消耗

注意事项：

• AEC功能主要解决播放与识别的冲突问题
• 不是所有应用场景都需要开启此功能
• 开启AEC后，如识别不正常可尝试关闭测试
• 该功能在老版本模型中通常需要手动开启

如何实现两个负载的互斥控制？¶

问题描述：

需要控制两个独立负载（如开关A和开关B），实现互斥功能，即当一个负载接通时，另一个负载必须自动关闭，避免同时工作导致冲突。

解决方案：

1. 使用IO输出直接控制

• 配置两个IO引脚（如IO1和IO2）分别控制两个负载
• 通过高低电平控制负载的开关状态

2. 配置互斥控制逻辑

打开一号负载指令：

- IO1输出：高电平
- IO2输出：低电平

打开二号负载指令：

- IO1输出：低电平
- IO2输出：高电平

关闭所有负载指令：

- IO1输出：低电平
- IO2输出：低电平

3. 平台配置步骤

• 在详细控制中创建两个控制指令
• 每个指令同时设置两个IO口的输出状态
• 确保一个IO为高时，另一个IO必为低
• 可添加"全关"指令用于关闭所有负载

4. 应用场景示例

• 电机正反转控制：防止正反转同时通电
• 照明模式切换：保证只有一种模式点亮
• 风扇调速档位：避免高速档和低速档同时开启
• 阀门控制：确保进水阀和出水阀不会同时打开

注意事项：

• 互斥控制通过IO电平输出实现，无需额外MCU
• 配置时要确保每个指令都同时控制两个IO口
• 建议添加全关指令作为安全选项
• 实际应用中可根据需要添加状态反馈
• 硬件设计时要考虑IO口的驱动能力

自学习功能如何配置？¶

问题描述：

在使用自学习功能时，对不同产品特性下自学习功能的启用条件和配置方法存在疑问。

解决方案：

1. 老版本模型配置

- 老版本模型自带自学习功能，无需在产品特性中选择
- 直接在详细控制中开启"学习唤醒词"或"学习命令词"
- 支持删除唤醒词、删除命令词、删除学习等操作

2. 新版本模型配置

- 新版本模型需要在"产品特性"中选择相应的自学习选项
- 选择"语音识别+自学习"或类似组合功能
- 根据功能需求选择对应的学习模式

3. 配置步骤

- 确认使用的是新版本还是老版本模型
- 老版本：在详细控制中直接配置
- 新版本：在产品特性中选择后再在详细控制中配置

4. 功能对比

- 老版本：功能稳定，配置简单
- 新版本：功能更丰富，但需要正确选择产品特性

注意事项：

• 模型版本不同，自学习功能的配置方式也不同
• 新老版本的配置界面和选项有区别
• 如配置后功能异常，检查是否选择了正确的模型版本
• 建议根据实际需求选择合适版本和配置

为什么自学习功能生成固件时会自动关闭？¶

问题描述：

在平台配置中已开启自学习功能，但每次生成固件后该功能会自动关闭。

解决方案：

1. 固件类型确认

- 某些特定语种的固件可能未包含自学习功能
- 需要确认生成的是否为支持自学习的固件版本
- 部分定制固件可能默认关闭自学习功能

2. 配置检查

- 确认在"产品特性"中选择了包含自学习的选项
- 检查生成固件时的配置是否正确保存
- 重新生成固件前再次确认自学习选项状态

3. 固件验证

- 生成固件后，检查固件配置信息
- 如问题持续，需要官方确认固件版本
- 可能需要重新选择正确的产品特性

注意事项：

• 自学习功能依赖于特定的固件支持
• 不同语种或版本的固件功能可能有差异
• 生成固件前务必确认所有配置已正确保存
• 建议使用支持自学习的标准固件版本

如何配置不学习唤醒词只学习命令词？¶

问题描述：

在使用自学习功能时，希望只学习命令词而不学习唤醒词，同时避免触发不必要的删除操作。

解决方案：

1. 修改学习唤醒词配置

- 在自学习界面修改学习唤醒词的内容
- 改为不常见、不易识别的词组（如"天王盖地虎，宝塔镇河妖"）
- 目的是避免误触发学习唤醒词功能

2. 配置删除功能选项

- 在"删除学习"功能中：

- 取消"删除唤醒词"选项
- 保留"删除命令词"选项
- 可选择性启用"删除学习"功能

3. 自学习流程

- 只进行命令词的学习训练
- 避免说出可能触发唤醒词的内容
- 学习完成后测试命令词识别效果

4. 替代方案

- 使用固定的唤醒词，通过命令词实现功能切换
- 在平台配置中预设好常用命令词
- 使用串口或其他方式控制设备状态

注意事项：

• 修改唤醒词为不常用词汇只是规避方法，并非根本解决方案
• 最好的方式是使用不支持唤醒词学习的固件版本
• 删除学习功能会清除所有学习内容，操作需谨慎
• 建议在测试环境下先验证配置效果

语音模块的指令是发送还是接收？¶

问题描述：

在使用语音模块时，需要确认模块发出的指令是模块向外发送的数据，还是模块接收的数据。

解决方案：

语音模块的指令通信是双向的，既可以发送也可以接收：

1. 指令方向说明

• 模块可以向外发送控制指令（如控制红外、串口输出等）
• 模块也可以接收外部指令（如串口输入、网络控制等）
• 同一个指令格式既可用于发送也可用于接收

2. 通信协议

• 串口通信指令格式统一
• 红外串口数据对标表中的指令格式
• 发送和接收使用相同的数据格式

3. 应用场景

• 发送：语音识别后控制外设（红外发射、GPIO输出）
• 接收：外部控制（串口命令、网络指令、触发播报）

注意事项：

• 指令格式在发送和接收时保持一致
• 具体是发送还是接收取决于应用场景和通信方向
• 开发时需根据实际需求判断指令流向

如何增加语音识别和播报的开关功能？¶

问题描述：

希望在语音模块中增加控制喇叭和语音识别功能的开关指令，以便在特定场景下可以关闭语音功能。

解决方案：

1. 公版固件限制

• 公版固件未内置语音开关指令
• 需要通过主控控制模块电源实现开关
• 断电会影响所有功能（包括服务器指令控制）

2. 定制开发方案

• 可定制开发专用的开关功能
• 支持通过串口控制语音识别和语音播报
• 需要一定的开发费用和采购量要求

3. 定制方式

• 方案一：支付开发费定制（具体费用请联系官方客服评估）

  • 包含3次功能修改
  • 如涉及优惠政策或采购量要求，请联系官方客服确认
  • 固件可修改1次

• 方案二：批量采购免费开发

  • 是否可提供免费/优惠开发服务需根据项目情况评估，请联系官方客服确认

4. 定制内容示例

• 红外学习顺序调整
• 唤醒词定制（仅保留特定唤醒词）
• 串口控制语音识别开关
• 串口控制语音播报开关

注意事项：

• 定制开发需要明确具体需求
• 定制固件与公版固件不兼容
• 建议根据项目规模选择合适的方案
• 定制开发有一定周期，需提前规划

语音模块的红外学习顺序是怎样的？¶

问题描述：

需要确认定制开发中红外学习的顺序设置，以确保学习流程正确。

解决方案：

标准红外学习顺序

1. 先关闭空调
2. 再打开空调
3. 后续保持不变

注意事项：

• 学习顺序固定，不可更改
• 学习的是按键的实际红外码
• 确保遥控器有足够的电量
• 学习环境避免红外干扰

WiFi模块是否可以对接涂鸦APP？¶

问题描述：

需要确认WiFi模块能否与涂鸦APP对接，以及是否需要定制开发和相关费用。

解决方案：

WiFi模块可以对接涂鸦APP，但需要定制开发：

• 通过网关方式对接：使用WiFi模块直接连接到涂鸦网关，进而与涂鸦APP通信
• 需要定制开发：对接涂鸦平台需要专门的定制开发服务
• 开发费用较高：定制开发涉及较多工作量，费用相对较高

注意事项：

• 量产后可降低成本：月用量达到一定规模（如上千级别）可协商降低开发费用
• 需求评估：建议提供具体的项目需求和预期用量，便于评估开发方案和费用
• 官方支持：可安排技术人员进行详细对接方案讨论

平台模块指令设置是否支持插行编辑？¶

问题描述：

在平台模块设置指令时，发现无法进行插行编辑，新添加的指令只能添加到指令列表的末尾，不能插入到现有指令的中间位置。

解决方案：

当前平台确实不支持插行编辑功能。如果需要调整指令顺序，可以：

1. 删除需要调整位置之后的指令
2. 重新按正确顺序添加这些指令

注意事项：

• 建议在添加指令前规划好执行顺序
• 删除并重新添加指令可能会影响已生成的SDK，需要重新生成

如何设置语音包的触发方式？¶

问题描述：

不清楚如何配置默认高电平和低电平触发方式，以及语音指令在设备上的体现方式。

解决方案：

1. 触发方式配置

• 默认高电平：GPIO默认输出高电平状态（3.3V）
• 触发方式低电平：当检测到低电平信号（0V）时触发动作
• 触发条件可设置为电平变化或边沿触发

2. 语音指令体现方式

语音指令在设备上通过以下方式体现：

• GPIO输出：控制外部设备（如LED、继电器）
• 语音播放：播放设定的提示音或回复语
• 串口输出：通过串口发送特定指令
• 组合动作：同时执行多个输出动作

3. 配置步骤

1. 在平台选择"触发器"配置
2. 设置GPIO的默认电平状态
3. 选择触发条件（高/低电平、上升/下降沿）
4. 配置触发后执行的语音动作
5. 生成固件并测试

注意事项：

• 默认电平状态影响电路设计，需提前确认
• 语音指令需要与触发条件匹配
• 建议添加必要的消抖处理

智能公元平台的正确访问地址是？¶

问题描述：

需要确认使用的平台是否为官方正式平台，以免影响产品配置和固件生成。

解决方案：

官方平台地址：

• 网址：https://smartpi.cn/
• 标识：页面标题显示"智能公元/AI产品零代码平台"
• 功能：包含完整的产品管理、固件生成、SDK下载等功能

平台区分说明：

1. 正式平台：https://smartpi.cn/

   • 官方运营的稳定版本
   • 功能完善，技术团队到位
   • 推荐所有项目使用

2. 测试平台：可能存在的内测版本

   • 用于新功能测试
   • 可能有功能限制或不稳定
   • 不建议正式项目使用

验证方法：

• 检查浏览器地址栏是否为 smartpi.cn
• 查看页面是否有"智能公元"标识
• 确认可以正常访问产品管理功能

注意事项：

• 建议收藏官方平台地址
• 如在其他平台遇到问题，请切换到官方平台
• 技术团队仅提供官方平台的服务

离线语音模块是否支持自行修改指令？¶

问题描述：

希望在离线语音识别模块上实现自定义语音指令的修改功能，但不确定是否支持。

解决方案：

离线语音模块的功能限制说明：

1. 指令修改限制

   • 离线模块本身不支持自行修改语音指令
   • 只能使用预设的固定指令进行控制
   • 需要通过蓝牙模块才能实现自定义功能

2. 词条数量限制

   • 低功耗模块的词条数量有限制
   • 不同型号支持的词条数量不同
   • 选择模块时需考虑词条容量需求

注意事项：

• 离线模块适合功能固定、成本敏感的应用场景
• 如需频繁修改指令，建议选择支持蓝牙的模块
• 可根据项目需求选择合适的模块型号

上传的配置文件有问题如何排查？¶

问题描述：

在智能公元平台上传JSON配置文件后，配置存在问题需要技术团队检查。

解决方案：

当配置文件上传后出现问题时，按以下步骤排查：

1. 平台确认

   • 确认使用的是官方平台：https://smartpi.cn/
   • 检查账号登录状态是否正常
   • 验证产品选择是否正确

2. 配置文件检查

   • 检查JSON文件格式是否正确
   • 确认文件大小是否符合限制
   • 验证字段名称与平台要求一致

3. 重新上传尝试

   • 删除已上传的配置文件
   • 清除浏览器缓存后重新登录
   • 重新选择文件进行上传

4. 逐步验证

   • 简化配置，先上传基础版本
   • 逐步添加配置项，定位问题
   • 保存不同版本的配置文件

常见问题：

• JSON格式错误：缺少逗号、括号不匹配等
• 字段名称错误：与平台要求不符
• 文件编码问题：建议使用UTF-8编码
• 版本兼容性：确认固件版本支持

注意事项：

• 建议使用文本编辑器验证JSON格式
• 保留配置文件的备份副本
• 如问题持续，可尝试简化配置测试

平台SDK版本与声学模型的兼容性？¶

问题描述：

在使用平台SDK 2.2.6版本时，尝试替换为1088模型但无法使用，询问是否可以升级SDK以支持该模型。

解决方案：

版本兼容性说明：

• 平台SDK 2.2.6版本有其对应的声学模型支持范围
• 1088模型通常需要更高版本的SDK支持
• 不同版本的SDK和模型需要严格匹配

当前限制：

1. 模型版本锁定

   • 每个SDK版本对应特定的模型版本
   • 不能跨版本使用声学模型
   • 模型文件名中通常包含版本信息

2. 平台提示机制

   • 平台会明确标注支持的SDK版本
   • 如"仅支持算法sdkv2.2.6"提示
   • 强制使用不兼容的模型会导致生成失败

解决方案：

1. 使用兼容的模型

   • 选择当前SDK版本支持的模型
   • 查看模型列表中的版本要求
   • 优先使用带"V01088"标识的模型

2. 等待平台更新

   • 关注平台版本更新通知
   • 新版本通常会支持更多模型
   • 可向技术团队反馈需求

3. 联系技术团队

   • 询问特定模型的SDK版本要求
   • 申请测试新版SDK的权限
   • 获取模型兼容性对照表

注意事项：

• SDK和模型版本必须严格对应
• 使用不匹配的模型可能导致功能异常
• 建议保存常用的SDK-模型组合配置

如何生成日语固件并选择合适的模型？¶

问题描述：

需要生成支持日语的固件，但不确定应选择哪个模型版本，以及如何正确配置。

解决方案：

1. 模型选择建议

• 选用Pro模型生成日语固件
• 推荐选择："日文通用Pro5(占1.3M空间)-V01149-v2"
• 老版本模型很多词条不存在，建议使用最新Pro版本

2. 配置步骤

• 登录智能公元平台
• 在"应用场景"下拉菜单中选择日语Pro模型
• 配置其他参数（麦克风、产品特性等）
• 生成并下载固件

3. 注意事项

• 日语识别模型占用约1.3M空间
• 确保目标模块有足够的Flash容量
• Pro模型相比普通模型支持更多词汇

重复触发和立即重复触发有什么区别？¶

问题描述：

需要了解重复触发和立即重复触发两种机制的区别，以及它们在事件序列中的表现。

解决方案：

1. 计时起点差异

• 重复触发：计时起点不触发事件
• 立即重复触发：从计时起点就开始执行事件触发

2. 事件序列表示

将触发事件记为1，不触发事件记为0：

• 重复触发：01010101……
• 立即重复触发：10101010……

3. 应用场景

• 重复触发：适用于需要间隔触发的场景
• 立即重复触发：适用于需要立即开始的周期性触发

注意事项：

• 两种模式的触发时机不同，根据实际需求选择
• 立即重复触发会比重复触发多一次初始触发
• 配置时注意触发周期和间隔的设置

获取系统时间功能的开发进度如何？¶

问题描述：

需要了解获取系统时间功能是否已经完成开发并可以使用。

解决方案：

获取系统时间功能已经上线，可以正常使用。

注意事项：

• 功能已通过测试验证
• 如需使用该功能，请参考相关API文档或示例代码

如何获取音量值并判断音量是否达到最大或最小值？¶

问题描述：

需要获取当前音量值，以便在程序中判断音量是否已达到最大或最小值，从而避免无效的音量调节操作。

解决方案：

音量范围说明：

• 音量最大值：100
• 音量最小值：0
• 无法直接获取准确的当前音量数值

判断方法：

虽然无法直接获取当前音量值，但可以通过以下方式判断是否达到极值：

1. 状态记录法：

   • 在程序中维护一个音量变量
   • 每次调节音量后更新该变量
   • 根据变量值判断是否达到极值

2. 边界测试法：

   • 尝试执行音量增加操作
   • 如果音量没有变化，说明可能已达到最大值
   • 尝试执行音量减少操作
   • 如果音量没有变化，说明可能已达到最小值

注意事项：

• 音量范围固定为 0-100
• 建议在应用层实现音量状态的记录和管理
• 可以通过视觉或声音反馈提示用户当前音量状态
• 避免频繁的无效音量调节操作

音量控制的步进值是多少？¶

问题描述：

在配置音量增减控制时，需要了解每次调节的步进值，以便准确控制音量变化。

技术参数：

默认配置：

• 音量档位：5档
• 默认步进值：20

步进值说明：

• 每次执行"增加音量"或"减少音量"操作时，音量值变化20

• 从最小值(0)到最大值(100)共分为5档：

  • 0%（静音）
  • 20%
  • 40%
  • 60%
  • 80%
  • 100%（最大音量）

配置位置：

• 在平台的系统动作配置中可以找到音量控制相关设置
• 通过"优化选项"可以调整音量的档位配置
• 支持配置SOUND_UP（增加音量）和SOUND_DOWN（减少音量）动作

注意事项：

• 步进值可通过平台优化选项进行自定义配置
• 建议根据实际应用场景选择合适的步进值
• 过小的步进值可能导致调节次数过多
• 过大的步进值可能导致音量变化过于明显

固件生成失败怎么办？¶

问题描述：

在智能公元平台生成固件时，虽然配置检查通过，但固件生成仍失败，需要排查原因并解决。

解决方案：

常见原因：命令词配置中包含多余空格

• 命令词配置中不应包含空格字符
• 特别是在多个命令词组合时，容易误输入空格
• 空格会导致生成引擎解析错误

解决步骤：

1. 导出配置文件检查：

   • 在产品管理页面点击"导出"
   • 下载JSON配置文件
   • 仔细检查命令词配置

2. 定位问题位置：

   • 查看命令词列表
   • 特别注意使用"|"分隔的多个命令词
   • 找出包含空格的命令词组合

3. 修正配置错误：

   • 删除命令词中的所有空格
   • 例如：将"ECO|eco mode"改为"ECO|ecomode"
   • 确保没有多余的空格字符

问题示例：

导出JSON文件方法：

1. 进入"产品管理"→"所有产品"
2. 找到对应项目，点击"导出"
3. 下载JSON配置文件
4. 使用文本编辑器检查命令词配置

验证方法：

• 修正配置后重新生成固件
• 确认生成成功
• 下载并测试固件功能

注意事项：

• 命令词配置严格禁止使用空格
• 使用"|"连接多个相似命令词时不要加空格
• 生成前务必进行配置检查
• 如问题持续，检查JSON文件中是否还有隐藏字符

固件生成失败的常见配置错误有哪些？¶

问题描述：

固件生成失败，可能由配置错误或网络问题导致，需要排查具体原因并提供解决方案。

解决方案：

1. 检查空配置项

• 确认触发记录中没有空的触发条件
• 检查控制记录中没有空的控制动作
• 验证变量名定义符合规范要求

2. 串口参数检查

• 确保未使用空的串口参数或变量
• 检查串口发送的信息内容已填写
• 验证数据格式符合十六进制要求

3. 变量名规范

• 变量名不能包含特殊字符
• 避免使用系统保留字作为变量名
• 确保变量引用格式正确

4. 网络和环境因素

• 检查网络连接是否稳定
• 尝试在网络使用较少的时段生成
• 清理浏览器缓存后重试

5. 错误代码 500（服务器内部错误）

• 现象：提示 "Request failed with status code 500" 和 "固件生成失败"
• 常见原因：
• 配置检测未通过（即使平台检查通过）
• 工程名称或文本包含特殊字符
• 上传的播报文件包含特殊符号
• 网络不稳定导致控制信息未保存成功
• 解决方法：
• 根据平台智能客服的提示检查配置
• 删除空格后重新生成
• 去掉播报文件中的特殊符号
• 重新配置网络后再尝试

6. 过期清理状态恢复生成失败

当固件状态显示"过期清理，可恢复生成"时，点击"重新生成"可能失败。

• 现象：固件状态显示"过期清理，可恢复生成"，点击"重新生成"后提示 "Request failed with status code 500" 和 "固件生成失败"
• 原因：过期固件的源文件已被服务器清理，直接重新生成无法找到原始编译文件
• 解决方法：
• 使用"继承"功能创建新版本：点击该版本操作列中的"继承"按钮
• 系统会自动创建包含原配置的新版本
• 在新版本中点击"生成固件"完成编译
• 生成成功后下载新固件使用

注意事项：

• 生成失败时先检查配置完整性
• 网络问题通常在非高峰时段会自动恢复
• 配置检查通过不代表所有细节都正确
• 建议导出配置文件进行仔细检查
• 过期固件优先使用"继承"而非"重新生成"

授权点数如何分配到指定账号？¶

问题描述：

需要将授权点数分配到指定的账号，并确认登录用户数量的分配方案。

解决方案：

分配流程：

1. 联系技术团队或客服进行授权分配
2. 提供目标账号信息（如："智控物联"）
3. 指定授权数量范围（如：1001-10000个登录用户）
4. 确认分配完成

分配规则：

• 授权点数可以灵活分配到指定账号
• 不同账号的授权数量独立计算
• 分配后即时生效

注意事项：

• 分配前需确认账号信息准确无误
• 建议根据实际使用需求规划授权数量
• 保留分配记录以便后续管理

平台配置功能是否已经上线？¶

问题描述：

需要了解平台的配置功能是否已经上线并可以使用，以及当前是否可以访问。

解决方案：

上线状态确认：

• 测试平台已经上线
• 正式平台已经上线
• 现在可以正常访问和使用

平台访问：

• 直接访问正式平台地址进行配置
• 所有配置功能已经可用
• 硬件设计保持不变

注意事项：

• 如遇到访问问题，请确认使用正确的平台地址
• 建议使用最新版浏览器以获得最佳体验
• 配置完成后请及时保存

如何在平台中查找已创建的项目？¶

问题描述：

在智能平台创建项目后，下次登录时找不到项目存放位置。

解决方案：

1. 登录智能平台 https://www.smartpi.cn

2. 在左侧导航栏找到"产品管理"菜单

3. 点击"所有产品"选项

4. 在所有产品列表中可以找到之前创建的所有项目

注意事项：

• 项目默认保存在"所有产品"分类中
• 如找不到项目，确认登录的账号是否正确
• 平台首页展示的是推荐作品，不是个人项目

如何核对固件文件中的配置信息？¶

问题描述：

需要确认固件文件中包含的语音指令、开机播报和唤醒词等配置是否正确。

解决方案：

1. 获取配置信息

   • 在平台中导出或查看项目的JSON配置文件
   • 或请求固件提供方提供配置清单

2. 核对要点

   • 检查所有语音指令的行为名称、命令词和回复语
   • 确认开机播报内容是否正确
   • 验证唤醒词设置
   • 检查识别灵敏度等参数设置

3. 配置示例

   • 行为名称：如'shuibenen'对应命令词'打开水泵'
   • 回复语：如'水泵已打开'
   • 开机播报：如'欢迎使用智能水肥一体机，请用你好小正唤醒我'

注意事项：

• 固件文件名通常包含模块型号和芯片信息
• 核对时需要逐项确认配置内容
• 发现问题需要在平台中修改并重新生成固件

固件版本如何更新？¶

问题描述：

现有固件可能为旧版本，需要了解如何获取新版本固件，以及新旧版本固件的差异和升级方法。

解决方案：

版本确认方法：

1. 版本信息查询：

   • 联固件提供方确认当前版本
   • 对比已使用的固件和最新版本
   • 记录版本号和更新日期

2. 版本差异了解：

   • 询问新版本的功能改进
   • 确认新版本是否兼容现有项目
   • 了解是否需要修改配置

升级流程：

1. 样品测试（推荐）：

   • 先申请少量新版本样品
   • 在实际应用中测试功能
   • 确认无问题后再批量使用

2. 直接升级：

   • 确认新版本兼容性后
   • 可直接用于新模块
   • 旧版本固件将不再使用

注意事项：

• 升级前建议先进行样品测试
• 确认新版本固件与项目需求匹配
• 保留旧版本配置作为备份
• 如有问题可联系技术人员协助

语音指令配置中"行为"字段应填写什么？¶

问题描述：

在语音指令配置界面中，不确定"行为"字段应该填写什么内容，以及不填写是否会影响功能。

解决方案：

字段说明：

• "行为"字段用于填写英文标识符
• 可填入具有标识度的英文单词
• 便于代码调试和功能识别
• 非必填项但有建议填写

填写建议：

• 使用驼峰命名法：TurnOn、TurnOff
• 或使用下划线：Turn_On、Turn_Off
• 保持命名一致性
• 使用有意义的英文单词

示例：

命令词：开机     → 行为：TurnOn
命令词：关机     → 行为：TurnOff
命令词：增大音量 → 行为：VolumeUp
命令词：减小音量 → 行为：VolumeDown

不填写的影响：

• 平台检测配置时会报错
• 可能导致固件生成失败
• 不影响基本的识别和控制功能
• 但不利于代码维护

注意事项：

• 该字段主要用于开发调试
• 最终控制功能依赖于引脚配置
• 建议养成填写习惯
• 避免使用中文或特殊字符

个性化音频文件大小限制是多少？¶

问题描述：

在上传个性化音频文件时，系统提示音频文件不能大于500kb，但模块Flash容量为2M，询问文件大小限制。

解决方案：

1. 文件大小限制说明

   • 平台前端限制：单个音频文件不能超过500KB
   • 此限制为平台上传机制的技术限制
   • 与模块Flash容量无关

2. Flash空间分配

   • 2M Flash需要存储的内容包括：

     • 固件程序代码
     • 语音识别模型
     • 语音录音文件
     • 个性化音频文件
       • 可用于个性化音频的空间通常不足2M

3. 压缩建议

   • 使用音频压缩软件减小文件体积
   • 推荐压缩到500KB以内
   • 保持采样率8kHz-16kHz，单声道
   • 使用MP3格式，比特率32-64kbps

注意事项：

• 即使Flash容量为2M，实际可用空间会被固件占用
• 平台上传时会自动压缩，但仍建议先手动压缩
• 如果音频过大，可考虑分段录制或降低音质
• 建议总音频不超过500KB：多个音频文件的总大小建议控制在500KB以内，以确保存储空间充足

如何配置基于哭声/鼾声检测的定时器控制逻辑？¶

问题描述：

需要配置基于哭声/鼾声检测的定时器控制逻辑，实现异常告警后启动30秒定时器，若在30秒内通过声控取消告警则定时器清零，超过30秒未取消则触发声光电警报。

解决方案：

实现方案：

1. 添加变量控制

   • 在异常告警触发后，添加一个变量改变动作
   • 该变量用于标识定时器状态
   • 变量可作为定时器控制的开关

2. 配置定时器逻辑

   • 异常告警触发 → 启动30秒定时器
   • 声控取消告警 → 改变变量状态，清零定时器
   • 定时器超时（30秒）且变量未改变 → 触发声光电警报

3. 具体配置步骤

   • 在异常告警行为后添加"设置变量"动作
   • 在声控取消行为中添加"改变同一变量"动作
   • 使用定时器功能监控该变量状态

注意事项：

• 需要合理设置定时器时长（30秒）
• 确保声控取消能正确改变变量状态
• 定时器超时后要检查变量状态再决定是否触发警报
• 建议增加手动复位功能以防异常情况

如何添加多语言命令词支持？¶

问题描述：

需要将中文命令词翻译成其他语言（如越南语、英语），以支持多语言应用场景。

解决方案：

翻译流程：

• 准备需要翻译的命令词列表
• 将中文命令词翻译为目标语言
• 确认翻译协议与原有协议一致
• 在平台中配置多语言命令词

常用命令词类型：

• 窗帘控制：打开/关闭窗帘、纱帘
• 房间标识：客厅、卧室、客房、老人房等
• 功能设置：增大音量、减小音量、设置窗帘类型

命令词完整性要求：

• 确保所有功能都有对应的命令词
• 包含音量调节等基础控制功能
• 考虑常用的所有操作场景
• 初期版本可先覆盖核心功能，后续逐步完善

多语言翻译流程：

1. 准备阶段：

   • 整理完整的中文命令词列表
   • 按功能模块分类（控制类、设置类、状态类等）
   • 确认无遗漏的功能点

2. 翻译阶段：

   • 将中文命令词翻译为目标语言
   • 确保翻译符合当地语言习惯
   • 注意命令词的简洁性和易识别性

3. 验证阶段：

   • 在目标语言环境下测试识别效果
   • 调整发音不准确的词条
   • 优化识别率较低的命令词

注意事项：

• 确保翻译准确性和本地化适配
• 不同语言的命令词发音特点可能影响识别率
• 建议在目标语言环境下充分测试
• 协议保持一致性可避免兼容性问题
• 命令词库需要持续更新和完善

平台维护通知¶

CI系列平台维护期间无法生成固件怎么办？¶

问题描述：

CI系列平台进行服务器维护时，固件生成功能暂时无法使用，影响正常固件生成操作。

解决方案：

• 关注平台官方发布的维护通知
• 维护期间请耐心等待，避免重复尝试
• 维护完成后（通常1-2天）功能将恢复正常
• 如急需生成固件，可联系客服或技术团队协助
• SU系列平台通常不受CI系列维护影响，可作为临时替代方案

注意事项：

• 平台维护是必要的系统升级操作，旨在提升服务质量
• 维护时间通常会提前公告，请留意通知
• 维护期间其他功能可能也会受到影响

SDK生成服务编译时间过长怎么办？¶

问题描述：

使用SDK生成服务时，编译时间过长（如需要180分钟），影响开发效率。

解决方案：

• SDK生成服务采用队列机制，当同时有大量使用方生成固件时需要排队等待
• 编译时间会根据队列长度动态调整，从显示的180分钟逐渐减少到118分钟是正常现象

• 如遇长时间排队，建议：

  • 避开高峰期（工作日白天）进行生成
  • 耐心等待，不要重复提交以免增加队列负担
  • 可考虑在夜间或非工作时间提交生成任务

注意事项：

• 编译时间长度反映当前服务器负载情况，并非系统故障
• 后台正在持续优化服务器性能以缩短等待时间

生产SDK时快速版本和优化版本有什么区别？¶

问题描述：

在生产SDK时，快速版本生成时间短，优化版本生成时间长（约3小时），需要了解两者的区别以及量产时应该选择哪个版本。

解决方案：

版本区别：

• 快速版本：主要用于功能测试和验证
• 优化版本：经过进一步润色和优化，识别效率有提升

性能对比：

• 快速版本可以正常使用，功能完整
• 优化版本对识别效率有少许提升
• 两个版本的识别效果可能存在细微差异

选择建议：

• 如果快速版本功能验证已通过，建议继续使用快速版本
• 量产时并非必须使用优化版本
• 优化版本更适合对识别精度要求极高的场景

注意事项：

• 优化版本生成时间较长，需要合理安排生产计划
• 建议先使用快速版本完成所有功能验证
• 两个版本的选择应根据实际产品需求决定

固件生成问题¶

固件生成失败或卡在"固件生成中"怎么办？¶

问题描述：

在平台生成固件时，出现生成失败或点击"重新生成"后卡在"固件生成中，请稍候..."界面，无法完成生成。

解决方案：

问题现象：

• 配置检查通过，但固件生成失败
• 点击重新生成后界面卡住
• 需要刷新页面才能恢复

解决方法：

1. 等待一段时间后重试

   • 建议等待30分钟后再提交生成
   • 避免频繁操作导致系统繁忙

2. 通过"更多"菜单重新生成

   • 进入固件列表界面
   • 点击"更多"选项
   • 选择重新生成固件

3. 检查网络和浏览器

   • 确保网络连接稳定
   • 尝试刷新页面或更换浏览器
   • 清除浏览器缓存后重试

注意事项：

• 固件生成需要一定时间，请耐心等待
• 如果持续失败，可能是系统繁忙，建议错峰使用
• 生成过程中不要关闭或刷新页面

固件生成失败且无法编辑怎么办？¶

问题描述：

在使用固件生成工具时，出现"生成失败，可能是配置原因，请检查配置"的错误，且无法再次编辑配置，提示"当前版本已发布，继承为新版本才能保存修改的内容"。

解决方案：

1. 版本继承操作

• 找到生成失败的固件记录
• 点击"继承"按钮创建新版本
• 在新版本中修改配置并重新生成

2. 配置检查要点

• 逐项检查所有配置参数
• 特别关注可能导致冲突的设置
• 确认没有重复或矛盾的指令

3. 编辑限制说明

• 已发布的版本无法直接修改
• 必须继承为新版本才能编辑
• 这是平台的版本管理机制

注意事项：

• 继承版本会保留原有配置
• 建议在继承后先检查配置再修改
• 生成失败通常是配置逻辑问题，需要仔细排查

固件状态长时间停留在"待生成"怎么办？¶

问题描述：

在固件生成平台中，工程的固件状态长时间显示为"待生成"，即使SDK状态已显示"已生成"，但固件生成过程似乎被中断或卡住。

解决方案：

原因分析：

• 生成中断：在固件生成过程中进入界面查看，导致生成过程被中断
• 状态异常：系统未正确更新固件状态
• 网络波动：网络连接不稳定可能导致生成请求丢失

解决方法：

1. 重新生成固件

   • 在工程列表中找到对应的工程
   • 点击"重新生成"按钮
   • 等待固件生成完成

2. 避免操作中断

   • 提交生成请求后，避免频繁进入工程界面
   • 等待固件生成完成后再进行其他操作
   • 生成期间不要刷新或关闭相关页面

3. 检查网络环境

   • 确保网络连接稳定
   • 避免在网络不稳定时进行固件生成
   • 必要时更换网络环境重试

注意事项：

• 固件生成需要一定时间，请耐心等待完成
• 生成过程中避免进入工程界面查看状态
• 如果问题持续存在，可联系技术团队协助处理

SDK生成排队等待时间过长怎么办？¶

问题描述：

在SDK生成平台提交生成任务后，显示"大约需要3分钟"，但实际等待超过30分钟仍未完成，询问是否需要继续等待。

解决方案：

排队机制说明：

• 生成队列：SDK生成采用排队机制，按提交顺序处理
• 并发限制：服务器同时处理的生成任务数量有限
• 等待原因：当前生成任务较多，需要排队等待

处理建议：

1. 耐心等待

• 正常现象：高峰期等待时间可能超过预期
• 建议等待：一般会在1-2小时内完成
• 不要重复提交：避免重复生成造成资源浪费

2. 检查进度

• 保持页面开启：不要关闭或刷新生成页面
• 查看状态：留意状态栏的进度提示
• 自动完成：生成完成后会自动开始下载

3. 优化时机

• 错峰使用：避开工作日高峰时段

• 推荐时段：

  • 工作日晚上8点后
  • 周末或节假日
  • 凌晨时段

4. 其他方案

• 本地生成：如有离线生成工具，可考虑本地生成
• 联系支持：等待超过 2 小时可联系技术团队
• 分批生成：大型项目可分多次生成不同模块

注意事项：

• SDK生成是服务器密集型操作，需要排队调度
• 生成时间受任务队列长度影响
• 系统维护期间生成服务可能暂停
• 建议合理安排生成时间，提高效率

TTS语音合成¶

CI1302芯片是否支持TTS功能？¶

问题描述：

需要了解CI1302芯片是否支持TTS（文字转语音）功能，以及该功能与语音识别功能是否可以同时使用。

解决方案：

CI1302有专门的TTS版本芯片可供选择。

功能说明：

• TTS版本支持：有提供TTS功能的CI1302芯片版本
• 功能互斥性：TTS版本的芯片不能同时进行语音识别
• 定制需求：如需TTS功能，需要选择专门的TTS版本芯片

注意事项：

• TTS功能与语音识别功能在硬件上互斥，不能同时使用
• 选择芯片时需要明确主要应用场景
• 如需同时具备两种功能，建议考虑使用两颗芯片分别实现

是否有支持TTS语音合成和MP3播放的模块？¶

问题描述：

寻找支持汉字语音合成（TTS）并能播放预存MP3格式语音的模块。

解决方案：

有专门的TTS模块可供选择。

模块功能：

• TTS语音合成：支持汉字转语音
• MP3播放：支持预存MP3格式音频文件播放
• 两种功能集成：一个模块同时支持两种需求

产品动态：

• 机芯智能已推出TTS文本转语音模块新品
• 可通过官方公众号了解TTS产品详细信息
• 支持多种TTS应用场景和定制需求

获取方式：

• 联系客服咨询具体型号
• 获取详细技术资料
• 了解采购流程
• 关注官方公众号获取TTS产品更新

应用场景：

• 语音提示系统
• 报站器设备
• 智能家居控制
• 工业自动化语音播报

注意事项：

• 不同型号功能可能有所差异
• 购买前确认具体需求
• 索取开发资料和样例

语音模块的串口通信协议是否支持自定义配置？¶

问题描述：

在使用语音模块与主控MCU通信时，需要了解串口通信协议是否可以自定义配置，以及是否可以通过平台自动生成代码。

解决方案：

• 语音模块的串口通信协议支持自定义配置
• 官方平台可以自动生成代码，无需二次开发
• 串口协议支持自定义配置，不限于固定模式

注意事项：

• 长词条（如超过10个字符）可能会增加误触发概率，建议简化为短词条
• 不支持单线通信，仅支持标准串口通信方式
• 平台生成的固件不提供源码

唤醒词唤醒语音芯片时能否同时发送串口数据给主控MCU？¶

问题描述：

在使用语音模块时，希望在唤醒词唤醒语音芯片的同时，通过串口发送数据给主控MCU，以实现主控的同步唤醒。同时需要确认唤醒词条是否可以配置串口发送16进制数据，以及是否会与其他命令词冲突。

解决方案：

• 唤醒词唤醒语音芯片的同时可以发送串口数据给主控
• 通过这种方式可以实现主控MCU的同步唤醒
• 唤醒后的语音词条可通过语音芯片发送串口数据给主控MCU实现功能控制

配置方法：

在智能公元平台配置词条的串口发送功能：

1. 选择词条：在词条列表中选择需要配置串口发送的词条（包括唤醒词或命令词）

2. 添加串口发送动作：

3. 在词条的控制详情中点击"添加控制"
4. 操作类型选择"发送UART1_TX"（或对应串口）
5. 参数类型设置为16进制数

6. 输入要发送的16进制数据（如01、AA 55等）

7. 保存配置：保存并发布固件

功能说明：

• 每个词条（包括唤醒词和命令词）都可以独立配置串口发送16进制数据
• 一条命令词可以同时作为唤醒词和串口发送，两者不会冲突
• 语音识别只能识别然后播报，不发送串口数据就没有控制意义
• 可参考B站的串口视频教程了解详细配置步骤

是否支持定制开发中英文自学习声控词汇功能？¶

问题描述：

需要在现有产品基础上定制开发支持中英文的自学习声控词汇功能，了解技术可行性、开发周期和相关费用。

解决方案：

技术可行性：

• 支持定制开发中英文自学习声控词汇功能
• 需要区分两类功能：对应动作的指令词汇和自学习词汇
• 技术上可实现，但需要一定的开发周期

开发周期：

• 中英文混合的自学习声控词汇功能开发较为复杂
• 预计开发周期：一周左右可提供初版
• 具体时间取决于功能复杂度和需求细节

开发服务：

• 需要根据具体需求评估开发费用
• 建议提供详细的功能需求文档和词汇列表
• 可通过官方渠道提交定制开发申请

注意事项：

• 定制开发前建议先明确具体的技术需求和功能规格
• 提供完整的词汇定义文件有助于准确评估开发工作量
• 定制固件与公版固件不兼容，需要综合考虑后续维护

语音模块的低功耗待机机制和词条开发服务如何收费？¶

问题描述：

需要了解语音模块在无语音输入时的低功耗待机机制、语音功能超时退出时间，以及词条生成和固件开发服务的收费方式。

解决方案：

低功耗待机机制：

• 周围环境安静时，语音模块会立即进入待机状态
• 再次使用语音功能需要重新说唤醒词
• 语音功能超时退出时间可自定义（10秒、20秒、60秒等）

词条与固件开发服务：

• 词条由需求方提供，开发团队根据要求制作固件
• 串口协议可由需求方提供，或使用默认协议
• 开发服务可能涉及费用，具体以官方渠道评估为准

注意事项：

• 主控MCU需要根据语音模块的超时时间配置相应的sleep机制
• 建议通过官方平台提交详细需求表以获取评估信息
• 官方平台（smartpi.cn）支持用户自行配置和生成固件

语音模块唤醒后如何通过串口激活主控？平台能否自行配置词条？¶

问题描述：

需要在语音模块唤醒后通过串口通信发送数据激活低功耗主控，并配置30-40条语音词条，但词条内容可能需要后续修改。

解决方案：

串口激活主控：

• 唤醒词识别后可配置串口输出数据
• 通过串口数据可激活处于低功耗状态的主控MCU
• 支持自定义串口协议和数据格式

词条配置方式：

• 官方平台配置：可在智能公元平台（smartpi.cn）自行配置
• 支持灵活修改：后期可随时登录平台修改词条内容
• 即时生成固件：配置完成后可立即生成固件下载

配置流程：

1. 登录官方平台创建产品项目
2. 添加唤醒词和命令词（30-40条）
3. 配置串口输出动作和数据
4. 设置唤醒超时时间
5. 生成并下载固件

注意事项：

• 官方平台提供完整的配置界面，无需开发经验
• 词条修改后需要重新生成并烧录固件
• 建议在平台中保存项目配置便于后续修改

TTS串口工具如何使用？固件生成有限制吗？¶

问题描述：

需要使用TTS串口工具进行语音合成，但网站生成的固件无法输出声音，询问TTS专用固件获取方式和串口协议。

解决方案：

TTS固件获取：

• 平台暂不支持直接生成TTS固件
• 需联系官方客服或技术团队获取专用TTS固件
• 通过客服提供的二维码可直接联系获取

TTS串口工具使用：

• 双击打开TTS串口工具软件
• 选择正确的串口号
• 设置波特率（通常为115200）
• 点击"打开串口"按钮建立连接
• 按协议格式发送TTS指令

注意事项：

• 必须使用专用TTS固件，网站生成的通用固件不支持TTS功能
• TTS串口协议数据包格式需参考官方文档
• 确保使用最新版本的TTS工具
• 正确配置串口参数以保证通信正常

固件运行时出现死机问题如何排查？¶

问题描述：

固件程序在运行过程中出现死机现象，需要排查原因。

解决方案：

电流供电检查：

• 检查电源供电是否稳定
• 确认供电电流是否足够
• 电流不足可能导致设备运行不稳定或死机

日志查看方法：

• 将烧录口设置为默认状态（不用于其他功能）
• 通过串口连接查看设备运行日志
• 分析日志中的异常信息定位问题

简化测试：

• 断开所有外接设备，只保留基本连接（麦克风、喇叭、继电器）
• 逐步添加外设，观察死机现象是否重现
• 确认是否为外设干扰导致的问题

注意事项：

• 供电质量是影响设备稳定性的关键因素
• 查看日志时避免执行消耗资源的操作
• 如问题持续，需联系技术团队提供详细日志

语音合成与播报¶

如何配置多音字播报？¶

问题描述：

需要在智能语音设备中配置多音字播报，实现对特定汉字在不同语境下的不同发音。

解决方案：

多音字配置方法：

使用[=py]标签在回复语中指定多音字的拼音和声调。

配置格式：

• [=拼音声调]：指定汉字的发音
• 声调范围：1-5（对应不同音量）
• 直接写在需要发音的汉字后面

配置示例：

已调[=tiao2]至中[=zhong1]风档

参数说明：

• 声调1：最低音量
• 声调2-4：音量递增
• 声调5：最高音量

使用位置：

• 命令词自定义的回复语中
• 语音播报的任意文本内容
• 支持多个多音字同时配置
• 语音导航的回复语：语音导航功能中的回复语同样支持多音字标注

注意事项：

• 拼音必须准确，声调要符合实际发音
• 不同声调会影响音量，根据需要调整
• 配置后建议测试播报效果

SU系列模块配置¶

如何配置GPIO引脚作为串口通信接口？¶

问题描述：

需要配置GPIO引脚（如B6/B7）作为UART1串口，实现与单片机的通信。

解决方案：

1. GPIO配置方法

   • 在配置平台中找到GPIO引脚配置选项
   • 将GPIO_B6配置为UART1_RX功能
   • 将GPIO_B7配置为UART1_TX功能

2. 串口通信使用

   • 配置完成后，B6/B7引脚将作为串口1使用
   • 可通过这两个引脚与单片机进行串口通信
   • 通信参数需要与单片机端保持一致

注意事项：

• GPIO引脚功能可自行配置
• 配置为串口功能后，原GPIO功能将不可用
• 使用时需注意电平匹配和波特率设置

控制逻辑中的延时恢复功能是如何工作的？¶

问题描述：

在配置控制逻辑时，对延时恢复功能的执行方式存在疑问，不确定在设置的延时期间系统是处于阻塞等待状态还是其他状态。

解决方案：

延时恢复功能的工作原理：

• 当设置延时恢复（如1000ms）后，系统会在延时期间继续正常执行其他任务
• 延时期间不会阻塞整个系统，模块仍然可以响应其他语音指令
• 延时时间到达后，相关变量会自动恢复到默认值

注意事项：

• 延时恢复是非阻塞的，不影响其他功能的正常运行
• 延时时间应根据实际应用需求设置，避免过短导致功能失效
• 多个控制逻辑可以同时设置不同的延时恢复时间

芯片升级后新模块与旧模块的固件兼容性如何？¶

问题描述：

芯片升级后，新模块与旧模块在固件兼容性方面存在差异，需要了解不同组合的兼容性情况。

解决方案：

固件兼容性规则：

• 旧模块 + 旧固件：完全兼容，不受影响
• 新模块 + 旧固件：不支持，必须更新固件
• 新模块 + 新固件：完全兼容
• 旧模块 + 新固件：兼容，可以正常使用

注意事项：

• 旧模块库存使用完毕后不再生产
• 建议尽快更新到新固件版本，以保证长期支持
• 新生成的程序应优先适配新模块，但需要考虑旧模块库存的兼容性

固件生成超时怎么办？¶

问题描述：

在使用平台生成固件时，固件生成过程已超过30分钟仍未完成，导致无法正常生成SDK。

解决方案：

正常生成时间参考：

• 测试固件：1-3分钟
• 正式固件：10-30分钟

超时处理方案：

1. 耐心等待

   • 在平台使用高峰时段，服务器任务较多，可能超过30分钟
   • 只要网络连接正常，最终会完成生成

2. 网络检查

   • 检查网络连接是否稳定
   • 避免在网络不稳定时生成固件
   • 建议选择非高峰时段操作

3. 刷新页面

   • 等待一段时间后刷新页面查看状态
   • 不要重复点击生成，避免多个任务排队

注意事项：

• 固件生成时间受服务器负载影响，存在波动是正常现象
• 建议在网络环境良好的情况下操作
• 如持续超时，可联系技术团队处理
• 生成失败后，系统会返回提醒，这时可以再次提交
• 请不要多次提交，这样会堵塞服务器，导致所有人都更慢

生成超时后的处理方式：

当版本列表显示"生成超时"状态时：

• 继续等待：任务仍在服务器队列中处理，可能即将完成
• 重新生成：点击"继承"按钮，基于当前配置重新生成固件
• 删除重试：删除超时版本后，检查配置并重新提交

生成超时并不代表配置错误，通常是服务器负载过高导致。建议先尝试继续等待，如仍需使用可选择重新生成。

离线语音模块是否支持播报当前时间？¶

问题描述：

需要语音模块能够播报当前时间，实现语音查询时间功能。

解决方案：

功能限制说明：

• 直接不支持：离线语音模块本身无法获取当前时间信息
• 离线特性：作为离线模块，无法联网获取时间

替代实现方案：

1. 外部时间输入

   • 通过串口从外部设备（如单片机、RTC模块）获取时间数据
   • 接收格式化的时间字符串（如："现在时间是14点30分"）

2. 播报流程

   • 外部系统通过串口发送时间数据给语音模块
   • 语音模块接收并播报收到的时间信息

实现步骤：

• 配置语音模块接收串口消息
• 设置串口消息触发播报功能
• 外部系统定时发送或按需发送时间数据

注意事项：

• 需要外部系统提供时间源
• 串口通信需要确保波特率等参数匹配
• 时间格式应提前配置好播报模板

如何获取平台资料和教程视频？¶

问题描述：

需要了解产品开发、烧录和串口通信等操作，希望获取官方平台资料和教程视频。

解决方案：

官方资料获取渠道：

1. 智能公元文档中心

   • 网址：https://help.aimachip.com/

   • 内容包括：

     • 常见问题解答
     • 产品选型表
     • 开发包下载
     • 技术文档

2. B站机芯智能官方频道

   • 网址：https://space.bilibili.com/1903518159

   • 视频内容包括：

     • 平台操作教程
     • 固件烧录演示
     • 串口数据发送示例
     • 实际应用案例

使用建议：

• 优先查看文档中心获取系统性的技术资料
• 结合B站视频教程进行实操学习
• 遇到问题时先查阅FAQ和文档
• 关注官方账号获取最新更新信息

如何配置离线语音模块的开机播报功能？¶

问题描述：

离线语音模块的开机播报功能无法正常工作。

解决方案：

1. 配置开机播报

   • 在配置平台的"其它配置"页面
   • 设置"开机播报"为"有开机播报"
   • 输入自定义播报语句（如："哇偶今天心情不错，有什么想了解的吗"）
   • 设置超时退出时间和退出回复

2. 故障排查

   • 重启电脑可能解决通信问题
   • 检查USB驱动是否正常
   • 确认配置文件已正确下载到模块

注意事项：

• 开机播报语句需要符合TTS合成规则
• 重启电脑可以解决某些临时性通信问题
• 配置完成后需要重新生成并烧录固件

UART1接口通信异常如何处理？¶

问题描述：

使用UART1接口进行串口通信时，出现数据发送和接收无响应的问题。

解决方案：

1. 硬件连接检查

   • 确认UART1的TX和RX引脚正确连接
   • 检查供电电压是否在规定范围内（3.6-5.5V）
   • 确认波特率、数据位、停止位等参数与对端设备一致

2. 平台配置确认

   • 在配置平台中确认GPIO引脚已正确配置为UART功能
   • 检查串口通信参数设置是否正确
   • 确认固件已正确烧录到模块

3. 通信协议调试

   • 使用串口调试工具发送测试数据
   • 检查数据格式是否符合协议要求
   • 确认数据校验位设置正确

注意事项：

• UART1接口功能需要平台支持，部分功能可能暂时不可用
• 确保对端设备的电平与模块匹配
• 建议使用标准波特率（如9600、115200）

如何实现UART1接收特定指令并返回数据？¶

问题描述：

需要通过UART1接口接收读取ID的指令，并返回系统中掉电保存的变量ID值。

解决方案：

1. 协议设计

   • 定义指令格式：[命令头][命令字][校验位]
   • 例如：0x01 0x02 0x03 0x04（0x02为读取ID指令）

2. 实现步骤

   • 配置UART1接收中断
   • 解析接收到的数据，识别读取ID指令
   • 从Flash存储区读取保存的ID值
   • 通过UART1发送返回数据

3. 数据返回格式

   • 返回格式：[命令头][命令字][ID高8位][ID低8位]
   • 确保ID值已在系统掉电前正确保存到Flash

注意事项：

• 需要确保ID值已通过掉电保存功能写入非易失性存储器
• 读取Flash操作时要避免数据损坏
• 返回数据的格式需要与接收端预先约定

如何在平台中调节音量大小？¶

问题描述：

需要了解如何在配置平台中调节设备的语音播报音量。

解决方案：

平台音量配置方法：

1. 找到音量配置选项

   • 在配置平台的固件生成界面
   • 找到音量、语速、亮度等参数设置
   • 音量通常以数值形式表示（如0-100）

2. 调节音量参数

   • 拖动音量滑块或输入数值
   • 默认值通常为50或75
   • 可根据需要调大或调小

3. 应用配置

   • 设置完成后生成固件
   • 烧录到模块后生效
   • 也可通过语音指令实时调节

注意事项：

• 音量数值没有固定标准，根据实际应用场景调节
• 音量过大可能导致失真，过小可能听不清
• 部分模块支持通过语音指令动态调节音量
• 配置界面还包含语速、亮度等其他参数可一并调节

语音模块是否支持接收字符串进行播放？¶

问题描述：

需要了解语音模块是否支持接收外部传入的字符串，并根据字符串内容进行语音播报。

解决方案：

语音模块本身不支持直接接收字符串进行TTS播报。字符串需要转换为数值形式才能被模块识别和处理：

• 字符串内容最终都会转换为数值数据
• 模块通过识别特定的数值来触发预置的语音播报
• 如需动态播报不同内容，建议使用串口通信协议

注意事项：

• 模块主要支持预置的语音词条播报
• 动态字符串播报需要通过上位机或MCU发送相应指令
• 具体的串口通信协议可参考对应模块的开发文档

行为控制详情中播放语音内容不能为空怎么办？¶

问题描述：

配置检查时提示"行为控制详情中播放语音内容不能为空"，导致配置无法通过。

解决方案：

错误原因：

• 添加"播放"行为时，未填写具体的播放内容
• 播放内容字段显示为"???"或空白

解决方法：

1. 填写播放内容

   • 在版本详情配置界面
   • 找到对应的行为（如AA）
   • 在播放内容字段输入具体的播报文本

2. 配置确认

   • 确保播放内容不为空
   • 检查参数设置是否正确
   • 保存后重新进行配置检查

注意事项：

• 播放内容可以是任意文本，但必须填写
• 支持中文、英文、数字等字符
• 播放内容将用于TTS语音合成
• 配置完成后需重新生成固件并烧录

如何设计按键按下时的提示音功能？¶

问题描述：

需要设计按键按下时发出提示音（如嘀嘀声）的功能，并了解新一代产品是否支持通过APP进行配置。

解决方案：

按键提示音实现方法

1. 硬件触发设计

   • 将按键连接到模块的GPIO引脚
   • 配置GPIO为输入模式，检测低电平触发
   • 当检测到按键按下（输入低电平）时，触发播报提示音

2. 平台配置步骤

   • 在配置平台中添加触发行为
   • 触发方式选择"GPIO输入"
   • 选择对应的GPIO引脚
   • 触发电平设置为"低电平"
   • 播报内容设置为提示音（如"嘀"声）

3. 使用个性化音频

   • 可以在平台上传自定义的提示音文件
   • 支持常见的音频格式（如MP3、WAV）
   • 配置为按键触发时播放的音频文件

新一代产品配置支持

• 新一代产品支持在平台上直接配置
• 无需使用APP进行配置，所有功能都在平台完成
• 支持更灵活的音频文件管理和触发逻辑配置

注意事项：

• 按键电路需要做防抖处理，避免多次触发
• GPIO引脚的电平需要与硬件电路匹配
• 提示音文件不宜过长，建议控制在1-2秒内
• 配置完成后需要重新生成并烧录固件

如何通过命令词查询电量并通过串口返回？¶

问题描述：

需要设置命令词触发电量查询功能，让模块播报电量值的同时通过串口返回具体的电量数据。

解决方案：

需要配置两个部分：命令词触发和端口输出：

1. 配置命令词识别

   • 添加命令词如"查询电量"
   • 设置对应的语音回复语

2. 添加电量查询行为

   • 触发方式：选择"串口输入"
   • 消息编号：设置为1（或自定义）
   • 参数：选择U1_Energy（电量参数）
   • 参数类型：unsigned char
   • 操作：播放当前电量百分比

3. 配置串口输出

   • 控制方式：选择"端口输出"
   • 控制类型：UART1_TX
   • 动作：发送
   • 参数格式：十六进制
   • 最大长度：32字节
   • 格式要求：两个字符一组，空格分隔

注意事项：

• 普通的命令词响应只会进行语音回复，不会自动返回数据
• 如需通过串口获取电量数据，需要单独发送串口指令触发
• 电量查询功能需要模块支持电量检测（如U1_Energy参数）
• 串口输出的数据格式需要与接收端约定好

版本选择¶

SDK生成时显示"待生成"状态且未生成文件怎么办？¶

问题描述：

在平台生成SDK时，系统显示"待生成"状态，但长时间等待后实际并未生成SDK文件，导致无法继续后续操作。

解决方案：

问题分析：

• 显示"待生成"状态说明系统未正常完成生成过程
• 这通常不是等待时间问题，而是生成流程出现异常
• 需要重新触发生成操作

处理方法：

1. 重新生成SDK：

   • 在SDK管理界面找到对应条目
   • 点击重新生成或删除后重新创建
   • 确保配置参数正确无误

2. 检查生成状态：

   • 正常生成过程会有进度显示
   • "待生成"状态通常表示生成失败
   • 需要手动重新发起生成请求

3. 优化生成配置：

   • 简化初始配置，先生成基础版本
   • 确认网络连接稳定
   • 避开高峰时段进行生成

注意事项：

• "待生成"状态持续存在表明生成失败，不是等待问题
• 不要长时间等待，应及时重新操作
• 如反复出现此问题，建议联系技术团队

SDK生成固件时显示"正在生成"但未完成怎么办？¶

问题描述：

固件生成平台显示SDK状态为"正在生成"，预计3分钟完成，但长时间等待后无响应，或最终固件状态显示失败。

解决方案：

问题分析：

• SDK生成过程中可能出现服务器异常或网络超时
• "正在生成"状态超过预计时间通常表示生成失败
• 固件状态失败与SDK状态可能不同步更新

处理方法：

1. 刷新页面重试

   • 等待超过预计时间后刷新页面
   • 查看最新状态更新
   • 如仍显示"正在生成"，可尝试重新生成

2. 避开高峰时段

   • 服务器繁忙时生成成功率较低
   • 建议在非高峰时段操作
   • 两小时内能生成成功算运气好

3. 多次尝试策略

   • 删除当前生成任务
   • 重新创建固件生成
   • 简化配置参数减少生成时间

技术说明：

• 正常生成过程约需3-5分钟
• 超过10分钟未完成视为异常
• SDK和固件状态可能异步更新

注意事项：

• 不要长时间等待"正在生成"状态
• 多次刷新无效时应重新操作
• 如持续失败，联系技术团队协助
• 保留好配置参数便于重试

SDK生成完成后在哪里下载？¶

问题描述：

SDK生成完成后收到完成通知，但在平台上找不到下载入口，工单列表中也显示为空，导致无法下载已生成的SDK文件。

解决方案：

1. 在产品详情页下载：

   • 返回到生成SDK的产品详情页面
   • 在第4步"下载固件"右侧找到下拉箭头
   • 点击下拉箭头选择"下载SDK"选项

2. 查找已生成工单：

   • 如果不在生成界面，需要重新进入对应产品页面
   • 使用Ctrl+F搜索功能搜索项目名称
   • 或者通过"我的发布"查看历史记录

3. 刷新和重试：

   • 确保页面已完全刷新
   • 清除浏览器缓存后重新登录
   • 检查网络连接是否正常

注意事项：

• SDK生成完成后必须在生成界面或产品详情页下载
• 工单列表可能有延迟，建议直接在产品页面操作
• 生成成功后系统会保留一段时间，请及时下载

平台发布版本选项在哪里？¶

问题描述：

在平台发布固件时，发现"发布版本"选项消失，询问该功能是否还存在。

解决方案：

版本功能说明

1. 当前版本选项

   • 正式版本：包含SDK和完整功能，用于正式发布
   • 测试版本：仅包含基础功能，用于二次开发
   • 快速测试版本：功能与正式版基本相同

2. 功能一致性

   • 正式版和测试版在功能上基本相同
   • 平台陆续加入了很多新功能
   • 有时没有正式版/测试版可选是正常现象

3. 使用建议

   • 直接勾选"快速测试版本"进行生成
   • 功能完全不受影响，可正常使用
   • 无需担心版本选择问题

注意事项：

• 平台会持续更新功能
• 版本选项可能因功能更新而调整
• 选择可用版本即可，功能不受影响

功能实现¶

US1302芯片是否支持SPI控制？¶

问题描述：

希望了解US1302芯片是否支持通过SPI控制外部设备，以及是否有相关的开发资料或SDK。

解决方案：

SPI支持情况：

• 平台不支持：官方平台未提供SPI控制功能
• 无开发资料：不提供SPI相关的SDK或开发文档
• 技术限制：芯片固件未集成SPI通信协议

替代方案：

1. GPIO控制

   • 使用通用GPIO引脚模拟SPI时序
   • 适合低速、简单通信需求
   • 需要自行编写驱动代码

2. 外部MCU方案

   • 添加单片机作为SPI主控
   • 语音模块通过UART或GPIO控制MCU
   • MCU负责具体的SPI通信实现

3. 模块化设计

   • 将SPI功能独立为单独模块
   • 通过标准接口与语音模块通信
   • 便于功能扩展和维护

注意事项：

• 自行开发SPI功能需要深厚的嵌入式经验
• 不规范的实现可能影响系统稳定性
• 建议优先使用官方支持的功能接口

设备待机时能同时输出信号吗？¶

问题描述：

需要了解设备在待机状态下是否能够同时输出一个控制信号。

解决方案：

待机状态说明：

• 设备待机时仍可保持部分功能
• 可以配置特定GPIO在待机时输出信号
• 需要通过平台配置实现

实现方法：

1. 配置GPIO输出

   • 在平台选择目标GPIO引脚
   • 设置为输出模式
   • 配置默认输出状态

2. 待机行为设置

   • 在控制逻辑中添加待机状态检测
   • 设置对应的GPIO输出动作
   • 确保信号持续输出

注意事项：

• 待机时部分功能可能受限
• 输出信号会增加功耗
• 建议选择低功耗输出方案

如何配置音量增减控制功能？¶

问题描述：

需要在语音模块中配置音量增加和减少的控制功能。

解决方案：

配置步骤：

1. 添加控制项

   • 在控制配置中选择目标引脚
   • 设置控制方式为"系统控制"

2. 选择操作类型

   • 类别：播放控制
   • 操作：增加音量/减少音量
   • 根据需要配置相应功能

控制配置界面：选择系统控制→播放控制→减少音量

1. 设置触发方式
   • 根据实际需求选择触发方式
   • 可以是GPIO输入、串口命令等
   • 只要能触发对应控制即可

应用示例：

• 物理按键控制音量
• 串口指令调节音量
• 自动音量调节逻辑
• 多级音量控制

注意事项：

• 音量调节范围有限制
• 建议设置合理的调节步长
• 保存配置前测试效果

语音指令回复语无法正常播放怎么办？¶

问题描述：

配置语音指令时，发现部分命令的回复语无法正常播放，特别是当回复语包含特殊格式或与其他控制动作混合时。

解决方案：

1. 检查回复语格式

• 避免在回复语中包含控制字符或特殊符号
• 回复语内容应简洁明了
• 不建议将控制指令与回复语混合编写

配置界面显示部分命令的回复语为空

2. 分离控制与播报功能

• 将串口发送和语音播报分开配置
• 使用"控制详情"添加串口发送动作
• 回复语仅用于语音播报

TurnOn和TurnOff指令的UART1_TX发送设置

3. 优化配置方法

• 命令词：设置识别的语音内容
• 触发方式：根据需要选择（如串口输入）
• 回复语：单独设置播报内容
• 控制详情：添加串口输出等控制动作

注意事项：

• 回复语过长可能导致播放不完整
• 特殊字符可能影响语音合成
• 建议先测试简单回复语确认功能正常
• 复杂控制逻辑建议分步实现

烧录器是否支持Python代码导入？¶

问题描述：

询问烧录器是否支持导入Python代码进行加减乘除等计算功能。

解决方案：

烧录器不支持导入Python代码：

• 功能限制：烧录器仅用于固件烧录，不支持代码编程
• 固件格式：只支持.bin格式的固件文件
• 开发方式：需要在智能公元平台上配置功能后生成固件

实现计算功能的方法：

1. 使用平台配置

   • 在智能公元平台配置控制逻辑
   • 利用平台的计算功能模块
   • 生成对应功能的固件

2. 二次开发方案

   • 下载SDK源代码（C语言）
   • 在源代码中添加计算逻辑
   • 重新编译生成固件

注意事项：

• 烧录器是纯固件烧录工具，无编程功能
• Python等高级语言需要通过特定开发环境实现
• 简单功能建议直接使用平台配置实现

串口数据发送有长度限制吗？¶

问题描述：

需要了解串口通信是否支持发送超过32字节的数据，如发送7-8个字节或更长的数据。

解决方案：

1. 数据长度说明

• 串口通信本身没有严格的长度限制
• 可发送超过32字节的数据
• 实际支持长度取决于接收端处理能力

2. 模块限制

• 单个串口消息可包含多个字节
• 建议单次发送不超过128字节
• 超长数据可分包发送

3. 实现方式

• 通过配置平台设置串口输出功能
• 可配置命令词触发串口输出
• 支持自定义数据格式和长度

注意事项：

• 虽然界面提示最大32字节，但实际可发送更长数据
• 接收端需做好数据解析和缓冲
• 建议根据实际需求设置合适的数据长度

如何优化模块执行顺序，先执行命令再回复语音？¶

问题描述：

需要配置模块使其在接收到语音指令后，先执行控制命令（如开灯），再播放语音回复，以减少延迟感。

解决方案：

1. 调整控制执行顺序

• 在控制详情列表中调整执行顺序
• 将GPIO控制等操作放在语音播报之前
• 系统按从上到下的顺序执行

2. 配置方法

• 删除原有的语音播报控制
• 重新添加，调整先后顺序
• 确保动作执行在前，播报在后

3. 测试验证

• 去除播报功能测试执行速度
• 确认控制命令已正常执行
• 逐步添加语音播报功能

注意事项：

• 执行顺序对使用方体验影响明显
• 某些操作可能需要等待完成后再播报
• 建议根据实际需求调整执行逻辑

回复语与GPIO输出脉冲的时序关系是怎样的？¶

问题描述：

配置了语音指令的回复语，同时配置了GPIO引脚输出高电平脉冲，想了解两者的执行时序：是等回复语播完后才触发GPIO，还是同时触发？

时序说明：

默认执行逻辑：

• 回复语（语音播报）和GPIO输出脉冲是同时触发的
• 两者不会相互等待，执行顺序由配置列表中的排列顺序决定
• 实际执行中，语音播报需要时间（取决于音频长度），而GPIO脉冲是瞬时的电平变化

配置控制方法：

1. 调整执行顺序
2. 在控制详情列表中，将GPIO输出和语音播报按需要的顺序排列

3. 系统按从上到下的顺序执行各个动作

4. 添加延时控制

5. 如果需要GPIO在语音播报后触发，可以在两者之间添加延时节点
6. 或在GPIO输出前设置条件判断

应用场景示例：

• 同时触发：语音提示"开始工作"的同时输出GPIO脉冲控制设备启动
• 先后触发：语音播报完成后，GPIO输出脉冲触发后续设备动作

注意事项：

• GPIO脉冲持续时间通常很短（几十到几百毫秒），远短于语音播报时间
• 如果时序要求严格，建议通过配置延时或条件判断来精确控制
• 不同固件版本的执行逻辑可能略有差异，建议实际测试验证

如何更新固定发送变量内容的功能？¶

问题描述：

希望更新固定发送变量内容的功能，以避免在多个模块中频繁修改模块序号，提高开发效率。

解决方案：

功能现状：

• 固定发送变量内容功能正在开发中
• 当前版本暂不支持此功能
• 需要为每个模块单独修改配置

临时解决方案：

1. 批量配置方法：

   • 使用文本编辑工具批量修改固件配置
   • 搜索并替换所有模块序号
   • 重新生成固件进行烧录

2. 配置模板化：

   • 创建标准配置模板
   • 预留模块序号为变量位置
   • 根据不同模块快速替换序号

3. 脚本辅助：

   • 编写脚本自动处理配置文件
   • 使用程序批量更新模块序号
   • 减少手动操作错误

开发计划：

1. 功能开发进度：

   • 该功能已列入开发计划
   • 具体发布时间待官方通知
   • 关注平台更新公告

2. 替代方案考虑：

   • 考虑使用带存储功能的模块
   • 通过外部存储设备保存配置
   • 实现配置的快速切换

操作建议：

• 做好配置修改记录，便于追溯
• 建立模块序号管理表，避免混乱
• 联系技术团队了解最新开发进展

注意事项：

• 固定变量功能是平台级改进
• 更新后所有项目将受益
• 建议收集使用反馈，便于功能优化

如何配置A26引脚电平变化控制A27引脚输出？¶

问题描述：

需要实现A26引脚电平变化来控制A27引脚输出的功能，但配置中缺少必要的命令词触发条件，导致功能无法正常工作。

解决方案：

实现A26控制A27的输出需要满足以下配置要求：

1. 必须添加命令词触发

• 平台要求所有GPIO控制逻辑必须基于命令词触发
• 不能直接配置GPIO间的直接联动
• 需要设置一个命令词作为主触发条件

2. 正确的配置步骤

步骤1：添加命令词 - 在"命令词自定义"中添加一个命令词（如"我是村口王大爷"） - 设置触发方式为"命令词"

步骤2：配置A26输入 - 添加新的行为配置 - 行为设置为"A26" - 触发方式选择"GPIO输入"

步骤3：配置A27输出 - 添加第三个行为配置 - 行为设置为"A27" - 触发方式选择"GPIO输入" - 在A27后添加附加条件，设置变量A等于数值1时触发

步骤4：定义变量 - 在"变量定义"中创建变量A - 类型设置为int - 默认值设为1

3. 逻辑实现原理

当A26引脚电平变化时：

• A26的GPIO输入触发被检测
• 系统检查命令词条件（需要语音触发或设置为难以触发的词）
• 满足条件后执行A27的输出动作
• 变量A作为中间条件，确保逻辑正确执行

注意事项：

• 必须要有命令词作为支撑，即使设置为难以触发的命令词
• 变量配对必须正确，A26变量需要与具体变量关联
• 建议将主命令词设置为难以误触发的内容
• 配置完成后需要检查配置，确保没有逻辑错误

自定义命令的行为命名规则是什么？¶

问题描述：

在配置自定义语音指令时，不清楚行为列（如open1、open2、close、TurnOn等）的命名规则和使用规范。

解决方案：

行为命名需要遵循C语言语法规则：

1. 命名规则

• 只能包含字母、数字和下划线
• 不能包含空格或特殊字符
• 区分大小写
• 行为名不能重复

2. 常见命名方式

• open1、open2、open3：用于多个开启动作
• close、close1、close2：用于关闭动作
• TurnOn、TurnOff：驼峰命名法
• A_05、B_10：带前缀的编号方式

3. 选择建议

• 根据实际功能选择有意义的名称
• 保持命名风格统一
• 建议使用英文命名

注意事项：

• 行为名是程序内部标识，与命令词展示名称无关
• 一旦定义，在同一个固件中不能修改
• 建议先规划好所有行为，再进行配置

如何在出厂固件的基础上进行修改？¶

问题描述：

需要在现有的出厂固件基础上进行功能修改，而不需要从零开始配置。

解决方案：

1. 导入出厂固件

• 进入智能公元配置平台
• 找到导入功能选项
• 选择出厂固件包中的json文件并导入

2. 继承修改

• 导入成功后，固件配置会在平台中打开
• 根据需求修改相应的配置项
• 可以添加、删除或修改命令词
• 可以调整GPIO配置和其他参数

3. 生成新固件

• 修改完成后点击生成固件
• 等待平台编译完成
• 下载生成的固件文件

注意事项：

• 导入的是固件包中的json配置文件，不是bin固件文件
• 修改前建议备份原始配置
• 继承修改可以保留原有的有效配置
• 某些特殊配置可能需要重新设置

平台命令词自定义功能无法添加新命令怎么办？¶

问题描述：

在平台的命令词自定义功能中，点击"添加一条"按钮无反应，无法添加新的命令词。

解决方案：

1. 网络问题排查

• 检查网络连接是否稳定
• 尝试刷新页面或更换浏览器
• 避免在网络高峰期操作

2. 操作步骤检查

• 确认已选择正确的触发类型（命令词）
• 下拉菜单展开后要选择具体的命令词选项
• 不要只展开下拉框而不选择

3. 重新创建项目

• 保存当前配置
• 重新创建一个新的固件项目
• 在新项目中尝试添加命令词

4. 浏览器兼容性

• 推荐使用Chrome或Edge浏览器
• 清除浏览器缓存和Cookie
• 禁用不必要的浏览器插件

注意事项：

• 平台功能偶尔会因网络波动异常
• 多次尝试无效时可联系技术团队
• 建议在操作前先测试网络稳定性

SDK生成超时是什么原因？¶

问题描述：

在使用平台生成SDK时，连续出现生成超时，询问具体原因和解决方法。

解决方案：

1. 超时原因分析

• SU系列模块使用人数多，服务器负载高
• 生成队列拥堵，需要排队等待
• 网络波动也可能导致生成中断

2. 解决措施

• 避开高峰期：选择人少的时间段操作
• 多次尝试：删除任务后重新生成
• 简化配置：减少功能项降低生成时间
• 继续等待：有时只是显示延迟，实际在生成

3. 预防建议

• 生成前确保网络稳定
• 不要频繁刷新页面
• 保留配置参数便于重试

注意事项：

• 超时是普遍现象，非个例问题
• 生成成功率与服务器负载直接相关
• 建议提前生成，预留充足时间

如何解决引脚控制逻辑配置中的变量设置为空错误？¶

问题描述：

配置引脚控制逻辑时，系统提示变量设置为空的错误，导致固件无法生成。即使配置检查通过，仍然出现"A26和A27的变量设置为空"的错误。

解决方案：

1. 检查变量配对

在变量定义界面中，必须确保每个GPIO都正确配对变量：

• A26引脚需要关联到具体变量（如变量A）
• A27引脚也需要关联到变量
• 变量不能留空，必须选择已定义的变量

2. 正确的变量配置方法

步骤1：定义变量 - 在"变量定义"中创建所需变量 - 变量名：A（或自定义名称） - 类型：int - 默认值：1

步骤2：配置A26引脚 - 进入控制详情页面 - 选择A26的GPIO输入配置 - 在变量设置中选择刚定义的变量A - 当A26为高电平时，变量A变为0

步骤3：配置A27引脚 - 选择A27的输出配置 - 设置触发条件：当变量A等于1时输出高电平 - 确保条件判断使用正确的变量

3. 逻辑验证

正确的逻辑应该是：

• A26高电平 → 变量A = 0
• 变量A = 1 → A27输出高电平

注意这里的逻辑关系，确保变量值的变化符合预期。

注意事项：

• 所有GPIO配置必须关联到具体变量，不能留空
• 变量的赋值和条件判断要逻辑一致
• 配置完成后使用"配置检查"功能验证
• 如果仍有错误，检查是否有中文字符导致的问题

平台固件生成卡在"正在生成"状态怎么办？¶

问题描述：

平台在生成固件时出现卡顿，长时间无法完成生成，刷新页面后问题依旧存在，状态显示为"SDK正在生成"。

解决方案：

1. 立即尝试的解决方法

• 刷新浏览器页面
• 清除浏览器缓存后重试
• 退出登录重新进入平台
• 尝试使用不同的浏览器

2. 检查配置问题

• 确认配置中没有逻辑错误
• 检查变量定义是否正确
• 验证命令词配置是否完整
• 使用"配置检查"功能验证

3. 继承版本重新生成

如果基础配置正确：

• 进入"发布版本"页面
• 选择"继承"已有版本
• 修改必要的配置项
• 重新生成固件

4. 可能的原因分析

• 服务器负载高：平台服务器繁忙导致处理缓慢
• 配置复杂：配置项过多或逻辑复杂
• 网络问题：网络不稳定导致通信中断
• 浏览器兼容性：某些浏览器可能有兼容问题

5. 长时间等待的处理

如果等待超过30分钟仍未完成：

• 保存当前配置
• 联系技术团队
• 尝试简化配置后重新生成
• 在非高峰时段尝试生成

注意事项：

• 固件生成通常需要1-3分钟
• 避免在配置中包含特殊字符
• 大量命令词会延长生成时间
• 建议在非业务高峰期进行固件生成

如何通过语音指令向MCU发送变量值？¶

问题描述：

希望实现通过语音指令向MCU发送变量值（如温度设定），而不是通过添加大量命令词来实现温度设定功能。

解决方案：

1. 当前平台的限制

• 平台不支持直接通过语音识别数值并发送变量
• 数字识别误识别率较高，需要大量调试
• 目前需要为每个数值设置独立的命令词

2. 实现温度控制的方法

方案一：多命令词方式（推荐） - 添加"温度5度"、"温度10度"等命令 - 每个命令词对应具体的温度值 - 适合5-80度范围，但命令词数量较多

方案二：串口通信方式 - 通过语音指令触发串口输出 - MCU接收串口数据后解析温度值 - 可以实现更灵活的数值传递

3. 优化建议

减少命令词数量的方法：

• 使用常用温度点（如5的倍数）
• 分档位控制（低、中、高）
• 结合加减调节（"温度加5度"、"温度减5度"）

4. 替代方案

如果需要精确数值控制：

• 使用二次开发SDK
• 在代码中实现语音数字识别
• 通过串口发送具体的数值给MCU

注意事项：

• 数字语音识别的准确率相对较低
• 大量命令词会增加固件大小
• 建议使用分档控制而非精确数值
• 可以结合上下文减少命令词数量

如何调整命令词的序号顺序？¶

问题描述：

希望在自定义命令词时，能够自由调整命令词的序号顺序，并在多个行为之间插入新行为，以方便查看和编辑。

解决方案：

1. 使用拖拽功能调整顺序

平台支持通过拖拽调整命令词顺序：

• 长按命令词的序号
• 拖动到目标位置
• 松开鼠标完成顺序调整

2. 具体操作步骤

步骤1：进入命令词自定义页面 - 找到需要调整的命令词列表 - 确认所有命令词都在列表中

步骤2：调整顺序 - 鼠标左键按住序号不放 - 向上或向下拖动命令词 - 虚线显示目标位置 - 松开鼠标完成移动

步骤3：插入新命令词 - 在"命令词自定义"中添加新命令词 - 拖拽调整到合适位置 - 保存配置使更改生效

3. 注意事项

• 拖拽时保持鼠标稳定，避免误操作
• 调整后要保存配置
• 复杂的命令词关系调整后需要测试
• 可以多次小幅度调整而非一次性大幅改动

4. 功能优势

• 直观的顺序管理
• 无需删除重新添加
• 支持灵活的位置调整
• 方便命令词的逻辑分组

固件生成失败提示"可能是配置原因"怎么办？¶

问题描述：

平台固件生成失败，提示"生成失败，可能是配置原因，请检查配置"，但配置检查通过，且之前可正常生成。

解决方案：

1. 检查隐藏的配置错误

即使配置检查通过，仍可能存在以下问题：

• 深度降噪配置冲突：开启了深度降噪导致生成失败
• 中文字符问题：配置中包含不允许的中文字符
• 逻辑错误：某些逻辑关系配置错误但未被检查出

2. 排查步骤

方法一：使用默认配置测试

• 新建一个工程，使用默认配置
• 不做任何修改，直接生成固件
• 如果默认配置生成失败，可能是平台正在维护
• 如果默认配置生成成功，说明原配置存在格式或逻辑问题

方法二：逐步检查原配置

步骤1：关闭深度降噪 - 进入基础配置页面 - 关闭"深度降噪"功能 - 重新尝试生成固件

步骤2：检查所有配置项 - 确认命令词没有特殊字符 - 检查GPIO配置是否合理 - 验证变量定义是否正确 - 检查变量修改后的影响：修改变量后，确认串口协议、控制逻辑中没有引用旧的变量名 - 检查行为名修改后的影响：修改行为名后，小程序控件仍会绑定旧行为名，需要重新在小程序中绑定新的行为名

步骤3：简化配置测试 - 先使用最小配置生成 - 逐步添加功能项 - 定位导致失败的具体配置

3. 其他可能原因

• 服务器临时问题：平台服务器故障导致生成失败
• 配额限制：超出每日生成次数限制
• 网络问题：网络不稳定导致通信中断

4. 解决建议

• 尝试继承之前的成功版本
• 删除部分命令词后重新生成
• 联系技术团队获取帮助
• 在非高峰时段重新尝试

注意事项：

• 深度降噪功能可能与某些配置冲突
• 配置检查功能不能发现所有错误
• 保存配置副本便于恢复
• 重大修改前先备份原有配置

如何设置唤醒词超时时间？¶

问题描述：

需要延长唤醒词识别后的有效指令输入窗口时间，从默认的10秒延长至20秒，但发现后台配置界面无法直接修改该时间。

解决方案：

唤醒后的超时时间可以通过"超时退出"功能进行配置：

1. 配置超时时间

   • 在唤醒配置中找到"超时退出"设置
   • 修改"超时时间"参数（建议范围：5-60秒）
   • 设置为20秒可满足需求

2. 功能说明

   • 超时时间是指唤醒后等待指令的时间窗口
   • 如果在设定时间内没有收到指令，系统会发出提示音
   • 可以通过提示音"有需要在叫我"重新唤醒

3. 配置步骤

   • 进入平台配置界面
   • 找到"超时退出"设置区域
   • 将超时时间从10秒修改为20秒
   • 保存配置并重新生成固件

注意事项：

• 超时时间不宜设置过长，建议不超过60秒
• 过长的等待时间可能增加误触发概率
• 不同的应用场景可能需要不同的超时设置
• 常用超时时间：10秒（默认）、15秒、20秒、30秒

退出唤醒后如何通过串口通知单片机？¶

问题描述：

需要在语音模块退出唤醒状态时，自动通过串口发送协议通知单片机，以便主控设备同步状态。

解决方案：

通过配置退出唤醒事件触发串口输出，实现退出唤醒状态通知：

1. 配置串口协议输出

   • 在控制详情中添加"超时退出"或"退出唤醒"触发条件
   • 设置触发方式为：事件触发
   • 添加动作：串口输出（或发送协议消息）
   • 配置协议格式（如：AA 55 01 01 55 AA，01表示退出唤醒）

2. 退出方式说明

   • 自动退出：超时时间到后自动退出唤醒状态
   • 命令词退出：说出特定命令词（如"退下"、"再见"）主动退出
   • 两种退出方式都可以配置串口通知

3. 协议格式设计

   • 建议使用固定格式便于单片机解析
   • 可包含事件类型（唤醒/退出）、状态码等信息
   • 格式示例：[帧头][命令字][数据][校验][帧尾]

注意事项：

• 退出唤醒通知需要在平台配置后重新生成固件
• 单片机端需要实现协议解析逻辑
• 建议测试验证退出唤醒后串口数据发送的时序
• 如使用命令词退出，该命令词也需要配置对应的串口输出动作

如何设置CI系列芯片上电自动唤醒且永不退出？¶

问题描述：

需要配置CI系列芯片上电后自动进入唤醒状态，并且保持唤醒状态不自动退出，以实现即时响应功能。

解决方案：

通过配置控制详情中的启动系统命令和定时器触发来实现上电自动唤醒：

1. 配置启动系统命令

   • 在控制详情中添加命令词：wake_up_ur
   • 设置触发方式为：事件触发
   • 配置动作参数：启动定时器
   • 设置超时时间：30ms
   • 执行模式：单次执行

2. 配置永不退出机制

   • 在唤醒配置中禁用自动超时退出功能
   • 或将超时时间设置为最大值
   • 确保设备保持持续唤醒状态

注意事项：

• 上电自动唤醒适用于需要即时响应的应用场景
• 30ms的延时确保系统完全启动后再触发唤醒
• 配置完成后需要重新生成并烧录固件

固件生成后无法返回页面怎么办？¶

问题描述：

固件生成完成后，点击退出后无法再次返回到固件生成页面，导致无法进行后续操作。

解决方案：

1. 页面刷新方法

• 刷新浏览器页面（F5或Ctrl+R）
• 清除浏览器缓存后重新访问
• 使用无痕/隐私模式重新登录平台

2. 重新进入路径

• 重新登录智能公元平台
• 进入对应的项目配置页面
• 点击"生成固件"重新进入固件生成界面

3. 避免问题发生

• 固件生成完成后不要立即退出页面
• 使用浏览器的新标签页打开其他功能
• 下载固件后再进行其他操作

注意事项：

• 建议使用Chrome、Firefox等主流浏览器
• 避免同时打开过多页面导致浏览器卡顿
• 定期清理浏览器缓存和Cookie

平台固件生成服务中断怎么办？¶

问题描述：

平台固件生成服务出现中断，无法正常生成固件。

解决方案：

• 平台定期维护会导致服务暂时中断
• 维护期间固件生成功能不可用
• 请关注官方通知了解维护时间安排

注意事项：

• 维护完成后服务将自动恢复
• 避免在维护期间重复提交生成任务
• 如超出维护时间仍未恢复，请联系技术团队

固件生成时提示无法生成测试版固件？¶

问题描述：

在使用服务器生成固件时，无法生成测试版固件，等待较长时间仍无法完成。

解决方案：

• 该现象通常出现在使用高峰期时段
• 建议错峰使用平台服务
• 可选择在非高峰时段（如早晨、夜间）进行固件生成

注意事项：

• 高峰期时段服务器负载较高，可能出现生成延迟
• 避免重复提交生成任务，可能导致队列拥堵
• 如持续无法生成，可稍后重试或联系技术团队

定时器工作模式有哪几种？¶

问题描述：

需要了解定时器配置中"单次触发"、"重复触发"和"立即重复触发"三种工作模式的具体含义和区别。

解决方案：

三种工作模式说明：

1. 单次触发

   • 定时器超时后只会触发一次
   • 触发后定时器停止工作
   • 适用于需要一次性执行的任务

2. 重复触发

   • 定时器超时触发后会重新加载定时器
   • 继续下一轮定时，循环往复
   • 适用于需要周期性执行的任务

3. 立即重复触发

   • 直接触发当前定时器超时事件
   • 然后立即重新加载定时器继续工作
   • 适用于需要连续执行且间隔固定的任务

注意事项：

• 根据实际应用场景选择合适的工作模式
• 重复触发模式下需要注意避免任务堆积
• 立即重复触发适合高频率、实时性要求高的场景

定时器工作模式选项界面

多个定时器会相互冲突吗？¶

问题描述：

需要了解多个定时器同时运行时是否会相互影响，以及如何避免定时器之间的冲突。

解决方案：

定时器冲突规则：

1. 不同名称的定时器不会冲突

   • 定时器名称不同，各自独立运行
   • 可以同时创建多个不同名称的定时器
   • 例如：3秒循环定时器和15秒单次定时器可同时存在

2. 同一定时器的重装机制

   • 同一个定时器未触发前，重新启动会覆盖原有设置
   • 每次调用"启动定时器"都会重置计时初值
   • 适用于"检测到命令后重置超时时间"的场景

应用示例：超时播报功能

实现"超过一定时间没检测到命令就播报一段文字"功能：

1. 上电启动定时器

   • 在开机事件中启动定时器
   • 设置超时时长（如30秒）

2. 命令识别后重置

   • 每次识别到命令时，重新启动定时器
   • 这样可以重置计时，避免触发播报

3. 定时器超时处理

   • 定时器超时后执行播报动作
   • 然后重新启动定时器继续监听

上电 → 启动定时器(30秒)
识别到任何命令 → 重启定时器(30秒)
定时器超时 → 播报提示语 → 重启定时器

注意事项：

• CI-03T系列最多支持5个定时器
• 定时器名称必须唯一，避免与变量名冲突
• 使用重装机制可实现"无操作超时"功能

如何实现语音回复音的循环播放功能？¶

问题描述：

需要在网页平台上配置语音回复音的循环播放功能，使模块在收到"开启"指令后开始重复播放，直到收到"关闭"指令时停止。

解决方案：

通过配置两个定时器（一个主定时器控制循环周期，一个控制定时器）来实现循环播放功能：

1. 配置主定时器（L1 - 控制定时器）

• 定时器名称：L1
• 超时时间：10000ms（10秒，控制总播放时长）
• 工作模式：单次触发
• 用于控制整个循环播放的持续时间

2. 配置循环定时器（L2 - 播放定时器）

• 定时器名称：L2
• 超时时间：3000ms（3秒，播放间隔）
• 工作模式：重复触发
• 用于周期性触发播放动作

3. 配置事件触发逻辑

• DS1模块：配置L1定时器，当收到"开启"指令时启动L1
• DS2模块：配置L2定时器，当L1启动后启动L2循环
• DS3模块：配置播放动作，当L2超时时执行播放操作
• DS4模块：配置停止动作，当L1超时时停止所有定时器

DS1和DS2模块的定时器配置

完整的循环播放逻辑配置

注意事项：

• 模块需要支持AEC功能才能正常使用定时器
• "开启"指令会立即开始循环播放，"关闭"指令会立即停止
• 也可等待主定时器（L1）超时后自动停止播放
• 循环间隔和总时长可根据实际需求调整

大模型免费体验版与正式版有什么区别？¶

问题描述：

希望了解大模型免费体验版与正式版在功能、使用时长和限制方面的具体差异。

解决方案：

版本差异说明：

• 个人使用场景：免费体验版与正式版功能基本相同
• 商业使用：正式版支持商业应用，免费体验版仅限个人测试使用

功能对比：

• 免费体验版：

  • 支持全部基础功能测试
  • 适合个人学习和评估
  • 有使用时间和功能限制

• 正式版：

  • 完整功能，无限制使用
  • 支持商业项目部署
  • 享有完整技术团队服务

注意事项：

• 免费体验版主要用于功能评估和测试
• 如需商用请联系客服获取正式版授权
• 具体验证时长请以平台最新政策为准

平台自有智能体服务：

• 免费体验版：使用千问3大模型，当前免费向用户开放
• 商用量级：需支付大模型服务费（费用相对其他平台较低，具体可协商）
• 自有智能体：可在平台自主配置智能体功能

外部智能体对接：

• 支持平台：可对接豆包（Coze）等外部大模型平台
• 费用承担：外部模型的费用由对应平台收取，硬件模块方仅提供平台对接的API接口
• 对接方式：在外部平台申请智能体后，将API接口信息填入智能公元后台配置即可

平台添加300条以上命令词后出现严重卡顿怎么办？¶

问题描述：

在平台上添加超过300条命令词后，页面出现严重卡顿现象，影响正常操作。

解决方案：

1. 页面刷新处理

• 关闭当前页面，重新打开
• 刷新浏览器缓存
• 重新登录平台尝试

2. 操作建议

• 分批添加命令词，避免一次性添加过多
• 先添加部分命令词，生成固件测试
• 确认功能正常后再继续添加

3. 性能优化

• 使用性能较好的浏览器
• 关闭不必要的浏览器标签页
• 确保网络连接稳定

注意事项：

• 命令词数量过多会增加平台处理负担
• 建议根据实际需求控制命令词数量
• 如持续卡顿，可联系技术团队协助处理

快速发布模式生成固件需要很长时间怎么办？¶

问题描述：

使用快速发布模式生成SDK时，等待时间超过两小时仍未完成。

解决方案：

1. 高峰期影响

• 生成时间过长通常是由于使用高峰期
• 服务器负载较高导致处理速度变慢
• 建议错峰使用平台服务

2. 优化建议

• 选择非高峰时段进行生成（如早晨、夜间）
• 避免在工作时间等人多时使用快速发布
• 生成前确保配置简洁合理

3. 替代方案

• 如急用，可尝试使用普通模式生成
• 简化配置内容，减少生成时间
• 分批次生成功能模块

注意事项：

• 快速发布模式在高峰期可能比普通模式更慢
• 生成时间与配置复杂度直接相关
• 如长时间无响应，可刷新页面重新尝试

为什么不提供离线版本的IDE？¶

问题描述：

希望能够使用离线版本的集成开发环境（IDE），以便在没有互联网连接的情况下进行开发和固件生成。

解决方案：

技术限制说明：

1. 服务器端依赖

   • 唤醒词和命令词需要服务器端生成特征波形
   • AI模型训练和优化依赖云端计算资源
   • 需要GPU服务器集群支持，本地难以部署

2. 安全考虑

   • 核心算法和模型需要保护知识产权
   • 本地部署容易被破解和复制
   • 商业核心技术需要云端保护

3. 资源需求

   • 需要昂贵的GPU服务器支持
   • 对普通开发者来说部署成本过高
   • 专业维护要求较高

替代方案：

• 优化网络环境，提升访问速度
• 批量生成任务，减少等待时间
• 关注平台公告，避开高峰期
• 如有特殊需求，可联系商务合作

注意事项：

• 平台持续优化服务响应速度
• 未来可能推出本地轻量级开发工具
• 企业版需求方可探讨定制化方案

开发环境与基础¶

STM32项目中除了main.c还有哪些文件？它们的作用是什么？¶

问题描述：

在学习STM32开发时，只能看懂main.c文件，不了解其他文件（如startup_stm32f103xe.s、system_stm32f1x.c、stm32f1xx_hal_gpio.c等）的作用和功能。

解决方案：

STM32项目文件结构说明：

1. 核心文件说明

• main.c：主程序文件，包含main函数和主要业务逻辑
• startup_stm32f103xe.s：启动文件，汇编语言编写
  • 设置堆栈指针
  • 初始化中断向量表
  • 调用main函数前的准备工作

2. 系统层文件

• system_stm32f1x.c：系统时钟配置

  • 初始化系统时钟
  • 配置PLL和分频器
  • 设置系统总线频率

• stm32f1xx_hal.c：HAL库主文件

  • 硬件抽象层初始化
  • 提供系统级API
  • 管理低功耗和调试功能

3. 外设驱动文件

• stm32f1xx_hal_gpio.c：GPIO驱动

  • GPIO初始化和配置
  • 提供读写接口
  • 中断处理相关

• stm32f1xx_hal_uart.c：串口驱动

• stm32f1xx_hal_tim.c：定时器驱动
• stm32f1xx_hal_rcc.c：时钟控制驱动

4. 配置文件

• stm32f1xx_hal_conf.h：HAL库配置
  • 选择要使用的外设
  • 配置调试选项
  • 优化代码大小

5. 学习建议

循序渐进的学习路径：

1. 先理解main.c

   • 掌握程序基本流程
   • 理解初始化顺序
   • 学会调用HAL函数

2. 逐步了解HAL库

   • 从GPIO开始学习
   • 逐步掌握其他外设
   • 查看官方例程

3. 深入底层（可选）

   • 了解启动文件原理
   • 学习寄存器操作
   • 理解中断机制

推荐学习资源：

• ST官方参考手册
• HAL库使用方指南
• 正点原子等教程视频
• GitHub上的开源项目

注意事项：

• 初学者无需完全理解所有文件
• 先会用HAL函数即可
• 遇到问题时再深入了解对应模块

平台配置与调试¶

自定义协议测试值无法输入怎么办？¶

问题描述：

在平台配置触发方式为"串口输入"且选择自定义协议时，测试值输入框为灰色，无法输入数据。

解决方案：

• 这是自定义协议的正常显示逻辑
• 自定义协议不支持直接输入测试值
• 需要通过实际串口发送数据进行测试

配置说明：

• 自定义协议用于定义特定通信格式
• 测试值输入框仅适用于预设协议
• 自定义协议需外部提供测试数据

注意事项：

• 使用串口调试工具发送测试数据
• 确认数据格式符合自定义协议定义
• 如需模拟测试，可临时使用标准协议

固件下载与文件格式¶

点击产品管理后看不到所有产品怎么办？¶

问题描述：

在智能公元平台点击"产品管理"后，无法看到所有产品列表，导致无法进行后续操作。

解决方案：

1. 检查操作步骤

• 确认点击的是左侧菜单栏的"产品管理"
• 点击后应显示"所有产品"子菜单
• 需要点击"所有产品"才能看到完整列表

2. 页面显示问题排查

• 刷新浏览器页面（F5）
• 检查网络连接是否正常
• 尝试使用其他浏览器访问

3. 账号和权限检查

• 确认登录了正确的账号
• 检查账号是否有查看产品的权限
• 确认账号下是否已创建产品

注意事项：

• 产品管理菜单可能有折叠子菜单
• 如果是新账号，需要先创建产品
• 部分功能可能需要账号权限支持

误删除产品/工程后能找回吗？¶

问题描述：

在平台误删除了产品或工程配置，询问是否能够找回或恢复。

解决方案：

1. 删除操作说明

• 产品/工程一旦删除无法从平台恢复
• 删除操作是永久性的，平台不提供回收站功能
• 所有配置、版本记录、固件文件都会被清除

2. 预防措施

• 定期导出配置：使用平台的"导出"功能备份工程配置
• 保留配置文件：将导出的JSON配置文件保存在本地
• 重要配置多备份：对于关键产品，建议定期备份配置

3. 如果已删除的处理方式

• 检查本地是否保存了导出的配置文件
• 如果有配置文件，可以通过"导入"功能重新创建产品
• 检查固件包：如果之前下载过固件包，解压后可以从固件包中的JSON配置文件重新导入
• 如果没有任何备份，需要重新创建和配置产品

注意事项：

• 删除操作不可逆，删除前务必确认
• 建议在删除任何产品前先导出配置文件作为备份
• 定期备份重要产品的配置，避免误删除导致数据丢失

下载固件后功能未生效怎么办？¶

问题描述：

下载并烧录新固件后，设备功能未按预期生效，怀疑是否因登录账号错误导致。

解决方案：

1. 确认账号一致性

• 检查是否使用了正确的账号登录平台
• 确认固件是在当前账号下生成的
• 不同账号的固件无法通用

2. 验证固件内容

• 重新登录平台查看固件配置
• 确认生成固件时包含所需功能
• 检查固件版本是否正确

3. 烧录检查

• 确认烧录过程没有报错
• 检查固件是否完整烧录
• 烧录后需要重新上电

注意事项：

• 账号密码不要混淆，做好记录
• 生成固件前确认配置正确
• 烧录成功后功能应立即生效

如何找到固件下载页面？¶

问题描述：

在智能平台中无法找到固件下载页面，不知道在哪里下载生成的固件。

解决方案：

1. 进入产品管理

• 登录智能公元平台
• 点击左侧菜单栏的"产品管理"
• 进入"所有产品"列表

2. 找到固件下载入口

• 在产品列表中找到对应产品
• 点击产品名称进入详情页
• 查找"下载"或"导出"按钮
• 部分版本可能显示为"生成固件"

3. 可能的问题

• 账号问题：确认登录了正确的账号
• 权限问题：检查是否有下载权限
• 产品状态：确认产品已生成完成

注意事项：

• 如果产品列表为空，需要先创建产品
• 刷新页面重试
• 联系技术团队获取帮助

下载的固件是.tar格式，如何获取.bin烧录文件？¶

问题描述：

在平台生成固件后，下载的文件为.tar格式，但烧录工具需要.bin格式文件，不清楚如何从.tar文件中获取.bin文件。

解决方案：

1. 文件格式说明

• 平台下载的固件默认为压缩格式
• 显示为.tar或.tar.gz是正常的压缩文件
• .bin文件包含在压缩包内

2. 获取.bin文件的方法

• 方法一：解压压缩文件

  • 使用解压软件（如7-Zip、WinRAR）解压.tar文件
  • 解压后即可找到.bin烧录文件
  • 可能还包含其他配置文件

• 方法二：文件名显示问题

  • 某些系统可能隐藏了文件扩展名
  • 下载后应显示为.tar.gz格式
  • 使用7-Zip等软件直接解压

3. 烧录文件使用

• 解压后使用其中的.bin文件进行烧录
• 确保烧录工具选择正确的文件
• 不要烧录整个压缩包

注意事项：

• .bin文件是实际的固件程序
• 保留原始压缩包作为备份
• 解压后文件请勿随意修改

开发包下载速度过慢怎么办？¶

问题描述：

从官网下载开发包时速度极慢，仅几KB/s，影响开发进度。

解决方案：

1. 网络环境优化

• 检查本地网络连接是否稳定
• 尝试更换网络环境或使用热点下载
• 避开网络高峰期进行下载

2. 下载方式调整

• 使用浏览器下载功能，避免使用下载工具
• 尝试不同浏览器（Chrome、Edge、Firefox）
• 暂停其他占用带宽的应用程序

3. 替代获取方式

• 开发包只需下载一次，可重复使用
• 下载完成后妥善保存备份
• 如遇紧急情况，可联系技术团队获取帮助

注意事项：

• 开发包体积较大，建议预留充足下载时间
• 下载中断后可支持断点续传
• 确保磁盘空间充足
• 下载完成后验证文件完整性

固件生成40分钟仍未完成且无重新生成选项怎么办？¶

问题描述：

固件生成过程异常缓慢，持续40分钟仍未完成，且界面中没有提供重新生成的选项。

解决方案：

1. 问题原因分析

• 固件生成缓慢通常与网络连接有关
• 服务器负载过高时也会导致生成速度变慢
• 界面功能异常可能导致重新生成选项不显示

2. 解决方法

• 检查网络连接：确认网络连接稳定，尝试刷新页面
• 清除缓存：清除浏览器缓存后重新登录平台
• 更换时段：避开使用高峰期，选择非高峰时段生成
• 联系技术团队：如持续异常，联系技术协助

3. 临时解决方案

• 通过"更多"菜单查找是否有其他操作选项
• 尝试返回上一级页面重新进入生成界面
• 考虑简化配置以减少生成时间
• 重新生成固件：点击"更多"菜单选择"重新生成固件"选项，通常比首次生成更快

注意事项：

• 固件生成慢通常是网络或服务器负载问题
• 建议在网络状况良好时进行固件生成
• 平台高峰期（如工作日下午）速度可能较慢

SDK生成平台状态长时间卡在"正在生成"怎么办？¶

问题描述：

在使用SDK生成平台时，SDK生成状态长时间显示"正在生成"，持续超过预期时间（如1小时）。

解决方案：

1. 刷新页面查看最新状态
2. 检查网络连接是否稳定
3. 清除浏览器缓存后重新登录
4. 若问题持续，可稍后重试，系统可能有延迟

注意事项：

• SDK生成正常需要10-30分钟，超过1小时属于异常情况
• 多个任务同时生成可能导致队列拥堵
• 建议避开高峰期进行SDK生成
• SU系列模块使用人数较多，生成速度可能较慢
• 可考虑使用CI系列模块，生成速度通常更快

固件生成卡在"待生成"状态怎么办？¶

问题描述：

在平台生成固件时，固件状态长时间显示"待生成"，SDK状态显示"SDK正在生成，大约需要1-3分钟"，但实际长时间无法完成，重新生成多次均失败。

解决方案：

1. 问题定位

• 检查是否使用了特定的播报员语音（如lida）
• 某些语音配置可能导致生成异常
• 确认平台服务是否正常

2. 处理步骤

• 更换播报员语音重新生成
• 尝试简化固件配置
• 检查网络连接稳定性

3. 应急措施

• 取消当前生成任务
• 导出产品配置文件（sde.json）供技术团队分析
• 避开平台使用高峰期

注意事项：

• 平台使用人数多时，生成速度会变慢
• 之前成功生成的配置，如果平台规则变更也可能失败
• 不提供失败原因时，通常是语音配置问题
• 如问题持续，联系技术团队并提供产品配置

之前成功生成的固件再次生成失败怎么办？¶

问题描述：

之前在平台成功生成的固件版本，再次尝试生成时无法完成，界面卡在"待生成"状态，且没有明确的错误提示。

解决方案：

1. 问题排查

• 检查播报员配置是否有问题
• 确认是否修改了其他配置项
• 验证产品配置是否触发平台规则限制

2. 解决方法

• 更换播报员语音（从lida改为其他）
• 导出产品配置文件供技术团队分析
• 恢复到最后成功时的配置状态

3. 平台使用建议

• 避免重复提交生成任务
• 检查所有生成任务的状态
• 确认配置是否符合平台最新规则

注意事项：

• 平台规则更新可能影响之前可用的配置
• 无错误提示时多为语音配置兼容性问题
• 及时导出并备份成功的产品配置
• 问题持续时联系技术团队

SDK生成因使用方量激增导致超时怎么办？¶

问题描述：

由于平台使用方数量激增，服务器承载压力增大，导致SDK生成超时、排队时间过长，甚至需要等待1-2 小时。

解决方案：

1. 平台状况说明

• SU系列产品使用方量较大，生成队列较长
• 服务器正在进行扩容升级
• 生成时间可能比平时延长2-3倍

2. 临时解决方法

• 重新发布生成任务，刷新队列状态
• 避开高峰期（工作时间）进行生成
• 考虑使用CI系列产品，生成速度相对较快

3. 平台优化进展

• 新增服务器已在部署中
• 计划实施限时分流机制
• 平台会定期进行升级维护（如16:00-18:00）

4. 建议做法

• 提前规划固件生成，预留充足时间
• 生成成功后及时下载备份
• 关注群内公告，了解平台维护时间

注意事项：

• 生成时间超过1小时属于正常现象（高峰期）
• 避免频繁重新生成，加重队列负担
• 如急需使用，可联系技术团队协调处理

SDK生成时间长达4-5小时怎么办？¶

问题描述：

使用SDK生成工具时，生成过程耗时过长（4-5小时），无法完成SDK生成。

解决方案：

1. 异常情况判断

• 正常生成时间：10-30分钟
• 异常时间：超过1小时
• 严重异常：超过4小时，说明系统或配置存在问题

2. 问题排查步骤

• 立即刷新页面：查看是否生成完成但界面未更新
• 检查网络连接：网络不稳定可能导致生成中断
• 清除浏览器缓存：重新登录平台尝试
• 更换浏览器：尝试Chrome、Edge等不同浏览器

3. 配置检查

• 固件配置复杂度：过多的词条和功能配置会增加生成时间
• 词条数量验证：确认词条数量在合理范围内
• 功能配置精简：暂时禁用非必需功能重新生成

4. 应急处理

• 取消当前生成：如可操作，取消后重新提交
• 联系技术团队：提供账号信息和生成时间
• 错峰生成：避开服务器负载高峰期

5. 预防措施

• 精简配置：按需配置功能，避免过度复杂化
• 分段生成：复杂项目可分阶段生成和测试
• 本地备份：生成成功的固件及时备份

注意事项：

• 4-5小时的生成时间属于严重异常情况
• 可能是服务器端问题，需及时反馈
• 建议截图记录生成状态和时间
• 长时间无响应应主动联系技术团队

生产SDK生成需要多长时间？¶

问题描述：

需要了解生产SDK生成所需的时间，以便合理安排开发计划。

解决方案：

• SDK生成需要等待处理时间
• 具体时间取决于服务器负载和任务队列
• 建议合理安排生成时间，避开高峰期

注意事项：

• 生成期间请耐心等待，不要重复提交
• 如长时间未完成，可尝试刷新页面

配置检查¶

配置检查提示触发方式配置错误和未添加主触发怎么办？¶

问题描述：

配置检查报告提示：1）行为控制详情触发方式配置错误；2）行为控制详情没有添加主触发，导致配置无法通过。

解决方案：

1. 常见原因分析：

   • ADC输入被错误配置为GPIO输入
   • 附加条件中的ADC值设置了错误的输入源
   • 主触发条件缺失或配置错误

2. 问题排查步骤：

   • 检查触发条件的输入源设置
   • 确认ADC相关配置是否正确选择ADC输入
   • 验证每个行为是否都有主触发条件

3. 正确配置方法：

   • 触发方式：选择正确的输入类型（ADC/GPIO/串口等）
   • ADC值条件：确保输入源选择ADC而非GPIO
   • 主触发：每个行为必须添加至少一个主触发

4. 配置检查技巧：

   • 逐项检查每个行为的触发条件
   • 使用导出JSON功能检查配置
   • 参考官方示例配置

注意事项：

• 配置检查通过不代表功能一定正常，还需实际测试
• ADC功能需要硬件支持，确认型号是否支持
• 保存配置前仔细检查所有触发条件
• 如问题持续，可导出配置文件联系技术团队

- 高峰期可能需要更长时间

配置检查提示"TCP和UDP协议数量不能超过3"怎么办？¶

问题描述：

在配置通讯接口时，配置检查工具显示错误："TCP和UDP协议数量不能超过3"，询问是否可以增加这个限制。

解决方案：

1. 了解协议数量限制

• 平台对TCP和UDP协议数量有硬性限制：最多3个
• 此限制为系统架构决定，目前无法通过配置调整
• 限制适用于所有型号的通讯模块

2. 优化通讯配置

如果需要超过3个TCP/UDP连接，可考虑以下方案：

• 合并相同类型的连接：将多个同类服务合并为单一连接
• 使用协议复用：在同一TCP连接上传输多种类型数据
• 区分服务优先级：保留核心服务的连接，次要服务通过其他方式实现

3. 替代方案

• 使用MQTT协议：MQTT支持多主题订阅，可减少连接数
• 采用轮询机制：通过单一连接定期查询不同服务
• 考虑网关方案：使用中间网关设备聚合多个连接

注意事项：

• 协议数量限制是平台固有的约束，无法通过配置修改
• 如确需超过3个连接，需联系技术团队评估定制方案
• 配置检查通过后仍需实际测试各连接的稳定性
• 不支持队列式连接管理：平台不支持"出栈方式"（如第四个连接时自动断开第一个）的自动轮替连接管理，需要时必须手动断开旧连接后再建立新连接

固件生成卡住或失败怎么办？¶

问题描述：

固件生成任务卡在"待生成"状态，SDK状态显示"正在生成"但长时间无进展，即使重新生成也失败。

解决方案：

1. 检查语音播报员配置

• 确认未使用可能导致冲突的播报员（如"lida"）
• 更换为其他可用的播报员后重新生成
• 导出产品配置文件检查是否有异常配置

2. 平台负载问题

• 平台使用人数多时生成速度会变慢
• 建议等待1-3分钟后刷新页面查看状态
• 避开高峰期进行固件生成

3. 重新操作步骤

• 取消当前卡住的生成任务
• 检查并修改问题配置（如播报员选择）
• 重新提交生成任务

注意事项：

• 如果之前成功生成的配置现在无法生成，可能是平台规则更新
• 长时间（超过30分钟）卡住需联系技术团队
• 保留错误截图和配置信息便于问题排查

固件生成失败但无错误提示怎么办？¶

问题描述：

固件生成任务一直显示"待生成"状态，没有明确的错误提示，即使之前成功生成的版本也无法再次生成。

解决方案：

1. 检查播报员配置

• 某些播报员（如"lida"）可能导致生成失败
• 尝试更换为其他播报员
• 导出产品配置文件（sde.json）进行检查

2. 平台规则变更

• 平台规则更新可能导致旧配置无法生成
• 对比新旧配置的差异
• 根据新规则调整配置参数

3. 故障排查步骤

• 截图保存当前状态
• 导出产品配置文件
• 联系技术团队并提供详细信息

注意事项：

• 平台不会主动提示配置冲突
• 保存成功不代表一定能生成固件
• 定期备份配置文件避免丢失

平台服务器负载过高导致生成失败怎么办？¶

问题描述：

由于平台使用方数量激增，服务器负载过高，导致SDK和固件生成频繁失败或超时。

解决方案：

1. 确认问题原因

• 平台使用方量持续攀升，服务器承载压力增大
• SU系列模块使用人数较多，排队现象严重
• 生成任务会进入队列等待，需要较长时间

2. 应对措施

• 避开高峰期：在非工作时间段进行生成
• 耐心等待：生成任务会逐步完成，不要频繁刷新
• 尝试重新发布：对卡住的任务可点击编辑后重新发布
• 考虑替代方案：使用CI系列模块，生成速度更快

3. 导出配置寻求帮助

• 如果问题持续，可导出产品配置文件
• 在产品管理界面找到"导出"功能
• 将配置文件提供给技术团队进行分析

4. 平台维护信息

• 平台会定期进行升级维护以改善服务
• 关注官方通知，了解维护时间安排
• 维护期间服务暂时不可用，请耐心等待

5. 长时间等待处理

• 固件生成状态显示"正在生成"超过30分钟未更新
• SDK状态长时间卡在"SDK正在生成，大约需要10-30分钟"
• 多次尝试重新生成都失败时，建议联系技术支持

6. 服务恢复确认

• 生成成功后状态显示为"已生成"
• 固件状态显示"生成成功"
• MD5校验码可用于验证固件完整性

注意事项：

• 服务器负载问题是暂时的，平台正在紧急优化
• 生成失败不是配置错误，不要频繁修改配置
• 保留错误截图和配置信息便于技术团队排查
• 可关注官方公告获取最新服务状态
• 避免多次提交相同任务，会加重服务器负担
• 如持续"待生成"状态，说明生成任务已卡住需要重新提交

SDK生成显示"待生成"或生成时间过长怎么办？¶

问题描述：

在使用SDK生成固件时，部分固件状态显示为"待生成"，且SDK生成时间过长，影响开发进度。

解决方案：

1. 状态说明

• SDK正在生成：表示正在处理，需要等待
• 待生成：表示排队等待，系统负载较高
• 生成成功：表示已完成，可下载使用

2. 生成时间长的原因

• 服务器负载高，需要排队处理
• 同时生成使用方多，资源分配紧张
• 复杂配置需要更多处理时间

3. 解决方法

• 避开高峰时段（如下午2-4点）进行生成
• 推荐时段：早上、凌晨等用户较少时生成速度更快
• 不要频繁刷新页面或重复提交
• 耐心等待，正常生成需要10-30分钟
• 如超1小时未完成，可联系技术团队

SU系列模块特别说明：

• SU系列产品（如SU-03T）因用户量较大，生成队列任务多时速度会变慢
• 生成时间长是SU系列产品的正常现象，非个人设置错误
• 建议在非高峰时段（早上/凌晨）进行SDK和固件生成
• 生成期间可以关闭电脑，不影响服务端处理
• 刷新页面可查看队列进度是否缩短

注意事项：

• 生成时间与配置复杂度相关
• 状态显示"待生成"说明已进入队列
• 平台正在扩容以缓解压力
• 建议提前规划，留出充足时间

语音模块是否支持闹钟功能？¶

问题描述：

需要了解语音模块是否支持通过语音指令设置闹钟功能。

解决方案：

语音模块不支持闹钟功能，无法实现定时提醒。

功能限制说明：

• 无时钟模块：语音模块没有内置实时时钟（RTC）
• 不支持定时：无法实现特定时间的闹钟提醒
• 功能定位：专注于语音识别和控制执行

替代方案：

方案一：外接时钟模块

• 使用带RTC功能的单片机
• 通过串口与语音模块通信
• 由单片机管理闹钟功能

方案二：使用定时器功能

• 部分模块支持简单的定时器
• 可实现延时执行功能
• 但无法实现按时钟的定时

方案三：语音提醒替代

• 设置固定的提醒语音
• 通过语音触发播报时间
• 需要手动触发执行

注意事项：

• 如需闹钟功能，建议配合其他设备使用
• 可关注产品更新，看是否新增时钟功能
• 语音模块主要用于即时响应和控制

CI系列模块支持串口触发强制退出唤醒吗？¶

问题描述：

需要了解CI系列离线语音识别芯片是否支持通过串口触发强制退出唤醒状态功能。

解决方案：

1. 功能确认

• CI系列模块支持串口触发强制退出唤醒
• 可通过添加行为实现该功能
• 不需要修改固件，平台配置即可实现

2. 配置步骤

• 添加新的行为项
• 触发方式选择"串口输入"
• 控制详情选择"退出唤醒"

触发方式选择串口输入，消息编号为3

控制详情中选择退出唤醒功能

3. 触发参数设置

• 选择接收串口：UART0_RX
• 设置消息编号：匹配发送的数据
• 测试消息：AA 55 03 55 AA（十六进制）
  • AA：帧头
  • 55：帧尾
  • 03：消息号

串口输入触发参数配置

4. 退出唤醒配置

• 控制方式：系统设置
• 类别：识别控制
• 操作：退出唤醒
• 延时恢复：选择"否"

系统设置中的退出唤醒操作

5. 串口输出配置（可选）

如需同时发送串口数据确认：

• 控制类型：端口输出
• 端口类型：UART0_TX
• 动作：发送
• 参数：01（或其他确认数据）

UART0_TX发送数据配置

6. 串口参数配置

确保UART0配置正确：

• UART0_TX和UART0_RX波特率：9600
• 数据位：8
• 停止位：1
• 校验位：无
• 功能：烧录功能引脚（可用于通信）

UART0作为烧录功能引脚的配置

注意事项：

• 退出唤醒后需要重新唤醒词才能进入语音识别
• 串口数据格式必须严格按帧格式发送
• 消息号要与配置的一致
• 退出唤醒功能不影响其他正常工作

平台功能问题¶

如何在同一个行为中同时使用唤醒词和串口输入触发？¶

问题描述：

希望配置一个行为，能够同时通过唤醒词和串口输入两种方式触发，避免需要创建两个重复的行为配置。

解决方案：

平台功能限制说明：

1. 触发方式设计原则：

   • 单一触发源：每个行为只能设置一种触发方式
   • 不支持合并：无法在同一行为中设置多种触发条件
   • 独立处理：不同触发方式需要创建独立的行为

2. 设计原因：

   • 逻辑清晰：避免触发条件冲突
   • 响应明确：确保触发来源可追溯
   • 状态管理：简化模块内部状态管理

替代方案实现：

方案一：创建两个独立行为

行为1：语音触发
├── 触发方式：命令词"打开灯"
├── 执行动作：开灯
└── 回复语："灯已打开"

行为2：串口触发
├── 触发方式：串口输入特定数据
├── 执行动作：开灯
└── 回复语："灯已打开"

方案二：使用中间变量

• 通过串口设置内部状态变量
• 语音命令检查状态变量后执行
• 需要固件支持自定义变量功能

方案三：语音控制串口模式

• 默认语音触发所有功能
• 通过语音命令切换到串口控制模式
• 串口模式时只响应串口输入

实现步骤（方案一示例）：

1. 创建语音触发行为：

   • 新建行为
   • 设置触发方式为"命令词"
   • 输入命令词如"打开灯"
   • 添加执行动作（如GPIO输出）
   • 设置回复语（可选）

2. 创建串口触发行为：

   • 新建行为
   • 设置触发方式为"串口输入"
   • 指定触发数据（如0x01）
   • 添加相同的执行动作
   • 设置相同的回复语

3. 行为管理优化：

   • 命名规范：

     • "语音-打开灯"
     • "串口-打开灯"
       • 分组管理：使用文件夹或标签分组
       • 批量操作：复制行为后修改触发方式

注意事项：

• 不同触发方式的行为无法合并，这是平台设计限制
• 如果功能复杂，建议使用模块化编程或定制开发
• 行为数量过多时，建议使用MCU协调多个模块
• 维护两套相同配置时，注意同步更新

配置完成后无法保存怎么办？¶

问题描述：

在语音指令配置界面设置完成后，界面上显示黄色提示文字，无法保存配置。

解决方案：

1. 检查提示信息

• 界面顶部的黄色提示框会说明无法保存的原因
• 常见提示："当前版本正在发布，系统不会保存修改的内容！"
• 这表示当前版本处于发布状态

2. 使用继承功能

• 在"下载固件"旁边找到"继承成新的工程"按钮
• 点击继承按钮创建新的工程版本
• 返回上一级页面找到继承按钮

3. 继承操作步骤

• 点击返回按钮离开当前配置页面
• 在下载固件旁边点击"继承成新的工程"
• 系统会创建新的可编辑版本
• 原有设置会继承到新版本中

注意事项：

• 发布状态的版本不能直接修改
• 继承新工程会保留之前的配置
• 刚修改的内容在继承时会丢失
• 建议在可编辑状态下完成所有修改