# chromebox_10th_audio_driver

Kaisa（Chromebox 10 / Coreboot）上 **Linux / Windows** 音频排查文档；主线 **Ubuntu HWE 6.17**、**SOF / iDisp**、仓库补丁 `0001–0003`。

## 文档入口

**仅本文件为根 README**；主题表 [docs/INDEX.md](docs/INDEX.md)。子目录勿再建 README。

| 你想… | 打开 |
| ----- | ---- |
| 全路径（脚本/补丁/大目录） | [REPO_INDEX.md](REPO_INDEX.md) |
| BMad 菜单码（中文） | [bmad-help.zh-CN.md](bmad-help.zh-CN.md) |
| Linux HDMI 路线图 | [docs/linux-hdmi/Linux_HDMI_Audio_Roadmap.md](docs/linux-hdmi/Linux_HDMI_Audio_Roadmap.md) |
| 分平台总览 | [audio_topology/REPAIR_Plan_Audio.md](audio_topology/REPAIR_Plan_Audio.md) |
| 三平台技术分析 | [audio_topology/ANALYSIS_Audio.md](audio_topology/ANALYSIS_Audio.md) |
| 换机 / 阶段 / clone | [docs/meta/WORK_PROGRESS.md](docs/meta/WORK_PROGRESS.md) |
| 入口分层、进度分工（图） | [docs/meta/DOCUMENTATION_ARCHITECTURE.md](docs/meta/DOCUMENTATION_ARCHITECTURE.md) |
| 体例与改写约定 | [docs/meta/DOCUMENTATION_STYLE.md](docs/meta/DOCUMENTATION_STYLE.md) |
| 产品需求（PRD）/ 能力契约 | [_bmad-output/planning-artifacts/prd.md](_bmad-output/planning-artifacts/prd.md) |
| 架构决策（BMad CA） | [_bmad-output/planning-artifacts/architecture.md](_bmad-output/planning-artifacts/architecture.md) |
| Epic / Story（BMad CE） | [_bmad-output/planning-artifacts/epics.md](_bmad-output/planning-artifacts/epics.md) |

---

## 当前问题概况

| 平台 | HDMI | 3.5mm | 插拔提示 |
|------|------|-------|----------|
| Linux | 无 | 有（选对 `aplay -L` 里 `plughw`）；**`0,2` 未必是 3.5mm** | 有 |
| Windows | 有 | 无 | 无 |

**范围（FR20）**：上表为跨平台现象对照。**PRD 交付主线**为 **Linux HDMI**（见 [docs/INDEX.md](docs/INDEX.md)）。Windows 列仅作同款硬件参考；Windows 操作入口见 [INDEX · Windows 专项](docs/INDEX.md)，**不**属 PRD 必达的 Linux HDMI 方案。

---

## 任务列表（对齐路线图）

顺序建议：拓扑与文档 → [Linux HDMI 路线图](docs/linux-hdmi/Linux_HDMI_Audio_Roadmap.md) → Windows 3.5mm。

### 共通

| 任务 | 说明 |
| ---- | ---- |
| C1 | 拓扑采集：C1a Linux / C1b Windows 已做；C1c ChromeOS 待补 |
| C2 | Coreboot vs 原生 ChromeOS 固件差异（记录） |
| C3 | [REPAIR_Plan_Audio.md](audio_topology/REPAIR_Plan_Audio.md) 与各 OPERATION |
| C4 | 已验证机型与固件版本（待补） |

### Linux（L1–L4）

| 阶段 | 说明 |
|------|------|
| L1 | 用户态基线：`aplay`、`speaker-test`、采集 |
| L2 | SOF+iDisp；细节 [ANALYSIS_Audio.md](audio_topology/ANALYSIS_Audio.md) |
| L3 | 固件/HWE/0001/自编内核 |
| L4 | 脚本、补丁、diff、上游：[INDEX](docs/INDEX.md) |

均对齐 [路线图](docs/linux-hdmi/Linux_HDMI_Audio_Roadmap.md)。

### Windows

| 任务 | 说明 |
| ---- | ---- |
| W1–W4 | [docs/windows/OPERATION_Windows_Audio.md](docs/windows/OPERATION_Windows_Audio.md) |

---

## 速链

- 源码与补丁：[kernel-src/README.md](kernel-src/README.md)、[patches/ubuntu-hwe-6.17/](patches/ubuntu-hwe-6.17/)
- 装自编 deb：[docs/kernel-build/OPERATION_Install_CustomKernel_Ubuntu_HWE617.md](docs/kernel-build/OPERATION_Install_CustomKernel_Ubuntu_HWE617.md)
- 固件实验：[audio_topology/OPERATION_Force_Intel_Signed_Firmware.md](audio_topology/OPERATION_Force_Intel_Signed_Firmware.md)
- 双系统：[docs/meta/OPERATION_DualBoot_Ubuntu24_Windows.md](docs/meta/OPERATION_DualBoot_Ubuntu24_Windows.md)
- 脚本表：[docs/INDEX.md](docs/INDEX.md) 文末 · 采集：[audio_topology/COLLECT.md](audio_topology/COLLECT.md)