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
2.5 KiB
2.5 KiB
LiveCD 验证:UCM(HiFi / Jack-driven)方案
目标:在 Ubuntu Live 环境里验证 本仓库的 UCM2 + HiFi 是否能实现:
- HDMI 插入才显示为输出
- HDMI 测试音正常、切换正常
1) Live 原生基线(不装任何东西)
目的:确认 Live 的内核/驱动本身没把 HDMI 搞死(排除“纯驱动级”问题)。
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仓库(需要网络)
在仓库根目录执行:
./scripts/install-kaisa-ucm-overlay.sh
systemctl --user restart wireplumber pipewire pipewire-pulse
说明:
- Live 环境通常没有你的 pro-audio 方案,所以一般不需要跑
disable-kaisa-pro-audio-wireplumber.sh(跑了也多半是空操作)。
3) 验收 UCM 是否真的生效(关键)
alsaucm -c sof-rt5682 list _verbs
pactl list cards
预期:
alsaucm应列出HiFipactl list cards的 配置文件 里应出现HiFi:
若 HiFi: 已出现但活动配置不是 HiFi,手动切一次:
pactl set-card-profile "$(pactl list cards short | awk '/cml_rt5682/ {print $2; exit}')" HiFi
4) 验收“插线才出现 HDMI” + 出声
- 拔掉 HDMI:GNOME 输出列表应只剩模拟(或 HDMI 变不可用)
- 插上 HDMI:应出现 HDMI1/HDMI2(以及显示器名),并可用测试音验证
终端验收(可选):
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的变化