3. Codec硬件架构概览

各位同学，今天我们来啃一块硬骨头——Linux ALSA SoC框架下的Codec驱动。说实话，我刚接触这个框架的时候，也被那一堆结构体和回调函数搞得晕头转向。但后来我发现，只要抓住三个核心：snd_soc_codec_driver、DAPM和kcontrol，整个驱动框架就像一张地图一样清晰了。

3.1 snd_soc_codec_driver：Codec驱动的“身份证”

每个Codec驱动，说白了就是向ALSA SoC框架注册一个snd_soc_codec_driver结构体。这个结构体描述了Codec的所有能力、控制接口和回调函数。我习惯把它比作Codec的“身份证”——框架通过它来认识你的硬件。

来看一个实际注册的例子。这是我之前移植某款Codec时写的代码片段：

static struct snd_soc_codec_driver my_codec_driver = {
    .probe = my_codec_probe,
    .remove = my_codec_remove,
    .controls = my_codec_controls,
    .num_controls = ARRAY_SIZE(my_codec_controls),
    .dapm_widgets = my_codec_dapm_widgets,
    .num_dapm_widgets = ARRAY_SIZE(my_codec_dapm_widgets),
    .dapm_routes = my_codec_dapm_routes,
    .num_dapm_routes = ARRAY_SIZE(my_codec_dapm_routes),
};

module_i2c_driver(my_codec_i2c_driver);

嗯，这里要注意：module_i2c_driver这个宏会把你的驱动挂到I2C总线上。如果你的Codec走的是SPI接口，记得换成module_spi_driver。我曾经见过有人I2C的Codec用了SPI的宏，结果驱动死活加载不上，查了两天才发现是这里错了。

3.2 DAPM机制：让电源管理“聪明”起来

DAPM，全称Dynamic Audio Power Management。说白了，就是让Codec知道什么时候该开电源，什么时候该关电源。你想想看，一个Codec内部有几十个模块——ADC、DAC、麦克风偏置、耳机放大器……如果全部同时供电，功耗肯定扛不住。

DAPM的核心思想是：只给正在使用的音频路径供电。比如你只播放音乐，那ADC和麦克风偏置就可以关掉。这个机制在嵌入式设备上特别重要——省电就是延长续航。

3.2.1 DAPM Widget：音频路径的“节点”

每个音频处理模块对应一个DAPM widget。我习惯把widget理解为音频路径上的一个“节点”。常见的widget类型有：

• SND_SOC_DAPM_INPUT：输入引脚，比如MIC_IN
• SND_SOC_DAPM_OUTPUT：输出引脚，比如HP_OUT
• SND_SOC_DAPM_ADC：模数转换器
• SND_SOC_DAPM_DAC：数模转换器
• SND_SOC_DAPM_MIXER：混音器
• SND_SOC_DAPM_MUX：多路选择器
• SND_SOC_DAPM_PGA：可编程增益放大器

定义widget的宏长这样：

static const struct snd_soc_dapm_widget my_codec_dapm_widgets[] = {
    SND_SOC_DAPM_INPUT("MIC_IN"),
    SND_SOC_DAPM_OUTPUT("HP_OUT"),
    SND_SOC_DAPM_ADC("ADC", "HiFi Capture", SND_SOC_NOPM, 0, 0),
    SND_SOC_DAPM_DAC("DAC", "HiFi Playback", SND_SOC_NOPM, 0, 0),
    SND_SOC_DAPM_MIXER("Mixer", SND_SOC_NOPM, 0, 0, NULL, 0),
};

3.2.2 DAPM Route：音频路径的“地图”

有了节点，还得有连接线。DAPM Route就是描述这些连接关系的。每条route包含三个要素：源widget、控制名（可选）、目标widget。

static const struct snd_soc_dapm_route my_codec_dapm_routes[] = {
    { "ADC", NULL, "MIC_IN" },
    { "Mixer", NULL, "DAC" },
    { "HP_OUT", NULL, "Mixer" },
};

