嵌入式Linux ASoC音频驱动开发：从架构到Codec驱动实战

1. 从一次喇叭不出声的调试说起搞嵌入式Linux音频的兄弟大概率都经历过这样的场景板子跑起来了耳机插孔有声音但板载喇叭死活不出声或者录音能录但回放全是杂音再或者用amixer调了半天音量控件纹丝不动。我第一次碰ASoC的时候就是被一个耳机有声、喇叭无声的问题卡了整整两天最后发现是DAPM的widget连接关系没配对一个SND_SOC_DAPM_OUTPUT漏了导致功放芯片的供电一直没被打开。ASoC全称ALSA System on Chip是Linux内核里专门为嵌入式音频子系统设计的一套框架。它要解决的核心问题很朴素嵌入式SoC的音频通路太碎了——CPU侧有I2S/PCM控制器叫DAI板子上挂着各种Codec芯片WM8960、ES8388、TLV320AIC23这些中间还可能经过功放、麦克风、耳机检测。如果每个平台都自己写一套驱动代码复用率几乎为零。ASoC把这套东西抽象成三块Machine驱动负责板子怎么连Platform驱动负责CPU侧怎么传数据Codec驱动负责音频芯片怎么配置。三者通过dai_link绑在一起内核启动时自动匹配。这篇文章面向的是正在做嵌入式Linux音频驱动开发的工程师尤其是那些已经能跑通内核、会写简单字符设备驱动但一碰到ASoC就发懵的朋友。我会从整体架构拆到控件注册、Codec驱动的具体实现把amixer背后到底发生了什么、DAPM的电源管理怎么工作、Codec驱动里那些regmap和kcontrol怎么写全部掰开揉碎讲清楚。看完之后你应该能独立给自己的板子写一个能出声、能调音量、能省电的Codec驱动。2. ASoC整体架构与设计思路拆解2.1 为什么要有ASoC这层抽象在ASoC出现之前Linux音频驱动基本是照搬桌面那套snd_cardsnd_pcm的写法。桌面声卡是PCI设备硬件通路固定Codec和控制器基本绑死。但嵌入式不一样同一颗SoC比如i.MX6ULL可以配WM8960也可以配ES8388甚至同一块板子换不同Codec。如果按传统写法每换一个Codec就要重写一遍PCM和混音器逻辑维护成本爆炸。ASoC的设计哲学是分层解耦。它把音频系统拆成三个独立的驱动模块各自注册到ASoC核心层由核心层根据dai_link的名字去匹配。这样Platform驱动比如imx-ssi.c、fsl_sai.c可以跨多块板子复用Codec驱动比如wm8960.c可以跨多个SoC复用只有Machine驱动是板级专属的代码量通常只有一两百行。这个思路和Linux设备模型的分离-匹配思想一脉相承。你可以类比成USB主机控制器驱动和USB设备驱动各自独立靠USB核心层匹配。ASoC核心层干的就是这个红娘的活。2.2 三大组件的职责边界Platform驱动管的是CPU侧的DAI控制器。它要注册struct snd_soc_dai_driver里面描述支持哪些采样率、位宽、通道数以及ops回调hw_params、trigger、set_fmt等。同时它还要通过snd_soc_component注册DMA相关的pcm_ops因为音频数据最终要靠DMA搬运。以i.MX的SAI控制器为例fsl_sai.c里会注册fsl_sai_dai和对应的fsl_sai_pcm_dma。Codec驱动管的是音频芯片本身。它要注册struct snd_soc_codec_driver老内核或struct snd_soc_component_driver新内核5.x以后里面包含寄存器读写现在基本都用regmap、DAPM widget和route、kcontrol控件、以及DAI配置。Codec驱动是这篇文章的重点因为控件和音量调节都在这层。Machine驱动是板级胶水。它定义struct snd_soc_card里面挂一个或多个snd_soc_dai_link每个link指定cpu_dai_name、codec_dai_name、platform_name、codec_name。它还负责板级特有的东西比如时钟配置、GPIO控制功放使能脚、jack检测。Machine驱动通常放在arch/arm/mach-xxx/或sound/soc/xxx/下。三者的关系可以用一句话概括Machine说我要把CPU的SAI0和Codec的I2S口连起来Platform提供SAI0的传输能力Codec提供WM8960的配置能力核心层把它们撮合到一起用户空间就能看到一块声卡。2.3 数据流与控制流的两条路径理解ASoC一定要分清两条路径。数据流是PCM音频采样数据用户空间aplay写数据到/dev/snd/pcmC0D0pALSA核心层把数据交给Platform的DMADMA通过I2S总线把数据推给CodecCodec的DAC转成模拟信号输出。这条路径的关键是DMA和DAI的hw_params配置要匹配。控制流是寄存器和控件用户空间amixer通过/dev/snd/controlC0下发命令ALSA核心层找到对应的kcontrol调用Codec驱动注册的put回调put回调通过regmap写Codec寄存器。这条路径的关键是kcontrol的注册和DAPM的电源管理。很多人调不出声音就是因为只关注了数据流DMA配好了、I2S时钟对了忽略了控制流Codec的DAC没上电、输出mixer没打开。DAPM就是专门管控制流里电源那部分的它会根据当前的音频路径自动开关Codec内部的各个模块省电的同时保证通路正确。2.4 新老内核的API变迁这里必须提醒一句ASoC的API在Linux 5.x之后有较大变化。老内核4.x及以前用snd_soc_codec_driver和snd_soc_codec新内核逐步迁移到snd_soc_component_driver和snd_soc_componentsnd_soc_codec结构体在5.10左右被移除。如果你拿的是老驱动往新内核上移植会发现一堆编译错误。具体差异老代码里codec-control_data是regmap新代码里要用snd_soc_component_get_regmap(component)老代码的codec-dev新代码是component-devkcontrol的private_value和access基本没变但注册函数从snd_soc_add_codec_controls变成snd_soc_add_component_controls。写新驱动建议直接参考内核sound/soc/codecs/下最新的驱动比如wm8960.c在5.15之后已经改成component风格了。3. 音频控件与Codec驱动核心细节解析3.1 kcontrol的四种类型与注册方式音频控件kcontrol是用户空间和Codec驱动交互的接口。amixer看到的每一个Master Playback Volume、Capture Switch背后都是一个struct snd_kcontrol。ASoC里最常用的是通过soc_controls数组批量注册每个元素是SOC_SINGLE、SOC_DOUBLE、SOC_ENUM这类宏。SOC_SINGLE用于单声道寄存器比如一个8位寄存器控制某个增益。SOC_DOUBLE用于左右声道共用一个寄存器的场景比如WM8960的耳机音量低6位是左声道高6位是右声道用SOC_DOUBLE_R两个寄存器或SOC_DOUBLE一个寄存器分两段。SOC_ENUM用于枚举类型比如输入源选择Line In / Mic / DAC它需要配合snd_soc_enum和snd_soc_enum_item数组。注册的时候SOC_SINGLE(Master Playback Volume, WM8960_LINVOL, 0, 63, 0)这行代码的含义是控件名Master Playback Volume寄存器WM8960_LINVOL起始位0最大值636位invert为0不反转。用户空间amixer sset Master Playback Volume 40时ALSA核心层会调用snd_soc_put_volsw它把40写进寄存器的bit0-5。注意SOC_SINGLE的max值是最大值不是位数。比如6位寄存器max填638位填255。填错了会导致amixer显示的范围不对或者写入时被截断。3.2 DAPM的widget与route机制DAPMDynamic Audio Power Management是ASoC最精妙也最容易踩坑的部分。它的核心思想是Codec内部有很多功能模块ADC、DAC、Mixer、PGA、输出驱动不是所有模块都需要一直上电。DAPM根据当前的通路自动决定哪些模块上电。实现上每个模块是一个struct snd_soc_dapm_widget类型有SND_SOC_DAPM_ADC、SND_SOC_DAPM_DAC、SND_SOC_DAPM_MIXER、SND_SOC_DAPM_OUTPUT、SND_SOC_DAPM_INPUT等。模块之间的连接是snd_soc_dapm_route格式是{sink, control, source}表示信号从source流向sinkcontrol是中间的开关名可以是kcontrol名也可以是NULL表示直连。举个例子WM8960的喇叭输出通路大概是DAC-Left Output Mixer-Speaker Output-SPK_OUT。对应的route就是{Left Output Mixer, Left DAC Switch, DAC}, {Speaker Output, NULL, Left Output Mixer}, {SPK_OUT, NULL, Speaker Output},当用户空间打开PCM播放时DAPM会从SPK_OUT这个output widget反向遍历找到所有需要上电的模块依次调用它们的event回调通常是写寄存器的power bit。如果route漏了一条DAPM就找不到通路模块不上电结果就是数据流正常但没声音。3.3 regmap在Codec驱动里的作用现代Codec驱动几乎都用regmap替代手写的I2C/SPI读写。regmap的好处是统一了寄存器访问接口、支持缓存cache、支持寄存器位域操作、支持regmap_update_bits原子更新。对于Codec这种寄存器多、位域复杂的芯片regmap能省掉大量样板代码。初始化regmap的典型写法static const struct regmap_config wm8960_regmap { .reg_bits 7, .val_bits 9, .max_register WM8960_RESET, .cache_type REGCACHE_RBTREE, };注意reg_bits和val_bits要按芯片手册填。WM8960是7位寄存器地址、9位数据填错了读写全乱。cache_type选REGCACHE_RBTREE是因为Codec寄存器访问不频繁用红黑树缓存能加速regmap_read。regmap_update_bits(map, reg, mask, val)是调音量、开关模块时最常用的函数它读-改-写是原子的避免多线程竞争。DAPM的event回调里基本都是这个函数。3.4 DAI配置与时钟计算Codec的DAI配置决定了它和CPU侧怎么对接。struct snd_soc_dai_driver里的playback和capture要填rates、formats、channels_min/max、rates。formats要包含SNDRV_PCM_FMTBIT_S16_LE、SNDRV_PCM_FMTBIT_S24_LE这些具体看Codec支持什么。时钟是另一个大坑。Codec通常需要MCLK主时钟由SoC提供频率一般是采样率的256倍或384倍。比如44.1kHz采样MCLK可以是11.2896MHz256fs或22.5792MHz512fs。Codec内部的PLL会根据MCLK和采样率算出BCLK和LRCK。如果MCLK频率不对或者PLL配置错误结果就是采样率不对、声音变调。在Machine驱动里通常要设置dai_link的dai_fmt比如SND_SOC_DAIFMT_I2S | SND_SOC_DAIFMT_NB_NF | SND_SOC_DAIFMT_CBS_CFS表示I2S格式、正常位时钟和帧时钟、Codec作为从设备BCLK和LRCK由SoC提供。这个配置必须和Codec的DAI配置一致否则时钟对不上。4. Codec驱动实操过程与关键环节实现4.1 驱动骨架与probe流程一个完整的Codec驱动probe函数大致流程是获取I2C设备、初始化regmap、注册component、注册DAI、注册kcontrol、注册DAPM widget和route、配置初始寄存器。下面以I2C接口的Codec为例给出骨架代码。static int mycodec_i2c_probe(struct i2c_client *i2c, const struct i2c_device_id *id) { struct mycodec_priv *priv; int ret; priv devm_kzalloc(i2c-dev, sizeof(*priv), GFP_KERNEL); if (!priv) return -ENOMEM; priv-regmap devm_regmap_init_i2c(i2c, mycodec_regmap); if (IS_ERR(priv-regmap)) return PTR_ERR(priv-regmap); i2c_set_clientdata(i2c, priv); ret devm_snd_soc_register_component(i2c-dev, mycodec_component_drv, mycodec_dai, 1); if (ret) return ret; return 0; }devm_snd_soc_register_component是5.x之后的推荐接口它把component和DAI一起注册。mycodec_component_drv里包含controls、dapm_widgets、dapm_routes、probe、remove等字段。4.2 kcontrol数组的编写与验证假设我们的Codec有一个主音量寄存器REG_VOL地址0x10左声道bit0-5右声道bit6-11范围0-630最大声。用SOC_DOUBLE_R还是SOC_DOUBLE因为左右声道在同一个寄存器用SOC_DOUBLEstatic const struct snd_kcontrol_new mycodec_controls[] { SOC_DOUBLE(Master Playback Volume, REG_VOL, 0, 6, 63, 0), SOC_SINGLE(DAC Playback Switch, REG_DAC, 0, 1, 0), SOC_ENUM(Input Source, mycodec_input_enum), };SOC_DOUBLE的参数是名字、寄存器、左声道shift、右声道shift、max、invert。这里左shift0右shift6max63。用户空间amixer sset Master Playback Volume 30会同时设置左右声道为30。验证方法加载驱动后amixer controls应该能看到这些控件。amixer contents能看到当前值和范围。如果控件没出现检查controls数组是否挂到了component_drv上以及num_controls是否填对。实操心得SOC_DOUBLE的invert参数很关键。有些Codec的音量寄存器是值越大声音越小比如0是最大声这时候invert要填1否则amixer调大音量反而变小。我第一次调WM8960就栽在这调了半天以为驱动写错了。4.3 DAPM widget与route的完整配置DAPM配置是Codec驱动里最容易出错的部分。以一条完整的播放通路为例从DAC到喇叭输出static const struct snd_soc_dapm_widget mycodec_dapm_widgets[] { SND_SOC_DAPM_DAC(DAC, Playback, REG_POWER, 3, 1), SND_SOC_DAPM_MIXER(Output Mixer, REG_POWER, 2, 1, mycodec_mixer_controls, ARRAY_SIZE(mycodec_mixer_controls)), SND_SOC_DAPM_PGA(Speaker Driver, REG_POWER, 1, 1, NULL, 0), SND_SOC_DAPM_OUTPUT(SPK_OUT), SND_SOC_DAPM_INPUT(MIC_IN), SND_SOC_DAPM_ADC(ADC, Capture, REG_POWER, 0, 1), }; static const struct snd_soc_dapm_route mycodec_dapm_routes[] { {Output Mixer, DAC Switch, DAC}, {Speaker Driver, NULL, Output Mixer}, {SPK_OUT, NULL, Speaker Driver}, {ADC, NULL, MIC_IN}, };SND_SOC_DAPM_DAC的参数是名字、stream namePlayback、电源寄存器、bit位、active level。SND_SOC_DAPM_MIXER多两个参数mixer的kcontrol数组和数量这些kcontrol控制mixer的输入开关。route的control字段如果是NULL表示直连如果是字符串必须是某个kcontrol的名字。比如DAC Switch就是mixer里的一个开关控件。DAPM在遍历时会检查这个开关是否打开只有打开才继续往上游走。验证DAPM是否工作cat /sys/kernel/debug/asoc/card/dapm能看到所有widget的当前状态on/off。播放时观察DAC和Speaker Driver是否变成on。如果一直是off说明route断了或者widget的电源bit配错了。4.4 时钟与PLL配置的实操Codec的PLL配置通常写在hw_params回调里因为采样率是运行时才知道的。以WM8960为例wm8960_hw_params里会根据params_rate(params)算出PLL的N、K、P值然后写寄存器。static int mycodec_hw_params(struct snd_pcm_substream *substream, struct snd_pcm_hw_params *params, struct snd_soc_dai *dai) { struct snd_soc_component *component dai-component; unsigned int rate params_rate(params); int pll_out, ret; switch (rate) { case 8000: case 16000: case 32000: case 48000: pll_out 24576000; break; case 11025: case 22050: case 44100: pll_out 22579200; break; default: return -EINVAL; } ret snd_soc_component_set_pll(component, 0, 0, 0, pll_out); if (ret 0) return ret; return 0; }pll_out的选择逻辑是48kHz系列用24.576MHz44.1kHz系列用22.5792MHz这两个频率分别是48000×512和44100×512。Codec内部再用分频器得到BCLK和LRCK。如果MCLK是SoC直接提供的set_pll可能不需要但大多数板子为了灵活都用Codec的PLL。注意snd_soc_component_set_pll的第二个参数是PLL ID单PLL的Codec填0。第三个参数是source通常填MCLK的ID。具体看Codec的set_pll实现。4.5 Machine驱动的dai_link绑定Codec驱动写完后还需要Machine驱动把它和CPU侧连起来。一个典型的dai_linkstatic struct snd_soc_dai_link mycard_dai_link { .name mycodec-hifi, .stream_name mycodec HiFi, .cpu_dai_name fsl-sai.0, .codec_dai_name mycodec-hifi, .platform_name fsl-sai.0, .codec_name mycodec.0-001a, .dai_fmt SND_SOC_DAIFMT_I2S | SND_SOC_DAIFMT_NB_NF | SND_SOC_DAIFMT_CBS_CFS, .ops mycard_ops, };codec_name的格式是i2c_device_name.i2c_bus-addr比如mycodec.0-001a表示I2C0上地址0x1a的设备。这个字符串必须和实际注册的名字一致否则匹配不上声卡注册失败。dai_fmt要和Codec的DAI配置一致。CBS_CFS表示Codec是时钟从设备SoC提供BCLK和LRCK。如果Codec是主设备要改成CBM_CFM。5. 常见问题与排查技巧实录5.1 声卡注册失败与dai_link匹配问题最常见的报错是ASoC: no backend DAIs enabled for ...或者ASoC: CODEC DAI ... not registered。前者通常是cpu_dai_name或platform_name写错了后者是codec_dai_name或codec_name不对。排查方法cat /sys/kernel/debug/asoc/dais能看到所有已注册的DAI名字cat /sys/kernel/debug/asoc/codecs能看到所有Codec名字。把dai_link里的名字和这两个文件对照一字不差才行。注意codec_name里的I2C地址是十六进制别写成十进制。另一个坑是dai_link的platform_name。有些SoC的CPU DAI和Platform名字不一样比如i.MX6的SAIcpu_dai_name是fsl-sai.0platform_name也是fsl-sai.0但有些平台是分开的。查/sys/kernel/debug/asoc/platforms确认。5.2 有数据流但无声音的DAPM排查这是最经典的问题。aplay能跑完/proc/asound/card0/pcm0p/sub0/status显示RUNNING但喇叭没声。九成是DAPM通路没打通。第一步cat /sys/kernel/debug/asoc/card/dapm看播放时DAC、Mixer、Output这些widget是不是on。如果全是off说明DAPM没触发。原因可能是route漏了或者widget的电源bit配错。第二步检查route的control字段。如果写了一个不存在的kcontrol名字DAPM会静默忽略这条route。用amixer controls确认控件名存在。第三步检查widget的reg和shift。SND_SOC_DAPM_DAC(DAC, Playback, REG_POWER, 3, 1)表示电源在REG_POWER的bit3active high。如果实际是active low最后一个参数要填0。填反了模块永远不上电。5.3 音量控件无效或范围不对amixer sset Master Playback Volume 50执行了但声音没变化。先amixer contents看控件的当前值有没有变。如果值变了但声音不变说明put回调写错了寄存器或者写到了被DAPM覆盖的寄存器。如果值没变检查SOC_SINGLE的max值。比如寄存器是6位max填了255amixer允许设到255但实际写入时高2位被截断可能写到别的位域去了。用regmap的debugfs/sys/kernel/debug/regmap/device/registers看寄存器实际值。范围不对的另一个原因是invert。如果寄存器0是最大声invert要填1这样amixer显示0%对应寄存器最大值100%对应0。填反了用户调大音量反而变小。5.4 录音有杂音或采样率不对录音杂音通常是时钟问题。检查MCLK频率是否匹配采样率。44.1kHz需要11.2896MHz或22.5792MHz如果SoC给了12MHzPLL算出来的采样率就偏了声音会变调或带噪声。用示波器量MCLK、BCLK、LRCK的实际频率。LRCK应该等于采样率44.1kHzBCLK等于采样率×位宽×通道数比如44.1k×16×21.4112MHz。如果LRCK不对检查Codec的PLL配置和分频寄存器。采样率不对还可能是hw_params里没调set_pll或者set_pll的pll_out算错了。48kHz系列和44.1kHz系列的pll_out不能混用混了就会有细微的变调。5.5 常见问题速查表现象可能原因排查方法声卡注册失败dai_link名字不匹配对照/sys/kernel/debug/asoc/dais有数据流无声音DAPM route断或widget电源bit错看dapmdebugfs的on/off状态音量控件无效max值错或invert错看amixer contents和regmap寄存器录音杂音MCLK频率不匹配示波器量MCLK/LRCK采样率变调PLL配置错检查hw_params的pll_out耳机有声喇叭无声输出route漏了Speaker补SND_SOC_DAPM_OUTPUT和route播放一段时间断流DMA buffer太小增大pcm_hardware的buffer_bytes_max独家避坑技巧调试DAPM时可以临时把可疑的widget强制打开在dapm_widgets里加SND_SOC_DAPM_REG或者直接在probe里用regmap_write把电源bit置位。如果强制打开后有声音说明就是DAPM route的问题然后逐条route排查。这个方法能快速定位是电源问题还是数据问题。6. 从能出声到好用进阶优化与经验总结6.1 耳机检测与jack的接入板子上有耳机插孔的话通常需要一个GPIO或Codec内部的jack检测。Codec驱动里可以注册struct snd_soc_jack然后通过SND_SOC_DAPM_HP和SND_SOC_DAPM_MIC的event回调处理插拔。WM8960有内置的jack检测通过wm8960_jack_init注册。如果是GPIO检测在Machine驱动里申请GPIO中断中断里调snd_soc_jack_report。耳机插拔的DAPM处理要注意插入耳机时喇叭输出要自动关闭耳机输出打开。这通过SND_SOC_DAPM_HP和SND_SOC_DAPM_SPK两个widget的event回调实现回调里根据jack状态写Codec的寄存器。6.2 低功耗优化与DAPM的自动管理DAPM最大的价值就是省电。播放停止后DAPM会自动把DAC、Mixer、Output全部下电Codec进入低功耗状态。要确保这个机制工作需要正确配置每个widget的电源bit以及SND_SOC_DAPM_SUSPEND相关的标志。如果发现待机电流偏高用cat /sys/kernel/debug/asoc/card/dapm看哪些widget还是on。常见原因是某个widget的event回调里没有正确写power down bit或者route里有个always-on的路径。另外Codec的set_bias_level回调要正确实现从STANDBY到OFF要关掉所有偏置电流。6.3 多Codec与多声卡的场景有些板子有两颗Codec比如一颗接喇叭、一颗接耳机或者一颗做播放、一颗做录音。这时候Machine驱动里要定义多个dai_link每个link对应一颗Codec。snd_soc_card的num_links要填对。多声卡的情况下用户空间会看到card0和card1。amixer -c 0和amixer -c 1分别操作。注意dai_link的name要唯一否则核心层会报重复。6.4 我个人在实际操作中的体会搞ASoC这几年最大的感受是调试音频问题一定要把数据流和控制流分开看。数据流的问题用aplay和/proc/asound看控制流的问题用amixer和DAPM debugfs看。两者都正常还没声音那就是硬件问题功放没使能、喇叭没接。另一个体会是不要迷信参考驱动。很多板级驱动是从别的板子抄来的Codec型号一样但硬件连接可能不同比如MCLK频率、功放使能脚、耳机检测极性。抄过来能编译不代表能出声一定要对着原理图逐条核对。最后分享一个小技巧调试新Codec时先在probe里把所有电源寄存器的相关bit全部置位强制上电确认能出声后再逐步启用DAPM一条条route加这样能快速定位是哪条route或哪个widget的问题。这个方法比一上来就配全套DAPM再调试要快得多我后来带新人都让他们这么干。