jack/chromebox_10th_audio_driver
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

fix(wp): force HiFi profile for Kaisa UCM so HDMI routes appear

Browse Source 
WirePlumber often kept stereo-fallback when only enabling use-ucm, hiding HDMI.
Set device.profile to HiFi, disable api.acp.auto-profile, and document recovery.

Made-with: Cursor
This commit is contained in:
jack
2026-04-08 00:19:58 +08:00
parent 60f249773e
commit 3c7860c96f
2 changed files with 12 additions and 2 deletions
Download Patch File Download Diff File Expand all files Collapse all files

8
docs/linux-hdmi/OPERATION_PipeWire_Kaisa_HDMI.md
View File

@@ -104,7 +104,13 @@ pactl list short sinks
### UCM Jack：自动显示/隐藏（安装与验收）
**思路**：UCM2 在 **[`reference/ucm2/GoogleKaisa/sof-rt5682/HiFi.conf`](../../reference/ucm2/GoogleKaisa/sof-rt5682/HiFi.conf)** 为 **HDMI1/2/3** 配置 **`JackControl "HDMI/DP,pcm=N Jack"`** 与 **`IEC958`** 开关序列；WirePlumber 通过 **[`wireplumber/main.lua.d/60-kaisa-ucm.lua`](../../wireplumber/main.lua.d/60-kaisa-ucm.lua)** 对 **`sof-rt5682`** 启用 **`api.alsa.use-ucm`** / **`api.acp.auto-port`**，让 ACP 按端口可用性暴露路由（**Jack off 时该 HDMI 设备不应对桌面表现为随意可用**）。
**思路**：UCM2 在 **[`reference/ucm2/GoogleKaisa/sof-rt5682/HiFi.conf`](../../reference/ucm2/GoogleKaisa/sof-rt5682/HiFi.conf)** 为 **HDMI1/2/3** 配置 **`JackControl "HDMI/DP,pcm=N Jack"`** 与 **`IEC958`** 开关序列；WirePlumber 通过 **[`wireplumber/main.lua.d/60-kaisa-ucm.lua`](../../wireplumber/main.lua.d/60-kaisa-ucm.lua)** 对 **`sof-rt5682`** 启用 **`api.alsa.use-ucm`**、**`device.profile = "HiFi"`**（并关闭 **`api.acp.auto-profile`**，避免默认抢 **stereo-fallback**），再开 **`api.acp.auto-port`**，让 ACP 按端口可用性暴露路由（**Jack off 时该 HDMI 不对桌面表现为随意可用**）。
**若安装后只剩模拟/耳机、HDMI 全消失**：先看 **`pactl list cards`** 里 **活动配置** 是否为 **`stereo-fallback`**。若是，说明未切到 UCM 的 **`HiFi`**。请 **`sudo cp` 更新后的 `60-kaisa-ucm.lua`** 并 **`systemctl --user restart wireplumber pipewire pipewire-pulse`**，或手动切 profile：
```bash
pactl set-card-profile "$(pactl list cards short | awk '/cml_rt5682/ {print $2; exit}')" HiFi
```
**安装（在仓库根目录，需 sudo）**：

6
wireplumber/main.lua.d/60-kaisa-ucm.lua
View File

@@ -1,5 +1,8 @@
-- Kaisa (sof-rt5682): enable UCM + ACP so HiFi profile / Jack-driven ports work.
-- WirePlumber 0.4.x: appended after stock alsa rules.
--
-- 若仅启用 use-ucm 而不固定 profile，栈常会默认选 stereo-fallback，界面只剩模拟/耳机，HDMI 消失。
-- 固定为 UCM 中 SectionUseCase 名 "HiFi"；并关闭 auto-profile，避免抢回 stereo-fallback。
table.insert(alsa_monitor.rules, {
matches = {
@@ -10,7 +13,8 @@ table.insert(alsa_monitor.rules, {
apply_properties = {
["api.alsa.use-acp"] = true,
["api.alsa.use-ucm"] = true,
["api.acp.auto-profile"] = true,
["api.acp.auto-profile"] = false,
["api.acp.auto-port"] = true,
["device.profile"] = "HiFi",
},
})