Initial commit

README.md

@@ -0,0 +1,36 @@
+# chromebox_10th_audio_driver
+
+Google **Kaisa**（Chromebox 10）上 **Ubuntu + PipeWire** 的 **HDMI 出声**交付：仓库主线为 **`pro-audio` + IEC958 + WirePlumber 片段**（及可选 **UCM2**），与 **`kaisa-hdmi-pipewire-fix` deb**。**自编内核 / SOF 诊断补丁**与 **`kernel-src/` 大目录**已不随仓库提供；若要做 **ChromiumOS ↔ HWE** 源码对照，在本机 **`apt source linux-hwe-6.17`** 后对两棵树自行 **`diff -u`** / **`diff -rq`**（**`chromiumos_kernel/v5.15`** 与解压的 `linux-hwe-6.17-*`）。
+
+## 文档（仅保留已实机验证路线）
+
+| 你想… | 打开 |
+| ----- | ---- |
+| **操作与排障**（WirePlumber、`50-kaisa-…`、deb、基线脚本） | [docs/linux-hdmi/OPERATION_PipeWire_Kaisa_HDMI.md](docs/linux-hdmi/OPERATION_PipeWire_Kaisa_HDMI.md) |
+| **deb 手顺与验收** | [docs/linux-hdmi/REPRO_Kaisa_Deb_ProAudio_Manual.md](docs/linux-hdmi/REPRO_Kaisa_Deb_ProAudio_Manual.md) |
+| 速查下一步 | [next.md](next.md) |
+| 全仓库路径与脚本表 | [REPO_INDEX.md](REPO_INDEX.md) |
+| UCM2 源码（打入 deb） | [reference/ucm2/README.md](reference/ucm2/README.md) |
+| 拓扑采集脚本 | [audio_topology/COLLECT.md](audio_topology/COLLECT.md) |
+| BMad 菜单码 | [bmad-help.zh-CN.md](bmad-help.zh-CN.md) |
+| 产品需求（若仍用 BMad） | [_bmad-output/planning-artifacts/prd.md](_bmad-output/planning-artifacts/prd.md) |
+
+**仅本文件为根 README**；`docs/` 下不再维护旧版 ChromiumOS/路线图索引。
+
+---
+
+## 现象速览（Kaisa）
+
+| 平台 | HDMI | 3.5mm |
+|------|------|-------|
+| Linux（本仓库目标） | 需 **pro-audio profile** + 正确 **IEC958** / 默认 sink；**`stereo-fallback` 常仅一路** | 一般有（以本机 `aplay -L` 为准） |
+
+细节以 **OPERATION** 为准。
+
+---
+
+## 速链
+
+- **基线**：`scripts/capture-ubuntu-audio-baseline.sh`（装 deb / 大改前）、`scripts/restore-ubuntu-audio-baseline.sh`（回滚）— [OPERATION](docs/linux-hdmi/OPERATION_PipeWire_Kaisa_HDMI.md) §4.5。
+- **打 deb**：`debian/` + `scripts/build-deb.sh`（**≥0.3.0** 包内为 **UCM2 + WirePlumber 片段**，无随包 shell 工具）。
+- 原始拓扑与 dmesg：`audio_topology/collected/`（`baseline-stash/` 见 `.gitignore`）。