Files
chromebox_10th_audio_driver/audio_topology/COLLECT.md
2026-04-05 13:24:31 +08:00

3.4 KiB
Raw Blame History

音频拓扑收集

体例../docs/meta/DOCUMENTATION_STYLE.md。任务编号 C1 与根 README.md 任务表一致。

用于 C1a/C1b/C1c收集 Chromebox 10 代在 Linux / Windows / 原生 ChromeOS 下的音频拓扑。

对外分享与脱敏NFR1

采集输出可能含 hostname、MAC、序列号、账号 等。在并入公共 issue或外发前,按 本文UPSTREAM_SOF_Kaisa_HDMI_REPRO.md 做裁剪或脱敏;默认不贴未脱敏全量日志。若上游清单明确要求某工具全量输出,按该清单执行并遵循 最小必要

HDMI 试播日志工件FR10

HDMI 相关 dmesg、trace、脚本输出建议保存到 audio_topology/collected/(命名与 README_TRACE_KAISA.md 约定一致),便于与 路线图 · § 四、成功标准 对照。

目录结构

  • collect_linux_audio_topology.sh - Linux 收集脚本
  • collect_windows_audio_topology.ps1 - Windows 收集脚本
  • collect_chromeos_audio_topology.sh - 原生 ChromeOS 收集脚本(在 crosh → shell 下运行)
  • collected/ - 收集结果输出目录

Linux 用法

# 从项目根目录运行,输出默认到 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 中运行(建议以管理员身份运行以获取完整驱动信息)
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 /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 下可做语法检查与试跑,确认脚本不报错(输出内容会因环境不同而不同):

修复方案与专项文档