jack
17f0a4521f
- 新增 OPERATION_PipeWire_Kaisa_ProAudio / UCM_HiFi，核心问题复盘与恢复 Ubuntu 重测手顺；HDMI 旧文改为 stub。 - 脚本：apply / verify-pro-audio、strip default-profile、reapply-session、remove deb 与 UCM overlay、verify-audio-environment。 - systemd-user：kaisa-pro-audio-reapply.service 示例。 - README、docs 索引、REPO_INDEX、REPRO deb 存档说明；deb 标为未来计划；reference/ucm2 与采集脚本小改。 - debian 与 _bmad-output 规划文件随本次工作区一并更新。 Made-with: Cursor
62 lines
3.1 KiB
Markdown
62 lines
3.1 KiB
Markdown
# 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)**）。
|
||
|
||
## 布局
|
||
|
||
| 路径（相对 `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`** |
|
||
|
||
上游 **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)）。
|
||
|
||
## 手工安装（调试）
|
||
|
||
**推荐（仓库根目录）**：先禁用强制 pro-audio 的 WirePlumber 片段，再一键安装 UCM + Lua：
|
||
|
||
```bash
|
||
./scripts/disable-kaisa-pro-audio-wireplumber.sh
|
||
./scripts/install-kaisa-ucm-overlay.sh
|
||
```
|
||
|
||
等价手工步骤：
|
||
|
||
```bash
|
||
sudo cp -a reference/ucm2/conf.d/sof-rt5682 /usr/share/alsa/ucm2/conf.d/
|
||
sudo cp -a reference/ucm2/GoogleKaisa /usr/share/alsa/ucm2/
|
||
sudo install -D -m0644 wireplumber/main.lua.d/60-kaisa-ucm.lua /usr/share/wireplumber/main.lua.d/60-kaisa-ucm.lua
|
||
sudo alsactl init # 或重登 / 重启 pipewire
|
||
systemctl --user restart wireplumber pipewire pipewire-pulse
|
||
```
|
||
|
||
## 与 WirePlumber **`50-kaisa-sof-rt5682-hdmi.conf` 的互斥**
|
||
|
||
- **UCM 模式（本 overlay）**：依赖 **ACP** 的 profile/端口；**请勿**再使用强制 **`device.profile = pro-audio`** 的片段，否则仍易出现 **多路 `pro-output-*` 常驻**。
|
||
- **过渡 pro-audio 模式**：保留现有 `wireplumber.conf.d` 片段；**不要**同时叠加本 UCM 覆盖（二选一）。
|
||
|
||
## 校验（可选）
|
||
|
||
若已安装 **`alsa-utils`**：
|
||
|
||
```bash
|
||
alsaucm -c sof-rt5682 list _verbs
|
||
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)「一键环境验证」。
|
||
|
||
## 实机验收表（勾选）
|
||
|
||
| 步骤 | 预期 |
|
||
|------|------|
|
||
| 仅接模拟 / 不接 HDMI | HDMI 相关输出不对「可用路由」误导（依桌面实现） |
|
||
| 接 HDMI，Jack on | 对应 **IEC958** on 后有声 |
|
||
| 拔线 Jack off | 该路不应再被选为有效 HDMI 输出 |
|
||
|
||
---
|
||
|
||
_控件名以本机 `amixer` 为准；若 `Headphone`/`IEC958` 命名不同，需改 `HiFi.conf` 后重测。_
|