jack
17f0a4521f
- 新增 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
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 后重测。