2. Linux I2C 子系统架构：三层模型详解

Linux I2C 子系统采用经典的三层软件架构设计，将硬件差异、总线通信与设备控制逻辑解耦。理解这一分层模型是进行车载 I2C 设备驱动开发与调试的基础。三层分别为：I2C 核心层、I2C 总线驱动层、I2C 设备驱动层。

2.1 三层模型总体架构

下图展示了 I2C 子系统在 Linux 内核中的分层关系，以及各层之间的数据流与控制流路径。

2.2 各层职责与核心数据结构

三层模型中，每一层都对应一组内核数据结构和操作函数。下表总结了各层的核心职责与关键接口：

2.3 I2C 核心层 (I2C Core)

核心层是 I2C 子系统的中枢，负责管理总线适配器与设备的生命周期，并提供统一的传输接口。核心层的主要功能包括：

• 适配器管理： 通过 i2c_add_adapter() 注册总线控制器，通过 i2c_del_adapter() 注销。
• 设备管理： 通过 i2c_new_device() / i2c_new_probed_device() 创建 I2C 从设备节点。
• 驱动匹配： 基于 i2c_device_id 或 of_match_table（设备树）完成驱动与设备的绑定。
• 传输调度： 提供 i2c_transfer() 作为统一的传输入口，内部调用适配器的 master_xfer()。

2.4 I2C 总线驱动层 (I2C Bus Driver)

总线驱动层直接与硬件 I2C 控制器交互，负责产生符合 I2C 协议的 SCL 时钟与 SDA 数据信号。在车载 SoC（如 NXP i.MX8、TI Jacinto、R-Car）中，该层通常由 SoC 厂商提供。

总线驱动层的核心数据结构是 struct i2c_adapter，其中最重要的成员是 struct i2c_algorithm *algo：

struct i2c_adapter {
    struct module *owner;
    unsigned int class;               // 适配器支持的设备类型
    const struct i2c_algorithm *algo; // 算法指针，核心操作函数
    struct device dev;                // 内核设备模型
    struct i2c_lock_operations *lock_ops;
    struct rt_mutex bus_lock;
    int nr;                           // 适配器编号（如 i2c-0, i2c-1）
    char name[48];
    struct completion dev_released;
    struct mutex userspace_clients_lock;
    struct list_head userspace_clients;
};

struct i2c_algorithm {
    int (*master_xfer)(struct i2c_adapter *adap, struct i2c_msg *msgs, int num);
    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);
};

总线驱动层的关键职责：

• 实现 master_xfer()：处理多条消息的复合传输（组合 START/STOP 条件）。
• 实现 smbus_xfer()：支持 SMBus 协议的子集传输。
• 实现 functionality()：返回适配器支持的功能掩码（如 I2C_FUNC_I2C、I2C_FUNC_SMBUS_READ_BYTE）。
• 管理中断：在车载系统中，I2C 传输通常基于中断完成，避免 CPU 忙等。

2.5 I2C 设备驱动层 (I2C Device Driver)

设备驱动层是开发者最常接触的层次，负责实现具体 I2C 从设备的操作逻辑。在车载场景中，常见的 I2C 设备包括：

• 环境传感器（温度、湿度、气压）
• 触摸屏控制器（如 FT5x06、GT911）
• 音频编解码器（如 WM8960、TLV320AIC）
• 电源管理芯片（PMIC）
• EEPROM / 安全芯片

设备驱动层使用 struct i2c_driver 和 struct i2c_client 两个核心结构：

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);
    struct device_driver driver;
    const struct i2c_device_id *id_table;
    const struct of_device_id *of_match_table;
};

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;
};

设备驱动层的典型工作流程：

1. 注册驱动： 调用 i2c_add_driver() 将驱动注册到核心层。
2. 匹配设备： 核心层根据 id_table 或 of_match_table 匹配设备树中的节点。
3. Probe 初始化： 匹配成功后调用 probe()，完成设备初始化、注册中断、创建输入设备等。
4. 数据传输： 使用 i2c_master_send() / i2c_master_recv() 或 SMBus 辅助函数进行读写。
5. 移除驱动： 调用 i2c_del_driver()，触发 remove() 清理资源。

2.6 三层模型在车载系统中的交互流程

以下 SVG 图展示了一个典型的 I2C 温度传感器驱动从设备树解析到数据读取的完整调用链：

2.7 车载环境下的分层调试要点

针对三层模型，车载调试建议如下：