# chromebox_10th_audio_driver

Google **Kaisa**（Chromebox 10）上 **Ubuntu + PipeWire** 的 **HDMI 出声**交付：仓库主线为 **ALSA UCM2 + PipeWire HiFi（Jack-driven 端口）**，目标是 **HDMI 仅在插入时才出现在输出列表中**，并能稳定出声。

## 文档（仅保留已实机验证路线）

| 你想… | 打开 |
| ----- | ---- |
| **操作与排障（主交付）** | [docs/linux-hdmi/OPERATION_PipeWire_Kaisa_UCM_HiFi.md](docs/linux-hdmi/OPERATION_PipeWire_Kaisa_UCM_HiFi.md) |
| 全仓库路径与脚本表 | [REPO_INDEX.md](REPO_INDEX.md) |
| UCM2 源码（overlay / 曾拟打入 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 / UCM 主线）

- **HDMI**：插入后才在输出列表出现（Jack-driven），并按 UCM `HiFi` 的 device 2/3/4（HDMI1/2/3）出声；IEC958 需为 on。
- **3.5mm**：Port1（模拟）一般可用。

---

## 速链（UCM 主线）

- **禁用 pro-audio 片段**：`scripts/disable-kaisa-pro-audio-wireplumber.sh`（可选 `--system`）
- **安装 UCM overlay + WirePlumber Lua**：`scripts/install-kaisa-ucm-overlay.sh`
- **卸载 overlay（恢复发行版 vendor 配置）**：见主文档的卸载段落