4. ASoC 框架分层：Machine、Platform、Codec 三层架构详解

在嵌入式 Linux 音频驱动开发中，ALSA SoC（ASoC）框架通过将音频子系统抽象为 Machine、Platform、Codec 三个独立层次，实现了驱动代码的高度复用与模块化设计。理解这三层架构是编写高质量音频驱动的核心基础。

4.1 三层架构总览

ASoC 的三层分别对应音频数据通路中的不同硬件角色：

• Machine 层： 板级音频拓扑描述，负责将 Platform 和 Codec 绑定在一起，并定义音频路由、时钟、GPIO 等板级约束。
• Platform 层： CPU 侧音频接口驱动，负责 DMA 传输、CPU 侧 DAI（Digital Audio Interface）配置、以及音频数据在内存与 FIFO 之间的搬运。
• Codec 层： 外部音频编解码器驱动，负责 Codec 芯片内部的寄存器控制、音频路径切换、采样率/位深设置、以及 DAPM（动态音频电源管理）控制。

4.2 Machine 层：板级音频拓扑

Machine 层是板级特定的驱动代码，通常位于 sound/soc/ 下的厂商目录中。它的核心职责是描述“这个板子上，CPU 的哪个 DAI 连接了哪个 Codec”。

典型的 Machine 驱动初始化流程：

1. 定义 snd_soc_dai_link 数组，填充 CPU DAI 名称、Codec 名称、平台名称。
2. 定义 snd_soc_card，关联 DAI Link 数组、DAPM 路由表、控件映射。
3. 在平台驱动 probe 中调用 devm_snd_soc_register_card() 注册声卡。

/* Machine 层 DAI Link 示例 */
static struct snd_soc_dai_link imx_wm8960_dai_link = {
    .name           = "WM8960 HiFi",
    .stream_name    = "WM8960 HiFi",
    .codec_dai_name = "wm8960-hifi",
    .codec_name     = "wm8960.0-001a",
    .cpu_dai_name   = "2030000.sai",
    .platform_name  = "2030000.sai",
    .dai_fmt        = SND_SOC_DAIFMT_I2S | SND_SOC_DAIFMT_NB_NF |
                      SND_SOC_DAIFMT_CBM_CFM,
    .ops            = &imx_wm8960_ops,
};

4.3 Platform 层：CPU 侧音频引擎

Platform 层负责 CPU 侧的音频数据传输与控制，主要包括两个部分：

• CPU DAI 驱动： 配置 I2S/PCM/TDM 接口的时钟、帧同步、数据格式，对应 snd_soc_dai_driver。
• DMA 引擎驱动： 管理音频数据在内存与 CPU DAI FIFO 之间的 DMA 传输，对应 snd_soc_platform_driver。

Platform 层通常由 SoC 厂商提供通用驱动（如 fsl_sai.c、stm32_i2s.c），开发者一般不需要修改，只需在设备树中配置对应的 DAI 节点。

4.4 Codec 层：外部编解码器控制

Codec 层驱动封装了音频编解码芯片的所有硬件操作，包括寄存器读写、音频路径切换、音量控制、动态电源管理（DAPM）等。

Codec 驱动的核心结构：

• snd_soc_codec_driver：定义 Codec 的读写函数、控件注册、DAPM 配置。
• snd_soc_dai_driver：定义 Codec 侧 DAI 的采样率、格式支持范围。
• snd_kcontrol_new：定义用户空间可访问的控件（音量、开关、EQ 等）。
• snd_soc_dapm_widget 和 snd_soc_dapm_route：定义内部音频路径和电源域。

/* Codec DAI 驱动示例（WM8960） */
static struct snd_soc_dai_driver wm8960_dai = {
    .name = "wm8960-hifi",
    .playback = {
        .stream_name = "Playback",
        .channels_min = 1,
        .channels_max = 2,
        .rates = WM8960_RATES,
        .formats = WM8960_FORMATS,
    },
    .capture = {
        .stream_name = "Capture",
        .channels_min = 1,
        .channels_max = 2,
        .rates = WM8960_RATES,
        .formats = WM8960_FORMATS,
    },
    .ops = &wm8960_dai_ops,
};

4.5 三层之间的交互流程

当用户播放音频时，三层之间的典型交互流程如下：

1. 应用层 通过 ALSA 库调用 snd_pcm_writei() 写入音频数据。
2. Platform 层 的 DMA 引擎将数据从用户空间缓冲区搬运到 CPU DAI 的 FIFO。
3. Platform 层 的 CPU DAI 按照 Machine 层配置的格式（I2S、采样率、位深）将数据串行发送到总线。
4. Codec 层 的 Codec DAI 接收总线数据，经过内部数字滤波、DAC 转换、音量控制后输出到耳机或扬声器。
5. 整个过程中，Machine 层 通过 DAPM 机制动态管理 Codec 内部各模块的电源开关，降低功耗。

4.6 三层架构的复用优势

4.7 设备树中的三层映射

在实际开发中，三层架构的绑定关系通常通过设备树（Device Tree）来描述：

/* 设备树中的三层映射示例 */
sound {
    compatible = "fsl,imx6q-sabresd-wm8960";
    model = "imx-wm8960";
    cpu-dai = <&sai1>;           /* Platform 层：CPU DAI 节点 */
    audio-codec = <&wm8960>;     /* Codec 层：Codec 节点 */
    /* Machine 层：通过 sound 节点将两者绑定 */
};

&sai1 {                           /* Platform 层：CPU DAI 配置 */
    pinctrl-names = "default";
    pinctrl-0 = <&pinctrl_sai1>;
    status = "okay";
};

&wm8960 {                         /* Codec 层：Codec 配置 */
    compatible = "wlf,wm8960";
    reg = <0x1a>;
    clocks = <&clks IMX6QDL_CLK_CKO>;
    clock-names = "mclk";
    status = "okay";
};

设备树中的 sound 节点对应 Machine 层，cpu-dai 属性指向 Platform 层的 CPU DAI 节点，audio-codec 属性指向 Codec 层的 Codec 节点。内核在解析设备树时，会自动匹配对应的驱动并建立三层之间的连接。