4. I2C控制器驱动核心数据结构：struct i2c_adapter、struct i2c_algorithm、struct i2c_msg

在Linux内核的I2C子系统中，驱动开发者通过三个核心数据结构完成控制器适配与消息传输：struct i2c_adapter（适配器）、struct i2c_algorithm（算法）和struct i2c_msg（消息）。这三者构成了从上层客户端到底层硬件寄存器的完整调用链。理解它们的职责、成员与协作关系，是编写可移植I2C控制器驱动的第一步。

4.1 struct i2c_adapter —— 适配器实例

struct i2c_adapter 是I2C控制器的软件抽象，每个注册到内核的I2C总线对应一个适配器实例。驱动开发者需要填充该结构体，并通过 i2c_add_adapter() 或 i2c_add_numbered_adapter() 将其注册到I2C核心。

4.2 struct i2c_algorithm —— 传输算法

struct i2c_algorithm 是适配器与硬件之间的桥梁，定义了实际的数据传输方法。驱动开发者必须实现 master_xfer 回调，该回调接收一个 i2c_adapter 指针和一个 i2c_msg 数组，负责启动硬件时序完成传输。

struct i2c_algorithm {
    /* 标准 I2C 传输：处理 msg 数组，返回成功传输的 msg 数量 */
    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 struct i2c_msg —— 消息描述符

struct i2c_msg 描述一次完整的I2C数据交换，包含从设备地址、读写方向、数据缓冲区及长度。多个 i2c_msg 可以组成数组，实现复合传输（如先写寄存器地址再读数据）。

struct i2c_msg {
    __u16 addr;    /* 从设备地址（7位或10位） */
    __u16 flags;   /* 传输标志：I2C_M_RD, I2C_M_TEN, I2C_M_NOSTART 等 */
    __u16 len;     /* 数据长度（字节） */
    __u8 *buf;     /* 数据缓冲区指针 */
};

4.4 三者的协作流程

1. 客户端发起传输：调用 i2c_transfer()，传入 adapter 指针和 msg 数组。
2. I2C核心加锁：获取 adapter->lock，防止并发访问。
3. 调用算法回调：执行 adapter->algo->master_xfer(adap, msgs, num)。
4. 硬件操作：master_xfer 内部通过 algo_data 访问控制器寄存器，逐条处理 msg。
5. 返回结果：返回成功传输的 msg 数量，I2C核心释放锁并返回给客户端。