# 音频拓扑收集

用于 C1a/C1b/C1c 任务：收集 Chromebox 10 代在 Linux / Windows / 原生 ChromeOS 下的音频硬件拓扑信息。

## 目录结构

- `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 下可做语法检查与试跑，确认脚本不报错（输出内容会因环境不同而不同）：
   ```bash
   bash -n collect_chromeos_audio_topology.sh && echo "Syntax OK"
   OUTPUT_DIR=. bash collect_chromeos_audio_topology.sh ./collected/audio_topology_chromeos_test.txt && echo "Run OK"
   ```