3.4 KiB
音频拓扑收集
体例:../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 的音频差异。
- 浏览器按 Ctrl+Alt+T 打开 crosh,输入
shell进入 bash。 - 将
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 下可做语法检查与试跑,确认脚本不报错(输出内容会因环境不同而不同):
修复方案与专项文档
- Linux HDMI 路线图(未来步骤主文档):../docs/linux-hdmi/Linux_HDMI_Audio_Roadmap.md
- 全文档索引:../docs/INDEX.md
- 分平台总览:REPAIR_Plan_Audio.md(Linux HDMI / Windows 3.5mm)
- 其它见 REPAIR_Plan_Audio.md 内「文档索引」表。