音频 - Qualcomm Dragonwing Documentation

IQ-8275 音频子系统由低功耗 AI（LPAI）驱动，并通过 PipeWire 提供先进的语音 UI 和音频体验。

主要特性

低功耗 AI（LPAI） 子系统，实现高效的音频处理
PipeWire 多媒体服务器，实现低延迟音频路由
硬件加速编码/解码
Fluence ECNS — 先进的回声消除和噪声抑制
多种音频接口 — I2S、TDM、SoundWire

硬件配置

扬声器： 板载 MAX98357 I2S 功放；连接随附的两个迷你扬声器即可听到输出。HS0_MI2S 由左右声道共用以实现立体声。
麦克风： HS2_MI2S 上的单个板载麦克风（MMICT5848），默认配置为左声道 扬声器连接：

架构

组件	说明
PipeWire	多媒体服务器；替代 PulseAudio；低延迟、灵活的媒体处理
WirePlumber	会话/策略管理器；处理默认 sink/source 和自动连接规则
PAL	平台抽象层；提供音频专用 API 和 DSP 图操作
AGM	音频图管理器；基于 ALSA 的混音器控制和 PCM/压缩插件
ARGS/GSL	AudioReach 图服务；处理音频图的初始化和创建
SPF	信号处理框架；LPAI DSP 上的模块化框架

配置文件

组件	位置
ALSA 声卡注册	`/proc/asound/cards`
UCM2 配置文件	`/usr/share/alsa/ucm2/<card-name>/`
PipeWire 配置	`/etc/pipewire/`
WirePlumber 规则	`/usr/share/wireplumber/`

验证音频栈

cat /proc/asound/cards                                   # List registered ALSA sound cards
aplay -l                                                 # List playback (output) devices
arecord -l                                               # List capture (input) devices
systemctl --user status pipewire wireplumber --no-pager  # Confirm the audio services are active
wpctl status                                             # Show the default sink/source and routing
pw-top                                                   # Live view of the audio graph (Ctrl+C to exit)

预期结果： /proc/asound/cards 至少列出一个声卡，并且 aplay -l 和 arecord -l 各显示一个设备。例如：

 0 [<card-name>     ]: <driver> - <card description>
                       <card long name>

**** List of PLAYBACK Hardware Devices ****
card 0: <card-name> [<card description>], device 0: <pcm-name> []
  Subdevices: 1/1

wpctl status 应列出一个默认的 Sink 和 Source（各自以 * 标记）。如果 /proc/asound/cards 为空，或者 wpctl status 未显示默认的 sink 或 source，则说明音频栈未正常启动：请参见下面的故障排除部分。

音频播放和采集

PipeWire 播放

将音频文件推送到设备

将一段简短的测试音频复制到设备，以便有可播放的内容。test.wav 可以是任何小的 PCM WAV 文件（48 kHz、16 位立体声效果很好）：可以使用主机上的文件，或者用 ffmpeg -f lavfi -i "sine=frequency=440:duration=5" -ar 48000 -ac 2 test.wav 创建一个。

scp test.wav ubuntu@<ip-addr>:/home/ubuntu/

设置默认 sink 和音量

wpctl status
wpctl set-default <sink-node>
wpctl set-volume @DEFAULT_AUDIO_SINK@ 1.0

播放音频

pw-play /home/ubuntu/test.wav -v

您应该能听到音频通过连接的扬声器播放，并且 pw-play 在运行时会打印进度和峰值电平读数。按 Ctrl+C 停止。

PipeWire 录音

设置默认 source 和音量

wpctl status
wpctl set-default <mic-node>
wpctl set-volume @DEFAULT_AUDIO_SOURCE@ 1.0

开始录音

pw-record /home/ubuntu/record.wav -v

按 Ctrl+C 停止。

1.0 表示 100% 音量。

GStreamer 音频

采集
播放

gst-launch-1.0 -v pulsesrc volume=10 ! audioconvert ! wavenc ! \
  filesink location=/home/ubuntu/audio.wav

gst-launch-1.0 -e filesrc location=/home/ubuntu/audio.wav ! \
  wavparse ! audioconvert ! pulsesink volume=10

gst-launch-1.0 -e filesrc location=/home/ubuntu/audio.mp3 ! \
  mpegaudioparse ! mpg123audiodec ! pulsesink volume=10

故障排除

播放时没有音频输出

wpctl status
wpctl set-volume @DEFAULT_AUDIO_SINK@ 1.0
systemctl --user restart wireplumber
aplay -l

麦克风没有音频采集

arecord -l
arecord -D hw:0,0 -f S16_LE -r 48000 test.wav
pw-cli ls Node | grep -i source
systemctl --user status pipewire pipewire-pulse wireplumber

音频播放卡顿或有杂音

pw-metadata -n settings
pw-top

修复 — 增大 PipeWire 缓冲区：

mkdir -p ~/.config/pipewire/pipewire.conf.d
cat > ~/.config/pipewire/pipewire.conf.d/99-custom-buffer.conf << 'EOF'
context.properties = {
    default.clock.quantum = 1024
    default.clock.min-quantum = 1024
}
EOF
systemctl --user restart pipewire wireplumber

PipeWire 服务无法启动

systemctl --user status pipewire pipewire-pulse wireplumber
rm -rf ~/.config/pipewire ~/.config/wireplumber
systemctl --user daemon-reload
systemctl --user restart pipewire pipewire-pulse wireplumber

​主要特性

​硬件配置

​架构

​配置文件

​验证音频栈

​音频播放和采集

​PipeWire 播放

​PipeWire 录音

​GStreamer 音频

​故障排除

​资源

主要特性

硬件配置

架构

配置文件

验证音频栈

音频播放和采集

PipeWire 播放

PipeWire 录音

GStreamer 音频

故障排除

资源