高级音频功能 - Qualcomm Dragonwing Documentation

最大限度地减少回声和噪声

回声和噪声问题是 VoIP 系统中常见的问题。语音从远端扬声器发出，并经过时延后回声，从而造成感知问题。回声消除可减少通信期间来自远端扬声器的回声。噪声抑制可减少来自麦克风通道的噪声。SMECNS 回声消除和噪声抑制（ECNS）算法可提供平稳和非平稳噪声抑制以及回声消除。声学回声是指由于设备的扬声器和麦克风之间的声学路径（声学耦合）而产生的回声。这对免提和电话会议应用非常重要。下图显示了声学回声路径以及扬声器和麦克风之间如何发生声学回声。

噪声与声学回声

近端语音信号远端语音信号近端扬声器环境噪声声学回声路径声学回声近端语音远端语音噪声与声学回声

回声消除器 – 一种自适应滤波器，可自我调整系数以消除回声。每个回声都有一个回声路径，并由脉冲响应表征。回声消除器可以自适应网络回声路径，从而消除回声。
噪声抑制 – 单麦克风回声消除器和噪声抑制器（SMECNS）在嘈杂环境中使用设备时，有助于抑制周围的平稳噪声。

为录音启用 SMECNS

录音时，SMECNS 通过抑制麦克风采集到的背景噪声来保持录音路径中的语音质量。对于单麦克风录音，仅支持平稳噪声抑制。平稳噪声是指频率不随时间变化的噪声，例如道路噪声或白噪声。下图显示了如何使用增益、SMECNS 和后处理模块来去除外部噪声和回声，从而输出清晰的语音。

用于录音的 SMECNS 软件块

用于录音的 SMECNS 软件块要在录音路径中启用 SMECNS：

使用 wpctl status 命令列出可用节点。

systemctl stop pipewire wireplumber pipewire.socket pipewire-manager.socket

chmod 777 /dev/dma_heap/system

systemctl start pipewire wireplumber

wpctl status

运行 wpctl set-default 将源节点设置为手持麦克风。
wpctl set-default <sink/source node ID>
运行 pw-record 开始录音。以下示例以详细模式运行，并将录音保存到 /opt/test.wav。
pw-record /opt/test.wav -v

模拟 VoIP

要使用 PipeWire 模拟 VoIP：

设置录音源

pw-record /opt/record_voip.wav -v --target=voip-tx0

设置播放接收端

pw-play /opt/test.wav -v --target=voip-rx0

请务必将 PCM 文件（<FileName>.wav）推送到 /opt/ 文件夹。

启用单流多设备播放

配置平台以同时在多个输出设备（例如内置扬声器和有线耳机）上呈现单个音频流。在此模式下，音频会被复制，同一解码音频流会同时路由到多个活动输出设备，确保所有选定端点之间的同步播放。

列出可用的音频节点。
wpctl status

wpctl status output showing available PAL sink and source nodes

wpctl status 输出显示了可用的 PAL 接收端和源节点

设置默认节点。
wpctl set-default <NUMBER for low-latency>
- 对于低延迟，选择带有 pal sink combined speaker and headset ll 的节点。
- 对于深度缓冲，选择带有 pal sink combined speaker and headset db 的节点。
开始播放。
pw-play /tmp/yesterday_48KHz.wav -v

启用多流多设备播放

配置平台以同时在不同的输出设备（例如内置扬声器和有线耳机）上呈现多个独立的音频流。在此模式下，每个音频流都是独立管理和路由的，允许不同的流同时传送到不同的输出设备而不会互相干扰。这样可实现例如跨多个端点的并行媒体播放和通知路由等用例。

列出可用的音频节点。
pw-cli ls Node
选择要在其上播放多个流的音频节点，并使用 --target 命令行选项指定这些节点名称。

启动低延迟播放。

pw-play --target=pal_sink_speaker_ll /opt/clip1.wav -v

pw-play --target=pal_sink_headset_ll /opt/clip2.wav -v

使用 PipeWire 进行动态设备切换

