64 lines
2.7 KiB
Markdown
64 lines
2.7 KiB
Markdown
# chromebox_10th_audio_driver — 项目概览（BMad 文档扫描）
|
||
|
||
**日期：** 2026-04-05
|
||
**类型：** 近类 **infra**（脚本、补丁、自动化与文档为主；非典型 Terraform 独占仓库）
|
||
**架构：** 单体仓库（monolith），以 **文档索引 + Shell 脚本 + 内核补丁** 组织工作
|
||
|
||
**文档体例**：[meta/DOCUMENTATION_STYLE.md](meta/DOCUMENTATION_STYLE.md)
|
||
|
||
---
|
||
|
||
## 摘要
|
||
|
||
本仓库面向 **Google Kaisa（Chromebox 10 代）** 在 **Coreboot** 环境下的 **跨平台音频问题**（Linux HDMI、Windows 3.5mm 等），集中存放：
|
||
|
||
- **操作文档与路线图**（`docs/`，含 Linux HDMI 主路线图）；
|
||
- **Ubuntu HWE 6.17 内核补丁**（`patches/ubuntu-hwe-6.17/`，0001–0003）与验证说明；
|
||
- **自动化脚本**（`scripts/`，构建、diff、采集）；
|
||
- **可选对照源码树路径**（`chromiumos_kernel/`、`kernel-src/`，大文件常不提交）。
|
||
|
||
**不是**以单一 `package.json` / Web 应用为核心的「典型 web 项目」；AI 代理实现变更时应以 **最小 diff、对齐现有文档结构** 为准。
|
||
|
||
---
|
||
|
||
## 分类
|
||
|
||
| 项 | 内容 |
|
||
|----|------|
|
||
| **仓库类型** | 单体（monolith） |
|
||
| **主要语言** | Bash、Markdown；内核相关为 C（补丁上下文） |
|
||
| **架构模式** | 文档驱动 + 可重复实验脚本（内核构建、补丁应用、采集） |
|
||
|
||
---
|
||
|
||
## 技术栈摘要
|
||
|
||
| 类别 | 技术/工件 |
|
||
|------|-----------|
|
||
| 自动化 | Bash、`ubuntu-hwe-617-build.sh` |
|
||
| 内核 | Ubuntu `linux-hwe-6.17` 源码（`apt source`）、可选 `chromiumos_kernel/v5.15` |
|
||
| 文档 | CommonMark Markdown，`docs/INDEX.md` 为主题索引 |
|
||
| 版本控制 | Git |
|
||
|
||
---
|
||
|
||
## 关键能力（功能视角）
|
||
|
||
- Linux：**SOF / iDisp / HDMI** 排查路径、自编内核、**0001/0002/0003** 验证脚本。
|
||
- 采集：`audio_topology/collected/`、拓扑与 dmesg 基线。
|
||
- 对照：ChromeOS 5.15 与 Ubuntu 6.17 **sound/soc** diff 脚本与 reference。
|
||
|
||
---
|
||
|
||
## 架构要点
|
||
|
||
- **文档入口**：根目录仅 **[README.md](../README.md)**；详细索引为 **[INDEX.md](INDEX.md)** 与 **[REPO_INDEX.md](../REPO_INDEX.md)**。
|
||
- **补丁与验证**：**[patches/ubuntu-hwe-6.17/VERIFY_PATCHES.md](../patches/ubuntu-hwe-6.17/VERIFY_PATCHES.md)**。
|
||
- **BMad 主索引（本工作流）**：[index.md](index.md)（与 `INDEX.md` 并存：`INDEX.md` 为人用总目，`index.md` 面向 AI 检索约定）。
|
||
|
||
---
|
||
|
||
## 后续（棕地 PRD / 功能规划）
|
||
|
||
文档改写约定：[meta/DOCUMENTATION_STYLE.md](meta/DOCUMENTATION_STYLE.md)。规划新功能时请将 **`docs/index.md`** 与 **`docs/INDEX.md`** 一并纳入上下文；内核修改对齐 **`uname -r`** 与 **`patches/ubuntu-hwe-6.17/README.md`**。
|