# chromebox_10th_audio_driver

修复 Chromebox 刷写 Coreboot 后，安装 Windows/Linux 时的声音问题。

## 文档入口（请先读）

**全仓库仅本文件为 README**；`docs/` 下详细目录见 [docs/INDEX.md](docs/INDEX.md)（非 README，避免双层入口）。

| 你想… | 打开 |
| ----- | ---- |
| **全仓库路径索引**（含脚本、补丁、大目录说明） | [REPO_INDEX.md](REPO_INDEX.md) |
| **BMad 帮助目录（中文版，译自 bmad-help.csv）** | [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) |
| **按主题浏览全部文档** | [docs/INDEX.md](docs/INDEX.md) |
| Linux / Windows 分平台思路与文档索引 | [audio_topology/REPAIR_Plan_Audio.md](audio_topology/REPAIR_Plan_Audio.md) |
| 三平台技术分析与对比 | [audio_topology/ANALYSIS_Audio.md](audio_topology/ANALYSIS_Audio.md) |
| 换机交接、源码克隆、实验结论 | [docs/meta/WORK_PROGRESS.md](docs/meta/WORK_PROGRESS.md) |

---

## 当前问题概况


| 平台      | HDMI 声音 | 3.5mm 耳机声音 | 插入/拔出提示 |
| ------- | ------- | ---------- | ------- |
| Linux   | 无      | 有         | 有      |
| Windows | 有      | 无         | 无      |


**目标平台**：Chromebox（10 代 Intel，Google **Kaisa**），Coreboot 刷机后。

---

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

> **建议顺序**：共通拓扑与文档 → Linux HDMI 按 [路线图](docs/linux-hdmi/Linux_HDMI_Audio_Roadmap.md) 分阶段推进 → Windows 3.5mm。

### 共通与文档

| 任务 | 说明 |
| ---- | ---- |
| C1 | 硬件拓扑（HDMI、3.5mm、codec）：C1a Linux / C1b Windows 采集已完成；C1c 原生 ChromeOS 待补 |
| C2 | Coreboot 与原生 ChromeOS 固件音频差异（记录） |
| C3 | 分平台文档： [REPAIR_Plan_Audio.md](audio_topology/REPAIR_Plan_Audio.md) 与各 OPERATION |
| C4 | 已验证机型与固件版本（待补充） |

### Linux（L1–L4 对应 HDMI 路线图阶段）

| 任务 | 对应路线图 | 说明 |
| ---- | ---------- | ---- |
| L1 | [路线图](docs/linux-hdmi/Linux_HDMI_Audio_Roadmap.md) | ALSA / PipeWire 用户态基线：`aplay`、`speaker-test`、采集脚本 |
| L2 | [路线图](docs/linux-hdmi/Linux_HDMI_Audio_Roadmap.md) | HDMI 走 SOF + iDisp；与内核/固件兼容性结论见 [ANALYSIS_Audio.md](audio_topology/ANALYSIS_Audio.md) |
| L3 | [路线图](docs/linux-hdmi/Linux_HDMI_Audio_Roadmap.md) | 固件实验（低期望）、HWE 6.17、0001 补丁与自编内核 |
| L4 | [路线图](docs/linux-hdmi/Linux_HDMI_Audio_Roadmap.md) + [docs/INDEX.md](docs/INDEX.md) | 脚本、补丁目录、深度 diff、上游复现 |

### Windows

| 任务 | 说明 |
| ---- | ---- |
| W1–W4 | 3.5mm / CoolStar / ALC5682、插拔提示等： [docs/windows/OPERATION_Windows_Audio.md](docs/windows/OPERATION_Windows_Audio.md) |

---

## 参考速链

- Ubuntu HWE 6.17 源码与补丁：[kernel-src/README.md](kernel-src/README.md)、[patches/ubuntu-hwe-6.17/](patches/ubuntu-hwe-6.17/)
- 自编内核安装：[docs/kernel-build/OPERATION_Install_CustomKernel_Ubuntu_HWE617.md](docs/kernel-build/OPERATION_Install_CustomKernel_Ubuntu_HWE617.md)
- Linux SOF 固件实验与回退：[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)

**脚本一览**（`ubuntu-hwe-617-build.sh`、采集、diff、trace 等）： [docs/INDEX.md](docs/INDEX.md) 文末「脚本」表。

**拓扑采集脚本说明**：[audio_topology/COLLECT.md](audio_topology/COLLECT.md)