OpusBWE.AXERA

AX650 上的 16 kHz → 48 kHz 音频超分 / 带宽扩展（Opus OSCE-BWE）。轻量、真流式：axmodel 288 KB + C++ 可执行 2.3 MB，逐 20 ms 帧因果推理，C++ 全链路 RTF 0.099（约 10× 实时）。

• HuggingFace: https://huggingface.co/HY-2012/opusBWE.AXERA
• GitHub: https://github.com/ZY-2012/opusBWE.AXERA
• 上游: https://github.com/xiph/opus

AX650 板端实测说明：AudioSR、LavaSR、FlowHigh、FastWave、OpusBWE 均已在 AX650N 板端跑通。

对比入口 GitHub: LavaSR · AudioSR · FlowHigh · FastWave HuggingFace: LavaSR · AudioSR · FlowHigh · FastWave

目录

• 快速开始
• 结果
• 推理速度
• 文件说明
• 数据来源
• License

快速开始（AX650 板端）

本仓库即完整包（models/ + bin/ + python/ + samples/），下载后在包根目录运行：

# C++（默认）
bash run_ax650.sh samples/listen/16k/speech_2_input_16k.wav output.wav

# Python 封装
bash run_ax650.sh samples/listen/16k/speech_2_input_16k.wav output.wav --python

输入必须是 16 kHz wav，输出固定 48 kHz。

结果

版本	输入（16 kHz）	OpusBWE.AXERA 输出（48 kHz）
speech_2	▶	▶
speech_3	▶	▶

16k → 48k 频谱对比（上：输入，下：输出）

推理速度：RTF

AX650（BSP V3.10.2），20 ms 一帧（320 → 960 点）：

链路	RTF
C++（NPU + Opus DSP）	0.099
Python 封装（同上）	≈ 0.10

文件说明

路径	内容
models/bwe_feature_net.axmodel	288 KB
bin/bwe_ax650	C++ 推理程序（aarch64，AX650）
python/demo.py	Python 封装
samples/	16 kHz 输入、48 kHz 输出、频谱图
config.json	{}

从源码编译（C++）

bash cpp/download_toolchains.sh   # Arm GNU 9.2 + AX650 BSP + Opus 源码 + BWE 权重（约 1.3 GB，仅一次）
bash cpp/build_ax650.sh           # -> bin/bwe_ax650

build_ax650.sh 在缺少工具链/BSP/源码时会自动调用 download_toolchains.sh。

数据来源

• 上游模型/代码：xiph/opus（BSD-3-Clause），OSCE-BWE 权重 bbwenet_v2.pth
• 16 kHz 示例：公开人声样例经 48k → 16k 降采样

License

Apache-2.0（本仓库代码）。上游 Opus 及 OSCE-BWE 模型为 BSD-3-Clause。