Initial commit

reference/chromeos-ubuntu-sound-diffs/README.md

@@ -0,0 +1,5 @@
+# ChromeOS 5.15 ↔ Ubuntu HWE（可选对照）
+
+本目录用于存放你在本机对两棵内核树 **`diff -u`** / **`diff -rq`** 的输出（例如 **`diff-u_sound_soc_….txt`**）。**仓库不再附带**自动生成脚本；在 **`chromiumos_kernel/v5.15`** 与 **`apt source linux-hwe-6.17`** 解压目录之间自行对照即可。
+
+默认可将生成物放于此处；**`diff-u_*.txt`** 仍由根目录 **`.gitignore`** 忽略，避免大段 diff 误入版本库。

reference/ucm2/README.md

@@ -0,0 +1,49 @@
+# Kaisa UCM2 overlay（`sof-rt5682`）
+
+本目录为 **alsa-ucm-conf** 风格的 **UCM2** 草稿，目标：**Jack off 时 HDMI 路由对 ACP/桌面不表现为可随意可用的输出**（与强制 **`pro-audio`** 的 WirePlumber 策略不同，见 [docs/linux-hdmi/OPERATION_PipeWire_Kaisa_HDMI.md](../../docs/linux-hdmi/OPERATION_PipeWire_Kaisa_HDMI.md)「UCM 模式 vs pro-audio 模式」）。
+
+## 布局
+
+| 路径（相对 `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/`，与本仓库 **deb 同时安装会冲突** — 优先 **合并上游** 或 **改名/拆包**（与 [OPERATION](../../docs/linux-hdmi/OPERATION_PipeWire_Kaisa_HDMI.md) 中 UCM / pro-audio 互斥说明一致）。
+
+## 手工安装（调试）
+
+```bash
+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 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`**：
+
+```bash
+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`**。
+
+## 实机验收表（勾选）
+
+| 步骤 | 预期 |
+|------|------|
+| 仅接模拟 / 不接 HDMI | HDMI 相关输出不对「可用路由」误导（依桌面实现） |
+| 接 HDMI，Jack on | 对应 **IEC958** on 后有声 |
+| 拔线 Jack off | 该路不应再被选为有效 HDMI 输出 |
+
+---
+
+_控件名以本机 `amixer` 为准；若 `Headphone`/`IEC958` 命名不同，需改 `HiFi.conf` 后重测。_