File size: 3,626 Bytes
759d0dd 8784afc 09bc000 8784afc 09bc000 8784afc 09bc000 | 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 | # openWakeWord C++ 推理
本目录提供 AX650 和 AX630C C++ 推理程序。WAV、STFT、mel 和缓存更新在 CPU
端完成，embedding 与 classifier 使用对应平台的 `axmodel`。
## 编译环境
AX650 与 AX630C 共用 Arm GNU 9.2 AArch64 交叉编译器：
```bash
mkdir -p cpp/toolchains
wget -P cpp/toolchains \
https://developer.arm.com/-/media/Files/downloads/gnu-a/9.2-2019.12/binrel/gcc-arm-9.2-2019.12-x86_64-aarch64-none-linux-gnu.tar.xz
tar -xf cpp/toolchains/gcc-arm-9.2-2019.12-x86_64-aarch64-none-linux-gnu.tar.xz \
-C cpp/toolchains
```
下载 BSP：
```bash
bash cpp/download_bsp.sh all
```
| 平台 | BSP 压缩包 | 编译目录 |
| --- | --- | --- |
| AX650 | `msp_50_3.10.2.zip` | `cpp/toolchains/ax650n_bsp_sdk/msp/out` |
| AX630C | `msp_20e_3.0.0.zip` | `cpp/toolchains/ax620e_bsp_sdk/msp/out/arm64_glibc` |
## 交叉编译
```bash
export TOOLCHAIN_ROOT="cpp/toolchains/gcc-arm-9.2-2019.12-x86_64-aarch64-none-linux-gnu"
bash cpp/build_ax650.sh
bash cpp/build_ax630c.sh
```
生成：
```text
cpp/bin/openwakeword_ax650
cpp/bin/openwakeword_ax630c
```
如 BSP 放在其他位置，可设置 `BSP_MSP_DIR`。AX650 应指向包含 `include/` 和
`lib/` 的 `msp/out`；AX630C 应指向 `msp/out/arm64_glibc`。
## 板端运行
AX650 单条推理：
```bash
AUDIO=audio/openwakeword/alexa_test.wav \
bash cpp/run_openwakeword_ax650.sh
```
AX630C 单条推理：
```bash
AUDIO=audio/openwakeword/alexa_test.wav \
bash cpp/run_openwakeword_ax630c.sh
```
批量测试：
```bash
THRESHOLD=0.5 bash cpp/run_batch_openwakeword_ax650.sh
THRESHOLD=0.5 bash cpp/run_batch_openwakeword_ax630c.sh
```
模型目录必须与平台对应：
```text
models/650/
models/630C/
```
运行脚本会检查 embedding 和 6 个 classifier 模型，避免误用其他平台的 axmodel。
输入音频必须为 16 kHz、单声道、16-bit PCM WAV。
单条推理会输出 classifier 分数和 `WAKEUP`，并只输出一个 `rtf`。`rtf` 包含
CPU mel 和 NPU 推理，不包含一次性模型加载与初始化。
阈值可通过环境变量调整：
```bash
THRESHOLD=0.6 AUDIO=audio/openwakeword/hey_mycroft_test.wav \
bash cpp/run_openwakeword_ax630c.sh
```
## 二次开发（共享库）
编译产物除可执行文件外，还包含共享库：
```text
cpp/lib/ax650/libopenwakeword_ax.so # AX650
cpp/lib/ax630c/libopenwakeword_ax.so # AX630C
cpp/include/openwakeword_ax.hpp # 公共 API 头文件
```
在自己的 CMake 工程中链接：
```cmake
add_library(openwakeword_ax SHARED IMPORTED)
set_target_properties(openwakeword_ax PROPERTIES
IMPORTED_LOCATION "${CMAKE_CURRENT_SOURCE_DIR}/cpp/lib/ax650/libopenwakeword_ax.so")
target_include_directories(your_app PRIVATE cpp/include)
target_link_libraries(your_app PRIVATE openwakeword_ax)
```
最小使用示例：
```cpp
#include "openwakeword_ax.hpp"
openwakeword::WakeWordDetector detector(
"models/650", // axmodel 目录
"config/openwakeword_mel_weights.bin", // CPU mel 权重
0.5f); // 阈值
// 每 80ms 喂一帧 1280 个 int16 样本（16 kHz）
openwakeword::FrameResult result = detector.ProcessFrame(pcm_frame);
for (std::size_t i = 0; i < result.names.size(); ++i) {
printf("%s max_score=%.4f\n", result.names[i].c_str(),
result.max_scores[i]);
}
if (result.any_triggered) { /* 唤醒 */ }
detector.Reset(); // 新会话时清空流式状态
```
板端运行时需提供 BSP 动态库路径（AX650 通常为 `/soc/lib`，AX630C 为
`/opt/lib`）：
```bash
export LD_LIBRARY_PATH=/soc/lib:${LD_LIBRARY_PATH}
```
|