# 开发与实验指南（chromebox_10th_audio_driver）

**体例**：[meta/DOCUMENTATION_STYLE.md](meta/DOCUMENTATION_STYLE.md)。**面向：** 维护文档、打补丁、真机验证。

---

## 前置条件

- **Linux（推荐 Ubuntu 24.04 Noble）**：与 **HWE 6.17** 内核文档路径一致。
- 工具：**bash**、**git**、**patch**；编内核时需 **fakeroot**、**dpkg-dev**、**debhelper** 等（见 **kernel-src/README.md** 与 **`scripts/ubuntu-hwe-617-build.sh deps`**）。
- 大目录：**kernel-src** 解压与 **deb 构建** 需 **数十 GB** 磁盘空间。

---

## 克隆与目录

```bash
git clone <本仓库 URL> chromebox_10th_audio_driver
cd chromebox_10th_audio_driver
```

可选：按 **docs/meta/WORK_PROGRESS.md** 拉取 **chromiumos_kernel**、**kernel-src**（不提交二进制/大 tarball）。

---

## 应用补丁并构建（摘要）

```bash
export PATCH="$PWD/patches/ubuntu-hwe-6.17/0001-....patch"
./scripts/ubuntu-hwe-617-build.sh apply
# 按需继续 0002、0003
./scripts/ubuntu-hwe-617-build.sh deps
./scripts/ubuntu-hwe-617-build.sh build
```

完整安装 **linux-image-unsigned**、**modules**、**modules-extra**：**docs/kernel-build/OPERATION_Install_CustomKernel_Ubuntu_HWE617.md**。

---

## 验证补丁（真机）

```bash
./scripts/verify-ubuntu-hwe617-patches-runtime.sh
RUN_HDMI_TEST=0 ./scripts/verify-ubuntu-hwe617-patches-runtime.sh   # 不跑 speaker-test
```

说明：**patches/ubuntu-hwe-6.17/VERIFY_PATCHES.md**。

---

## 文档维护约定

- **全项目体例与改写自检**：[meta/DOCUMENTATION_STYLE.md](meta/DOCUMENTATION_STYLE.md)。
- 新主题：在 **docs/INDEX.md**（或 **REPO_INDEX.md**）增加**一条**链入，避免孤岛文档。
- 用户向说明：默认 **中文**（与 **\_bmad/bmm/config.yaml** 一致）。
- **勿**在无请求时批量修改 **.cursor/plans/**（见 **WORK_PROGRESS** 说明）。

---

## 常用引用

| 文档 | 内容 |
|------|------|
| **docs/linux-hdmi/Linux_HDMI_Audio_Roadmap.md** | Linux HDMI 分阶段路线图 |
| **patches/ubuntu-hwe-6.17/DIFF_SUMMARY.txt** | 补丁设计与 smoke |
| **audio_topology/REPAIR_Plan_Audio.md** | Linux / Windows 分平台修复总览 |