这段代码的意思是：MIC_IN连接到ADC，DAC连接到Mixer，Mixer连接到HP_OUT。当用户开始录音时，DAPM会沿着这条路径向上游回溯，把MIC_IN和ADC的电源都打开。播放时同理，打开DAC、Mixer和HP_OUT。

3.2.3 DAPM事件：电源状态变化的“钩子”

有时候，你需要在widget上电或下电时做一些额外操作——比如配置寄存器、调整时钟。DAPM提供了事件回调机制：

SND_SOC_DAPM_PGA_E("HP Amp", SND_SOC_NOPM, 0, 0, NULL, 0,
    hp_amp_event,
    SND_SOC_DAPM_PRE_PMU | SND_SOC_DAPM_POST_PMD),

static int hp_amp_event(struct snd_soc_dapm_widget *w,
    struct snd_kcontrol *kcontrol, int event)
{
    switch (event) {
    case SND_SOC_DAPM_PRE_PMU:
        // 上电前配置
        snd_soc_write(w->codec, HP_AMP_CTRL, 0x01);
        break;
    case SND_SOC_DAPM_POST_PMD:
        // 下电后清理
        snd_soc_write(w->codec, HP_AMP_CTRL, 0x00);
        break;
    }
    return 0;
}

我个人习惯在事件回调里做三件事：配置寄存器、等待稳定时间、更新状态标志。尤其是等待稳定时间——有些Codec的放大器上电后需要几毫秒才能稳定输出，不加延时的话会有“噗”的一声爆音。

3.3 kcontrol控件：用户空间的“遥控器”

kcontrol是ALSA SoC框架提供给用户空间的控制接口。用户可以通过amixer命令或ALSA库来调节音量、切换输入源、开关静音等。每个kcontrol对应一个具体的硬件控制功能。

3.3.1 定义kcontrol

定义kcontrol最常用的宏是SOC_SINGLE和SOC_DOUBLE：

static const struct snd_kcontrol_new my_codec_controls[] = {
    SOC_SINGLE("Master Playback Volume", 0x02, 0, 255, 0),
    SOC_DOUBLE("Capture Volume", 0x04, 0, 8, 127, 0),
    SOC_SINGLE("Mic Boost Switch", 0x06, 0, 1, 0),
};

参数解释：

• 第一个参数：控件名字，用户空间通过这个名字来识别
• 第二个参数：寄存器地址
• 第三个参数：位偏移
• 第四个参数：最大值
• 第五个参数：是否反转（0=正常，1=反转）

3.3.2 自定义kcontrol

有时候标准宏不够用，比如你需要一个多路选择器。这时候可以用SOC_ENUM：

static const char * const input_select_texts[] = {
    "Mic", "Line In", "FM"
};

static const struct soc_enum input_select_enum =
    SOC_ENUM_SINGLE(0x08, 0, 3, input_select_texts);

static const struct snd_kcontrol_new my_codec_controls[] = {
    SOC_ENUM("Input Select", input_select_enum),
};

用户空间操作时：

# amixer cset name='Input Select' 'Mic'
# amixer cget name='Input Select'

3.4 知识体系总览

说了这么多，我画了一张图帮你把整个框架串起来。这张图展示了snd_soc_codec_driver、DAPM和kcontrol三者之间的关系：

3.5 调试技巧：三板斧

最后，分享几个我在调试Codec驱动时常用的方法：

1. 查看DAPM状态：

   cat /sys/kernel/debug/asoc/codec/dapm

   能看到每个widget当前是on还是off，以及连接的路径。
2. 查看kcontrol列表：

   amixer controls

   确认你的控件都注册成功了。
3. 手动触发DAPM：

   # 播放一个静音文件，触发播放路径上电
   aplay -d 1 /dev/zero

   然后立刻查看dapm状态，看路径是否按预期上电。