4. I2C核心数据结构：struct i2c_adapter、struct i2c_algorithm、struct i2c_client、struct i2c_driver

在Linux I2C子系统驱动框架中，四个核心数据结构构成了整个I2C通信的骨架：适配器（Adapter）、算法（Algorithm）、客户端（Client）和驱动（Driver）。理解这四个结构体之间的关系与职责，是进行I2C驱动移植与设备树绑定的基础。

4.1 整体架构关系

下图展示了四个核心数据结构在I2C子系统中的层级关系与数据流向：

4.2 struct i2c_adapter — 适配器结构体

struct i2c_adapter 是对I2C总线控制器硬件的软件抽象。每个I2C控制器对应一个adapter实例，负责管理总线上的所有I2C事务。

4.2.1 关键成员

struct i2c_adapter {
    struct module *owner;           /* 所属模块 */
    unsigned int class;             /* 适配器支持的设备类 */
    const struct i2c_algorithm *algo; /* 算法指针，核心成员 */
    struct device dev;              /* 内核设备模型 */
    int nr;                         /* 适配器编号，如 i2c-0 */
    char name[48];                  /* 适配器名称 */
    struct list_head userspace_clients; /* 用户空间客户端列表 */
    struct mutex bus_lock;          /* 总线访问互斥锁 */
    int timeout;                    /* 传输超时时间(ms) */
    int retries;                    /* 传输重试次数 */
    void *algo_data;                /* 算法私有数据 */
};

4.2.2 适配器注册流程

4.3 struct i2c_algorithm — 算法结构体

struct i2c_algorithm 定义了适配器与从设备之间进行数据收发的底层通信方法。它是I2C控制器驱动必须实现的核心接口。

4.3.1 关键成员

struct i2c_algorithm {
    /* 标准I2C传输：发送起始条件、地址、数据、停止条件 */
    int (*master_xfer)(struct i2c_adapter *adap,
                       struct i2c_msg *msgs,
                       int num);

    /* SMBus兼容传输（可选） */
    int (*smbus_xfer)(struct i2c_adapter *adap,
                      u16 addr,
                      unsigned short flags,
                      char read_write,
                      u8 command,
                      int size,
                      union i2c_smbus_data *data);

    /* 功能支持查询 */
    u32 (*functionality)(struct i2c_adapter *adap);
};

4.3.2 三种方法对比

4.4 struct i2c_client — 客户端结构体

struct i2c_client 代表挂载在I2C总线上的一个从设备。每个从设备在系统中对应一个client实例，由I2C核心层在设备枚举或设备树解析时创建。

4.4.1 关键成员

struct i2c_client {
    unsigned short addr;            /* 7位或10位从设备地址 */
    char name[I2C_NAME_SIZE];       /* 设备名称，用于驱动匹配 */
    struct i2c_adapter *adapter;    /* 所属适配器指针 */
    struct device dev;              /* 内核设备模型 */
    int irq;                        /* 中断号（如支持） */
    struct list_head detected;      /* 检测链表 */
    int flags;                      /* 标志位（如地址长度） */
};

4.4.2 设备树到client的映射

当设备树中包含I2C从设备节点时，内核在解析过程中自动创建i2c_client实例：

// 设备树示例
&i2c1 {
    status = "okay";
    clock-frequency = <100000>;

    temperature_sensor: tmp102@48 {
        compatible = "ti,tmp102";
        reg = <0x48>;          // 7位从设备地址
        interrupt-parent = <&gpio1>;
        interrupts = <15 IRQ_TYPE_EDGE_FALLING>;
    };
};

// 内核解析后自动创建：
// struct i2c_client *client;
// client->addr = 0x48;
// client->adapter = i2c1_adapter;
// client->irq = gpio_to_irq(15);

4.5 struct i2c_driver — 驱动结构体

struct i2c_driver 是I2C从设备驱动的核心结构体，负责将驱动与client绑定，并提供设备操作接口。

4.5.1 关键成员

struct i2c_driver {
    unsigned int class;             /* 驱动支持的设备类 */
    int (*probe)(struct i2c_client *client,
                 const struct i2c_device_id *id);  /* 设备探测 */
    int (*remove)(struct i2c_client *client);      /* 设备移除 */
    void (*shutdown)(struct i2c_client *client);   /* 系统关机 */
    int (*suspend)(struct i2c_client *client,
                   pm_message_t mesg);             /* 电源管理-挂起 */
    int (*resume)(struct i2c_client *client);      /* 电源管理-恢复 */
    struct device_driver driver;    /* 内核驱动模型 */
    const struct i2c_device_id *id_table; /* 设备ID匹配表 */
};

4.5.2 驱动注册与匹配流程

1. 定义驱动结构体：填充probe、remove、id_table等成员
2. 注册驱动：调用 i2c_add_driver() 宏
3. 匹配过程：内核将client的name与id_table中的name字段比对，或通过设备树compatible属性匹配
4. probe调用：匹配成功后，内核调用驱动的probe函数，传入匹配的client指针
5. 设备操作：在probe中通过client调用i2c_transfer()与硬件通信

// 典型I2C驱动模板
static const struct i2c_device_id tmp102_id[] = {
    { "tmp102", 0 },
    { }
};
MODULE_DEVICE_TABLE(i2c, tmp102_id);

static const struct of_device_id tmp102_of_match[] = {
    { .compatible = "ti,tmp102" },
    { }
};
MODULE_DEVICE_TABLE(of, tmp102_of_match);

static struct i2c_driver tmp102_driver = {
    .driver = {
        .name = "tmp102",
        .of_match_table = tmp102_of_match,
    },
    .probe    = tmp102_probe,
    .remove   = tmp102_remove,
    .id_table = tmp102_id,
};

module_i2c_driver(tmp102_driver);

4.6 四个结构体的协作流程

下图展示了一次典型的I2C读写操作中，四个结构体之间的协作关系：

4.7 数据结构对比总结