MECHREVO WUJIE14 PRO on Linux 声卡完整修复历程

为了解决我的机械革命无界 14 pro 笔记本在 linux debian testing(forky) 下的自带麦克风、自带扬声器、插入 3.5mm 耳机这三个场景下，对应硬件都能正常工作的问题，遂有了此文。

前景提要：机械革命无界14Pro笔记本debian forky成功驱动内置扬声器和麦克风

系统信息

目标

确保以下三个场景全部正常工作：

问题

插入 3.5mm 耳机后声音仍然从笔记本内置扬声器输出，耳机无声音。系统设置输入设备显示正常（内置数字麦克风可用）。

根因分析

三重故障叠加

┌─────────────────────────────────────────────────────────┐
│  问题 1：硬件插孔检测不工作                                │
│  ALSA 控制 "Headphone Jack" 始终 = off                    │
│  即使耳机物理插入，Codec (Node 0x21) 的 pin sense 未触发   │
│  可能原因：SOF 驱动与 ALC256 pin sense 事件处理有兼容问题    │
├─────────────────────────────────────────────────────────┤
│  问题 2：UCM2 启动时禁用 Auto-Mute                         │
│  /usr/share/alsa/ucm2/HDA/init.conf                      │
│  → cset "name='Auto-Mute Mode' off"                      │
│  设计意图：让 PipeWire 用户态管理切换，但 UCM2 配置有缺陷    │
├─────────────────────────────────────────────────────────┤
│  问题 3：Speaker 和 Headphones 在不同 HiFi Profile 中      │
│  两者共用 PlaybackPCM "hw:0"，ACP 拆分成了两个互斥 Profile  │
│  Headphones 依赖 JackControl，端口永远 "not available"     │
│  导致 PipeWire 无法激活耳机 DSP 通路                       │
└─────────────────────────────────────────────────────────┘

为什么 model= 参数无效

• 本机使用 SOF/avs 驱动栈（snd_soc_skl_hda_dsp），声卡名 sof-hda-dsp
• snd-hda-intel 模块虽然被加载，但依赖计数为 0，不参与实际驱动
• /etc/modprobe.d/alsa-alc256.conf 中配置的 options snd-hda-intel model=xxx 在 SOF 下不生效
• 修复后该文件应当为空（或直接删除），避免误导
• 强制使用传统 HDA（snd-intel-dspcfg.dsp_driver=1）会丢失内置 DMIC

音频拓扑（ALC256 Codec 节点路由）

                    ┌──────────┐
    hw:0 PCM ──────┤ DAC 0x02 │──┬── Pin 0x14 (Speaker) ── 扬声器
                    │ (Speaker)│  │
                    └──────────┘  │
                                  ├── Pin 0x1b (unused)
                                  └── Pin 0x21 (HP β) ── 耳机(辅)
                    ┌──────────┐
    hw:0 PCM ──────┤ DAC 0x03 │───── Pin 0x21* (HP α) ── 耳机(主)
                    │(Headphone)│
                    └──────────┘

                    * 表示活动连接

关键：两个 DAC 接收同一路 PCM 音频流，SOF DSP 固件根据激活的 Profile 控制哪个 DAC 通路工作。

修复历程（失败记录）

最终修复方案

核心思路

绕过硬件插孔检测，通过切换 Profile 来切换耳机/扬声器，让 WirePlumber 独立管理每个 Profile 的音量。

步骤

1. 修改 UCM2 配置，移除耳机 JackControl

# 备份
sudo cp /usr/share/alsa/ucm2/HDA/HiFi-analog.conf \
        /usr/share/alsa/ucm2/HDA/HiFi-analog.conf.bak

# 注释 JackControl 行（保留缩进）
sudo sed -i 's/^\([[:space:]]*\)JackControl "${var:hpjack}"/\1#JackControl "${var:hpjack}"/' \
    /usr/share/alsa/ucm2/HDA/HiFi-analog.conf

