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

docs(kaisa): make UCM HiFi the only supported path

Browse Source 
Promote UCM2/HiFi (Jack-driven) as the primary delivery, add HISTORY.md,
remove ProAudio/REPRO docs and non-UCM scripts, and fix repo-wide references.

Made-with: Cursor
This commit is contained in:
jack
2026-04-08 15:22:45 +08:00
parent 17f0a4521f
commit bda6b60c15
33 changed files with 384 additions and 1780 deletions
Download Patch File Download Diff File Expand all files Collapse all files

13
reference/ucm2/GoogleKaisa/sof-rt5682/HiFi.conf
View File

@@ -1,8 +1,17 @@
# Google Kaisa — sof-rt5682 / Intel Kabylake HDMI
# 本文件由 SectionUseCase."HiFi" 引用；须使用顶层 SectionDevice（勿再包一层 SectionVerb），
# 否则 alsaucm 报「no use case device defined」，PipeWire 不会出现 HiFi profile。
# 本文件由 conf.d/sof-rt5682/sof-rt5682.conf 中 SectionUseCase."HiFi" 引用。
# 须有 SectionVerb + Value.TQ（与上游 ucm2 中 Intel/*/HiFi.conf 一致），PipeWire/ACP 才会把
# 「HiFi」注册为 pactl 可见的 card profile；仅有顶层 SectionDevice 时 alsaucm 可能仍列出
# HiFi，但活动配置会卡在 off、配置列表只剩 off + pro-audio。
# HDMI：device 2/3/4；JackControl + IEC958 numid 与本机 amixer 对齐。
# SectionVerb 内勿使用 disdevall：部分 SOF 卡会导致 PipeWire 不把 HiFi 注册进 EnumProfile。
SectionVerb {
Value {
TQ "HiFi"
}
}
SectionDevice."Port1" {
Comment "Analog (Port1)"

8
reference/ucm2/README.md
View File

@@ -1,15 +1,15 @@
# Kaisa UCM2 overlay（`sof-rt5682`）
本目录为 **alsa-ucm-conf** 风格的 **UCM2** 草稿，目标：**Jack off 时 HDMI 路由对 ACP/桌面不表现为可随意可用的输出**（与强制 **`pro-audio`** 的 WirePlumber 策略不同，见 **[UCM 操作文档](../../docs/linux-hdmi/OPERATION_PipeWire_Kaisa_UCM_HiFi.md)** 与 **[ProAudio 文档](../../docs/linux-hdmi/OPERATION_PipeWire_Kaisa_ProAudio.md)**）。
本目录为 **alsa-ucm-conf** 风格的 **UCM2** 草稿，目标：**Jack off 时 HDMI 路由对 ACP/桌面不表现为可随意可用的输出**（与强制 **`pro-audio`** 的 WirePlumber 策略不同；主交付文档见 **[UCM 操作文档](../../docs/linux-hdmi/OPERATION_PipeWire_Kaisa_UCM_HiFi.md)**）。
## 布局
| 路径（相对 `ucm2/` 根） | 说明 |
|-------------------------|------|
| `conf.d/sof-rt5682/sof-rt5682.conf` | 卡入口，匹配 ALSA **card name** `sof-rt5682` |
| `GoogleKaisa/sof-rt5682/HiFi.conf` | HiFi：`Port1` + **HDMI1/2/3**，**JackControl** + **`IEC958',N`** |
| `GoogleKaisa/sof-rt5682/HiFi.conf` | HiFi：**`SectionVerb` + `Value.TQ "HiFi"`** + **`Port1` / HDMI1/2/3**，**JackControl** + **`IEC958',N`**（供 PipeWire 注册 **`HiFi:`** profile） |
上游 **alsa-ucm-conf** 若日后增加同名 `conf.d/sof-rt5682/`，与 **本 overlay 或历史 deb 路径** 可能冲突 — 优先 **合并上游** 或 **改名/拆包**（与 [UCM / ProAudio 文档](../../docs/linux-hdmi/OPERATION_PipeWire_Kaisa_UCM_HiFi.md) 中互斥说明一致；**deb 当前不作为交付**，见 [ProAudio §4.4](../../docs/linux-hdmi/OPERATION_PipeWire_Kaisa_ProAudio.md)）。
上游 **alsa-ucm-conf** 若日后增加同名 `conf.d/sof-rt5682/`，与 **本 overlay** 可能冲突 — 优先 **合并上游** 或 **改名/拆包**（与 [UCM 文档](../../docs/linux-hdmi/OPERATION_PipeWire_Kaisa_UCM_HiFi.md) 的互斥说明一致）。
## 手工安装（调试）
@@ -46,7 +46,7 @@ alsaucm -c sof-rt5682 set _verb HiFi list _devices
插拔 HDMI 时对照 **`amixer -c0`** 中 **`HDMI/DP,pcm=N` Jack** 与 **`IEC958',N`**。
**一次跑完（推荐）**：在仓库根目录执行 **`./scripts/verify-kaisa-audio-environment.sh`**（可选 **`--output ~/kaisa-audio-verify.txt`**），覆盖硬件枚举、UCM、PipeWire、WirePlumber 与摘要；详见 [ProAudio 文档](../../docs/linux-hdmi/OPERATION_PipeWire_Kaisa_ProAudio.md)「一键环境验证」。
（可选）环境采集脚本已从仓库移除；建议直接按 **[UCM 操作文档](../../docs/linux-hdmi/OPERATION_PipeWire_Kaisa_UCM_HiFi.md)** 的验收命令（`alsaucm` / `pactl` / `wpctl` / `amixer`）逐项核对。
## 实机验收表（勾选）