📚 课程目录第4章音频驱动与ALSA框架

4. 音频驱动与ALSA框架

在Linux音频子系统中，ALSA（Advanced Linux Sound Architecture）负责向用户空间提供PCM、控制接口与混音器节点，而ALSA SoC（ASoC）层则专门解决嵌入式SoC上音频链路“可拆分、可复用、可动态管理”的问题。Snapdragon平台上的音频驱动正是围绕ASoC的三类驱动模型展开：machine driver描述板级连接，platform driver管理SoC侧DMA与DAI控制器，codec driver控制外部编解码器或片上音频编解码模块。三者通过DAI（Digital Audio Interface）与DAPM（Dynamic Audio Power Management）连接，最终以kcontrol暴露给用户空间进行路由与音量控制。

一、ASoC的三层驱动结构

ASoC将传统ALSA声卡拆分为三个可独立注册的组件。platform driver对应Snapdragon内部的音频接口控制器，例如LPASS（Low Power Audio SubSystem）中的I2S、MI2S、TDM或SoundWire控制器，它负责FE（Front End）与BE（Back End）DMA、时钟和DAI操作。codec driver对应WCD938x、WSA881x等编解码器或功放芯片，负责寄存器初始化、上电时序、增益与DAPM widget。machine driver则把两者“粘合”起来，定义dai_link、时钟主从关系、引脚复用和路由，最终调用snd_soc_register_card()注册声卡。

在设备树中，这三类驱动通过compatible、sound-dai、cpu-dai等属性关联。例如一个典型的Snapdragon板级节点会写成：

sound {
    compatible = "qcom,sm8250-sndcard";
    model = "SM8250-WCD938x";
    qcom,mi2s-primary;
    dai-link@0 {
        link-name = "MultiMedia0";
        cpu { sound-dai = <&lpass_cpu MI2S_PRIMARY>; };
        codec { sound-dai = <&wcd938x 0>; };
    };
};

machine driver解析该节点后，会为每个dai_link创建snd_soc_dai_link结构，并绑定platform与codec。当声卡注册成功，用户空间即可看到对应的PCM设备（如hw:0,0）和kcontrol节点。

二、DAI与DAPM：连接与供电的协同

DAI是数字音频接口的抽象，描述数据格式（I2S、TDM、PDM）、时钟极性、帧同步和slot宽度。Snapdragon的LPASS通常支持多组MI2S，每组可配置为主模式或从模式。主模式下SoC输出BCLK与WS；从模式下则由外部codec提供时钟。DAI的配置必须与codec端严格匹配，否则会出现无声音、噪声或采样率偏移。

DAPM是ASoC的动态电源管理机制。它把codec内部和板级路径抽象为widget（如Mixer、Mux、PGA、ADC、DAC、Speaker），并用route描述连接关系。当PCM流打开或关闭时，DAPM根据当前激活的路径自动上电或断电相关模块，从而在不播放时关闭codec偏置和功放，显著降低功耗。在Snapdragon上，DAPM还常与LPASS的时钟门控、电源域（如audio_core）联动，形成从SoC到codec的完整供电链。

三、kcontrol与用户空间控制

kcontrol是ASoC向用户空间暴露的混音器控制单元，类型包括SNDRV_CTL_ELEM_IFACE_MIXER、MUX、ENUM等。codec driver在初始化时通过snd_soc_add_component_controls()注册控件，machine driver也可通过snd_soc_add_card_controls()添加板级控件。用户空间使用amixer或tinymix即可读写。例如在Snapdragon开发板上，常用命令如下：

# 查看声卡
tinymix -D 0
# 设置主输出音量
tinymix -D 0 "Master Playback Volume" 85
# 选择扬声器路径
tinymix -D 0 "RX_MACRO RX0 MUX" "AIF1_PB"
# 播放测试
tinyplay /data/test.wav -D 0 -d 0

当播放无声时，首先应检查kcontrol中对应路径是否打开，再确认DAI格式与时钟是否匹配，最后用dmesg查看DAPM上电日志。Snapdragon平台常见的DAPM日志会显示“wcd938x_codec: wcd938x_rx1_mixer: On”之类的信息，可据此判断供电路径是否真正激活。

四、Snapdragon上的实现要点

在Snapdragon平台上，LPASS通常作为platform driver的核心，其DMA由ADSP或APSS管理。FE DAI用于PCM流，BE DAI用于连接codec。machine driver需要正确配置“qcom,mi2s-*”属性与codec的dai_name。对于WCD938x，codec driver会注册多个DAI（如AIF1_PB、AIF1_CAP），machine driver需在dai_link中指定codec_dai_name。此外，Snapdragon的音频时钟常由LPASS的audio PLL提供，machine driver需通过set_sysclk()设置MCLK频率，例如为48kHz采样率提供12.288MHz或24.576MHz主时钟。

DAPM路由在Snapdragon上通常由codec driver的dapm_widgets和dapm_routes数组定义，machine driver可通过snd_soc_dapm_add_routes()追加板级路由。调试时，可读取/sys/kernel/debug/asoc/下的dapm目录，查看每个widget的当前状态与电源域。若发现某路径未上电，应检查route是否完整、kcontrol是否被正确设置，以及codec的regmap读写是否成功。

调试提示：在Snapdragon上，若PCM打开失败并返回-EINVAL，优先检查dai_link的platform_name与cpu_dai_name是否与设备树一致；若播放有噪声，检查BCLK与WS的极性、slot宽度以及codec的TDM模式配置。

总体而言，理解ASoC的三层驱动模型、DAI的匹配规则、DAPM的供电逻辑以及kcontrol的控制路径，是在Snapdragon平台上完成音频驱动移植与调试的基础。实际开发中，应结合设备树、dmesg日志与tinymix工具，逐层验证从SoC到codec的完整音频链路。