修改位置：/usr/share/alsa/ucm2/HDA/HiFi-analog.conf 第 156 行

         PlaybackSwitch "${var:hpvol} Playback Switch"
-        JackControl "${var:hpjack}"
+        #JackControl "${var:hpjack}"

效果：Headphones 端口不再依赖 Headphone Jack ALSA 控制，始终显示为可用（如同 Speaker 的 availability unknown）。

2. 创建快捷键切换脚本

~/.local/bin/toggle-audio.sh：

#!/bin/bash
# 在扬声器和耳机之间切换

CARD="alsa_card.pci-0000_00_1f.3-platform-skl_hda_dsp_generic"
SPK_PROFILE="HiFi (HDMI1, HDMI2, HDMI3, Mic1, Mic2, Speaker)"
HP_PROFILE="HiFi (HDMI1, HDMI2, HDMI3, Headphones, Mic1, Mic2)"
SPK_SINK="alsa_output.pci-0000_00_1f.3-platform-skl_hda_dsp_generic.HiFi__Speaker__sink"
HP_SINK="alsa_output.pci-0000_00_1f.3-platform-skl_hda_dsp_generic.HiFi__Headphones__sink"

current=$(pactl list cards 2>/dev/null | grep "Active Profile" | grep -o "Speaker")

if [ -n "$current" ]; then
    pactl set-card-profile "$CARD" "$HP_PROFILE"
    sleep 0.3
    pactl set-default-sink "$HP_SINK"
    for i in $(pactl list sink-inputs short 2>/dev/null | awk '{print $1}'); do
        pactl move-sink-input "$i" "$HP_SINK" 2>/dev/null
    done
    notify-send -a "音频切换" "已切换到耳机" -i audio-headphones
else
    pactl set-card-profile "$CARD" "$SPK_PROFILE"
    sleep 0.3
    pactl set-default-sink "$SPK_SINK"
    for i in $(pactl list sink-inputs short 2>/dev/null | awk '{print $1}'); do
        pactl move-sink-input "$i" "$SPK_SINK" 2>/dev/null
    done
    notify-send -a "音频切换" "已切换到扬声器" -i audio-speakers
fi

chmod +x ~/.local/bin/toggle-audio.sh

3. 绑定快捷键

GNOME 设置 → 键盘 → 查看及自定义快捷键 → 自定义快捷键 → 添加：

• 命令：/home/dk/.local/bin/toggle-audio.sh
• 快捷键：Super+Alt+S

4. 重启音频服务

systemctl --user restart wireplumber pipewire pipewire-pulse

注意事项

• alsa-ucm-conf 包更新后会覆盖修改的配置文件，需重新执行 sed 命令
• 备份文件位置：/usr/share/alsa/ucm2/HDA/HiFi-analog.conf.bak
• 恢复：sudo cp /usr/share/alsa/ucm2/HDA/HiFi-analog.conf.bak /usr/share/alsa/ucm2/HDA/HiFi-analog.conf

涉及知识点

ALSA 驱动栈

UCM2 关键文件

诊断用命令

# 查看声卡
cat /proc/asound/cards
aplay -l

# 查看 Codec 寄存器（Pin Sense、DAC 音量、静音状态）
cat /proc/asound/card0/codec#0

# 查看 ALSA 控制和插孔状态
amixer -c0 contents | grep -E "Jack|Auto-Mute|name="

# 查看 PipeWire 状态
pactl info | grep "Default Sink"
pactl list cards | grep -A2 "Active Profile"
pactl list sinks short

# 查看 snd_hda_intel 是否被使用
ls /sys/module/snd_hda_intel/holders/
cat /sys/module/snd_hda_intel/refcnt

# 查看内核参数
cat /proc/cmdline

# 手动控制 Codec
amixer -c0 cset name='Headphone Playback Switch' on,on
amixer -c0 cset name='Auto-Mute Mode' Enabled