¶ arcs-mini 获取 麦克风录音 PCM 数据 + 扬声器播音 PCM 数据
¶ 前言
本文目标：
- 帮助您使用
tools/audio/serial_capture_gui.py在 PC 端抓取录音的音频数据并保存文件。 - 通过 UAC 获取到播放链路的 PCM 数据，并保存文件。
¶ 一、获取 MIC 录音 PCM 数据
¶ 1. PC 端环境
安装 Python 依赖：
pip3 install pyserial numpy matplotlib
如果 tkinter 缺失（部分 Linux 发行版会缺）：
sudo apt-get install python3-tk
¶ 2. 固件侧要求（启用 CDC ）
serial_capture_gui.py 走的是 USB CDC 协议录音链路，固件需支持 CDC 录音协议（开始/停止录音命令、音频帧、MD5帧）。
修改配置文件 ./apps/arcs-mini/prj.conf ，添加如下配置：
CONFIG_APP_USB_CDC_ENABLE=y
参考文档《Arcs-Mini 开发环境搭建指南》，重新编译固件并烧录。
¶ 3. 启动 GUI 工具
在工程根目录执行：
python3 tools/audio/serial_capture_gui.py
或先进入目录再运行：
cd tools/audio
python3 serial_capture_gui.py
¶ 4. GUI 参数怎么填（新手推荐）
- 串口：
- Linux 常见：
/dev/ttyACM0、/dev/ttyACM1 - Windows 常见：
COM3、COM4
- Linux 常见：
- 波特率：先用默认
921600（若连不上可试115200） - 采样率：
16000 - 位深：
16 - 通道数：
1（如固件发送多通道，再改对应值） - 保存文件：勾选
- 输出文件：建议先用
xxx.pcm
注意：该工具保存的是 PCM 原始数据。即使文件名写成
.wav，内容也不是标准 WAV 头格式。
¶ 5. 录音操作流程
- 接好设备 USB，确认串口号。
- 打开 GUI，填好参数。
- 点击“开始录音”。
- 对设备说话/播放音频，观察实时波形。
- 点击“停止录音”。
- 查看底部状态：优先确认
MD5校验通过。 - 到输出路径检查文件是否生成。
¶ 6. PCM 转 WAV（推荐）
用 ./tools/tone_tool/cmd/ffmpeg-64 转换（16k/16bit/单声道示例）：
ffmpeg-64 -f s16le -ar 16000 -ac 1 -i output.pcm output.wav
如果是多通道，把 -ac 1 改成你的实际通道数（例如 -ac 4）。
¶ 7. 常见问题
¶ 7.1 点“开始录音”后没数据
- 串口号不对
- 设备未枚举成功
- 固件未启用 CDC 录音协议
¶ 7.2 有文件但播放全是噪音
- PCM 参数不匹配（采样率/位深/通道数）
- 把 PCM 当 WAV 直接播放了（未转换）
¶ 7.3 MD5 校验失败
- 传输过程有丢包/异常
- 串口连接不稳定
¶ 二、 获取扬声器 播音 PCM 数据
¶ 1. 配置 UAC
配置文件 ./apps/arcs-mini/prj.conf 增加如下配置：
CONFIG_APP_USB_AUDIO_ENABLE=y
¶ 2. 修改通道数
./src/middleware/usb/tusb_config.h 文件做出如下修改：
¶ 3. audio_play.c 增加镜像上报代码
./src/middleware/audio/audio_play.c 在 lisa_audio_play_write(...) 返回后，增加以下代码：
if (data != NULL && size > 0) {
uint32_t sample_count = (uint32_t)ret;
extern int app_usb_audio_write(void *data, uint32_t sample, uint32_t channel, uint8_t bit);
app_usb_audio_write(data, sample_count, 1, 16);
}
¶ 4. 可使用 PC 端的录音软件进行录音
