67 lines
2.2 KiB
Markdown
67 lines
2.2 KiB
Markdown
# 开发与实验指南（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 分平台修复总览 |
|