Initial commit

debian/kaisa-hdmi-pipewire-fix/DEBIAN/control

@@ -0,0 +1,21 @@
+Package: kaisa-hdmi-pipewire-fix
+Version: 0.3.0
+Architecture: all
+Maintainer: chromebox_10th_audio_driver <maintainers@local>
+Installed-Size: 56
+Depends: wireplumber, alsa-utils, alsa-ucm-conf, init-system-helpers (>= 1.52)
+Recommends: pipewire-pulse | pipewire-pulseaudio
+Section: sound
+Priority: optional
+Description: Google Kaisa HDMI audio fix (PipeWire / sof-rt5682, UCM2)
+ Installs UCM2 overlay under /usr/share/alsa/ucm2/ (conf.d/sof-rt5682,
+ GoogleKaisa/sof-rt5682) for Jack-driven HDMI routes plus IEC958 sequences,
+ and a system-wide WirePlumber drop-in (pro-audio profile, HDMI sink
+ priorities). Does not ship helper binaries or user systemd units yet —
+ use manual pactl/amixer steps in OPERATION until automated restore is ready.
+ UCM-first and pro-audio WirePlumber are mutually exclusive — see
+ /usr/share/doc/kaisa-hdmi-pipewire-fix/README.md and OPERATION.
+ .
+ PCI path in the WirePlumber fragment targets BDF 0000:00:1f.3; edit under
+ /etc/wireplumber/ if needed. See OPERATION_PipeWire_Kaisa_HDMI.md.gz in
+ /usr/share/doc/.

debian/kaisa-hdmi-pipewire-fix/DEBIAN/postinst

@@ -0,0 +1,17 @@
+#!/bin/sh
+set -e
+case "$1" in
+configure)
+    echo "kaisa-hdmi-pipewire-fix: UCM2 已安装至 /usr/share/alsa/ucm2/（sof-rt5682 + GoogleKaisa）"
+    echo "kaisa-hdmi-pipewire-fix: WirePlumber 片段: /etc/wireplumber/wireplumber.conf.d/"
+    echo "  重要：UCM（产品目标：无 Jack 不误导）与强制 pro-audio 片段二选一。"
+    echo "  若优先 UCM：请移走 50-kaisa-sof-rt5682-hdmi.conf 后执行:"
+    echo "    systemctl --user restart wireplumber pipewire pipewire-pulse"
+    echo "  注意: apt upgrade 本包后若该文件曾被删/改名, 可能被再次装入; UCM 用户请再移走。"
+    echo "  否则保留 pro-audio 过渡时，可暂叠 UCM 但行为以 OPERATION 互斥说明为准。"
+    echo "  详见: /usr/share/doc/kaisa-hdmi-pipewire-fix/README.md.gz"
+    echo "  本包当前仅含 UCM2 + WirePlumber 片段；自动 restore / IEC958 / Jack 轮询工具尚未随 deb 提供，见 OPERATION 手顺。"
+    ;;
+esac
+#DEBHELPER#
+exit 0

debian/kaisa-hdmi-pipewire-fix/DEBIAN/postrm

@@ -0,0 +1,4 @@
+#!/bin/sh
+set -e
+#DEBHELPER#
+exit 0

debian/kaisa-hdmi-pipewire-fix/usr/share/doc/kaisa-hdmi-pipewire-fix/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` 后重测。_