4. Linux I2C核心层架构

I2C 核心层（I2C Core）是 Linux 内核中 I2C 子系统的心脏，它向上为 I2C 设备驱动提供统一的注册与通信接口，向下通过 i2c_adapter 抽象物理控制器，并通过 i2c_algorithm 封装具体的硬件收发方法。同时，i2c_client 代表挂接在总线上的每一个从设备。理解这三个数据结构之间的协作关系，是掌握 I2C 驱动框架的关键。

4.1 i2c_adapter：I2C 控制器抽象

i2c_adapter 是 I2C 核心层对物理 I2C 控制器的软件抽象。每个 I2C 总线控制器（如 SoC 内部的 I2C 外设、GPIO 模拟的 I2C 总线）在内核中都对应一个 i2c_adapter 实例。它负责管理总线编号、设备链表、锁机制以及底层的通信算法。

4.2 i2c_algorithm：硬件通信方法集

i2c_algorithm 是 I2C 核心层与底层硬件之间的“契约”。它定义了一组函数指针，用于实现 I2C 总线的标准通信协议。不同的硬件平台（如 IMX、STM32、GPIO 模拟）通过实现这些回调函数来适配 I2C 核心层。

struct i2c_algorithm {
    /* 主模式发送/接收：发送一个 i2c_msg 数组 */
    int (*master_xfer)(struct i2c_adapter *adap,
                       struct i2c_msg *msgs,
                       int num);
    /* 从模式发送/接收（较少使用） */
    int (*slave_xfer)(struct i2c_adapter *adap,
                      struct i2c_msg *msgs,
                      int num);
    /* 查询适配器功能（如是否支持 10 位地址、SMBus 等） */
    u32 (*functionality)(struct i2c_adapter *adap);
    /* 注册从设备回调（用于从模式） */
    int (*reg_slave)(struct i2c_adapter *adap,
                     struct i2c_client *client);
    int (*unreg_slave)(struct i2c_adapter *adap,
                       struct i2c_client *client);
};

4.3 i2c_client：I2C 从设备抽象

i2c_client 代表一个挂接在 I2C 总线上的从设备（如温度传感器、加速度计、EEPROM）。每个 client 都绑定到一个特定的 i2c_adapter 和一个 7 位或 10 位从设备地址。设备驱动通过 client 结构体与硬件进行数据交换。

struct i2c_client {
    unsigned short addr;        /* 7 位从设备地址（低 7 位有效） */
    unsigned short flags;       /* 标志位：I2C_CLIENT_TEN（10 位地址）、
                                   I2C_CLIENT_SLAVE（从模式）等 */
    char name[I2C_NAME_SIZE];  /* 设备名称，用于匹配驱动 */
    struct i2c_adapter *adapter; /* 指向所属的适配器 */
    struct device dev;          /* 内核设备模型 device 对象 */
    int irq;                    /* 从设备的中断号（可选） */
    struct list_head detected;  /* 用于挂接到 adapter 的 detected 链表 */
};

4.4 三大数据结构协作关系图

下面的 SVG 图展示了 i2c_adapter、i2c_algorithm 和 i2c_client 之间的静态组合关系与动态调用路径。

4.5 数据结构初始化与注册流程

在实际的 I2C 控制器驱动中，这三个数据结构的初始化与注册遵循固定的步骤。下面以平台驱动（platform driver）为例，展示典型的初始化流程：

1. 分配并初始化 i2c_adapter： 设置 nr、name、algo、algo_data、timeout、retries 等字段。
2. 实现 i2c_algorithm： 编写 master_xfer() 和 functionality() 回调函数，操作硬件寄存器完成时序。
3. 注册 adapter： 调用 i2c_add_adapter() 或 i2c_add_numbered_adapter() 将 adapter 注册到核心层。
4. 创建设备节点： 核心层根据设备树（Device Tree）或板级代码中的 I2C 设备信息，自动创建 i2c_client 实例。
5. 驱动匹配： 当 client 创建后，核心层遍历已注册的 I2C 设备驱动，通过 i2c_device_id 或设备树 compatible 属性进行匹配。

/* 典型的 I2C 适配器驱动 probe 函数片段 */
static int my_i2c_probe(struct platform_device *pdev)
{
    struct i2c_adapter *adap;
    struct i2c_algorithm *algo;

    adap = devm_kzalloc(&pdev->dev, sizeof(*adap), GFP_KERNEL);
    algo = devm_kzalloc(&pdev->dev, sizeof(*algo), GFP_KERNEL);

    adap->nr = pdev->id;              /* 使用平台设备 ID 作为总线编号 */
    adap->name = "my_i2c_adapter";
    adap->algo = algo;
    adap->algo_data = platform_get_drvdata(pdev);
    adap->timeout = HZ;               /* 1 秒超时 */
    adap->retries = 3;

    algo->master_xfer = my_i2c_master_xfer;   /* 硬件发送函数 */
    algo->functionality = my_i2c_functionality;

    return i2c_add_numbered_adapter(adap);    /* 注册到核心层 */
}

4.6 数据结构对比总结