jack/chromebox_10th_audio_driver
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

更新源码

Browse Source
This commit is contained in:
jack
2026-04-04 18:13:40 +08:00
parent 2e20b8e2c5
commit beed35ec13
31 changed files with 1632 additions and 209 deletions
Download Patch File Download Diff File Expand all files Collapse all files

83
README.md
View File

@@ -2,61 +2,70 @@
修复 Chromebox 刷写 Coreboot 后，安装 Windows/Linux 时的声音问题。
## 文档入口（请先读）
**全仓库仅本文件为 README**；`docs/` 下详细目录见 [docs/INDEX.md](docs/INDEX.md)（非 README，避免双层入口）。
| 你想… | 打开 |
| ----- | ---- |
| **解决 Linux HDMI 无声**（分阶段步骤、已排除项、成功标准） | [docs/linux-hdmi/Linux_HDMI_Audio_Roadmap.md](docs/linux-hdmi/Linux_HDMI_Audio_Roadmap.md) |
| **按主题浏览全部文档** | [docs/INDEX.md](docs/INDEX.md) |
| Linux / Windows 分平台思路与文档索引 | [audio_topology/REPAIR_Plan_Audio.md](audio_topology/REPAIR_Plan_Audio.md) |
| 三平台技术分析与对比 | [audio_topology/ANALYSIS_Audio.md](audio_topology/ANALYSIS_Audio.md) |
| 换机交接、源码克隆、实验结论 | [docs/meta/WORK_PROGRESS.md](docs/meta/WORK_PROGRESS.md) |
---
## 当前问题概况
| 平台 | HDMI 声音 | 3.5mm 耳机声音 | 插入/拔出提示 |
| ------- | ------- | ---------- | ------- |
| Linux | ❌ 无 | ✅ 有 | ✅ 有 |
| Windows | ✅ 有 | ❌ 无 | ❌ 无 |
| Linux | 无 | 有 | 有 |
| Windows | 有 | 无 | 无 |
**目标平台**：Chromebox（10 代 Intel，Google **Kaisa**），Coreboot 刷机后。
---
## 任务列表
## 任务列表（与路线图对齐）
> **建议执行顺序**：先完成共通文档（尤其是硬件拓扑），再分别处理 Linux / Windows 平台问题。
> **建议顺序**：共通拓扑与文档 → Linux HDMI 按 [路线图](docs/linux-hdmi/Linux_HDMI_Audio_Roadmap.md) 分阶段推进 → Windows 3.5mm。
### 一、共通与文档（优先）
### 共通与文档
- [✓] **C1**: 整理 Chromebox 10 代音频硬件拓扑（HDMI、3.5mm、codec 型号）
- [✓] C1a: 在 Linux 下收集硬件拓扑信息（运行 `audio_topology/collect_linux_audio_topology.sh`，输出到 `audio_topology/collected/`）
- [✓] C1b: 在 Windows 下收集硬件拓扑信息（运行 `audio_topology/collect_windows_audio_topology.ps1`，输出到 `audio_topology/collected/`）
- C1c: 在原生 ChromeOS 下收集硬件拓扑信息（运行 `audio_topology/collect_chromeos_audio_topology.sh`，并在 chrome://system 的 audio 节复制补充；结果放入 `audio_topology/collected/`）
- **C2**: 记录 Coreboot 下与原生 ChromeOS 固件的音频差异
- [✓] **C3**: 编写分平台操作步骤文档（Linux / Windows）— 见 [REPAIR_Plan_Audio.md](audio_topology/REPAIR_Plan_Audio.md) 与各 OPERATION 文档
- **C4**: 补充已验证的 Chromebox 型号与固件版本
| 任务 | 说明 |
| ---- | ---- |
| C1 | 硬件拓扑（HDMI、3.5mm、codec）：C1a Linux / C1b Windows 采集已完成；C1c 原生 ChromeOS 待补 |
| C2 | Coreboot 与原生 ChromeOS 固件音频差异（记录） |
| C3 | 分平台文档： [REPAIR_Plan_Audio.md](audio_topology/REPAIR_Plan_Audio.md) 与各 OPERATION |
| C4 | 已验证机型与固件版本（待补充） |
### 二、Linux 相关
### Linux（L1–L4 对应 HDMI 路线图阶段）
- **L1**: 调研 Chromebox 10 代在 Linux 下的 HDMI 音频方案（ALSA / PulseAudio / PipeWire）
- **L2**: 确认 HDMI 音频芯片型号和驱动兼容性
- **L3**: 尝试/验证 HDMI 音频所需固件或内核参数
- **L4**: 编写 Linux 下 HDMI 音频修复说明或脚本（如有需要）
| 任务 | 对应路线图 | 说明 |
| ---- | ---------- | ---- |
| L1 | [路线图](docs/linux-hdmi/Linux_HDMI_Audio_Roadmap.md) | ALSA / PipeWire 用户态基线：`aplay`、`speaker-test`、采集脚本 |
| L2 | [路线图](docs/linux-hdmi/Linux_HDMI_Audio_Roadmap.md) | HDMI 走 SOF + iDisp；与内核/固件兼容性结论见 [ANALYSIS_Audio.md](audio_topology/ANALYSIS_Audio.md) |
| L3 | [路线图](docs/linux-hdmi/Linux_HDMI_Audio_Roadmap.md) | 固件实验（低期望）、HWE 6.17、0001 补丁与自编内核 |
| L4 | [路线图](docs/linux-hdmi/Linux_HDMI_Audio_Roadmap.md) + [docs/INDEX.md](docs/INDEX.md) | 脚本、补丁目录、深度 diff、上游复现 |
### 三、Windows 相关
### Windows
- **W1**: 调研 Chromebox 10 代 3.5mm 音频在 Windows 下的驱动需求
- **W2**: 确认 3.5mm 接口对应芯片及 Windows 驱动支持情况
- **W3**: 解决 3.5mm 无声音问题（驱动安装 / 驱动修改 / 注册表等）
- **W4**: 解决耳机插入/拔出无提示问题（通常与 HDA 驱动 / 插孔检测相关）
| 任务 | 说明 |
| ---- | ---- |
| W1–W4 | 3.5mm / CoolStar / ALC5682、插拔提示等： [docs/windows/OPERATION_Windows_Audio.md](docs/windows/OPERATION_Windows_Audio.md) |
---
## 参考信息
## 参考速链
- 目标平台：Chromebox（10 代 Intel，Coreboot 刷机后）
- 目标系统：Linux / Windows
- **Linux / Windows 声音修复总方案**：[audio_topology/REPAIR_Plan_Audio.md](audio_topology/REPAIR_Plan_Audio.md)
- Windows 3.5mm / CoolStar：[audio_topology/OPERATION_Windows_Audio.md](audio_topology/OPERATION_Windows_Audio.md)
- Linux SOF / intel-signed 固件：[audio_topology/OPERATION_Force_Intel_Signed_Firmware.md](audio_topology/OPERATION_Force_Intel_Signed_Firmware.md)
- 三平台对比分析：[audio_topology/ANALYSIS_Audio.md](audio_topology/ANALYSIS_Audio.md)
- Ubuntu HWE 6.17 内核：源码目录 **`kernel-src/linux-hwe-6.17-6.17.0/`**（大文件不提交，见 [kernel-src/README.md](kernel-src/README.md)）；自定义补丁目录 [patches/ubuntu-hwe-6.17/](patches/ubuntu-hwe-6.17/)（应用时 **`PATCH=/path/to.patch`**）、脚本 [scripts/ubuntu-hwe-617-build.sh](scripts/ubuntu-hwe-617-build.sh)、依赖 [scripts/ubuntu-hwe-617-deps-packages.txt](scripts/ubuntu-hwe-617-deps-packages.txt)、摘要 [patches/ubuntu-hwe-6.17/DIFF_SUMMARY.txt](patches/ubuntu-hwe-6.17/DIFF_SUMMARY.txt)
- **换机交接 / 进度与两处内核源码下载**：[docs/WORK_PROGRESS.md](docs/WORK_PROGRESS.md)
- ChromeOS 5.15 与 Ubuntu HWE 6.17 的 iDisp/HDMI API 对照：[docs/CHROMEOS_VS_UBUNTU_HDMI_NOTES.md](docs/CHROMEOS_VS_UBUNTU_HDMI_NOTES.md)
- Linux HDMI 重新分析与补丁重设流程：[docs/REANALYSIS_Linux_HDMI_Audio_Kaisa.md](docs/REANALYSIS_Linux_HDMI_Audio_Kaisa.md)
- ChromeOS 5.15 与 Ubuntu 6.17 音频子树自动对照摘要：`./scripts/diff-chromeos-ubuntu-sound.sh` → [docs/CHROMEOS_vs_UBUNTU617_SOUND_AUTODIFF.md](docs/CHROMEOS_vs_UBUNTU617_SOUND_AUTODIFF.md)
- ChromeOS 内核深度 diff（unshallow、`git log`、导出 `ipc3`/`pcm`/`hda-dai`）：[docs/OPERATION_ChromeOS_Kernel_Deep_Diff.md](docs/OPERATION_ChromeOS_Kernel_Deep_Diff.md)
- Ubuntu 24.04 + Windows 双系统：[docs/OPERATION_DualBoot_Ubuntu24_Windows.md](docs/OPERATION_DualBoot_Ubuntu24_Windows.md)
- 自编译 HWE 6.17 内核 deb 安装步骤（`linux-base` / DKMS / Secure Boot）：[docs/OPERATION_Install_CustomKernel_Ubuntu_HWE617.md](docs/OPERATION_Install_CustomKernel_Ubuntu_HWE617.md)
- Ubuntu HWE 6.17 源码与补丁：[kernel-src/README.md](kernel-src/README.md)、[patches/ubuntu-hwe-6.17/](patches/ubuntu-hwe-6.17/)
- 自编内核安装：[docs/kernel-build/OPERATION_Install_CustomKernel_Ubuntu_HWE617.md](docs/kernel-build/OPERATION_Install_CustomKernel_Ubuntu_HWE617.md)
- Linux SOF 固件实验与回退：[audio_topology/OPERATION_Force_Intel_Signed_Firmware.md](audio_topology/OPERATION_Force_Intel_Signed_Firmware.md)
- 双系统：[docs/meta/OPERATION_DualBoot_Ubuntu24_Windows.md](docs/meta/OPERATION_DualBoot_Ubuntu24_Windows.md)
**脚本一览**（`ubuntu-hwe-617-build.sh`、采集、diff、trace 等）： [docs/INDEX.md](docs/INDEX.md) 文末「脚本」表。
**拓扑采集脚本说明**：[audio_topology/COLLECT.md](audio_topology/COLLECT.md)