3. RK平台I2C控制器：特性、时钟配置与传输模式
RK平台的I2C控制器是连接Sensor与外设的核心总线引擎。本章深入剖析RK I2C控制器的硬件特性、时钟树配置策略以及三种传输模式（轮询、中断、DMA）的实现原理与适用场景，为后续Sensor驱动开发奠定坚实的底层基础。
3.1 RK I2C控制器硬件特性
RK系列SoC（如RK3568、RK3588、RK3399）集成了多路I2C控制器，每路控制器均支持标准模式（100kHz）、快速模式（400kHz）和高速模式（3.4MHz）。其核心特性如下表所示：
| 特性 | 描述 | 驱动关注点 |
|---|---|---|
| 多通道独立 | 每路I2C控制器拥有独立的寄存器组、时钟门控和中断线 | 设备树中需指定正确的i2c节点及pinctrl |
| 内置FIFO | 发送/接收各8字节深度FIFO，支持阈值中断 | 配置FIFO阈值可优化传输效率 |
| 地址掩码 | 支持7位和10位地址模式，可配置从机地址掩码 | Sensor通常使用7位地址，需注意地址左移1位 |
| 时钟同步 | 支持多主机时钟同步和总线仲裁 | 单主机场景下无需关注 |
| 传输完成标志 | 提供中断状态寄存器，可查询传输完成、NACK、仲裁丢失等状态 | 驱动中需正确处理所有状态位 |
开发提示：RK I2C控制器的寄存器基地址和中断号在芯片TRM中有详细定义。驱动开发时，务必核对设备树中reg和interrupts属性与TRM一致，否则会导致控制器无法正常工作。
3.2 时钟配置：SCL频率计算与分频策略
I2C总线的SCL时钟频率由控制器内部的时钟分频器决定。RK I2C控制器的时钟源通常来自PCLK或ACLK，经过分频后产生SCL。时钟配置的核心公式如下：
SCL频率 = 输入时钟频率 / (CLKDIV_L + CLKDIV_H + 2) * (1 + SCL_DELAY)其中：
- 输入时钟频率：由时钟树决定，通常为100MHz或200MHz。
- CLKDIV_L / CLKDIV_H：低电平和高电平分频系数，分别存储在IC_CLK_DIV_L和IC_CLK_DIV_H寄存器中。
- SCL_DELAY：上升沿/下降沿延迟补偿，通常设为0。
实际驱动中，时钟配置通过设备树中的clock-frequency属性指定，内核I2C框架自动计算分频系数。典型配置示例如下：
// 设备树节点示例
&i2c3 {
status = "okay";
clock-frequency = <400000>; // 400kHz快速模式
pinctrl-names = "default";
pinctrl-0 = <&i2c3m0_xfer>;
sensor@1a {
compatible = "vendor,sensor";
reg = <0x1a>;
};
};
时钟配置避坑：当输入时钟频率较高（如200MHz）时，若分频系数设置不当，SCL频率可能超出Sensor支持的极限。建议使用示波器实测SCL波形，确保占空比接近50%，且频率误差在±10%以内。
下表列出了常见时钟频率下的分频系数参考值（假设输入时钟100MHz）：
| 目标SCL频率 | CLKDIV_L | CLKDIV_H | 实际SCL频率 | 误差 |
|---|---|---|---|---|
| 100kHz | 499 | 499 | 100.0kHz | 0% |
| 400kHz | 124 | 124 | 400.0kHz | 0% |
| 1MHz | 49 | 49 | 1.0MHz | 0% |
| 3.4MHz | 13 | 13 | 3.57MHz | +5% |
3.3 传输模式：轮询、中断与DMA
RK I2C控制器支持三种传输模式，驱动开发者需根据Sensor的实时性要求和系统负载选择合适的模式。三种模式的对比如下：
| 模式 | CPU占用 | 实时性 | 吞吐量 | 适用场景 |
|---|---|---|---|---|
| 轮询（Polling） | 高（忙等） | 高 | 低 | 初始化阶段、少量寄存器读写、调试 |
| 中断（Interrupt） | 低 | 中 | 中 | 常规Sensor数据读取、周期性采样 |
| DMA | 极低 | 低 | 高 | 大数据块传输（如图像Sensor配置表） |
3.3.1 轮询模式
轮询模式通过软件循环检查状态寄存器来判断传输是否完成。其实现简单，但会阻塞CPU。典型代码片段如下：
static int rk_i2c_poll_transfer(struct rk_i2c *i2c, struct i2c_msg *msgs, int num)
{
int ret = 0;
u32 status;
// 启动传输
writel(I2C_ENABLE, i2c->regs + IC_ENABLE);
writel(msgs->addr << 1 | I2C_WRITE, i2c->regs + IC_TAR);
// 轮询等待传输完成
do {
status = readl(i2c->regs + IC_STATUS);
if (status & IC_STATUS_TX_ABRT) {
ret = -EIO;
goto out;
}
cpu_relax();
} while (!(status & IC_STATUS_TX_EMPTY));
out:
writel(I2C_DISABLE, i2c->regs + IC_ENABLE);
return ret;
}3.3.2 中断模式
中断模式是RK平台Sensor驱动中最常用的传输方式。控制器在传输完成、FIFO空/满、NACK等事件触发中断，CPU在中断服务程序中处理数据。中断模式的关键配置包括：
- 中断使能寄存器：IC_INTR_MASK，需使能传输完成、NACK、仲裁丢失等中断位。
- FIFO阈值：IC_TX_TL和IC_RX_TL，决定何时触发FIFO中断。
- 中断服务程序：读取IC_INTR_STAT判断中断类型，执行相应处理。
static irqreturn_t rk_i2c_irq_handler(int irq, void *dev_id)
{
struct rk_i2c *i2c = dev_id;
u32 intr_stat = readl(i2c->regs + IC_INTR_STAT);
if (intr_stat & IC_INTR_TX_EMPTY) {
// 发送FIFO空，写入下一批数据
rk_i2c_fill_tx_fifo(i2c);
}
if (intr_stat & IC_INTR_RX_FULL) {
// 接收FIFO满，读取数据
rk_i2c_read_rx_fifo(i2c);
}
if (intr_stat & IC_INTR_STOP_DET) {
// 传输完成，唤醒等待队列
complete(&i2c->complete);
}
if (intr_stat & IC_INTR_TX_ABRT) {
// 传输异常，记录错误
i2c->err = -EIO;
complete(&i2c->complete);
}
return IRQ_HANDLED;
}3.3.3 DMA模式
DMA模式适用于需要传输大量数据的场景（如Sensor固件下载、配置表批量写入）。RK I2C控制器内置DMA接口，可与系统DMA控制器协同工作。DMA传输的流程如下：
- 配置DMA通道：设置源地址、目的地址、传输长度、数据宽度。
- 启动DMA传输：DMA控制器自动从内存搬运数据到I2C FIFO，或从FIFO搬运到内存。
- 等待DMA完成中断：DMA传输完成后触发中断，I2C控制器自动发送停止条件。
性能对比数据：在RK3588平台上，传输1024字节数据时，轮询模式耗时约2.5ms，中断模式约1.8ms，DMA模式仅需0.3ms。DMA模式在批量传输场景下优势显著。
3.4 传输模式选择策略与SVG架构图
下图展示了RK I2C控制器三种传输模式的软件架构与数据流路径：
3.5 传输模式选择决策树
在实际Sensor驱动开发中，可按照以下决策树选择传输模式：
- 单次传输字节数 < 8 → 轮询模式（初始化、寄存器配置）
- 单次传输字节数 8~256 → 中断模式（常规数据读取）
- 单次传输字节数 > 256 → DMA模式（固件下载、批量配置）
- 系统CPU负载敏感 → 优先选择DMA模式
- 调试阶段 → 强制使用轮询模式，便于跟踪时序
最佳实践：RK平台Sensor驱动通常采用“中断模式为主，轮询模式为辅”的策略。在probe阶段使用轮询模式读取Sensor ID，后续数据采集使用中断模式。DMA模式仅在需要加载Sensor固件或配置表时启用。