jack
bda6b60c15
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
83 lines
2.5 KiB
Markdown
83 lines
2.5 KiB
Markdown
## LiveCD 验证：UCM（HiFi / Jack-driven）方案
|
||
|
||
目标：在 Ubuntu Live 环境里验证 **本仓库的 UCM2 + HiFi** 是否能实现：
|
||
|
||
- HDMI **插入才显示为输出**
|
||
- HDMI **测试音正常**、切换正常
|
||
|
||
### 1) Live 原生基线（不装任何东西）
|
||
|
||
目的：确认 Live 的内核/驱动本身没把 HDMI 搞死（排除“纯驱动级”问题）。
|
||
|
||
```bash
|
||
uname -a
|
||
aplay -l
|
||
amixer -c0 sset 'IEC958',0 on
|
||
amixer -c0 sset 'IEC958',1 on
|
||
amixer -c0 sset 'IEC958',2 on
|
||
speaker-test -D pulse -c2 -t sine -f 440 -l 2
|
||
```
|
||
|
||
说明：
|
||
|
||
- 若 `-D pulse` 不通，再用 ALSA 直连（例如 `speaker-test -D hw:0,3 ...`），但**不要在 PipeWire 运行时**直连 `hw:0,N`，否则会遇到 `EBUSY` 或把状态搅乱。
|
||
|
||
### 2) 在 Live 里临时安装本仓库 UCM 方案
|
||
|
||
有两种方式，选你方便的：
|
||
|
||
- **方式 A（推荐）**：把仓库放到另一只 U 盘/同一只启动盘的可写分区里，Live 启动后挂载再执行脚本
|
||
- **方式 B**：Live 里 `git clone` 仓库（需要网络）
|
||
|
||
在仓库根目录执行：
|
||
|
||
```bash
|
||
./scripts/install-kaisa-ucm-overlay.sh
|
||
systemctl --user restart wireplumber pipewire pipewire-pulse
|
||
```
|
||
|
||
说明：
|
||
|
||
- Live 环境通常**没有**你的 pro-audio 方案，所以一般**不需要**跑 `disable-kaisa-pro-audio-wireplumber.sh`（跑了也多半是空操作）。
|
||
|
||
### 3) 验收 UCM 是否真的生效（关键）
|
||
|
||
```bash
|
||
alsaucm -c sof-rt5682 list _verbs
|
||
pactl list cards
|
||
```
|
||
|
||
预期：
|
||
|
||
- `alsaucm` 应列出 `HiFi`
|
||
- `pactl list cards` 的 **配置文件** 里应出现 `HiFi:`
|
||
|
||
若 `HiFi:` 已出现但活动配置不是 HiFi，手动切一次：
|
||
|
||
```bash
|
||
pactl set-card-profile "$(pactl list cards short | awk '/cml_rt5682/ {print $2; exit}')" HiFi
|
||
```
|
||
|
||
### 4) 验收“插线才出现 HDMI” + 出声
|
||
|
||
- **拔掉 HDMI**：GNOME 输出列表应只剩模拟（或 HDMI 变不可用）
|
||
- **插上 HDMI**：应出现 HDMI1/HDMI2（以及显示器名），并可用测试音验证
|
||
|
||
终端验收（可选）：
|
||
|
||
```bash
|
||
pactl list short sinks
|
||
speaker-test -D pulse -c2 -t sine -f 440 -l 3
|
||
```
|
||
|
||
### 5) 常见坑（Live 特有）
|
||
|
||
- **user systemd 不完整**：`systemctl --user restart ...` 失败时，注销/重登 Live 会话再试一次
|
||
- **误用 ALSA 直连**：PipeWire 运行时对 `hw:0,N` 直连会 `EBUSY`；优先 `-D pulse`
|
||
|
||
---
|
||
|
||
如果需要我远程判定“Live 是否真正验证了 UCM 方案”，请贴：
|
||
|
||
- `pactl list cards`（包含“配置文件”那段）
|
||
- 插拔 HDMI 前后 `pactl list short sinks` 的变化 |