从零到一：RK3568平台ES8326音频编解码器驱动移植实战

1. 环境准备与工具链搭建

拿到RK3568开发板和ES8326音频小板后，第一件事就是搭建完整的开发环境。我建议从官方渠道获取Rockchip提供的Linux SDK，这个包里通常包含交叉编译工具链、内核源码和必要的开发工具。记得检查工具链版本，我上次用gcc-linaro-7.5.0-2019.12-x86_64_aarch64-linux-gnu就遇到过兼容性问题。

必备的调试工具要提前装好：

• amixer/alsamixer：就像音频设备的遥控器，前者用命令行控制，后者带可视化界面。调试时我习惯先用alsamixer看整体状态，再用amixer做精细调节
• aplay/arecord：音频界的"Hello World"，播放测试用aplay，录音测试用arecord。记得测试时要用-D指定声卡设备
• mplayer：比aplay更强大的播放器，支持更多音频格式

开发文档也要备齐：

1. RK3568芯片手册（重点看I2S控制器章节）
2. ES8326数据手册（关注寄存器映射和时钟配置）
3. 开发板原理图（核对I2S引脚连接）

2. 驱动源码移植实战

2.1 获取与定位驱动代码

ES8326驱动通常在内核的sound/soc/codecs目录下。如果官方没提供，可以找类似型号的驱动修改，比如ES8316的驱动就有很多参考价值。我上次移植时发现，Everest Semi的驱动有个特点：它们喜欢用DAPM（动态音频电源管理）框架，这点在移植时要特别注意。

把驱动代码放到kernel/sound/soc/codecs/es8326.c后，需要修改三个关键文件：

1. Kconfig：添加config SND_SOC_ES8326选项
2. Makefile：加入obj-$(CONFIG_SND_SOC_ES8326) += es8326.o
3. defconfig：在rk3568_defconfig里加上CONFIG_SND_SOC_ES8326=y

2.2 内核编译技巧

编译命令看起来简单：

make ARCH=arm64 rk3568_defconfig make ARCH=arm64 -j12

但有几个坑我踩过：

• 编译线程数不要超过物理核心数，否则容易OOM
• 遇到undefined reference错误时，检查Makefile依赖关系
• 最好先编译一次纯净内核，确认基础环境没问题

编译完成后，用find . -name "es8326.o"确认驱动是否编译成功。有时候.o文件在奇怪的位置，可能是编译配置有问题。

3. 设备树深度解析

3.1 I2S音频链路搭建

RK3568的I2S控制器和ES8326的连接是关键。设备树要描述清楚这两者的关系：

i2s3_2ch: i2s@fe4a0000 { compatible = "rockchip,rk3568-i2s"; reg = <0x0 0xfe4a0000 0x0 0x1000>; interrupts = <GIC_SPI 54 IRQ_TYPE_LEVEL_HIGH>; clocks = <&cru MCLK_I2S3>, <&cru HCLK_I2S3>; clock-names = "i2s_clk", "i2s_hclk"; dmas = <&dmac1 10>, <&dmac1 11>; dma-names = "tx", "rx"; #sound-dai-cells = <0>; };

特别注意：

• clock频率要和ES8326的MCLK匹配
• dma通道不能和其他外设冲突
• #sound-dai-cells必须为0

3.2 ES8326节点配置

音频编解码器的设备树节点是调试中最容易出错的地方：

es8326: codec@18 { compatible = "everest,es8326"; reg = <0x18>; clocks = <&cru I2S3_MCLKOUT>; clock-names = "mclk"; assigned-clocks = <&cru I2S3_MCLKOUT>; assigned-clock-rates = <12288000>; pinctrl-names = "default"; pinctrl-0 = <&i2s3m0_mclk>; };

常见问题排查：

1. I2C地址错误：用i2cdetect扫描确认
2. MCLK频率不对：用示波器测量实际输出
3. 引脚复用冲突：检查pinctrl配置

3.3 声卡设备绑定

Simple Audio Card框架的配置模板：

es8326_sound { compatible = "simple-audio-card"; simple-audio-card,name = "ES8326-Audio"; simple-audio-card,format = "i2s"; simple-audio-card,mclk-fs = <256>; simple-audio-card,widgets = "Microphone", "Mic Jack", "Headphone", "Headphone Jack"; simple-audio-card,routing = "Mic Jack", "MICBIAS", "IN1P", "Mic Jack", "Headphone Jack", "HPOL", "Headphone Jack", "HPOR"; simple-audio-card,cpu { sound-dai = <&i2s3_2ch>; }; simple-audio-card,codec { sound-dai = <&es8326>; }; };

路由配置(routing)最容易出错，建议：

1. 先确认物理连接关系
2. 参考ES8326数据手册的信号流向图
3. 用amixer检查各通路开关状态

4. 系统调试与优化

4.1 基础功能测试

先用基本命令验证驱动是否工作：

# 查看声卡列表 cat /proc/asound/cards # 播放测试 aplay -Dhw:1,0 test.wav # 录音测试 arecord -Dhw:1,0 -f S16_LE -r 48000 -c 2 test.wav

如果没声音，按这个顺序排查：

1. 检查dmesg | grep es8326的错误日志
2. 确认设备树节点status是"okay"
3. 测量MCLK、BCLK等时钟信号
4. 用i2c-tools验证寄存器配置

4.2 音频参数调优

ES8326有几个关键寄存器需要特别注意：

• 0x04(系统控制)：电源管理配置
• 0x0D(ADC控制)：麦克风增益
• 0x1E(DAC控制)：耳机输出音量

用amixer调节参数的技巧：

# 查看所有控件 amixer -c1 controls # 设置耳机音量（范围0-192） amixer -c1 cset name='Headphone Playback Volume' 150 # 切换音频通路 amixer -c1 cset name='Output Mixer HiFi' on

4.3 PulseAudio集成

桌面系统需要配置PulseAudio：

1. 在/usr/share/alsa/ucm下创建配置文件
2. 编写HiFi.conf定义输入输出设备
3. 测试音量控制是否同步

常见问题解决方案：

• 声音卡顿：调整PulseAudio的buffer大小
• 音量调节无效：检查混音器控件映射
• 录音无声：确认麦克风偏置电压是否使能

5. 实战经验分享

在最近的一个项目中，我们遇到播放时有爆音的问题。经过示波器抓取波形发现，是I2S的LRCLK相位不对。解决方法是在设备树添加：

i2s3_2ch: i2s@fe4a0000 { rockchip,i2s-invert-lrclk = <1>; };

另一个常见问题是睡眠唤醒后没声音。这通常需要：

1. 在驱动中实现suspend/resume函数
2. 保存/恢复关键寄存器值
3. 检查时钟树是否正常恢复

对于需要低延迟的场景，建议：

• 使用tinyalsa替代alsa-lib
• 调整DMA buffer大小
• 关闭不必要的电源管理功能