音频 - Qualcomm Dragonwing Documentation

IQ-9075 音频子系统由低功耗 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	平台抽象层（Platform Abstraction Layer）；提供音频专用 API 和 DSP 图操作
AGM	音频图管理器（Audio Graph Manager）；基于 ALSA 的混音器控制和 PCM/压缩插件
ARGS/GSL	AudioReach 图服务（AudioReach Graph Service）；处理音频图的初始化和创建
SPF	信号处理框架（Signal Processing Framework）；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)
pw-cli ls Node                                           # List PipeWire nodes

预期结果： /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   # Find sink node marked with *
wpctl set-default <sink-node>   # If not already set
wpctl set-volume @DEFAULT_AUDIO_SINK@ 1.0

播放音频

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

你应该能通过连接的扬声器听到该音频片段，且 pw-play 在运行时会打印进度和峰值电平读数：

按 Ctrl+C 停止。

PipeWire 录制

设置默认 source 和音量

wpctl status   # Find mic node marked with *
wpctl set-default <mic-node>   # If not already set
wpctl set-volume @DEFAULT_AUDIO_SOURCE@ 1.0

开始录制

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

按 Ctrl+C 停止。

值 1.0 表示 100% 音量。

GStreamer 音频

录制
播放

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

# FLAC capture
gst-launch-1.0 -v pulsesrc volume=10 ! audioconvert ! flacenc ! \
  filesink location=/home/ubuntu/audio.flac

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

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

# FLAC playback
gst-launch-1.0 -e filesrc location=/home/ubuntu/audio.flac ! \
  flacparse ! flacdec ! pulsesink volume=10

日志采集

# PipeWire logs
journalctl --user -u pipewire
journalctl --user -u wireplumber

# Live debugging
journalctl --user -u pipewire -f

# Kernel audio driver logs
sudo dmesg

故障排查

播放时无音频输出

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

确认扬声器连接正确
如果音量为 0%，请调高音量
如果 PipeWire 路由不正常，请重启 WirePlumber

麦克风无音频采集

# Check ALSA capture devices
arecord -l
dmesg | grep -i "snd\|audio\|asoc"

# Test raw ALSA recording (bypass PipeWire)
arecord -D hw:0,0 -f S16_LE -r 48000 test.wav
aplay test.wav

# Check PipeWire capture nodes
pw-cli ls Node | grep -i source

# Check services
systemctl --user status pipewire pipewire-pulse wireplumber

如果 ALSA 采集失败 → 应首先检查内核/DT。

音频播放卡顿或有爆音

# Check CPU load
top

# Check PAL media config (expect rate=48000, ch=2, fmt=2)
grep "setDeviceMediaConfig" /var/log/syslog

# Check for underruns
dmesg | grep -i -e underrun -e xrun -e lpass -e audio

# Check PipeWire quantum
pw-metadata -n settings

# Monitor real-time
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

解决方案 — 将音频转换为 48 kHz 16 位立体声：

ffmpeg -i input.wav -ar 48000 -ac 2 -sample_fmt s16 output.wav

PipeWire 服务无法启动

systemctl --user status pipewire pipewire-pulse wireplumber
journalctl --user -u pipewire -u wireplumber -b

# Reset configuration
rm -rf ~/.config/pipewire ~/.config/wireplumber
systemctl --user daemon-reload
systemctl --user restart pipewire pipewire-pulse wireplumber

# Reinstall if needed
sudo apt install --reinstall pipewire wireplumber pipewire-pulse

高级特性

面向 VoIP 的回声消除（ECNS）

# VoIP record
pw-record /home/ubuntu/record_voip.wav -v --target=voip-tx0

# VoIP playback
pw-play /home/ubuntu/record_voip.wav -v --target=voip-rx0

特性：自适应回声消除、平稳与非平稳噪声抑制、声学回声路径消除。

IQ-9075 EVK

音频

主要特性

硬件配置

架构

配置文件

验证音频栈

音频播放与录制

PipeWire 播放

PipeWire 录制

GStreamer 音频

日志采集

故障排查

高级特性

面向 VoIP 的回声消除（ECNS）

资源

​主要特性

​硬件配置

​架构

​配置文件

​验证音频栈

​音频播放与录制

​PipeWire 播放

​PipeWire 录制

​GStreamer 音频

​日志采集

​故障排查

​高级特性

​面向 VoIP 的回声消除（ECNS）

​资源

主要特性

硬件配置

架构

配置文件

验证音频栈

音频播放与录制

PipeWire 播放

PipeWire 录制

GStreamer 音频

日志采集

故障排查

高级特性

面向 VoIP 的回声消除（ECNS）

资源