Files

jack 17f0a4521f docs(kaisa): ProAudio 主路线、WirePlumber default-profile 与一键脚本

- 新增 OPERATION_PipeWire_Kaisa_ProAudio / UCM_HiFi，核心问题复盘与恢复 Ubuntu 重测手顺；HDMI 旧文改为 stub。
- 脚本：apply / verify-pro-audio、strip default-profile、reapply-session、remove deb 与 UCM overlay、verify-audio-environment。
- systemd-user：kaisa-pro-audio-reapply.service 示例。
- README、docs 索引、REPO_INDEX、REPRO deb 存档说明；deb 标为未来计划；reference/ucm2 与采集脚本小改。
- debian 与 _bmad-output 规划文件随本次工作区一并更新。

Made-with: Cursor

2026-04-08 11:07:13 +08:00

3.1 KiB

Raw Blame History

Kaisa UCM2 overlay（`sof-rt5682`）

本目录为 alsa-ucm-conf 风格的 UCM2 草稿，目标：Jack off 时 HDMI 路由对 ACP/桌面不表现为可随意可用的输出（与强制 pro-audio 的 WirePlumber 策略不同，见 UCM 操作文档 与 ProAudio 文档）。

布局

路径（相对 `ucm2/` 根）	说明
`conf.d/sof-rt5682/sof-rt5682.conf`	卡入口，匹配 ALSA card name `sof-rt5682`
`GoogleKaisa/sof-rt5682/HiFi.conf`	HiFi：`Port1` + HDMI1/2/3，JackControl + `IEC958',N`

上游 alsa-ucm-conf 若日后增加同名 conf.d/sof-rt5682/，与 本 overlay 或历史 deb 路径 可能冲突 — 优先 合并上游 或 改名/拆包（与 UCM / ProAudio 文档中互斥说明一致；deb 当前不作为交付，见 ProAudio §4.4）。

手工安装（调试）

推荐（仓库根目录）：先禁用强制 pro-audio 的 WirePlumber 片段，再一键安装 UCM + Lua：

./scripts/disable-kaisa-pro-audio-wireplumber.sh
./scripts/install-kaisa-ucm-overlay.sh

等价手工步骤：

sudo cp -a reference/ucm2/conf.d/sof-rt5682 /usr/share/alsa/ucm2/conf.d/
sudo cp -a reference/ucm2/GoogleKaisa /usr/share/alsa/ucm2/
sudo install -D -m0644 wireplumber/main.lua.d/60-kaisa-ucm.lua /usr/share/wireplumber/main.lua.d/60-kaisa-ucm.lua
sudo alsactl init # 或重登 / 重启 pipewire
systemctl --user restart wireplumber pipewire pipewire-pulse

与 WirePlumber `50-kaisa-sof-rt5682-hdmi.conf` 的互斥

UCM 模式（本 overlay）：依赖 ACP 的 profile/端口；请勿再使用强制 device.profile = pro-audio 的片段，否则仍易出现 多路 pro-output-* 常驻。
过渡 pro-audio 模式：保留现有 wireplumber.conf.d 片段；不要同时叠加本 UCM 覆盖（二选一）。

校验（可选）

若已安装 alsa-utils：

alsaucm -c sof-rt5682 list _verbs
alsaucm -c sof-rt5682 set _verb HiFi list _devices

插拔 HDMI 时对照 amixer -c0 中 HDMI/DP,pcm=N Jack 与 IEC958',N。

一次跑完（推荐）：在仓库根目录执行 ./scripts/verify-kaisa-audio-environment.sh（可选 --output ~/kaisa-audio-verify.txt），覆盖硬件枚举、UCM、PipeWire、WirePlumber 与摘要；详见 ProAudio 文档「一键环境验证」。

实机验收表（勾选）

步骤	预期
仅接模拟 / 不接 HDMI	HDMI 相关输出不对「可用路由」误导（依桌面实现）
接 HDMI，Jack on	对应 IEC958 on 后有声
拔线 Jack off	该路不应再被选为有效 HDMI 输出

控件名以本机 amixer 为准；若 Headphone/IEC958 命名不同，需改 HiFi.conf 后重测。

3.1 KiB Raw Blame History Unescape Escape

Kaisa UCM2 overlay（sof-rt5682）

布局