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

在 Linux I2C 子系统中，四个核心数据结构构成了设备模型与通信的骨架。理解它们之间的关系，是编写显示驱动 I2C 调试代码的前提。本章将逐一剖析每个结构体的职责、关键成员以及它们在驱动注册流程中的协作方式。

3.1 整体架构关系图

下面的 SVG 图展示了四个核心结构体在 I2C 总线系统中的分层关系与数据流向：

3.2 struct i2c_adapter —— I2C 总线适配器

struct i2c_adapter 代表一个物理的 I2C 控制器实例。在显示驱动中，它通常对应 SoC 内部的一个 I2C 外设（如 i2c-0、i2c-1），负责管理总线时钟、仲裁和消息传输。

关键成员

3.3 struct i2c_algorithm —— 通信算法

struct i2c_algorithm 定义了适配器如何执行实际的 I2C 总线传输。它是硬件与上层协议之间的桥梁。

核心函数指针

3.4 struct i2c_client —— I2C 从设备

struct i2c_client 代表一个连接到 I2C 总线上的从设备。在显示驱动中，它对应 HDMI 接收器、触摸控制器、背光调节芯片等。

关键成员

3.5 struct i2c_driver —— I2C 设备驱动

struct i2c_driver 是驱动开发者主要实现的结构体。它定义了驱动与内核 I2C 核心的交互接口。

关键成员

设备匹配流程

1. 注册驱动： 调用 i2c_add_driver() 将 i2c_driver 注册到 I2C 总线。
2. 扫描设备： 内核遍历该适配器上的所有 i2c_client，调用 i2c_device_match()。
3. 匹配方式： 优先使用 of_match_table（设备树），其次使用 id_table（传统方式）。
4. 调用 probe： 匹配成功后，调用驱动的 probe 函数，传入匹配的 client 和 id。

3.6 数据结构协作流程

下面的 SVG 图展示了从驱动注册到设备 probe 的完整数据流：

3.7 典型代码示例：显示驱动中的 I2C 注册

以下代码展示了一个显示驱动中 I2C 子设备的注册与 probe 流程：

/* 定义 i2c_device_id 表 */
static const struct i2c_device_id hdmi_i2c_id[] = {
    { "hdmi_tx", 0 },
    { }
};
MODULE_DEVICE_TABLE(i2c, hdmi_i2c_id);

/* 定义 of_match_table（设备树匹配） */
static const struct of_device_id hdmi_of_match[] = {
    { .compatible = "vendor,hdmi-tx" },
    { }
};
MODULE_DEVICE_TABLE(of, hdmi_of_match);

/* probe 函数 */
static int hdmi_i2c_probe(struct i2c_client *client,
                          const struct i2c_device_id *id)
{
    struct device *dev = &client->dev;
    struct hdmi_priv *priv;

    priv = devm_kzalloc(dev, sizeof(*priv), GFP_KERNEL);
    if (!priv)
        return -ENOMEM;

    priv->client = client;
    i2c_set_clientdata(client, priv);

    /* 读取 EDID 示例 */
    u8 edid[128];
    struct i2c_msg msg[2];
    u8 addr = 0x00;

    msg[0].addr = 0x50;        /* EDID EEPROM 地址 */
    msg[0].flags = 0;          /* 写 */
    msg[0].len = 1;
    msg[0].buf = &addr;

    msg[1].addr = 0x50;
    msg[1].flags = I2C_M_RD;   /* 读 */
    msg[1].len = 128;
    msg[1].buf = edid;

    if (i2c_transfer(client->adapter, msg, 2) != 2) {
        dev_err(dev, "EDID read failed\n");
        return -EIO;
    }

    return 0;
}

/* 定义 i2c_driver */
static struct i2c_driver hdmi_i2c_driver = {
    .driver = {
        .name = "hdmi_tx",
        .of_match_table = hdmi_of_match,
    },
    .probe    = hdmi_i2c_probe,
    .id_table = hdmi_i2c_id,
};

/* 模块入口 */
module_i2c_driver(hdmi_i2c_driver);

3.8 数据结构对比总结