# chromebox_10th_audio_driver

Google **Kaisa**（Chromebox 10）上 **Ubuntu + PipeWire** 的 **HDMI 出声**交付：仓库主线为 **`pro-audio` + IEC958 + WirePlumber 用户级片段**（及可选 **UCM2 overlay 脚本**）。**`kaisa-hdmi-pipewire-fix` deb 不作为当前交付**，仅作未来计划（见 [ProAudio §4.4](docs/linux-hdmi/OPERATION_PipeWire_Kaisa_ProAudio.md) 存档）。**自编内核 / SOF 诊断补丁**与 **`kernel-src/` 大目录**已不随仓库提供；若要做 **ChromiumOS ↔ HWE** 源码对照，在本机 **`apt source linux-hwe-6.17`** 后对两棵树自行 **`diff -u`** / **`diff -rq`**（**`chromiumos_kernel/v5.15`** 与解压的 `linux-hwe-6.17-*`）。

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

| 你想… | 打开 |
| ----- | ---- |
| **操作与排障（pro-audio 主路线）** | [docs/linux-hdmi/OPERATION_PipeWire_Kaisa_ProAudio.md](docs/linux-hdmi/OPERATION_PipeWire_Kaisa_ProAudio.md)（文内 **「核心问题」**、**恢复 Ubuntu 后重测**） |
| **UCM / HiFi（可选）** | [docs/linux-hdmi/OPERATION_PipeWire_Kaisa_UCM_HiFi.md](docs/linux-hdmi/OPERATION_PipeWire_Kaisa_UCM_HiFi.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 源码（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）

| 平台 | HDMI | 3.5mm |
|------|------|-------|
| Linux（本仓库目标） | 需 **pro-audio profile** + 正确 **IEC958** / 默认 sink；**`stereo-fallback` 常仅一路** | 一般有（以本机 `aplay -L` 为准） |

细节以 **[ProAudio 文档](docs/linux-hdmi/OPERATION_PipeWire_Kaisa_ProAudio.md)** 为准。

---

## 速链

- **基线**：`scripts/capture-ubuntu-audio-baseline.sh`（大改前 / 曾用 overlay 或历史 deb 时）、`scripts/restore-ubuntu-audio-baseline.sh`（回滚）— [ProAudio 文档](docs/linux-hdmi/OPERATION_PipeWire_Kaisa_ProAudio.md) §4.5。
- **一键 pro-audio**：`scripts/apply-kaisa-pro-audio.sh`（默认 purge 已装的 `kaisa-hdmi-pipewire-fix` + 应用 + `verify-kaisa-pro-audio.sh` 门禁）；仅校验：`scripts/verify-kaisa-pro-audio.sh` — 见 [ProAudio「一键脚本」](docs/linux-hdmi/OPERATION_PipeWire_Kaisa_ProAudio.md)。
- **只卸历史 deb**：`scripts/remove-kaisa-hdmi-deb.sh`（`apt purge kaisa-hdmi-pipewire-fix` + `reinstall alsa-ucm-conf`，不改 WirePlumber）。
- **登录后 pro-audio 被顶掉**：多为 **`~/.local/state/wireplumber/default-profile`** 里持久了 **stereo-fallback**；`scripts/strip-kaisa-default-profile-state.sh` 或重跑 **`apply-kaisa-pro-audio.sh`**。仍偶发再用 `scripts/kaisa-reapply-pro-audio-session.sh` / [§4.1b](docs/linux-hdmi/OPERATION_PipeWire_Kaisa_ProAudio.md)。
- **打 deb（未来计划）**：`debian/` + `scripts/build-deb.sh` 仅作存档，**当前不维护发布**；见 [ProAudio §4.4](docs/linux-hdmi/OPERATION_PipeWire_Kaisa_ProAudio.md)。
- 原始拓扑与 dmesg：`audio_topology/collected/`（`baseline-stash/` 见 `.gitignore`）。