定位和求解Debian 13 下 PipeWire 无声问题

1. 问题背景与环境描述

张老师曾说过，声音问题是很难调试的问题。最近在将基于 Rockchip RK3588 的幽兰代码本升级至 Debian 13 (Trixie)时，又遇到声音问题，印证了张老师的话。今天的大多数桌面环境通常会默认采用 PipeWire 替代传统的 PulseAudio。

然而，由于ARM 生态中的声卡驱动（ASoC）与 PC 架构（HDA Intel）存在巨大差异，使用ARM硬件的用户常遇到“无声”问题。典型的症状是系统可以识别到底层 ALSA 设备，但 PipeWire 无法将其抽象为可用的“接插器”（Sink），导致桌面音量图标失效，无法播放声音。

2. 故障现场还原

2.1 用户态表现：有设备无输出

使用 PipeWire 的控制工具 wpctl 查看当前音频状态：

$ wpctl status
PipeWire 'pipewire-0' [default]
 └─ Clients:
        31. WirePlumber                         [0.5.2, user@debian, pid:1234]

Audio
 ├─ Devices:
 │      40. Built-in Audio (ES8388)             [alsa]
 │      41. Rockchip HDMI                       [alsa]
 │
 ├─ Sinks:
 │      * (No sinks found)   <-- 异常：没有输出节点
 │
 ├─ Sources:
 │      * (No sources found) <-- 异常：没有输入节点

上面的显示结果表名系统中虽然有两个声音设备，但是却缺少与它们接口的接插件，这正是本文所探讨的主要问题。

尝试播放音频，直接报错：

$ pw-play test.wav
remote 0x...: error: "no audio output found"

2.2 核心日志分析 (journalctl)

为了找到根因，最先应该查看 WirePlumber（PipeWire 的会话管理器）的日志：

journalctl --user -u wireplumber -b 0 --no-pager

捕获到的关键错误：

[W][00:00:05.123] mod.alsa.udev-detect | [alsa-udev.c:620 find_card()] alsa-udev: card 0: Rockchip-ES8388 [rockchip-es8388]: no profiles found
[E][00:00:05.124] m-lua-scripting      | [script/alsa/alsa-monitor.lua:185] <WpSiAudioAdapter> Object activation failed: SPA handle factory 'api.alsa.acp.device' not found or load failed

上文日志中的如下这句极为关键：

card 0: Rockchip-ES8388 [rockchip-es8388]: no profiles found

3. 根因深度解析：嵌入式音频的“方言”问题

为什么会出现 no profiles found？

1. 1. ALSA UCM 缺失：

PC 声卡通常符合 HDA 标准，PipeWire 可以自动探测。但 RK3588 的声卡是非常底层的 I2S 设备，它依赖 UCM (Use Case Manager) 配置文件来告诉用户态如何操作 Mixer（例如：打开哪个开关是扬声器，哪个是耳机）。Debian 上游仓库通常不包含特定开发板的 UCM 文件。

1. 2. ACP 探测失败：

当 UCM 缺失时，PipeWire 会回退到 ACP (ALSA Card Profiles) 机制尝试“猜测”设备功能。但 RK3588 的声卡驱动暴露的控制项（Controls）往往不标准，导致 ACP 无法构建出立体声（Stereo）或 5.1 声道配置，最终放弃接管该设备。

1. 3. WirePlumber 版本变迁：

Debian 13 引入了 WirePlumber 0.5。这个版本废弃了旧的 Lua 配置文件，改用了新的 SPA-JSON 格式。网上大部分关于“修改 alsa-monitor.lua”的教程在 Debian 13 上完全失效。

4. 解决方案：强制开启 Pro Audio 模式

既然自动探测失败，我们需要手动告诉 PipeWire：“不要尝试去理解这个声卡的高级功能，直接把它的 PCM 通道全部暴露出来。” 这就是 Pro Audio 模式。

步骤一：安装完整依赖

确保 Debian 的 PipeWire 组件是完整的，特别是 ALSA 插件。

sudo apt update
sudo apt install pipewire pipewire-audio wireplumber pipewire-pulse \
    pipewire-alsa libspa-0.2-alsa alsa-utils

步骤二：创建 WirePlumber 0.5 规则文件

我们需要在用户配置目录中添加一条规则，强制匹配 Rockchip 声卡并应用 Pro Audio 配置。

1. 1. 创建配置目录：

mkdir -p ~/.config/wireplumber/wireplumber.conf.d/

1. 2. 创建配置文件：

nano ~/.config/wireplumber/wireplumber.conf.d/51-force-rk3588.conf

1. 3. 写入配置内容 (SPA-JSON 格式)：

注意：这是 WirePlumber 0.5+ 的新语法，不要填入 Lua 代码。

monitor.alsa.rules = [
{
    matches = [
      {
        # 使用通配符匹配所有包含 rockchip 名字的 ALSA 设备
        # 这通常能覆盖 ES8388 (耳机/喇叭) 和 HDMI 音频
        "device.nick" = "~rockchip.*"
      }
    ]
    actions = {
      update-props = {
        # 关键：绕过 ACP/UCM 探测，直接使用 Pro Audio
        "api.alsa.use-acp" = true
        "api.alsa.use-ucm" = true
        "device.profile" = "pro-audio"
        
        # 关闭自动 Profile 选择，防止被覆盖
        "api.acp.auto-profile" = false
      }
    }
}
]

步骤三：重启音频服务

无需重启系统，重载用户态服务即可生效。

systemctl --user restart wireplumber pipewire pipewire-pulse

步骤四：验证修复结果

1. 1. 检查状态：

wpctl status

现在你应该能看到 Sinks 下出现了设备：

Audio
 ├─ Devices:
 │
 ├─ Sinks:
 │  *   30. Builtin speaker of YourLand         [vol: 1.00]
 │      31. HDMI/Display Port1 Stereo of YourLand [vol: 1.00]
 │
 ├─ Sink endpoints:
 │
 ├─ Sources:
 │  *   29. Builtin microphone of YourLand      [vol: 1.00]
 │
 ├─ Source endpoints:
 │
 └─ Streams:

1. 2. 测试声音：

# 测试左声道（粉红噪声）
speaker-test -D pipewire -c 2 -l 1 -t pink

5. 总结

在 Debian 13 (RK3588) 上解决 PipeWire 无声问题的关键逻辑如下：

1. 1. 现象：wpctl status 显示无 Sinks，日志报错 no profiles found。

2. 2. 原理：嵌入式声卡缺少 UCM 描述文件，导致标准探测逻辑失效。

3. 3. 手段：利用 WirePlumber 0.5 的规则引擎（SPA-JSON），强制将设备置于 pro-audio 模式，从而绕过复杂的场景检测，直接驱动 PCM 硬件。

通过此方法，我们可以使板载耳机接口、扬声器以及 HDMI 音频在 Wayland 桌面环境中正常工作。

(写文章很辛苦，恳请各位读者点击“在看”，也欢迎转发）

*************************************************

正心诚意，格物致知，以人文情怀审视软件，以软件技术改变人生

扫描下方二维码或者在微信中搜索“盛格塾”小程序，可以阅读更多文章和有声读物

也欢迎关注格友公众号