docs(next): add single-monitor HDMI pcm mapping checklist

Document the fixed evidence commands (Jack/ELD/pactl) and A/B/A reboot procedure to confirm how a single monitor maps to ALSA HDMI pcms.

Made-with: Cursor
This commit is contained in:
2026-04-09 22:34:44 +08:00
parent 60b7cd389f
commit 9346a81935

33
next.md
View File

@@ -23,3 +23,36 @@
./scripts/kaisa-audio-doctor.sh --fix --verify --only-connected --retries 10 ./scripts/kaisa-audio-doctor.sh --fix --verify --only-connected --retries 10
``` ```
## 单显示器:物理 HDMI 口与 pcm 映射验证(固定证据)
目的:验证“**只接一个显示器**时,不管插哪个物理 HDMI 口,系统是否都最终映射到同一个 ALSA HDMI pcm常见为 `pcm=2`)”。
### 每次进桌面后跑(固定证据)
```bash
amixer -c0 cget "iface=CARD,name='HDMI/DP,pcm=2 Jack'"
amixer -c0 cget "iface=CARD,name='HDMI/DP,pcm=3 Jack'"
amixer -c0 cget "iface=CARD,name='HDMI/DP,pcm=4 Jack'"
amixer -c0 cget "iface=PCM,name='ELD',device=2" | head -n 3
amixer -c0 cget "iface=PCM,name='ELD',device=3" | head -n 3
amixer -c0 cget "iface=PCM,name='ELD',device=4" | head -n 3
pactl list cards | sed -n '/cml_rt5682_def/,+220p' | \
grep -nE '\\[Out\\] HDMI|availability group|available|not available|device\\.product\\.name'
```
判读要点:
- `Jack values=on`:该 pcm 的 HDMI/DP 口当前被内核认为“连着线/有连接”
- `ELD values>0`:该 pcm 读取到了显示器 ELD通常说明 EDID/ELD 就绪)
- `pactl` 里对应 `HDMI/DP,pcm=N``available/not available`:与 Jack/ELD 应一致
### 建议做 3 轮A/B/A
- 轮 1只插物理口 A → **重启** → 采证据
- 轮 2只插物理口 B → **重启** → 采证据
- 轮 3回到物理口 A → **重启** → 采证据(看是否仍一致)
如果三轮都显示同一个 pcm例如 `pcm=2`)的 `Jack=on``ELD>0`,即可认为“单显示器时物理口切换不会改变 pcm 映射”在当前系统上成立。