音频输入输出使用
Rhino Pi IQ9N 通过板载音频模组提供音频输入（MIC，经 AEC 接口接入）与音频输出（SPK ×2）能力。系统下音频设备以 ALSA 声卡形式暴露，可使用标准 ALSA 工具进行配置、播放与录音测试。
音频通道说明
| 通道 | 说明 |
|---|---|
| MIC（AEC 接口） | 4Mic Array 全向麦克风阵列，经 AEC 接口（WAFER-GH1.25-4PLB，信号 LINE_LP / LINE_LM / LINE_RP / LINE_RM）接入，支持唤醒、波束降噪、回声消除与定向收音 |
| SPK ×2 | 2 × 5W 扬声器输出，接口型号 WAFER-PH2.0-2PWB |
| AEC 参考通道 | 内部 USB2.0 音频通道，用于回声消除参考信号 |
音频模组支持 4/6 MIC 输入、VOIP 通话降噪，可实现 5m 远距离拾音，录音距离 1~5m 可调。
以上为规格值，实测指标以整机测试为准。
查看声卡与设备
bash
# 查看声卡与设备节点（板载声卡为 card 0）
aplay -l
arecord -l
cat /proc/asound/cards
# 查看 PipeWire 的音频设备与路由
wpctl status实测设备枚举结果如下：
| 项目 | 名称 | 说明 |
|---|---|---|
| 播放设备（ALSA） | card 0, device 0 | 板载播放设备，输出到 SPK 接口的 2 × 5W 扬声器 |
| 录音设备（ALSA） | card 0, device 2 | 板载数字麦克风，单声道，支持 8~48 kHz |
| 默认输出（PipeWire） | pal sink speaker ll | 音频默认输出到扬声器 |
| 默认输入（PipeWire） | pal source handset mic | 录音默认取自板载麦克风 |
注意
IQ9N 的音频由 PipeWire 统一管理。使用 aplay / arecord 时请不要用 -D hw:x,y 直接占用硬件， 否则会与 PipeWire 冲突并报 Device or resource busy；不带 -D 时命令会自动走 PipeWire 的默认输入与输出。
音量配置
bash
# 查看默认输出设备与当前音量
wpctl status
wpctl get-volume @DEFAULT_AUDIO_SINK@
# 设置默认输出音量（0.0 ~ 1.0）
wpctl set-volume @DEFAULT_AUDIO_SINK@ 0.8
# 也可通过 ALSA 直接调节板载智能功放（双路功放分别对应两路扬声器，取值范围 0~180）
amixer -c 0 sget 'aw_dev_0_volume'
amixer -c 0 sset 'aw_dev_0_volume' 80%
amixer -c 0 sset 'aw_dev_1_volume' 80%播放测试
bash
# 播放 wav 文件（走 PipeWire 默认输出）
aplay test.wav
# 或使用 PipeWire 播放工具
pw-play test.wav录音测试
板载麦克风为单声道，录音时需指定 -c 1：
bash
# 录制 5 秒 wav 文件（走 PipeWire 默认输入）
arecord -f S16_LE -c 1 -r 16000 -d 5 -t wav mic_test.wav
# 或使用 PipeWire 录音工具（按 Ctrl+C 结束）
pw-record --rate 16000 --channels 1 mic_test.wav
# 回放录音
aplay mic_test.wav切换输入 / 输出设备
当系统存在多路输入输出（如板载扬声器与耳机）时，可通过 PipeWire 切换默认设备：
bash
# 查看设备名称与 ID
wpctl status
# 将默认设备切换为指定 ID（示例）
wpctl set-default 44
# 调整默认输入音量
wpctl set-volume @DEFAULT_AUDIO_SOURCE@ 1.0注意事项
- 麦克风阵列与扬声器之间建议保持一定距离，避免拾音时产生啸叫。
- 使用 AEC 回声消除时，需保证参考信号通道与录音通道同时开启。
- 外接扬声器时请注意功率匹配，单路最大输出为 5W。
- 音频接口线材请使用 PH2.0 2Pin 规格，具体接口定义见接口定义与应用。
- 上述命令需在 AidLux 桌面（用户
aidlux）的终端中执行；在adb shell的 root 环境下访问不到 PipeWire，aplay/arecord会报Host is down。