更新源码

docs/windows/OPERATION_Windows_Audio.md

@@ -0,0 +1,93 @@
+# Windows 音频修复说明（Chromebox 10 代 / Kaisa）
+
+针对 **Coreboot 刷机后**：HDMI（英特尔显示器音频）正常，**3.5mm / Realtek ALC5682 I2S 无声、无插拔提示** 的情况。与 Linux 问题相反，修法依赖 **CoolStar / Chrultrabook 驱动栈**，不是桌面机通用 Realtek 安装包。
+
+分析背景见 [ANALYSIS_Audio.md](../../audio_topology/ANALYSIS_Audio.md)；采集样例见 `audio_topology/collected/audio_topology_windows_*.txt`。
+
+**Hardware ID → 驱动包类型映射**（按设备管理器里的 `CSAUDIO\...` / `ACPI\10EC5682\...` / `HDAUDIO\...VEN_8086&DEV_280B...` 等对号入座）：见 [HARDWARE_ID_DRIVER_MAP_Windows.md](HARDWARE_ID_DRIVER_MAP_Windows.md)。
+
+---
+
+## 现象与要点（对照设备管理器）
+
+| 设备 | 常见状态 | 含义 |
+|------|----------|------|
+| **英特尔(R) 显示器音频** | OK | HDMI 走 HDA，一般无需再动 |
+| **Realtek ALC5682 I2S Audio** | OK 但无声 | I2S codec 驱动已挂，但路由或与 SOF 协同异常 |
+| **CoolStar SOF Audio (WDM)** | **Error** | 不少机型上 **3.5mm 依赖 SOF 相关栈**；此处报错时，容易出现「ALC5682 看似正常却不出声」 |
+
+**结论**：优先消除 **CoolStar SOF Audio** 错误，再按官方顺序重装 **ALC5682 I2S**，不要单独用网上下载的通用 Realtek 安装程序覆盖。
+
+---
+
+## 一、准备
+
+1. 确认机型为 **Kaisa（puff 系）** 或与你主板一致的 Chrultrabook 条目。
+2. 准备 **CoolStar 驱动**：从购买授权时提供的 **驱动门户** 或 [CoolStar Chromebook Windows](https://coolstar.org/chromebook/windows-install.html) 机型页获取 **当前推荐版本**（包内通常含 HD Audio、SOF、I2S 等）。
+3. 备份当前系统或创建还原点。
+
+---
+
+## 二、推荐安装顺序（概要）
+
+具体以 **Chrultrabook Post-install** 与 **CoolStar 包内 readme** 为准，常见顺序为：
+
+1. 安装/更新 **CoolStar HD Audio**（若包内要求）。
+2. 安装/更新 **CoolStar SOF Audio (Intel/I2S)**（需有效授权时按说明激活）。
+3. 安装/更新 **Realtek ALC5682 I2S**（多在同一个包或后续步骤中）。
+4. **重启**后再测 3.5mm。
+
+参考：[Chrultrabook Post-install 音频](https://docs.chrultrabook.com/docs/installing/post-install.html)。
+
+---
+
+## 三、设备管理器排查
+
+### 1. 处理 CoolStar SOF Audio (WDM) 的 Error
+
+1. **属性 → 常规**：记录 **错误代码**（如 10、43 等）与文字说明。
+2. **属性 → 驱动程序**：
+   - **更新驱动**：指向 CoolStar 解压目录（**不要让 Windows 自动搜索互联网**）。
+   - 若无效：**卸载设备**（可选勾选「删除此设备的驱动程序软件」）→ 重启 → 用 **「操作 → 扫描检测硬件改动」** 或重新运行 CoolStar 安装程序。
+3. 仍 Error：到 [Chrultrabook 论坛](https://forum.chrultrabook.com/) 搜索 **机型名 + SOF + 错误码**；或向 CoolStar 支持提交工单（附 `pnputil` / 设备实例 ID）。
+
+### 2. Realtek ALC5682 I2S Audio
+
+1. 在 SOF 设备已正常或至少安装流程完整执行后，对 **ALC5682** 再执行一次 **更新驱动**（指定 CoolStar 目录）。
+2. 必要时 **卸载 ALC5682** → 重启 → 再安装，避免残留旧 `oem*.inf` 冲突。
+3. 不要用 **Alienware/台式机** 等通用 Realtek UAD 包——ACPI/I2S 与 Chromebox 不一致。
+
+---
+
+## 四、系统侧检查
+
+1. **设置 → 系统 → 声音**：默认输出选 **耳机 / Realtek / 模拟**（勿只选「显示器音频」）。
+2. 确认 **Windows Audio**、**Windows Audio Endpoint Builder** 服务为「正在运行」。
+3. 运行 **声音疑难解答**，排除应用独占或静音。
+
+---
+
+## 五、仍无声时
+
+1. **事件查看器**：应用程序和服务日志 → Microsoft → Windows → Audio 相关项，查看与插拔、驱动加载有关的错误时间是否与重装一致。
+2. **论坛**：带关键字 **Kaisa / puff、ALC5682、headphone、jack、CSAUDIO** 检索；同板卡已有解决方案时直接复现步骤。
+3. **插孔检测 / 注册表**：属进阶（README **W4**），仅在确认驱动版本与 SOF 状态正常后、且论坛有明确指引时再改，避免系统不稳定。
+
+---
+
+## 六、与仓库任务对应
+
+| README | 内容 |
+|--------|------|
+| **W1–W2** | 本机驱动需求与芯片确认（ALC5682 I2S + CoolStar SOF） |
+| **W3** | 按上文消除 Error、重装 I2S、设默认设备 |
+| **W4** | 插拔提示：依赖 HDA/codec 与 jack 检测，多在驱动与 DDI 正确后恢复 |
+
+---
+
+## 参考链接
+
+- <https://docs.chrultrabook.com/docs/installing/post-install.html>
+- <https://forum.chrultrabook.com/>
+- <https://coolstar.org/chromebook/windows-install.html>
+- 对比分析：[ANALYSIS_Audio.md](../../audio_topology/ANALYSIS_Audio.md)