Files
chromebox_10th_audio_driver/next.md
jack bda6b60c15 docs(kaisa): make UCM HiFi the only supported path
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
2026-04-08 15:22:45 +08:00

2.5 KiB
Raw Blame History

LiveCD 验证UCMHiFi / 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 启动后挂载再执行脚本
  • 方式 BLive 里 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 应列出 HiFi
  • pactl list cards配置文件 里应出现 HiFi:

HiFi: 已出现但活动配置不是 HiFi手动切一次

pactl set-card-profile "$(pactl list cards short | awk '/cml_rt5682/ {print $2; exit}')" HiFi

4) 验收“插线才出现 HDMI” + 出声

  • 拔掉 HDMIGNOME 输出列表应只剩模拟(或 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 的变化