冠军资讯
程序员老猫在嵌入式 Linux 开发中，I2C（Inter-Integrated Circuit）总线被广泛应用于连接各种外围设备，例如传感器、EEPROM 等。要让这些设备正常工作，就需要编写相应的驱动程序。Linux 内核提供了一套完善的 I2C 子系统，其中 i2c_Adapter 驱动框架是核心组成部分。理解 i2c_Adapter 驱动框架对于进行 I2C 设备驱动开发至关重要。本文将深入剖析 i2c_Adapter 驱动框架的底层原理，并结合实际代码示例，帮助读者快速上手 I2C 设备驱动开发。
I2C 子系统架构概述
I2C 子系统主要由以下几个部分组成：
- i2c_adapter: 代表一个 I2C 主机控制器，例如 SOC 上的 I2C 控制器。每个 I2C 总线上可以挂载多个 I2C 设备。
- i2c_algorithm: 定义了 I2C 通讯的具体算法，例如发送起始信号、发送地址、读写数据等。
- i2c_client: 代表一个 I2C 从设备，例如传感器、EEPROM 等。
- i2c_driver: I2C 设备驱动程序，负责驱动 I2C 从设备。
i2c_adapter 负责管理 I2C 总线，i2c_client 通过 i2c_driver 与 i2c_adapter 进行通讯。
i2c_Adapter 驱动框架详解
i2c_adapter 驱动框架的核心在于 i2c_adapter 结构体，它定义了 I2C 主机控制器的属性和操作方法。在驱动开发中，我们需要填充 i2c_adapter 结构体，并将其注册到 I2C 子系统中。
struct i2c_adapter {
struct module *owner;
unsigned int class; /* classes to allow probing for */
const struct i2c_algorithm *algo; /* 必需，I2C 通讯算法 */
void *algo_data;
/* data fields that are not often accessed */
struct rt_mutex bus_lock;
int timeout; /* in jiffies */
int retries; /* in number of tries */
struct device dev; /* the adapter device */
int nr; /* adapter number */
char name[48]; /* adapter name */
struct completion dev_released;
struct mutex userspace_clients_lock;
struct list_head userspace_clients;
struct i2c_bus_recovery_info *bus_recovery_info;
const struct i2c_adapter_quirks *quirks;
};
其中，最重要的成员是 algo，它指向 i2c_algorithm 结构体，定义了 I2C 通讯的具体算法。i2c_algorithm 结构体包含以下几个关键函数：
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 *);
#ifdef CONFIG_I2C_SLAVE
int (*slave_xfer)(struct i2c_adapter *adap, struct i2c_msg *msgs, int num);
#endif
#ifdef CONFIG_I2C_DEBUG_CORE
void (*dump_regs)(struct i2c_adapter *adap);
#endif
};
master_xfer：用于执行 I2C 主模式下的数据传输。smbus_xfer：用于执行 SMBus 协议下的数据传输。functionality：用于返回 I2C 主机控制器的功能。
在编写 I2C Adapter 驱动时，需要实现 i2c_algorithm 中的这些函数，以完成 I2C 通讯的具体操作。
驱动实例：基于设备树的 I2C Adapter 驱动
现代 Linux 系统中，设备树被广泛应用于描述硬件信息。I2C Adapter 驱动也可以通过设备树进行配置。
1. 设备树节点定义
首先，需要在设备树中定义 I2C 控制器的节点。
&i2c1 {
status = "okay";
clock-frequency = <100000>; // 设置时钟频率为 100kHz
};
2. 驱动代码实现
接下来，需要在驱动代码中解析设备树节点，并注册 i2c_adapter。
static int i2c_adapter_probe(struct platform_device *pdev)
{
struct i2c_adapter *adap;
struct resource *res;
int irq;
adap = devm_kzalloc(&pdev->dev, sizeof(struct i2c_adapter), GFP_KERNEL);
if (!adap)
return -ENOMEM;
// 获取设备树中的资源信息，例如基地址、中断号
res = platform_get_resource(pdev, IORESOURCE_MEM, 0);
// ...
irq = platform_get_irq(pdev, 0);
// ...
// 填充 i2c_adapter 结构体
strlcpy(adap->name, "My I2C Adapter", sizeof(adap->name));
adap->owner = THIS_MODULE;
adap->algo = &my_i2c_algorithm; // 关联 i2c_algorithm
adap->dev.parent = &pdev->dev;
// 注册 i2c_adapter
int ret = i2c_add_adapter(adap);
if (ret) {
dev_err(&pdev->dev, "Failed to add I2C adapter");
return ret;
}
platform_set_drvdata(pdev, adap);
return 0;
}
static const struct i2c_algorithm my_i2c_algorithm = {
.master_xfer = my_i2c_master_xfer,
.smbus_xfer = my_i2c_smbus_xfer,
.functionality = my_i2c_functionality,
};
3. 实现 i2c_algorithm 中的函数
最后，需要实现 my_i2c_algorithm 中的函数，例如 my_i2c_master_xfer，以完成 I2C 通讯的具体操作。这部分代码需要根据具体的硬件平台进行编写，涉及到 I2C 控制器的寄存器操作等。
实战避坑经验总结
- 时钟频率配置： I2C 通讯的时钟频率需要根据 I2C 设备的规格书进行配置。过高的时钟频率可能导致通讯失败。
- 设备地址冲突： 确保 I2C 总线上各个设备的地址不冲突。可以使用
i2cdetect命令检测 I2C 总线上的设备地址。 - 中断处理： I2C 通讯过程中可能会产生中断。需要在中断处理函数中处理 I2C 中断，例如读取数据、发送应答信号等。
- DMA 传输： 对于大数据量的 I2C 传输，可以考虑使用 DMA 方式，以提高传输效率。
掌握 i2c_Adapter 驱动框架，能帮助开发者更高效地进行 Linux 下的 I2C 设备驱动开发。在实际开发中，还需要结合具体的硬件平台和 I2C 设备进行调试和优化。理解 I2C 总线协议和时序对于解决 I2C 通讯问题至关重要。一些常用的调试工具，例如逻辑分析仪，可以帮助开发者分析 I2C 总线上的信号，从而快速定位问题。同时，熟练使用 Linux 内核提供的 I2C API，例如 i2c_transfer，可以简化 I2C 设备驱动的开发工作。记得及时更新 Linux 内核，以获取最新的 I2C 驱动支持和性能优化。
I2C 驱动开发也需要考虑一些性能问题。例如，避免在中断处理函数中执行过多的操作，以免影响系统的实时性。可以使用工作队列（workqueue）将一些耗时的操作移到工作队列中执行。此外，还可以使用缓存来减少对 I2C 设备的访问次数，从而提高性能。
了解了 i2c_Adapter 驱动框架，对于在 Linux 下进行 I2C 设备驱动开发已经打下了坚实的基础。结合实际项目经验，不断学习和探索，才能成为一名优秀的嵌入式 Linux 驱动工程师。
