i.MX8MM处理器采用了先进的14LPCFinFET工艺,提供更快的速度和更高的电源效率;四核Cortex-A53,单核Cortex-M4,多达五个内核 ,主频高达1.8GHz,2G DDR4内存、8G EMMC存储。千兆工业级以太网、MIPI-DSI、USB HOST、WIFI/BT、4G模块、CAN、RS485等接口一应俱全。H264、VP8视频硬编码,H.264、H.265、VP8、VP9视频硬解码,并提供相关历程,支持8路PDM接口、5路SAI接口、2路Speaker。系统支持Android9.0(支持获取root限)Linux4.14.78+Qt5.10.1、Yocto、Ubuntu20、Debian9系统。适用于智能充电桩,物联网,工业控制,医疗,智能交通等,可用于任何通用工业和物联网应用、
【公众号】迅为电子
【粉丝群】258811263(加群获取驱动文档+例程)
第六十四章 Linux I2C驱动
本章导读
I2C 是很常用的一个串行通信接口,用于连接各种外设、传感器等。I2C 总线仅仅使用 SCL、SDA 这两根信号线就实现了设备之间的数据交互,极大地简化了对硬件资源和 PCB 板布线空间的占用。在本章中主要来看一下在 Linux 内核中如何使用 I2C 的驱动框架。
本章内容对应视频讲解链接(在线观看):
应用层实现12C通信 → https://www.bilibili.com/video/BV1Vy4y1B7ta?p=44
I2C总线实现client设备 → https://www.bilibili.com/video/BV1Vy4y1B7ta?p=45
I2C总线实现driver驱动 → https://www.bilibili.com/video/BV1Vy4y1B7ta?p=46
驱动程序实现I2C通信 → https://www.bilibili.com/video/BV1Vy4y1B7ta?p=47
64.1 Linux I2C 驱动框架简介
在 Linux 内核中 I2C 的体系结构分为 3 个部分:
- I2C 核心:I2C 核心提供了 I2C 总线驱动和设备驱动的注册、注销方法等。
- I2C 总线驱动:I2C 总线驱动是对 I2C 硬件体系结构中适配器端的实现,适配器可由 CPU 控制,甚
至可以直接集成在 CPU 内部。
- I2C 设备驱动:I2C 设备驱动是对 I2C 硬件体系结构中设备端的实现,设备一般挂接在受 CPU 控制
的 I2C 适配器上,通过 I2C 适配器与 CPU 交换数据。
64.1.1 I2C 总线驱动
I2C 总线和 platform 总线差不多,只不过 platform 总线是虚拟出来的一条总线,而 I2C 总线是实际存在的。对于使用 I2C 通信的设备,在驱动中直接使用 I2C 总结即可。I2C 总线驱动的重点是 I2C 适配器驱动,主要涉及到两个结构体:i2c_adapter 和 i2c_algorithm。在 Linux 内核中用 i2c_adapter 结构体来表示 I2C 适配器。i2c_adapter 结构体定义在 include/linux/i2c.h 文件中,结构体内容如下:
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 文件中,部分内容如下:
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 使用静态
总线号。函数参数和返回值含义如下表所示;
函数 | void i2c_del_adapter(struct i2c_adapter * adap) |
adapter或adap | 要添加到 Linux 内核中的 i2c_adapter,也就是 I2C 适配器 |
返回值 | 0,成功;负值,失败 |
功能 | 向系统注册设置好的 i2c_adapter |
如果要删除 I2C 适配器的话使用 i2c_del_adapter 函数即可,函数原型如下:
函数 | void i2c_del_adapter(struct i2c_adapter * adap) |
adap | 要删除的 I2C 适配器 |
返回值 | 无 |
功能 | 删除 I2C 适配器 |
关于 I2C 的总线(控制器或适配器)驱动就讲解到这里,一般 SOC 的 I2C 总线驱动都是由半导体厂商编
写的,比如 I.MX6U 的 I2C 适配器驱动 NXP 已经编写好了,这个不需要用户去编写。因此 我们不用关心
I2C 总线驱动具体是如何实现的,我们只要专注于 I2C 设备驱动即可。
64.1.2 I2C设备驱动
在 I2C 设备驱动中主要有两个重要的结构体:i2c_client 和 i2c_driver。i2c_client 就是描述设备信息的,
i2c_driver 描述驱动内容,类似于 platform_driver。i2c_client 结构体定义在 include/linux/i2c.h 文件中,内容如下:
161 struct i2c_driver {
162 unsigned int class;
163
164 /* Notifies the driver that a new bus has appeared. You should
165 * avoid using this, it will be removed in a near future.
166 */
167 int (*attach_adapter)(struct i2c_adapter *) __deprecated;
168
169 /* Standard driver model interfaces */
170 int (*probe)(struct i2c_client *, const struct i2c_device_id *);
171 int (*remove)(struct i2c_client *);
172
173 /* driver model interfaces that don't relate to enumeration */
174 void (*shutdown)(struct i2c_client *);
175
176 /* Alert callback, for example for the SMBus alert protocol.
177 * The format and meaning of the data value depends on the
178 * protocol.For the SMBus alert protocol, there is a single bit
179 * of data passed as the alert response's low bit ("event
180 flag"). */
181 void (*alert)(struct i2c_client *, unsigned int data);
182
183 /* a ioctl like command that can be used to perform specific
184 * functions with the device.
185 */
186 int (*command)(struct i2c_client *client, unsigned int cmd, void *arg);
187
188 struct device_driver driver;
189 const struct i2c_device_id *id_table;
190
191 /* Device detection callback for automatic device creation */
192 int (*detect)(struct i2c_client *, struct i2c_board_info *);
193 const unsigned short *address_list;
194 struct list_head clients;
195 };
第 170 行,当 I2C 设备和驱动匹配成功以后 probe 函数就会执行,和 platform 驱动一样。
第 188 行,device_driver 驱动结构体,如果使用设备树的话,需要设置 device_driver 的
of_match_table 成员变量,也就是驱动的兼容(compatible)属性。
第 189 行,id_table 是传统的、未使用设备树的设备匹配 ID 表。
在编写 I2C 设备的驱动时,主要就是创建 i2c_driver 结构体,并实现里面的内容。i2c_driver 结构体创建完成后,使用 int i2c_register_driver 函数向 Linux 内核中注册 i2c 设备。函数原型如下:
函数 | int i2c_register_driver(struct module *owner,struct i2c_driver *driver) |
owner | 一般为 THIS_MODULE |
driver | 要注册的 i2c_driver |
返回值 | 0,成功;负值,失败 |
功能 | 向 Linux 内核中注册 i2c 设备 |
另外 i2c_add_driver 也常常用于注册 i2c_driver,i2c_add_driver 是一个宏,定义如下:
587 #define i2c_add_driver(driver) \
588 i2c_register_driver(THIS_MODULE, driver)
可以看出 i2c_add_driver 就是对 i2c_register_driver 做了一个简单的封装,只有一个参数,就是要注册
的 i2c_driver。
在主线 I2C 设备驱动的同时需要将前面注册的 i2c_driver 也从 Linux 内核中注销掉。用 i2c_del_driver 函数,此函数原型如下:
函数 | void i2c_del_driver(struct i2c_driver *driver) |
driver | 要注销的 i2c_driver |
返回值 | 无 |
功能 | 向 Linux 内核中注销i2c 设备 |
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 函数里面基本就是标准的字符设备驱动那一套了。
64.2 3399的I2C节点简析
IMX8MM上I2C可以使用模拟I2C和硬件I2C。我们分别来看下模拟I2C和硬件I2C的设备树配置。
64.2.1 硬件I2C设备树配置
参考文件Documentation/devicetree/bindings/i2c/i2c-rk3x.txt。重点说明其中配置项,i2c-scl-rising-time-ns,i2c-scl-falling-time-ns:
clock-frequency: 默认frequency 为100k 可不配置,其它 I2C 频率需要配置,最大可配置频率由 i2c-sclrising-time-ns 决定;例如配置400k,clock-frequency=<400000>。ROCKCHIP I2C在不同芯片,不同内核版本上的驱动不一样,I2C可以跑的最高频率也有区别。在RK3399上,内核版本为4.4时Max Frequency最大为1000K。
i2c-scl-rising-time-ns:SCL 上升沿时间由硬件决定,改变上拉电阻可调节该时间,需通过示波器量测,参考
上图;例如测得 SCL 上升沿 365ns,i2c-scl-rising-time-ns=<365>。(默认可以不配置,但必须保证当前的上
升沿时间不能超过所配置频率下的 I2C 标准所定义的最大上升沿时间)
i2c-scl-falling-time-ns: SCL 下降沿时间, 一般不变, 等同于 i2c-sda-falling-time-ns。(默认也可以不配置)
&i2c1 {
status = "okay";
i2c‐scl‐rising‐time‐ns = <265>;
i2c‐scl‐falling‐time‐ns = <11>;
clock‐frequency = <400000>;
es8316: es8316@10 {
#sound‐dai‐cells = <0>;
compatible = "everest,es8316";
reg = <0x10>;
clocks = <&cru SCLK_I2S_8CH_OUT>;
clock‐names = "mclk";
spk‐con‐gpio = <&gpio0 11 GPIO_ACTIVE_HIGH>;
hp‐det‐gpio = <&gpio4 28 GPIO_ACTIVE_LOW>;
};
}
};
64.2.2 模拟I2C设备树配置
I2C 用 GPIO 模拟,内核已经有实现,一般不推荐使用 GPIO,效率不高
下面是使用的例子,dts 下配置 I2C 节点。
i2c@4 {
compatible = "i2c‐gpio";
gpios = <&gpio5 9 GPIO_ACTIVE_HIGH>, /* sda */
<&gpio5 8 GPIO_ACTIVE_HIGH>; /* scl */
i2c‐gpio,delay‐us = <2>; /* ~100 kHz */
#address‐cells = <1>;
#size‐cells = <0>;
pinctrl‐names = "default";
pinctrl‐0 = <&i2c4_gpio>;
status = "okay";
gt9xx: gt9xx@14 {
compatible = "goodix,gt9xx";
reg = <0x14>;
touch‐gpio = <&gpio5 11 IRQ_TYPE_LEVEL_LOW>;
reset‐gpio = <&gpio5 10 GPIO_ACTIVE_HIGH>;
max‐x = <1200>;
max‐y = <1900>;
tp‐size = <911>;
tp‐supply = <&vcc_tp>;
status = "okay";
};
};
参考文档: Documentation/devicetree/bindings/i2c/i2c-gpio.txt
64.1.3 I2C 核心
在 I2C 核心层完成的就是 I2C 设备和 I2C 驱动的匹配过程。I2C 核心部分的文件是 drivers/i2c/i2c-core.c,
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 总线完成的,I2C 总线的数据结构为 i2c_bus_type,定义在drivers/i2c/i2c-core.c 文件,i2c_bus_type 内容如下:
struct bus_type i2c_bus_type = {
.name = "i2c",
.match = i2c_device_match,
.probe = i2c_device_probe,
.remove = i2c_device_remove,
.shutdown = i2c_device_shutdown,
};
match 成员变量就是 I2C 总线上设备和驱动匹配函数,也就是 i2c_device_match 这个函数,此函数内容如下:
457 static int i2c_device_match(struct device *dev, struct device_driver *drv)
458 {
459 struct i2c_client *client = i2c_verify_client(dev);
460 struct i2c_driver *driver;
461
462 if (!client)
463 return 0;
464
465 /* Attempt an OF style match */
466 if (of_driver_match_device(dev, drv))
467 return 1;
468
469 /* Then ACPI style match */
470 if (acpi_driver_match_device(dev, drv))
471 return 1;
472
473 driver = to_i2c_driver(drv);
474 /* match on an id table if there is one */
475 if (driver->id_table)
476 return i2c_match_id(driver->id_table, client) != NULL;
477
478 return 0;
479 }
第 466 行,of_driver_match_device 函数用于完成设备树设备和驱动匹配。比较 I2C 设备节点的compatible 属性和 of_device_id 中的 compatible 属性是否相等,如果相当的话就表示 I2C 设备和驱动匹配。
第 470 行,acpi_driver_match_device 函数用于 ACPI 形式的匹配。
第 476 行,i2c_match_id 函数用于传统的、无设备树的 I2C 设备和驱动匹配过程。比较 I2C 设备名字和 i2c_device_id 的 name 字段是否相等,相等的话就说明 I2C 设备和驱动匹配。
64.3 I2C 设备驱动编写流程
I2C 总线驱动一般是不用用户自己编写的,而 I2C 设备驱动则需要用户自己编写。每个设备的驱动都不相同,但是编写流程是一样的。下面就来具体分析一下。
64.3.1 设备信息描述
1 、不使用设备树文件
当开始编写 I2C 设备驱动时,首先要添加设备信息。先来看一下在不使用设备树,使用平台文件时,
如何在平台文件中添加 I2C 设备信息。
在平台文件中通过 i2c_board_info 结构体来描述一个具体的 I2C 设备。i2c_board_info 结构体如下:
295 struct i2c_board_info {
296 char type[I2C_NAME_SIZE]; /* I2C 设备名字 */
297 unsigned short flags; /* 标志 */
298 unsigned short addr; /* I2C 器件地址 */
299 void *platform_data;
300 struct dev_archdata *archdata;
301 struct device_node *of_node;
302 struct fwnode_handle *fwnode;
303 int irq;
304 };
其中 type 和 addr 这两个成员变量是必须要设置的,一个是 I2C 设备的名字,一个是 I2C 设备的器
件地址。打开 arch/arm/mach-imx/mach-mx27_3ds.c 文件,此文件中关于 OV2640 的 I2C 设备信息描述如下:
392 static struct i2c_board_info mx27_3ds_i2c_camera = {
393 I2C_BOARD_INFO("ov2640", 0x30),
394 };
I2C_BOARD_INFO 来完成 mx27_3ds_i2c_camera 的初始化工作,I2C_BOARD_INFO 是一个宏,定义如下:
316 #define I2C_BOARD_INFO(dev_type, dev_addr) \
317 .type = dev_type, .addr = (dev_addr)
可以看出,I2C_BOARD_INFO 宏其实就是设置 i2c_board_info 的 type 和 addr 这两个成员变量。可以
在平台文件中找到许多类似的 I2C 设备,在平台文件中不仅有 I2C 设备,还有其他许多不同类型的设备,而且设备越多,越显得平台文件非常混乱,所以就产生了设备树文件。
2 、使用设备树文件
在使用设备树文件时,只需要在设备树文件中添加相应的I2C设备节点就可以了,比如开发板在 I2C1 上接了 es8316这个磁力计芯片,因此必须在 i2c1 节点下创建 es8316子节点,然后
在这个子节点内描述 es8316这个芯片的相关信息。打开itop-3399_linux-lvds.dts这个设备树文件,然后找到如下内容:
1 &i2c1 {
status = "okay";
i2c-scl-rising-time-ns = <140>;
i2c-scl-falling-time-ns = <30>;
#if 0
es8316: es8316@11 {
#sound-dai-cells = <0>;
compatible = "everest,es8316";
reg = <0x11>;
clocks = <&cru SCLK_I2S_8CH_OUT>;
clock-names = "mclk";
pinctrl-names = "default";
pinctrl-0 = <&i2s_8ch_mclk>;
spk-con-gpio = <&gpio0 RK_PB3 GPIO_ACTIVE_HIGH>;
};
- 第 7~11 行,向 i2c1 添加 es8316子节点,第 7 行“es8316@11”是子节点名字,“@”后面的
“11”就是 es8316的 I2C 器件地址。第 8 行设置 compatible 属性值为“everest,es8316”。第 9 行的 reg属性也是设置 es8316的器件地址的,因此值为 0x11。I2C 设备节点的创建重点是 compatible 属性和 reg属性的设置,一个用于匹配驱动,一个用于设置器件地址。
64.3.2 I2C设备的数据收发和处理
在 I2C 设备驱动中首先要完成 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) |
adap | 所使用的 I2C 适配器,i2c_client 会保存其对应的 i2c_adapter。 |
msgs | I2C 要发送的一个或多个消息 |
num | 消息数量,也就是 msgs 的数量 |
返回值 | 负值,失败,其他非负值,发送的 msgs 数量 |
我们重点来看一下 msgs 这个参数,这是一个 i2c_msg 类型的指针参数,I2C 进行数据收发说白了就
是消息的传递,Linux内核使用i2c_msg 结构体来描述一个消息。i2c_msg 结构体定义在include/uapi/linux/i2c.h 文件中,结构体内容如下:
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 数据收发的示例代码如下:
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 数据接收函数为 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 位)类型的数据。 |
返回值 | 负值,失败,其他非负值,发送的字节数。 |
I2C 数据接收函数为 i2c_master_recv,函数原型如下:
关于 Linux 下 I2C 设备驱动的编写流程就讲解到这里,重点就是 i2c_msg 的构建和i2c_transfer 函数的调用,接下来我们就编写 AP3216C 这个 I2C 设备的 Linux 驱动。