69 lines
3.4 KiB
Markdown
69 lines
3.4 KiB
Markdown
# 音频拓扑收集
|
||
|
||
**体例**：[../docs/meta/DOCUMENTATION_STYLE.md](../docs/meta/DOCUMENTATION_STYLE.md)。任务编号 **C1** 与根 [README.md](../README.md) 任务表一致。
|
||
|
||
用于 C1a/C1b/C1c：收集 Chromebox 10 代在 Linux / Windows / 原生 ChromeOS 下的音频拓扑。
|
||
|
||
## 对外分享与脱敏（NFR1）
|
||
|
||
采集输出可能含 **hostname、MAC、序列号、账号** 等。在并入**公共 issue**或外发前，按 **本文** 与 **[UPSTREAM_SOF_Kaisa_HDMI_REPRO.md](../docs/linux-hdmi/UPSTREAM_SOF_Kaisa_HDMI_REPRO.md)** 做裁剪或脱敏；**默认**不贴未脱敏全量日志。若上游清单**明确要求**某工具全量输出，按该清单执行并遵循 **最小必要**。
|
||
|
||
## HDMI 试播日志工件（FR10）
|
||
|
||
**HDMI 相关** dmesg、trace、脚本输出建议保存到 **`audio_topology/collected/`**（命名与 [README_TRACE_KAISA.md](collected/README_TRACE_KAISA.md) 约定一致），便于与 [路线图 · § 四、成功标准](../docs/linux-hdmi/Linux_HDMI_Audio_Roadmap.md) 对照。
|
||
|
||
## 目录结构
|
||
|
||
- `collect_linux_audio_topology.sh` - Linux 收集脚本
|
||
- `collect_windows_audio_topology.ps1` - Windows 收集脚本
|
||
- `collect_chromeos_audio_topology.sh` - 原生 ChromeOS 收集脚本（在 crosh → shell 下运行）
|
||
- `collected/` - 收集结果输出目录
|
||
|
||
## Linux 用法
|
||
|
||
```bash
|
||
# 从项目根目录运行，输出默认到 audio_topology/collected/
|
||
sudo ./audio_topology/collect_linux_audio_topology.sh
|
||
|
||
# 或指定输出文件
|
||
sudo ./audio_topology/collect_linux_audio_topology.sh /path/to/output.txt
|
||
```
|
||
|
||
建议用 `sudo` 运行以获取 dmesg、journalctl 等完整信息。
|
||
|
||
## Windows 用法
|
||
|
||
```powershell
|
||
# 在 PowerShell 中运行（建议以管理员身份运行以获取完整驱动信息）
|
||
cd audio_topology
|
||
.\collect_windows_audio_topology.ps1
|
||
|
||
# 或指定输出文件
|
||
.\collect_windows_audio_topology.ps1 -OutputPath "C:\path\to\output.txt"
|
||
```
|
||
|
||
默认输出到 `audio_topology\collected\audio_topology_windows_<计算机名>_<日期时间>.txt`。
|
||
|
||
## 原生 ChromeOS 用法
|
||
|
||
在**未刷 Coreboot** 的 Chromebox 上，用于 C1c / C2 对比原生固件与 Coreboot 的音频差异。
|
||
|
||
1. 浏览器按 **Ctrl+Alt+T** 打开 crosh，输入 `shell` 进入 bash。
|
||
2. 将 `collect_chromeos_audio_topology.sh` 拷到设备（如 U 盘、或从本仓库下载），在 shell 中执行：
|
||
```bash
|
||
bash /path/to/collect_chromeos_audio_topology.sh
|
||
```
|
||
或把脚本内容复制粘贴到 shell 中执行。
|
||
3. 脚本默认输出到 `/tmp/audio_topology_chromeos_<主机名>_<时间>.txt`。用「文件」应用打开 `/tmp` 将该文件复制到「下载」或 U 盘，再拷回电脑，放入 `audio_topology/collected/`。
|
||
4. 建议同时在浏览器打开 **chrome://system**，在「audio」一节复制内容，粘贴到上述输出文件末尾作为补充。
|
||
|
||
**脚本验证（无 ChromeOS 时）**：在任意 Linux 或 WSL 下可做语法检查与试跑，确认脚本不报错（输出内容会因环境不同而不同）：
|
||
|
||
## 修复方案与专项文档
|
||
|
||
- **Linux HDMI 路线图（未来步骤主文档）**：[../docs/linux-hdmi/Linux_HDMI_Audio_Roadmap.md](../docs/linux-hdmi/Linux_HDMI_Audio_Roadmap.md)
|
||
- 全文档索引：[../docs/INDEX.md](../docs/INDEX.md)
|
||
- 分平台总览：[REPAIR_Plan_Audio.md](REPAIR_Plan_Audio.md)（Linux HDMI / Windows 3.5mm）
|
||
- 其它见 [REPAIR_Plan_Audio.md](REPAIR_Plan_Audio.md) 内「文档索引」表。
|
||
|