47 lines
2.0 KiB
Markdown
47 lines
2.0 KiB
Markdown
# 源码树说明（Quick Scan）
|
||
|
||
**体例**：[meta/DOCUMENTATION_STYLE.md](meta/DOCUMENTATION_STYLE.md)。**扫描级别：** quick（基于目录与关键文件，非全量读源）
|
||
|
||
---
|
||
|
||
## 仓库根目录（节选）
|
||
|
||
```
|
||
chromebox_10th_audio_driver/
|
||
├── README.md # 全仓库唯一根 README；文档入口表
|
||
├── REPO_INDEX.md # 全路径索引（脚本、补丁、大目录）
|
||
├── help.md / bmad-help.zh-CN.md
|
||
├── next.md
|
||
├── docs/ # 主题文档（INDEX.md、linux-hdmi/、meta/、kernel-build/ 等）
|
||
├── scripts/ # 构建、diff、验证、采集脚本
|
||
├── patches/
|
||
│ └── ubuntu-hwe-6.17/ # 0001–0003 补丁、VERIFY_PATCHES.md、STREAM_PCM 笔记
|
||
├── audio_topology/ # 拓扑采集脚本、collected/ 真机输出
|
||
├── chromiumos_kernel/ # 可选：ChromiumOS 5.15 对照树
|
||
├── kernel-src/ # 可选：Ubuntu HWE 6.17 解压源码（常 gitignore）
|
||
├── design-artifacts/
|
||
├── _bmad/ # BMad 模块配置与工作流
|
||
└── _bmad-output/ # BMad 输出目录
|
||
```
|
||
|
||
---
|
||
|
||
## 关键目录用途
|
||
|
||
| 路径 | 用途 |
|
||
|------|------|
|
||
| **docs/** | 人读文档主区；**INDEX.md** 分类索引 |
|
||
| **scripts/** | `ubuntu-hwe-617-build.sh`、`verify-ubuntu-hwe617-patches-runtime.sh`、`diff-*` 等 |
|
||
| **patches/ubuntu-hwe-6.17/** | 内核补丁与对照笔记 |
|
||
| **audio_topology/** | 三平台音频采集与 **REPAIR_Plan_Audio.md** |
|
||
| **chromiumos_kernel/v5.15** | ChromeOS 内核对照（若已克隆） |
|
||
| **kernel-src/** | 本机 `apt source` 的 HWE 树（若存在） |
|
||
|
||
---
|
||
|
||
## 入口点（开发/实验）
|
||
|
||
- **应用补丁并编内核**：`scripts/ubuntu-hwe-617-build.sh` + 环境变量 `PATCH=`（见 **patches/ubuntu-hwe-6.17/README.md**）。
|
||
- **补丁真机验证**：`scripts/verify-ubuntu-hwe617-patches-runtime.sh`（成功输出 `VERIFY_OK`）。
|
||
- **文档导航**：从 **docs/INDEX.md** 或 **本工作流生成的 index.md** 进入子主题。
|