# `docs/` 说明

本目录保留 **已实机验证** 的 Kaisa（`sof-rt5682`）音频交付文档；当前主交付为 **UCM2 + HiFi（Jack-driven）**。

| 文档 | 内容 |
| ---- | ---- |
| [linux-hdmi/OPERATION_PipeWire_Kaisa_UCM_HiFi.md](linux-hdmi/OPERATION_PipeWire_Kaisa_UCM_HiFi.md) | **主路线（交付）**：UCM2、HiFi、Jack-driven 端口、IEC958、安装/验收/排障 |
| [linux-hdmi/DEBUG_Reboot_No_Sound_and_Fix.md](linux-hdmi/DEBUG_Reboot_No_Sound_and_Fix.md) | 排障记录：重启后无声与 `--fix` 恢复的证据与判因路径 |
| [linux-hdmi/ROOTCAUSE_Reboot_Silent_Analysis.md](linux-hdmi/ROOTCAUSE_Reboot_Silent_Analysis.md) | 根因深读：`default-routes` 极低 HDMI 音量 vs `set_hw_params` |

附属文件：`linux-hdmi/wireplumber/50-kaisa-sof-rt5682-hdmi.conf`、`linux-hdmi/systemd-user/kaisa-hdmi-iec958-pipewire.service`（旧 pro-audio 示例）、**`linux-hdmi/systemd-user/kaisa-ucm-hifi-boot-fix.service`（重启必现无声时登录自动 `--fix`）**。

仓库根 [README.md](../README.md) · 路径表 [REPO_INDEX.md](../REPO_INDEX.md)。