Linux I2C 驱动框架简介
回想一下我们在裸机篇中是怎么编写 AP3216C 驱动的，我们编写了四个文件：
bsp_i2c.c、bsp_i2c.h、bsp_ap3216c.c 和 bsp_ap3216c.h。其中前两个是 I.MX6U 的 IIC 接口驱动，后两个文件是 AP3216C 这个 I2C 设备驱动文件。相当于有两部分驱动：
①、I2C 主机驱动。
②、I2C 设备驱动。
对于 I2C 主机驱动，一旦编写完成就不需要再做修改，其他的 I2C 设备直接调用主机驱动提供的 API 函数完成读写操作即可。这个正好符合 Linux 的驱动分离与分层的思想，因此 Linux内核也将 I2C 驱动分为两部分：
①、I2C 总线驱动，I2C 总线驱动就是 SOC 的 I2C 控制器驱动，也叫做 I2C 适配器驱动。
②、I2C 设备驱动，I2C 设备驱动就是针对具体的 I2C 设备而编写的驱动。
I2C 总线驱动
这里要用到两个重要的数据结构：i2c_adapter 和 i2c_algorithm，结构体内容如下：
示例代码 61.1.1.1 i2c_adapter 结构体 498 struct i2c_adapter { 499 struct module *owner; 500 unsigned int class; /* classes to allow probing for */ 501 const struct i2c_algorithm *algo; /* 总线访问算法 */ 502 void *algo_data; 503 504 /* data fields that are valid for all devices */ 505 struct rt_mutex bus_lock; 506 507 int timeout; /* in jiffies */ 508 int retries; 509 struct device dev; /* the adapter device */ 510 511 int nr; 512 char name[48]; 513 struct completion dev_released; 514 515 struct mutex userspace_clients_lock; 516 struct list_head userspace_clients; 517 518 struct i2c_bus_recovery_info *bus_recovery_info; 519 const struct i2c_adapter_quirks *quirks; 520 };
第 501 行，i2c_algorithm 类型的指针变量 algo，对于一个 I2C 适配器，肯定要对外提供读写 API 函数，设备驱动程序可以使用这些 API 函数来完成读写操作。i2c_algorithm 就是 I2C 适配器与 IIC 设备进行通信的方法。
i2c_algorithm 结构体定义在 include/linux/i2c.h 文件中，内容如下(删除条件编译)：
示例代码 61.1.1.2 i2c_algorithm 结构体 391 struct i2c_algorithm { 398 int (*master_xfer)(struct i2c_adapter *adap, struct i2c_msg *msgs, 399 int num); 400 int (*smbus_xfer) (struct i2c_adapter *adap, u16 addr, 401 unsigned short flags, char read_write, 402 u8 command, int size, union i2c_smbus_data *data); 403 404 /* To determine what the adapter supports */ 405 u32 (*functionality) (struct i2c_adapter *); ...... 411 };
第 398 行，master_xfer 就是 I2C 适配器的传输函数，可以通过此函数来完成与 IIC 设备之间的通信。
第 400 行，smbus_xfer 就是 SMBUS 总线的传输函数。
综上所述，I2C 总线驱动，或者说 I2C 适配器驱动的主要工作就是初始化 i2c_adapter 结构体变量，然后设置 i2c_algorithm 中的 master_xfer 函数。完成以后通过i2c_add_numbered_adapter
或 i2c_add_adapter 这两个函数向系统注册设置好的 i2c_adapter，这两个函数的原型如下：
int i2c_add_adapter(struct i2c_adapter *adapter) int i2c_add_numbered_adapter(struct i2c_adapter *adap)
这两个函数的区别在于 i2c_add_adapter 使用动态的总线号，而 i2c_add_numbered_adapter使用静态总线号。函数参数和返回值含义如下：
adapter 或 adap：要添加到 Linux 内核中的 i2c_adapter，也就是 I2C 适配器。
返回值：0，成功；负值，失败。
如果要删除 I2C 适配器的话使用 i2c_del_adapter 函数即可，函数原型如下：
void i2c_del_adapter(struct i2c_adapter * adap)
函数参数和返回值含义如下： adap：要删除的 I2C 适配器。 返回值：无。
关于 I2C 的总线(控制器或适配器)驱动就讲解到这里，一般 SOC 的 I2C 总线驱动都是由半导体厂商编写的，比如 I.MX6U 的 I2C 适配器驱动 NXP 已经编写好了，这个不需要用户去编写。因此 I2C 总线驱动对我们这些 SOC 使用者来说是被屏蔽掉的，我们只要专注于 I2C 设备驱动即可。除非你是在半导体公司上班，工作内容就是写 I2C 适配器驱动。
I2C 设备驱动
I2C 设备驱动重点关注两个数据结构：i2c_client 和 i2c_driver,i2c_client 就是描述设备信息的，i2c_driver 描述驱动内容，类似于 platform_driver。
i2c_driver 的注册示例代码如下：
示例代码 61.1.2.4 i2c_driver 注册流程 1 /* i2c 驱动的 probe 函数 */ 2 static int xxx_probe(struct i2c_client *client, const struct i2c_device_id *id) 3 { 4 /* 函数具体程序 */ 5 return 0; 6 } 7 8 /* i2c 驱动的 remove 函数 */ 9 static int ap3216c_remove(struct i2c_client *client) 10 { 11 /* 函数具体程序 */ 12 return 0; 13 } 14 15 /* 传统匹配方式 ID 列表 */ 16 static const struct i2c_device_id xxx_id[] = { 17 {"xxx", 0}, 18 {} 19 }; 20 21 /* 设备树匹配列表 */ 22 static const struct of_device_id xxx_of_match[] = { 23 { .compatible = "xxx" }, 24 { /* Sentinel */ } 25 }; 26 27 /* i2c 驱动结构体 */ 28 static struct i2c_driver xxx_driver = { 29 .probe = xxx_probe, 30 .remove = xxx_remove, 31 .driver = { 32 .owner = THIS_MODULE, 33 .name = "xxx", 34 .of_match_table = xxx_of_match, 35 }, 36 .id_table = xxx_id, 37 }; 38 39 /* 驱动入口函数 */ 40 static int __init xxx_init(void) 41 { 42 int ret = 0; 43 44 ret = i2c_add_driver(&xxx_driver); 45 return ret; 46 } 47 48 /* 驱动出口函数 */ 49 static void __exit xxx_exit(void) 50 { 51 i2c_del_driver(&xxx_driver); 52 } 53 54 module_init(xxx_init); 55 module_exit(xxx_exit);
第 16~19 行，i2c_device_id，无设备树的时候匹配 ID 表。
第 22~25 行，of_device_id，设备树所使用的匹配表。
第 28~37 行，i2c_driver，当 I2C 设备和 I2C 驱动匹配成功以后 probe 函数就会执行，这些和 platform 驱动一样，probe 函数里面基本就是标准的字符设备驱动那一套了。
I2C 设备和驱动匹配过程
I2C 设备和驱动的匹配过程是由 I2C 核心来完成的，drivers/i2c/i2c-core.c 就是 I2C 的核心部分，I2C 核心提供了一些与具体硬件无关的 API 函数，比如前面讲过的：
1、i2c_adapter 注册/注销函数
int i2c_add_adapter(struct i2c_adapter *adapter) int i2c_add_numbered_adapter(struct i2c_adapter *adap) void i2c_del_adapter(struct i2c_adapter * adap)
2、i2c_driver 注册/注销函数
int i2c_register_driver(struct module *owner, struct i2c_driver *driver) int i2c_add_driver (struct i2c_driver *driver) void i2c_del_driver(struct i2c_driver *driver)
设备树下的I2C程序编写
1、设备树
在I2C1此父节点下插入mag3110子节点， “0e”是mag3110的I2C器件地址。<reg>属性是mag3110的器件地址，compatible属性用于设备驱动的匹配。
2、数据收发处理流程
I2C 设备驱动首先要做的就是初始化 i2c_driver 并向 Linux 内核注册。当设备和驱动匹配以后 i2c_driver 里面的 probe 函数就会执行，probe 函数里面所做的就是字符设备驱动那一套了。一般需要在 probe 函数里面初始化 I2C 设备，要初始化 I2C 设备就必须能够对 I2C 设备寄存器进行读写操作，这里就要用到 i2c_transfer 函数了。i2c_transfer 函数最终会调用 I2C 适配器中 i2c_algorithm 里面的 master_xfer 函数，对于 I.MX6U 而言就是i2c_imx_xfer 这个函数。
i2c_transfer 函数原型如下：
int i2c_transfer(struct i2c_adapter *adap, struct i2c_msg *msgs, int num)
我们重点来看一下 msgs 这个参数，这是一个 i2c_msg 类型的指针参数，I2C 进行数据收发说白了就是消息的传递，Linux 内核使用 i2c_msg 结构体来描述一个消息。i2c_msg 结构体定义
在 include/uapi/linux/i2c.h 文件中，结构体内容如下：
示例代码 61.3.2.1 i2c_msg 结构体 68 struct i2c_msg { 69 __u16 addr; /* 从机地址 */ 70 __u16 flags; /* 标志 */ 71 #define I2C_M_TEN 0x0010 72 #define I2C_M_RD 0x0001 73 #define I2C_M_STOP 0x8000 74 #define I2C_M_NOSTART 0x4000 75 #define I2C_M_REV_DIR_ADDR 0x2000 76 #define I2C_M_IGNORE_NAK 0x1000 77 #define I2C_M_NO_RD_ACK 0x0800 78 #define I2C_M_RECV_LEN 0x0400 79 __u16 len; /* 消息(本 msg)长度 */ 80 __u8 *buf; /* 消息数据 */ 81 };
使用 i2c_transfer 函数发送数据之前要先构建好 i2c_msg，使用 i2c_transfer 进行 I2C 数据收发的示例代码如下：
示例代码 61.3.2.2 I2C 设备多寄存器数据读写 1 /* 设备结构体 */ 2 struct xxx_dev { 3 ...... 4 void *private_data; /* 私有数据，一般会设置为 i2c_client */ 5 }; 6 7 /* 8 * @description : 读取 I2C 设备多个寄存器数据 9 * @param – dev : I2C 设备 10 * @param – reg : 要读取的寄存器首地址 11 * @param – val : 读取到的数据 12 * @param – len : 要读取的数据长度 13 * @return : 操作结果 14 */ 15 static int xxx_read_regs(struct xxx_dev *dev, u8 reg, void *val,int len) 16 { 17 int ret; 18 struct i2c_msg msg[2]; 19 struct i2c_client *client = (struct i2c_client *)dev->private_data; 20 21 /* msg[0]，第一条写消息，发送要读取的寄存器首地址 */ 22 msg[0].addr = client->addr; /* I2C 器件地址 */ 23 msg[0].flags = 0; /* 标记为发送数据 */ 24 msg[0].buf = ® /* 读取的首地址 */ 25 msg[0].len = 1; /* reg 长度 */ 26 27 /* msg[1]，第二条读消息，读取寄存器数据 */ 28 msg[1].addr = client->addr; /* I2C 器件地址 */ 29 msg[1].flags = I2C_M_RD; /* 标记为读取数据 */ 30 msg[1].buf = val; /* 读取数据缓冲区 */ 31 msg[1].len = len; /* 要读取的数据长度 */ 32 33 ret = i2c_transfer(client->adapter, msg, 2); 34 if(ret == 2) { 35 ret = 0; 36 } else { 37 ret = -EREMOTEIO; 38 } 39 return ret; 40 } 41 42 /* 43 * @description : 向 I2C 设备多个寄存器写入数据 44 * @param – dev : 要写入的设备结构体 45 * @param – reg : 要写入的寄存器首地址 46 * @param – val : 要写入的数据缓冲区 47 * @param – len : 要写入的数据长度 48 * @return : 操作结果 49 */ 50 static s32 xxx_write_regs(struct xxx_dev *dev, u8 reg, u8 *buf,u8 len) 51 { 52 u8 b[256]; 53 struct i2c_msg msg; 54 struct i2c_client *client = (struct i2c_client *)dev->private_data; 55 56 b[0] = reg; /* 寄存器首地址 */ 57 memcpy(&b[1],buf,len); /* 将要发送的数据拷贝到数组 b 里面 */ 58 59 msg.addr = client->addr; /* I2C 器件地址 */ 60 msg.flags = 0; /* 标记为写数据 */ 61 62 msg.buf = b; /* 要发送的数据缓冲区 */ 63 msg.len = len + 1; /* 要发送的数据长度 */ 64 65 return i2c_transfer(client->adapter, &msg, 1); 66 }
第2~5行，设备结构体，在设备结构体里面添加一个执行void的指针成员变量private_data，
此成员变量用于保存设备的私有数据。在 I2C 设备驱动中我们一般将其指向 I2C 设备对应的i2c_client。 第 15~40 行，xxx_read_regs 函数用于读取 I2C 设备多个寄存器数据。
第 18 行定义了一个i2c_msg 数组，2 个数组元素，因为 I2C 读取数据的时候要先发送要读取的****寄存器地址，然后再读取数据，所以需要准备两个 i2c_msg。一个用于发送寄存器地址，一个用于读取寄存器值。
对于 msg[0]，将 flags 设置为 0，表示写数据。
msg[0]的 addr 是 I2C 设备的器件地址，msg[0]的 buf成员变量就是要读取的寄存器地址。
对于 msg[1]，将 flags 设置为 I2C_M_RD，表示读取数据。msg[1]的 buf 成员变量用于保存读取到的数据，len 成员变量就是要读取的数据长度。
调用i2c_transfer 函数完成 I2C 数据读操作。
第 50~66 行，xxx_write_regs 函数用于向 I2C 设备多个寄存器写数据，I2C 写操作要比读操作简单一点，因此一个 i2c_msg 即可。数组 b 用于存放寄存器首地址和要发送的数据。
第 59 行设置 msg 的 addr 为 I2C 器件地址。第 60 行设置 msg 的 flags 为 0，也就是写数据。
第 62 行设置要发送的数据，也就是数组 b。第 63 行设置 msg 的 len 为 len+1，因为要加上一个字节的寄存器地址。最后通过 i2c_transfer 函数完成向 I2C 设备的写操作。
另外还有两个API函数分别用于I2C数据的收发操作，这两个函数最终都会调用i2c_transfer。
首先来看一下 I2C 数据发送函数 i2c_master_send，函数原型如下：
int i2c_master_send(const struct i2c_client *client, const char *buf, int count)
函数参数和返回值含义如下： client：I2C 设备对应的 i2c_client。 buf：要发送的数据。
count：要发送的数据字节数，要小于 64KB，以为 i2c_msg 的 len 成员变量是一个 u16(无 符号 16 位)类型的数据。
返回值：负值，失败，其他非负值，发送的字节数。
I2C 数据接收函数为 i2c_master_recv，函数原型如下：
int i2c_master_recv(const struct i2c_client *client, char *buf, int count)
函数参数和返回值含义如下： client：I2C 设备对应的 i2c_client。 buf：要接收的数据。
count：要接收的数据字节数，要小于 64KB，以为 i2c_msg 的 len 成员变量是一个 u16(无 符号 16 位)类型的数据。
返回值：负值，失败，其他非负值，发送的字节数。
关于 Linux 下 I2C 设备驱动的编写流程就讲解到这里，重点就是 i2c_msg 的构建和
i2c_transfer 函数的调用，接下来我们就编写 AP3216C 这个 I2C 设备的 Linux 驱动。
示例驱动：
&i2c1 { clock-frequency = <100000>; pinctrl-names = "default"; pinctrl-0 = <&pinctrl_i2c1>; status = "okay"; ap3216c@1e { compatible = "alientek,ap3216c"; reg = <0x1e>; }; };
