> ## Documentation Index > Fetch the complete documentation index at: https://dragonwingdocs-staging.qualcomm.com/llms.txt > Use this file to discover all available pages before exploring further. # 音频 IQ-9075 音频子系统由 Low Power AI(LPAI)驱动,并通过 PipeWire 提供先进的语音 UI 和音频体验。 ## 主要特性 * 用于高效音频处理的 **Low Power 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 Graph Service;处理音频图的初始化和创建 | | **SPF** | 信号处理框架(Signal Processing Framework);LPAI DSP 上的模块化框架 | ## 配置文件 | 组件 | 位置 | | -------------- | ----------------------------------- | | ALSA 声卡注册 | `/proc/asound/cards` | | UCM2 配置文件 | `/usr/share/alsa/ucm2//` | | PipeWire 配置 | `/etc/pipewire/` | | WirePlumber 规则 | `/usr/share/wireplumber/` | ### 验证音频栈 ```bash theme={null} 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` 各显示一个设备。例如: ```text theme={null} 0 [ ]: - **** List of PLAYBACK Hardware Devices **** card 0: [], device 0: [] 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` 创建一个。 ```bash theme={null} scp test.wav ubuntu@:/home/ubuntu/ ``` ```bash theme={null} wpctl status # Find sink node marked with * wpctl set-default # If not already set wpctl set-volume @DEFAULT_AUDIO_SINK@ 1.0 ``` ```bash theme={null} pw-play /home/ubuntu/test.wav -v ``` 您应该能听到音频通过连接的扬声器播放,`pw-play` 在运行时会打印进度和峰值电平读数:

按 `Ctrl+C` 停止。 ### PipeWire 录制 ```bash theme={null} wpctl status # Find mic node marked with * wpctl set-default # If not already set wpctl set-volume @DEFAULT_AUDIO_SOURCE@ 1.0 ``` ```bash theme={null} pw-record /home/ubuntu/record.wav -v ``` 按 `Ctrl+C` 停止。值 `1.0` 表示 100% 音量。 ### GStreamer 音频 ```bash theme={null} # 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 ``` ```bash theme={null} # 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 ``` ## 日志采集 ```bash theme={null} # PipeWire logs journalctl --user -u pipewire journalctl --user -u wireplumber # Live debugging journalctl --user -u pipewire -f # Kernel audio driver logs sudo dmesg ``` ## 故障排除 ```bash theme={null} wpctl status wpctl set-volume @DEFAULT_AUDIO_SINK@ 1.0 systemctl --user restart wireplumber aplay -l ``` * 验证扬声器连接是否正确 * 如果音量为 0%,请调高音量 * 如果 PipeWire 路由不正确,请重启 WirePlumber ```bash theme={null} # 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 录音失败 → 首先应检查内核/设备树。 ```bash theme={null} # 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 缓冲区:** ```bash theme={null} 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 位立体声:** ```bash theme={null} ffmpeg -i input.wav -ar 48000 -ac 2 -sample_fmt s16 output.wav ``` ```bash theme={null} 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) ```bash theme={null} # 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 ``` 功能:自适应回声消除、平稳和非平稳噪声抑制、声学回声路径消除。 ## 资源 * [PipeWire 文档](https://docs.pipewire.org/) * [AudioReach GitHub](https://github.com/audioreach) * [AudioReach 文档](https://audioreach.github.io/)