# Windows 音频修复说明（Chromebox 10 代 / Kaisa）

**体例**：[../meta/DOCUMENTATION_STYLE.md](../meta/DOCUMENTATION_STYLE.md)。**Linux / Windows 两行概况**见根 [README.md](../../README.md)；本文只写 **Windows 侧** CoolStar / ALC5682。

针对 **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)