音频 - 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	平台抽象层(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`
WirePlumber 规则与配置	`/usr/share/wireplumber/`

验证音频栈

# Confirm ALSA card and devices
cat /proc/asound/cards
aplay -l
arecord -l
# Confirm PipeWire + WirePlumber services
systemctl  status pipewire wireplumber --no-pager
# Validate default sink/source
wpctl status
# Monitor graph
pw-top
pw-cli ls Node

音频播放与录制

PipeWire 播放

将音频文件推送到设备

scp test.wav root@<ip-addr>:/opt/

设置默认 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 /opt/test.wav -v

命令行界面应类似如下:

按 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 /opt/record.wav -v

命令行界面应类似如下:

按 Ctrl+C 停止。

值 1.0 表示 100% 音量。

GStreamer 音频

采集
播放

# PCM capture
gst-launch-1.0 -v pulsesrc volume=10 ! audioconvert ! wavenc ! \
  filesink location=/opt/audio.wav
# FLAC capture
gst-launch-1.0 -v pulsesrc volume=10 ! audioconvert ! flacenc ! \
  filesink location=/opt/audio.flac

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

# MP3 playback
gst-launch-1.0 -e filesrc location=/opt/audio.mp3 ! \
  mpegaudioparse ! mpg123audiodec ! pulsesink volume=10
# FLAC playback
gst-launch-1.0 -e filesrc location=/opt/audio.flac ! \
  flacparse ! flacdec ! pulsesink volume=10

日志采集

# PipeWire logs
journalctl  -u pipewire
journalctl  -u wireplumber
# Live debugging
journalctl -u pipewire -f
# Kernel audio driver logs
sudo dmesg

故障排除

播放时没有音频输出

wpctl status
wpctl set-volume @DEFAULT_AUDIO_SINK@ 1.0
systemctl restart pipewire pipewire-pulse wireplumber
pw-play /opt/test.wav -v
# Check services
systemctl status pipewire pipewire-pulse wireplumber

音频播放卡顿或有杂音

# 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  restart pipewire wireplumber

修复 — 将音频转换为 48 kHz 16 位立体声:

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

PipeWire 服务无法启动

systemctl status pipewire pipewire-pulse wireplumber
journalctl -u pipewire -u wireplumber -b
# Reset configuration
rm -rf ~/.config/pipewire ~/.config/wireplumber
systemctl  daemon-reload
systemctl restart pipewire pipewire-pulse wireplumber
# Reinstall if needed
sudo apt install --reinstall pipewire wireplumber pipewire-pulse

高级功能

用于 VoIP 的回声消除(ECNS)

# VoIP record
pw-record /opt//record_voip.wav -v --target=voip-tx0
# VoIP playback
pw-play /opt/record_voip.wav -v --target=voip-rx0

功能:自适应回声消除、平稳与非平稳噪声抑制、声学回声路径消除。

IQ-8275 EVK

音频

主要特性

硬件配置

架构

配置文件

验证音频栈

音频播放与录制

PipeWire 播放

PipeWire 录制

GStreamer 音频

日志采集

故障排除

高级功能

用于 VoIP 的回声消除(ECNS)

资源

​主要特性

​硬件配置

​架构

​配置文件

​验证音频栈

​音频播放与录制

​PipeWire 播放

​PipeWire 录制

​GStreamer 音频

​日志采集

​故障排除

​高级功能

​用于 VoIP 的回声消除(ECNS)

​资源

主要特性

硬件配置

架构

配置文件

验证音频栈

音频播放与录制

PipeWire 播放

PipeWire 录制

GStreamer 音频

日志采集

故障排除

高级功能

用于 VoIP 的回声消除(ECNS)

资源