这块板子上的音频调试前前后后折腾了我大半个星期。RK3588这颗SoC性能确实强但很多开发板默认的音频方案用起来并不省心尤其是外挂一颗ES8388这种老资格的Codec时驱动能不能起来、设备树写得对不对直接决定了你最后是听到一首歌还是一段噪音。这篇文章我就把整个调试过程从头捋一遍从硬件信号关系到设备树节点从内核配置到实际播放录音把我踩过的坑和验证过的方法都写出来给后面做RK3588音频的朋友一个参照。这次调试的平台是常用的RK3588开发板音频Codec用的是ES8388这是一颗低功耗立体声音频编解码芯片支持I2S/TDM接口内置耳机放大器也支持单端或差分麦克风输入。在平板、智能音箱、工控机这类产品里非常常见。整套调试分这么几层最底层是I2C控制通道Codec的寄存器配置全靠它中间是I2S数据通道负责把音频数据搬进搬出最上层是ASoC框架里的Machine驱动也就是设备树里那个sound节点。很多人调不出来声音问题往往不出在Codec驱动本身而是设备树里那几个节点没配对、时钟没给够、引脚复用冲突。1. 方案选型与整体设计思路1.1 RK3588音频通路的基本形态RK3588本身不带集成功放和Codec所有模拟音频输入输出都需要外挂芯片完成。常见的搭配有ES8388、WM8960、TLV320AIC3x、RK817等。这颗芯片通过I2S接口和SoC相连控制通道走I2C。在Linux内核里ALSA框架把音频驱动分成了三块Machine、Platform和Codec。Platform负责DMA传输和CPU侧的DAI在RK平台上就是I2S/TDM控制器驱动。Codec管理ES8388本身的寄存器、DAC/ADC通路、音量、功放。Machine就是设备树里描述声卡的节点把Platform和Codec绑定起来定义好音频链路和路由。调RK3588的ES8388某种意义上只需要让这三层配合好。Platform驱动是SoC原厂写好的一般不用动Codec驱动是芯片厂商或内核社区维护的只要内核版本不太老大概率也是现成的真正需要花时间去看的反而是设备树里的Machine节点描述以及你和硬件原理图之间的对应关系。1.2 为什么选择ES8388选ES8388作为调试目标首先是因为它便宜、资料多、应用成熟。这颗Codec支持24bit/96kHz的DAC和ADC信噪比在消费级产品里算不错而且内部集成了耳机功放可以直接驱动32欧姆耳机。做便携设备、语音交互模块这类低功耗Codec非常合适。还有一个原因是它在主流内核里支持度好。从4.4到6.x内核sound/soc/codecs/es8388.c这个驱动一直都在而且RK的SDK里也专门做了适配。用这颗芯片做实验能遇到很多通用性问题——I2C枚举失败、MCLK配错、左右声道反了、录音通路有杂音等等这些问题在其它Codec上一样会出现所以调试经验是能复用的。1.3 音频调试的核心思路分层定位我的调试思路很简单从底层往上层一层层验证。第一步确认硬件供电和I2C通讯正常CPU能通过I2C总线访问到ES8388。如果这一步都过不去设备树写得再漂亮也没用。第二步确认I2S时钟和引脚配置正确。用示波器或逻辑分析仪看MCLK、BCLK、LRCLK有没有波形频率对不对。第三步确认驱动加载之后声卡节点正常出现在userspace能用tinymix看到Codec的控制项。第四步放歌测试并逐段排查路由和音量。这套思路能帮你把问题限定在硬件、设备树、驱动或应用层其中一个范围内不至于在一个方向上死磕到底。2. 硬件信号与驱动基础2.1 ES8388关键引脚与寄存器认知开始写设备树之前我建议先花点时间搞清楚ES8388的引脚和寄存器结构不然配置代码时很容易一头雾水。ES8388的引脚不多音频相关的主要有MCLK主时钟输入。在RK平台上由SoC的I2S控制器或CRU提供频率一般是采样率的256倍或512倍。BCLK位时钟。I2S总线上每一bit数据对应一个BCLK周期。LRCLK左右声道时钟频率等于采样率fs。DACDATI2S数据输入SoC发给ES8388播放的数据走这根线。ADCDATI2S数据输出ES8388采集到的录音数据通过它送回SoC。SDA/SCLI2C控制引脚用于读写寄存器。寄存器层面ES8388大概分成几个功能区DAC控制、ADC控制、混音器、音量和功放控制。调试播放问题时重点关注DAC相关寄存器比如DAC通路选择、左右声道音量、功放使能位调试录音问题时关注ADC的输入选择、MIC增益、ALC配置。这些寄存器平时不会手动写驱动会帮你搞定。但在排查异常时用i2cget直接读一下寄存器值能快速判断Codec到底初始化到了什么状态这个比瞎猜高效得多。2.2 I2C、I2S、MCLK三个角色不能搞混我经常用一句话给同事讲这三个东西的关系I2C是管理通道负责跟Codec“对话”I2S是数据通道负责把音频数据“搬运”MCLK是心跳所有音频时序都建立在这上面。如果I2C不通你就无法配置Codec内部寄存器DAC/ADC永远处于默认状态播放时大概率没有声音或者只有电流噪声。如果I2S引脚配错或总线格式不匹配数据传输就断了I2C通讯正常但依然没声音。如果MCLK频率不对BCLK和LRCLK的比例会乱声音就会变调而且音频频率越高失真越明显。所以在设备树里这三个部分缺一不可i2c节点描述Codec地址和时钟i2s节点描述数据引脚和DMAsound节点描述整个声卡链路以及MCLK与采样率的关系。2.3 动手前先核对硬件原理图在配置设备树之前一定要打开原理图把下面这几个信息确认清楚ES8388的I2C地址看A0/A1引脚的接法一般接线得到的地址是0x10或0x11。MCLK来自哪个时钟源有些板子直接接SoC的MCLK引脚有些通过外部晶振。I2S数据引脚接到SoC的哪组I2S控制器是I2S0还是I2S1SDI/SDO有没有接反。耳机检测引脚HP_DET有没有接如果接了设备树里要配中断或GPIO否则耳机插拔状态无法感知。忽略原理图直接抄网上别人的dts十个有九个要翻车。因为不同板卡SoC引脚复用不一样供电和时钟方案也不一样抄来的东西跑到你的板子上可能就是另一套行为。3. 内核配置与设备树实现3.1 内核配置要点我这次用的是Rockchip官方Linux SDK内核版本5.10。在正式编译之前需要确认内核里这几个配置项打开了CONFIG_SND_SOC_ES8388ES8388 Codec驱动编译成模块或直接编进内核都可以。CONFIG_SND_SOC_ROCKCHIP_I2S_TDMRK3588的I2S/TDM控制器驱动不用这个就没办法传数据。CONFIG_SND_SIMPLE_CARD或对应的Machine驱动常规做法是用simple-audio-card。在内核源码目录下执行make ARCHarm64 rockchip_linux_defconfig make ARCHarm64 menuconfig在menuconfig里搜索ES8388把对应选项勾上。如果你用SDK自带的build脚本也可以直接把配置写进arch/arm64/configs/rockchip_linux_defconfig这样后续编译不会丢。配置好之后编译内核和设备树make ARCHarm64 Image -j$(nproc) make ARCHarm64 dtbs编译完会在arch/arm64/boot/dts/rockchip/下生成对应的.dtb文件把这个文件烧到板子的dtb分区即可。3.2 ES8388的I2C节点配置设备树其实是硬件描述语言驱动启动时会从这里读取硬件信息。ES8388的I2C节点要挂在它实际连接的I2C总线上。假设ES8388挂在I2C0上地址是0x10那么设备树要新增一个子节点i2c0 { status okay; clock-frequency 400000; es8388: es838810 { compatible everest,es8388; reg 0x10; clocks cru MCLK_ES8388; clock-names mclk; pinctrl-names default; pinctrl-0 es8388_mclk; #sound-dai-cells 0; }; };这里的clocks属性很关键它告诉驱动MCLK的来源和去向。RK3588的CRUClock and Reset Unit里一般会有专门的MCLK输出引脚具体时钟名称要看SoC的TRM不同板卡差异很大。如果你发现启动日志里报mclk时钟找不到多半是这个名字和CRU里定义的对不上。#sound-dai-cells这个属性也容易被忽略。它表示这个Codec作为DAI设备时需要在引用处提供几个cell作为参数。ES8388只有一个DAI所以填0即可。如果你打算用simple-audio-card在设备树里关联Codec这个属性必不可少。3.3 I2S控制器节点配置I2S控制器节点在dtsi里是默认定义好的我们需要确认它启用了正确的引脚复用。RK3588的I2S0和I2S1都支持多组引脚默认引脚可能被分配给了其他功能所以必须通过pinctrl显式指定。i2s0 { status okay; pinctrl-0 i2s0_lrck i2s0_sclk i2s0_sdi i2s0_sdo; };i2s0_lrck、i2s0_sclk、i2s0_sdi、i2s0_sdo这些名字在dtsi的pinctrl节点里定义不同板卡可能略有差异。你可以先在arch/arm64/boot/dts/rockchip/rk3588-pinctrl.dtsi里搜索确认。在这个环节最容易踩的坑是引脚复用冲突。有些板子把I2S引脚同时复用给了别的外设比如PDM麦克风或SPDIF。如果你发现I2S引脚的波形出不来优先排查是不是被别的节点给占用了。设备树里pinctrl的优先级实际上是后解析的先生效但根本解决办法是冲突的节点只让一个开着。3.4 sound节点与完整链路接着是sound节点一般放在根节点下或者放在某个合适的总线节点里。两种写法我都见过一种是用simple-audio-card一种是用Rockchip定制的Machine驱动。为了兼容性和可移植性我建议优先用simple-audio-card。sound { compatible simple-audio-card; simple-audio-card,name rk3588-es8388; simple-audio-card,format i2s; simple-audio-card,mclk-fs 256; simple-audio-card,bitclock-master dailink0_master; simple-audio-card,frame-master dailink0_master; simple-audio-card,cpu { sound-dai i2s0; }; dailink0_master: simple-audio-card,codec { sound-dai es8388; clocks cru MCLK_ES8388; }; };simple-audio-card,mclk-fs表示MCLK频率是采样率的多少倍这里填256。如果板子上的Codec用的是512倍关系那这里也要改成512否则播放44.1kHz音频时MCLK会变成11.2896MHz但ES8388预期收到22.5792MHz两边就对不上声音会明显变调或者直接无声。simple-audio-card,bitclock-master和frame-master都指向同一个节点表示I2S总线上由CPU侧做主机Codec做从机。这个对应你硬件上把SoC的I2S控制器配置为主模式。把这三个节点都配好之后重新编译dtb并烧录启动系统在命令行执行cat /proc/asound/cards如果能看到类似rk3588-es8388的声卡说明整条链路已经建立成功。4. 驱动调试与实测记录4.1 先确认I2C通讯再谈声音驱动加载后第一步不要急着放歌。先用i2c工具确认Codec能不能正常访问。假设I2C总线编号为0地址为0x10i2cdetect -y 0 i2cget -y 0 0x10 0x00i2cset和i2cget可以直接读写寄存器。比如读寄存器0x00正常会返回一个非负值。如果返回错误或者总线上根本探测不到设备说明硬件连接或供电有问题这时候查设备树没有意义要拿万用表量一下Codec的供电、I2C上拉、复位引脚。如果I2C正常但/proc/asound/cards里没有声卡优先查内核日志dmesg | grep -i es8388 dmesg | grep -i asoc驱动初始化失败时通常会直接打印是哪一步出的问题比如时钟获取失败、DAI链接失败。我遇到过一种情况I2C能读到设备但驱动仍然报failed to find codec最后发现是设备树里#sound-dai-cells没写导致Machine层关联Codec失败。4.2 用tinymix和tinyplay验证播放通路确认声卡出现后我先用tinymix看看Codec有哪些控制项这一步能直观反映驱动是否完整初始化了寄存器映射。tinymix正常情况下能看到几十个控制项包括左右声道音量、DAC通路、功放开关、MIC增益等。如果控制项少得可怜甚至只有两三个说明Codec驱动没有正确初始化可能I2C通讯还是有隐患。播放测试我一般用tinyplay专门播放44.1kHz/16bit的WAV文件。方便起见用一个自己生成的测试音频。如果播放没有声音先用tinymix把主音量和DAC音量都调大很多板子默认音量是0或者静音状态。确认耳机还是喇叭。ES8388耳机输出和喇叭输出的功放控制位是独立的如果只开了耳机功放喇叭当然不响。用示波器或逻辑分析仪量DACDAT引脚看看有没有数据波形。如果有I2S数据但Codec没输出问题大概率在Codec路由或功放配置上如果DACDAT根本没波形问题在I2S DMA或SoC侧的DAI配置上。在调试过程中我习惯把/sys/kernel/debug/asoc/下的信息也打出来看看里面能看到完整的DAI链接和控件状态。需要先挂载debugfsmount -t debugfs none /sys/kernel/debug ls /sys/kernel/debug/asoc/4.3 录音通路调试记录播放能出声音不等于录音就没问题。ES8388的录音通道涉及MIC输入模式、偏置电压、ADC增益、ALC等多个环节。我用tinycap录了一段tinycap /data/test.wav -D 0 -d 0 -c 2 -r 16000 -b 16 -T 3然后用tinyplay放出来听。结果发现声音非常小而且底噪很大。用tinymix检查MIC增益和AGC设置把MIC增益从0dB调到20dB底噪问题有明显改善。后来发现板卡上用的是差分MIC输入但设备树和寄存器配置里没有把输入通路切到差分模式导致信号被衰减了一半。ES8388的MIC输入可以是单端也可以差分。硬件上怎么接的驱动里就要对应设置。这个信息在原理图上看得很清楚但很容易被忽略尤其是批量使用默认驱动时一般都是按单端麦克风配置的。4.4 示波器实测波形如果你的手上正好有示波器或逻辑分析仪在播放状态下量这几个点的波形MCLK频率应为采样率的256倍比如播放44.1kHz时约11.2896MHz或22.5792MHz取决于mclk-fs。LRCLK方波频率应等于采样率比如44.1kHz。BCLK频率一般是采样率乘以位数乘以声道数64fs左右比较常见。DACDAT有数据时能看到持续的脉冲串。我在调试这块板卡时一开始MCLK完全没有波形。查了时钟树发现CRU里MCLK输出到了一个复用引脚但设备树里没有打开对应的pinctrl状态导致引脚一直处于GPIO模式。补上pinctrl-0 es8388_mclk之后MCLK就出来了后续播放也就正常了。如果你没有示波器也可以通过读寄存器判断MCLK是否存在。ES8388有些寄存器会反映时钟状态但整体来说能上仪器还是上仪器这种排查效率是最高的。5. 常见问题与进阶调优5.1 问题速查表我把这次调试以及以前项目中经常遇到的问题整理成了表格方便大家直接对照排查。症状可能原因排查方向I2C探测不到设备供电异常、I2C地址错误、上拉电阻缺失量Codec电源核对A0/A1接法驱动加载失败日志报找不到mclk设备树clocks属性名字和CRU不一致在dtsi搜索MCLK定义修正属性声卡节点不存在设备树Codec节点或sound节点缺少#sound-dai-cells补齐属性重新编译dtb播放无声I2S有数据波形Codec路由静音、功放未开启tinymix调整DAC和功放控制项播放变调MCLK频率和采样率倍数不匹配检查mclk-fs是否为256只有单声道I2S引脚SDI/SDO接反或DAC寄存器设置对照原理图检查I2S数据线录音底噪大MIC增益设置过高、差分/单端模式不匹配调整gain核对输入通路配置有pop音功放使能时序问题调整设备树或驱动里的上电序列5.2 低功耗与系统裁剪注意点如果这个板子要做产品音频这部分还要考虑功耗和系统裁剪。ES8388本身是低功耗Codec但如果你让它的DAC和ADC永远处于工作状态功耗自然不会低。在驱动里可以通过runtime PM机制控制Codec的时钟和供电。设备树里最好把clocks属性配好这样驱动在空闲时会自动关闭Codec的MCLK。系统裁剪时也要注意保留/dev/snd/和ALSA相关的用户态库不然即使驱动正常应用层也没办法播放。剪内核的时候还要确认CONFIG_SND_SOC_ES8388依赖的I2C、regmap、DMA等组件没有被剪掉否则编出来的内核连模块都加载不上。5.3 多板复用的设备树技巧如果你在做一个系列产品硬件上可能有好几个版本音频Codec的接法有所差异。我的做法是把ES8388相关的节点放在一个单独的dtsi文件里然后在不同板卡的dts里包含它并用es8388去覆盖差异项。比如某个型号用I2C1某个型号用I2C0那我就不在公共dtsi里写死挂在哪个I2C总线上而是在对应板卡dts里这样写i2c1 { es8388: es838810 { status okay; }; };这样一套Codec驱动一个公共配置多个硬件版本都能跑后续维护会轻松很多。5.4 一个容易被忽略的坑播放器应用采样率匹配ES8388和I2S控制器都支持多种采样率但如果你用某些播放器默认不重采样往声卡里丢一个48kHz的文件而声卡链路只能跑44.1kHz就会出现“能播放但声音明显不对”的情况。调试时建议先用固定的WAV文件测比如48kHz文件配48kHz链路44.1kHz文件配44.1kHz链路先把链路最基础的能力确认了再交给上层做重采样策略。我在实际调试中还遇到过一种情况内核日志里一切正常声卡也在tinymix控制项也对但播放就是没声音。最后排查到是音量控制项DAC Volume和Playback Volume两者叠加默认值都是0。用户只调了一个另一个还是0声音自然出不来。所以出问题时要把所有音量相关控制项过一遍不能只看单个。另外如果你要用到耳机检测功能设备树里还要把HP_DET引脚对应的中断或GPIO属性配置好并在驱动里开启Jack检测。否则耳机插拔状态上报到上层就会一直不正确。6. 你的板子大概率会遇到这些事最后分享一个我个人的偏执习惯每次拿到一块新板子调音频我会先把I2S的MCLK、BCLK、LRCLK三个时钟用逻辑分析仪全部打一遍确认频率符合预期之后再去看Codec寄存器而不是一上来就拨弄alsa的各种控制项。硬件时序不解决软件调到天亮也白搭。ES8388这颗Codec虽然不算新但胜在简单稳定资料也齐全。只要你把I2C地址、MCLK频率、I2S引脚和sound节点这四个点牢牢抓好基本上半小时就能跑出声音。剩下的录音增益、音效调优、低功耗设计再慢慢打磨就行。调试过程中遇到什么问题欢迎在评论区交流。