4. I2C控制器节点配置：从时钟到引脚的完整指南
好，咱们今天来聊聊I2C控制器的节点配置。说实话，I2C这玩意儿在嵌入式系统里太常见了——传感器、EEPROM、音频编解码器，几乎都靠它。但很多工程师在配置设备树时，往往只关注了从设备，却忽略了控制器本身。嗯，这里要敲黑板了：控制器节点配不好，后面从设备再折腾也是白搭。
4.1 I2C控制器的dts节点结构
先看一个典型的I2C控制器节点长什么样。我习惯用i.MX6ULL的I2C1来举例，这个我在项目里用过很多次：
&i2c1 {
compatible = "fsl,imx6ul-i2c", "fsl,imx21-i2c";
reg = <0x021a0000 0x4000>;
interrupts = <GIC_SPI 36 IRQ_TYPE_LEVEL_HIGH>;
clocks = <&clks IMX6UL_CLK_I2C1>;
clock-names = "ipg";
pinctrl-names = "default";
pinctrl-0 = <&pinctrl_i2c1>;
status = "okay";
clock-frequency = <100000>;
/* 从设备节点 */
eeprom@50 {
compatible = "atmel,24c02";
reg = <0x50>;
};
};看到没？这里有几个关键字段。compatible是驱动匹配的依据，reg是寄存器基地址和长度，interrupts是中断号。这些是基础，但真正容易出问题的，是后面的时钟和引脚配置。
核心要点：I2C控制器节点必须包含compatible、reg、interrupts三个属性，否则内核无法正确识别和初始化硬件。
4.2 时钟频率配置——别小看这个数字
clock-frequency这个属性，很多人随手写个100000（100kHz）就完事了。但你知道吗？我在一个项目中遇到过，某款触摸屏在400kHz下工作得好好的，换到另一块板子上就频繁丢数据。查了半天，原来是I2C总线长度不一样，信号质量下降了。
标准I2C频率有三种：
| 模式 | 频率 | 典型应用 |
|---|---|---|
| 标准模式 | 100kHz | 大多数传感器、EEPROM |
| 快速模式 | 400kHz | 触摸屏、音频编解码器 |
| 高速模式 | 3.4MHz | 视频、大容量存储 |
我个人建议，除非你很清楚总线负载和信号完整性，否则先用100kHz。稳定第一，性能第二。你想想看，一个传感器数据晚几毫秒读到，和因为通信错误导致系统卡死，哪个更严重？
小技巧：如果从设备支持400kHz，但你的总线长度超过20cm，或者挂载了多个设备，建议降回100kHz。我曾经在一条总线上挂了4个传感器，400kHz下怎么调都不行，降到100kHz后稳如老狗。
4.3 时钟源选择——选错了直接罢工
clocks和clock-names这两个属性，决定了I2C控制器的时钟源。说白了，就是给I2C模块提供心跳的。不同的SoC，时钟源可能来自PLL、晶振或者内部振荡器。
以i.MX6UL为例：
clocks = <&clks IMX6UL_CLK_I2C1>;
clock-names = "ipg";这里的IMX6UL_CLK_I2C1是时钟ID，ipg是时钟名称。驱动会通过clock-names来获取对应的时钟句柄。如果时钟源选错了，I2C控制器可能根本没法工作，或者工作频率完全不对。
我记得有一次，一个同事把I2C2的时钟ID写成了I2C1的，结果I2C2死活不干活。查了两天才发现是时钟ID搞混了。所以，这里一定要对照芯片手册或者时钟树图来确认。
注意：不同SoC的时钟ID定义不同，不要想当然地复制粘贴。比如i.MX6UL和i.MX6ULL的时钟ID可能就有差异。务必参考对应芯片的参考手册。
4.4 pinctrl配置——引脚复用是门学问
pinctrl配置，说白了就是告诉芯片：I2C的SCL和SDA这两个引脚，要当I2C用，别当GPIO或者其他功能用。这个配置通常在SoC的pinctrl节点里定义，然后在I2C控制器节点里引用。
看一个实际的例子：
&iomuxc {
pinctrl_i2c1: i2c1grp {
fsl,pins = <
MX6UL_PAD_UART4_TX_DATA__I2C1_SCL 0x4001b8b0
MX6UL_PAD_UART4_RX_DATA__I2C1_SDA 0x4001b8b0
>;
};
};这里MX6UL_PAD_UART4_TX_DATA__I2C1_SCL的意思是：UART4的TX引脚，复用为I2C1的SCL。后面的0x4001b8b0是引脚配置值，包括上下拉、驱动能力、施密特触发器等。
嗯，这里要注意：0x4001b8b0这个值不是随便写的。它通常包含：
- 上拉使能：I2C总线需要上拉，所以一般要开启内部上拉
- 驱动强度：根据总线长度和负载选择，太弱信号上不去，太强会有过冲
- 施密特触发器：建议开启，提高抗干扰能力
我曾经在一个项目中，因为引脚配置值写错了，导致I2C信号上升沿特别慢，波形像正弦波一样。后来查了芯片手册，把驱动强度调高了一档，问题就解决了。所以，别小看这个十六进制数，它直接影响信号质量。
避坑指南：如果你发现I2C通信偶尔失败，或者某些设备无法识别，先别急着怀疑驱动。用示波器看看SCL和SDA的波形。如果上升沿太缓，或者有毛刺，多半是pinctrl配置或者外部上拉电阻的问题。
4.5 完整的配置检查清单
好了，说了这么多，我总结一个检查清单，你配置I2C控制器节点时可以对照着看：
- compatible：是否匹配内核驱动？不同SoC的compatible字符串可能不同
- reg：寄存器基地址和范围是否正确？对照芯片手册确认
- interrupts：中断号和触发类型是否正确？
- clocks：时钟源ID是否正确？时钟名称是否匹配驱动要求？
- clock-frequency：频率是否在从设备支持范围内？总线长度是否允许？
- pinctrl：引脚复用是否正确？引脚配置值是否合理？
- status：是否设置为"okay"？很多人忘了改这个
说实话，I2C控制器配置并不复杂，但细节很多。你只要按照这个清单一步步检查，基本不会出大问题。如果还是不行，那就拿示波器量波形吧——硬件问题，最终还得靠硬件手段来解决。
最后一个小建议：调试I2C时，可以在内核启动参数里加上"i2c_debug=1"，或者打开CONFIG_I2C_DEBUG_BUS和CONFIG_I2C_DEBUG_ALGO，这样内核会打印详细的I2C通信日志，对定位问题非常有帮助。