07 DAPM 路由断链与 XRUN 欠载案例¶

1. 案例背景：用户态执行播放命令卡死且扬声器死寂无声¶

某款工控平板在适配新型主板时，软件工程师执行：

tinyplay /test.wav -D 0 -d 0

2. 调试定位全过程与 DAPM 路由图深潜¶

sequenceDiagram
    autonumber
    participant User as tinyplay 命令
    participant Kernel_ALSA as ALSA Core
    participant DAPM as DAPM 电源管理引擎
    participant PA as 外部扬声器功放

    User->>Kernel_ALSA: open() -> hw_params() -> write()
    Kernel_ALSA->>DAPM: 触发声卡激活事件 (snd_soc_dapm_stream_event)
    DAPM->>DAPM: 遍历 DAPM 有向图，检查从 'Playback Stream' 到 'SPK' 是否连通
    Note over DAPM: 【断链发现】'Left Mixer' 处的 'SPK Switch' 控件在系统启动时默认值为 0 (断开!)
    Note over DAPM: 判定结论：没有任何活跃输出设备需要该流，属于孤立假播放!
    DAPM-->>PA: 保持功放电源关闭 (不使能 PA)
    Note over Kernel_ALSA: 驱动未启动底层 DMA，硬件指针不推进，10秒后因写入超时爆发 Broken pipe (XRUN)

深入分析排查步骤¶

1. 查看声卡拓扑状态（DAPM 调试秘籍）： Linux 内核提供了强大的 Debugfs 接口，直接反映每个 DAPM Widget 的物理供电状态：

   cat /sys/kernel/debug/asoc/my-soundcard/dapm/SPK
   # 输出显示: SPK: Off (电源关闭)
   cat /sys/kernel/debug/asoc/my-soundcard/dapm/Playback\ Stream
   # 输出显示: Playback Stream: Off (未连通到任何有效终端!)
   

2. 检查底层 Mixer 控件状态：

   tinymix
   # 检查输出列表，发现关键控制项:
   # 12 BOOL 1 Speaker Switch: [Off]  <-- 默认处于关闭状态!
   

3. 根因剖析（Root Cause）¶

1. DAPM 路由默认未导通：Machine 驱动虽然定义了完整的拓扑有向图，但用于连通信号的关键 Kcontrol 控件（Speaker Switch）在内核加载时的默认初始值是 0（关闭）。
2. ALSA 驱动缺少默认音频配置文件（UCM / State）：系统缺少 asound.state 初始化脚本，导致用户态认为声卡已就绪，而内核 DAPM 认为通路断开，从而压根未给后级功放供电。

4. 解决方案与修复代码¶

1. 软件快速修复（用户态打开开关）¶

执行初始化配置命令：

tinymix "Speaker Switch" 1
tinymix "DAC Playback Volume" 120
tinyplay /test.wav -D 0 -d 0  # 扬声器瞬间洪亮发声!

2. 驱动级加固修复（定义默认连通路径）¶

在 Machine Driver 中，将常开的关键链路声明为无开关的直连线（使用 NULL 替代开关名）：

static const struct snd_soc_dapm_route fixed_audio_routes[] = {
    // 关键修复: 将受控开关改为硬件直连通拓扑，保证开机默认连通
    { "Speaker Amp", NULL, "DAC Output" },
    { "SPK", NULL, "Speaker Amp" },
};