docs/scripts(kaisa): add doctor verify mode and HDMI readiness checks

Add a more detailed --verify flow to capture Jack/ELD/subdevices, route per sink, and collect kernel error windows. Improve --fix with readiness gating, retries, and connected-only selection; document single-monitor pcm mapping behavior and ignore local logs/artifacts.

Made-with: Cursor
This commit is contained in:
2026-04-09 22:26:35 +08:00
parent bda6b60c15
commit 60b7cd389f
14 changed files with 1406 additions and 76 deletions

View File

@@ -0,0 +1,24 @@
# 重启后若「必现无声」,可启用本 user 单元:登录后自动执行与
# kaisa-audio-doctor.sh --fix 相同的收敛(实际调用 scripts/kaisa-audio-boot-fix.sh
#
# 安装(把下面 @REPO@ 换成仓库绝对路径,或复制后手工改 ExecStart 一行):
# mkdir -p ~/.config/systemd/user
# sed "s|@REPO@|$HOME/文档/chromebox_10th_audio_driver|g" kaisa-ucm-hifi-boot-fix.service > ~/.config/systemd/user/kaisa-ucm-hifi-boot-fix.service
# chmod +x .../scripts/kaisa-audio-boot-fix.sh .../scripts/kaisa-audio-doctor.sh
# systemctl --user daemon-reload
# systemctl --user enable --now kaisa-ucm-hifi-boot-fix.service
#
# 日志:~/.local/state/kaisa-audio/last-boot-fix.log或环境变量 KAISA_BOOT_FIX_LOG
#
[Unit]
Description=Kaisa sof-rt5682: post-login audio convergence (UCM HiFi, same as doctor --fix)
After=wireplumber.service pipewire-pulse.service pipewire.service
Wants=wireplumber.service
[Service]
Type=oneshot
RemainAfterExit=yes
ExecStart=@REPO@/scripts/kaisa-audio-boot-fix.sh
[Install]
WantedBy=default.target