基于 ARCS SDK 的语音交互解决方案,支持多项目的语音解决方案定制功能。
本项目是一个完整的语音助手解决方案,集成了语音唤醒、语音识别、云端交互、本地播放等功能。
- 语音唤醒和识别
- 云端语音服务对接
- 本地音频播放
- WiFi/BLE 网络连接
参考SDK的开发文档:
voiceassistant/
├── apps/ # 应用方案工程集合
├── arcs-sdk/ # ARCS SDK 核心框架
├── modules/ # 项目级第三方模块
├── res/ # 资源文件(固件、配置、音频、图片等)
├── src/ # 语音交互核心代码
├── tools/ # 开发工具和脚本(如 adb、cskburn)
├── yaml/ # 配置文件
└── build.sh # 工程构建脚本
apps/ - 应用程序
包含多个应用方案项目,详细说明请参考对应工程下的README.MD(如有)。
src/ - 语音交互核心代码
包含语音助手的核心业务逻辑、中间件和工具库:
src/
├── category/ # 品类相关代码
│ ├── comm/ # 品类通用代码
│ ├── evb/ # EVB 品类实现
│ └── yuba/ # YUBA 品类实现
├── framework/ # 核心框架
│ └── voice_msg.* # 语音消息处理
├── middleware/ # 中间件层
├── server/ # 语音服务
├── shell/ # 调试命令行
│ └── cmd/ # Shell 命令实现
├── system/ # 系统服务
│ ├── platform.c # 平台抽象层
│ └── remote_logger.*# 远程日志
└── utils/ # 工具库
核心模块说明:
- category: 不同产品品类的特定实现,封装品类差异
- comm: 品类间通用代码和共享组件
- framework: 核心框架,提供语音消息传递机制
- middleware: 提供硬件抽象和系统服务,供应用层调用
- server: 语音交互核心逻辑,包括云端通信和唤醒处理
- shell: 提供调试命令行接口,用于开发调试
- system: 系统级服务,包括平台抽象和远程日志
- utils: 通用工具库,提供事件、配置、编解码等基础功能
基本编译命令,这里以/apps/evb-arcs项目为例,用户根据自己的实际项目路径选择:
./build.sh -S ./apps/arcs-evb -C编译成功后,固件文件位于 build/arcs-evb.bin
参考对应app的资源分配置表说明文件
适用于首次烧录或 boot 程序损坏的情况。
进入 ROM 升级模式:
- 将开发板的
boot引脚接地 - 复位开发板
- 开发板进入 ROM 升级模式
烧录 boot 程序:
# 连接串口 UART0(GPIOA2_RX0/GPIOA3_TX0)
cskburn -C arcs -s /dev/ttyACM0 -b 3000000 0x0 ./res/res_pack_a/boot.bin注意: boot 引脚和烧录串口引脚复用,烧录前需将 boot 引脚悬空
适用于已有 boot 程序且 ADB 可用的设备。仓库已内置 ADB 工具:
- Windows:
tools/adb/adb.exe - Linux / WSL:
tools/adb/adb
烧录脚本会自动检测 ADB、让普通模式设备进入 recovery、等待 BOOT-* 设备出现、推送固件并重启设备。多设备或多个相同 BOOT-* 序列号时,脚本会优先用 transport_id 区分目标设备。开发者通常不需要手动执行 adb shell recovery。
Linux / WSL / Git Bash:
# 默认模式:烧录除 boot 之外的其他固件和资源
bash adb_download.sh -S res/arcs-mini
# app 模式:只烧录 CP app 固件
bash adb_download.sh -S res/arcs-mini app
# boot 模式:包含 boot 的完整烧录
bash adb_download.sh -S res/arcs-mini bootWindows PowerShell:
# 默认模式:烧录除 boot 之外的其他固件和资源
powershell -ExecutionPolicy Bypass -File adb_download.ps1 -S res/arcs-mini
# app 模式:只烧录 CP app 固件
powershell -ExecutionPolicy Bypass -File adb_download.ps1 -S res/arcs-mini app
# boot 模式:包含 boot 的完整烧录
powershell -ExecutionPolicy Bypass -File adb_download.ps1 -S res/arcs-mini boot三种烧录模式:
| 模式 | 命令参数 | 烧录内容 | 适用场景 |
|---|---|---|---|
| 默认 | 无 | ap.bin、tone.bin、wake_word.bin、emoji.bin、respak.bin、build/arcs-mini.bin |
静态资源或 AP/app 一起更新 |
| app | app |
build/arcs-mini.bin |
只修改 CP app / 应用代码 |
| boot | boot |
boot.bin + 默认模式全部内容 |
首次烧录、boot 变更或 boot 损坏恢复 |
-S 指向包含 partition_table.json 的资源目录;脚本会按该分区表读取镜像地址和文件路径,跳过没有 file 的保留分区。-B 或 BUILD_DIR 可覆盖 ${BUILD_DIR} 对应的构建输出目录。
arcs-mini 的分区映射来自 res/arcs-mini/partition_table.json:
| 分区 | 地址 | 文件 |
|---|---|---|
| boot | 0x000000 |
res/arcs-mini/boot.bin |
| ap | 0x040000 |
res/arcs-mini/ap.bin |
| tone | 0x100000 |
res/arcs-mini/tone.bin |
| wake_word | 0x200000 |
res/arcs-mini/wake_word.bin |
| emoji | 0x380000 |
res/arcs-mini/emoji.bin |
| respak | 0x440000 |
res/arcs-mini/respak.bin |
| app (CP) | 0x600000 |
build/arcs-mini.bin |
可选环境变量:
| 变量 | 默认值 | 说明 |
|---|---|---|
MAX_DEVICES |
10 |
最多支持的设备数量 |
RECOVERY_TIMEOUT |
120 |
等待进入 recovery 的超时秒数 |
POLL_INTERVAL |
2 |
轮询 recovery 状态的间隔秒数 |
ADB_CMD |
自动检测 | 手动指定 ADB 路径 |
BUILD_DIR |
build |
arcs-mini.bin 所在构建目录 |
RES_DIR |
res/arcs-mini |
默认资源目录,可被 -S 覆盖 |
ADB 工具选择顺序:
ADB_CMD环境变量指定的路径- 仓库内置
tools/adb/adb或tools/adb/adb.exe - 系统 PATH 中的
adb
烧录建议:
- 只改应用代码时,优先使用
app模式,避免重复写入静态资源。 - 修改提示音、唤醒词、表情、respak 或 AP 固件时,使用默认模式。
- 只有首次烧录、boot 变更或 boot 损坏恢复时,才使用
boot模式。
Q: 找不到工具链
A: 检查环境变量是否正确设置:
echo $NUCLEI_TOOLCHAIN_PATH
echo $LISTENAI_TOOLS_PATH
Q: 编译失败
A: 尝试清理后重新编译:
./build.sh -C
Q: ADB 连接不上设备
A: 1. 检查 USB 连接
2. 运行 adb devices 查看设备
3. 尝试重启 adb: adb kill-server && adb start-server
Q: 烧录后无法启动
A: 1. 检查是否烧录了所有必要分区
2. 查看串口日志定位问题
3. 尝试重新烧录 boot.bin
- 当前分支: master
- 主分支: master
本项目遵循相应的开源许可证,详见各模块的 LICENSE 文件。