使用 wpctl 在音频活动时触发动态设备切换。

列出所有可用的音频节点。
wpctl status
在默认设备（例如扬声器）上开始播放。
pw-play /opt/test.wav -v
在播放期间，通过设置新的默认接收端切换到不同的输出设备（例如耳机）。
wpctl set-default <headset sink node ID>
WirePlumber 会重新路由流，PAL 会无缝执行设备切换。

启用 DP 和 HDMI 音频

本节适用于 QCS6490 (Kodiak) 和 IQ-9075 (Lemans) 平台（config1）。

设置 QCS6490 (rb3-gen2-core-kit)

将拓扑二进制文件复制到固件路径。

cp \\sphere\CasaBuilds\QLI\Topology\QCS6490\QCS6490-RB3Gen2-tplg.bin /lib/firmware/qcom/qcs6490/

复制 HiFi 配置文件。

cp \\sphere\CasaBuilds\QLI\Topology\QCS6490\HiFi.conf.kodiak /usr/share/alsa/ucm2/Qualcomm/qcs6490/QCS6490-RB3Gen2/HiFi.conf

复制 HDMI 格式配置文件。

cp \\sphere\CasaBuilds\QLI\Topology\QCS6490\51-hdmi-format.conf /usr/share/wireplumber.conf.d/51-hdmi-format.conf

重启设备。启动时，确保 DP 已连接（typeC 转 HDMI 母头 + HDMI 转 HDMI 线缆）。
reboot

HDMI 和 DP 音频播放 (QCS6490)

HDMI 音频播放	DP 音频播放
`amixer -c 0 cset iface=MIXER,name='SECONDARY_MI2S_RX Audio Mixer MultiMedia3' 1`	`amixer -c 0 cset iface=MIXER,name='DISPLAY_PORT_RX_0 Audio Mixer MultiMedia4' 1`
`aplay -D plughw:0,2 /home/test.wav`	`aplay -D plughw:0,3 /home/test.wav`
`wpctl set-default <node>`	`wpctl set-default <node>`
`pw-play -v /home/test.wav`	`pw-play -v /home/test.wav`

设置 IQ-9075 (iq-9075-evk)

将拓扑二进制文件复制到固件路径。

cp \\sphere\CasaBuilds\QLI\Topology\IQ-9075\LEMANS-EVK-tplg.bin /lib/firmware/qcom/sa8775p/

复制 HiFi 配置文件。

cp \\sphere\CasaBuilds\QLI\Topology\IQ-9075\HiFi.conf.lemans /usr/share/alsa/ucm2/Qualcomm/sa8775p/lemans-evk/HiFi.conf

重启设备。启动时，确保 DP 已连接（eDP 转 DP 线缆）。
reboot

DP 音频播放 (IQ-9075)

DP 音频播放
`amixer -c 0 cset iface=MIXER,name='DISPLAY_PORT_RX_0 Audio Mixer MultiMedia3' 1`
`aplay -D plughw:0,2 /home/test.wav`
`wpctl set-default <node>`
`pw-play -v /home/test.wav`

后续步骤

Audio Addendum — 使用 QACT 和 QXDM 进行校准和诊断
故障排除音频 — 捕获并分析音频日志以解决问题
自定义音频图 — 修改音频图和 PAL 配置

​最大限度地减少回声和噪声

​为录音启用 SMECNS

​模拟 VoIP

​启用单流多设备播放

​启用多流多设备播放

​使用 PipeWire 进行动态设备切换

​启用 DP 和 HDMI 音频

​设置 QCS6490 (rb3-gen2-core-kit)

​设置 IQ-9075 (iq-9075-evk)

​后续步骤

最大限度地减少回声和噪声

为录音启用 SMECNS

模拟 VoIP

启用单流多设备播放

启用多流多设备播放

使用 PipeWire 进行动态设备切换

启用 DP 和 HDMI 音频

设置 QCS6490 (rb3-gen2-core-kit)

设置 IQ-9075 (iq-9075-evk)

后续步骤