开发与实验指南（chromebox_10th_audio_driver）

体例：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 磁盘空间。

克隆与目录

git clone <本仓库 URL> chromebox_10th_audio_driver
cd chromebox_10th_audio_driver

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

应用补丁并构建（摘要）

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。

验证补丁（真机）

./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。
新主题：在 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 分平台修复总览

2.2 KiB Raw Blame History Unescape Escape