¶ 鼾声检测开发指南
¶ 写在前面
本章节主要讲解如何获取 鼾声检测 固件源码并进行代码的编译。
¶ 示例工程介绍
鼾声检测 示例工程包含在 语音视觉大模型AI开发板 SDK 的 apps/thinker_service目录下，工程目录名称为 snoring_net。
这个示例代码包含了以下操作：
- 通过麦克风录取音频
- 对录音数据经过前处理后，送入鼾声检测模型进行推理
- 将模型的推理结果通过串口进行输出打印
¶ 示例功能说明
该程序支持通过套件屏幕上显示的触摸界面使用，也可通过 UART 方式调用。
- 程序上电后会立刻开始录音，并分段送给 NPU 进行推理
- 观察串口日志，可得到当前分段为鼾声的概率（大于 0.5 可视为鼾声）
¶ 上手教程
¶ 1.准备工作：拉取并初始化 SDK
请参照《获取开发环境与SDK》进行大模型AI开发套件SDK的下载与初始化，若您之前已经操作过，可忽略本步骤。
建议您在开发前，参照《本地SDK更新》将SDK更新至最新版本。
¶ 2.编译示例工程
在 duomotai_ap 目录下，执行以下指令进行代码编译(以 Windows CMD 终端为例)：
lisa zep build -b csk6_duomotai_devkit apps\thinker_service\snoring_net -p
编译完成后，编译产物二进制文件为 build\zephyr\zephyr.bin
¶ 3.烧录固件
使用 Type-C 数据线连接开发套件的 DAP_USB接口，执行以下命令进行烧录：
cskburn desktop是一款聆思推出的桌面烧录工具，在下载并安装 cskburn desktop 烧录工具后，双击
图标运行软件：
1.点击串口下拉框，选择连接开发套件后识别到的串口编号；
2.将编译输出的.bin文件拖拽进烧录区域；
3.点击开始烧录，等待烧录完成。
若您已按照 《环境搭建》 教程完成开发环境的安装，可在编译完成后执行 lisa zep exec cskburn 指令完成烧录。
lisa zep exec cskburn -s \\.\COMxx -C 6 -b 1500000 0x000000 --verify-all .\build\zephyr\zephyr.bin
请将命令行中的的 COMx 替换为开发套件在 PC 上对应的串口号（可通过设备管理器查看）。例如：
COM3。
lisa zep exec cskburn -s PORT -C 6 0x000000 --verify-all ./build/zephyr/zephyr.bin -b 1500000
请将命令行中的 PORT 替换为开发套件连接在 PC 上对应的串口号。例如：
/dev/ttyUSB0。
¶ 4.复位运行
烧录完成后，程序将自动运行，你也可以通过按压开发板上的复位按键(RTS)进行复位运行，程序运行后，你可以运行串口工具，选择打开开发板对应的串口号 (波特率：115200)，可观察到每间隔2秒套件将对当前环境声音的检测结果：
当分数＞0 时，我们一般认为环境中可能存在鼾声，分数越接近1，可能性越大。
¶ 引脚使用
AP 串口日志TX：PA_3 波特率：115200
CP 串口日志TX：PA-4 波特率：921600
¶ 关键 API
| 功能 | 接口 |
|---|---|
| 音频系统初始化 | AudioSystem_initialize |
| 初始化鼾声检测网络模块 | snoring_net_init |
| 初始化gcs服务 | thinker_service_gcs_init |
| 启动gcs服务 | thinker_service_gcs_start |
| 内存块初始化 | fbank_init |
| 设置音频参数 | AudioSystem_setParameters |
| 创建和启动音频录制对象 | AudioRecord_start |
| 循环处理音频数据 | snoring_net_process |
¶ 相关内容与链接
| 项目 | 链接 |
|---|---|
| 本应用的配置与使用 | 可参照《功能体验》了解本应用的配置与使用方法。 |
| 在线串口终端的使用 | 可参照《聆思在线串口终端》了解在线串口终端更多的使用方法。 |
| 烧录工具的使用 | 可参照《cskburn桌面烧录工具》了解烧录工具更多的使用方法。 |
| 进阶开发 | 可参照《鼾声检测进阶开发》了解示例代码的关键业务流程与二次开发所需的关键接口。 |