I2C总线设备驱动
Posted jasontian996
tags:
篇首语：本文由小常识网(cha138.com)小编为大家整理，主要介绍了I2C总线设备驱动相关的知识，希望对你有一定的参考价值。
I2C总线、设备、驱动
框架
I2C驱动框架可分为3个部分，分别是：I2C核心层、I2C总线驱动层(适配器层)以及I2C设备驱动层；
I2C核心层
提供了统一的I2C操作函数，主要有两套函数smbus(system manager bus)和i2c_transfer；
其中smbus是i2c_transfer的一小部分，有一些适配器只支持smbus，当驱动中只是用部分I2C协议功能时可使用smbus，具体使用可参考内核源码目录下：kernel/Documentation/i2c/smbus-protocol文档；
在进行I2C设备的读写操作时，smbus提供了一系列的接口函数，可直接调用，而i2c_transfer需要构建i2c_msg，之后调用i2c_transfer函数进行操作；
I2C总线驱动层(适配器层)
是对I2C硬件结构中(即主控芯片中I2C控制器)适配器的实现，主要包括I2C适配器数据结构i2c_adapter、I2C适配器的algorithm数据结构i2c_algorithm以及控制I2C适配器产生通信信号的函数；
I2C设备驱动层
主要指的是对从设备硬件体系设备端的实现，设备一般挂接在受CPU控制的I2C适配器上，驱动部分主要包括了数据结构i2c_driver和i2c_client；
对于I2C设备驱动，在内核中有个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,
.pm = &i2c_device_pm_ops,
;在I2C总线中有两个链表，这两个链表分别存储着不同的“i2c_client”和“i2c_driver”；
当注册一个i2c_client时，会从i2c_driver所在的链表中将i2c-driver挨个取出与i2c_client进行比对，如果匹配，就调用对应i2c_driver中的probe函数(probe函数内部做什么事情自己随意定)；
当注册一个i2c_driver时，会从i2c_client所在的链表中将i2c_client挨个取出与i2c_driver进行比对，如果匹配，就调用对应i2c_driver中的probe函数(probe函数内部做什么事情自己随意定);
i2c_client和i2c_driver的进行匹配判断时调用的函数时i2c_bus_type中的.match，匹配判断的规则是driver->id_table中的名字与client的名字是否相同，代码如下：
if (driver->id_table)
return i2c_match_id(driver->id_table, client) != NULL;
/* i2c_match_id函数如下 */
static const struct i2c_device_id *i2c_match_id(const struct i2c_device_id *id,
const struct i2c_client *client)
while (id->name[0])
if (strcmp(client->name, id->name) == 0) /* 比对的关键所在name */
return id;
id++;
return NULL;
构建一个I2C设备
总共有四种方式，可参考文档：linux源码目录下/Documentation/i2c/instantiating-devices；
第一种方法
定义一个i2c_board_info结构体，例如：
static struct i2c_board_info i2c_devs[] __initdata = I2C_BOARD_INFO("xxx", (0x74>>1)), .platform_data = &xxx_pdata, , ;里面还有名字，设备地址；
然后调用函数i2c_register_board_info()注册这个结构体，之后的函数调用处理如下：
i2c_register_board_info /* 会在函数内部分配一个devinfo，然后根据i2c_register_board_info传入的参数 * 来设置devinfo，最终添加到__i2c_board_list链表中 */ list_add_tail(&devinfo->list, &__i2c_board_list);搜索__i2c_board_list这个链表在什么地方用，发现是i2c_scan_static_board_info函数在调用，内部处理如下：
/* 在函数i2c_scan_static_board_info中使用链表 * 对链表中的每一个成员都调用i2c_new_device() */ list_for_each_entry(devinfo, &__i2c_board_list, list) if (devinfo->busnum == adapter->nr && !i2c_new_device(adapter, &devinfo->board_info))其中调用的i2c_new_device()函数的作用是：根据i2c_board_info信息构造一个client，然后调用device_register()进行注册；
那么，i2c_scan_static_board_info()函数是谁在调用？
是i2c_register_adapter()函数在调用；
总结：
函数调用依次是：i2c_register_adapter() -> i2c_scan_static_board_info() -> i2c_new_device()；
当调用i2c_register_adapter()时，就会扫描挂在__i2c_board_list这个链表上的每个成员，并调用i2c_new_device()构造client，最终添加到i2c总线对应的设备链表中，并将i2c_driver中的每一项取出来比对，匹配上之后就调用i2c_driver中的probe函数；
使用限制：
必须在i2c_register_adapter之前就i2c_register_board_info()已经构造了i2c_board_info，所以不适合动态加载insmod；
第二种方法
直接使用i2c_new_device()或者i2c_new_probed_device()；
区别：
i2c_new_device()不管设备地址对还是不对，都认为设备肯定存在；
参考代码如下：
/* at24cxx_dev.c 使用i2c_new_device */ #include <linux/kernel.h> #include <linux/module.h> #include <linux/platform_device.h> #include <linux/i2c.h> #include <linux/err.h> #include <linux/regmap.h> #include <linux/slab.h> static struct i2c_board_info at24cxx_info = I2C_BOARD_INFO("at24c08", 0x50), ; static struct i2c_client *at24cxx_client; static int at24cxx_dev_init(void) struct i2c_adapter *i2c_adap; i2c_adap = i2c_get_adapter(0); at24cxx_client = i2c_new_device(i2c_adap, &at24cxx_info); i2c_put_adapter(i2c_adap); return 0; static void at24cxx_dev_exit(void) i2c_unregister_device(at24cxx_client); module_init(at24cxx_dev_init); module_exit(at24cxx_dev_exit); MODULE_LICENSE("GPL");i2c_new_probed_device()先通过传入的或者默认的probe函数发送一个数据看设备有没有回应，来确认设备是否真实存在，之后才会调用i2c_new_device()；
/* at24cxx_dev.c 使用i2c_new_probed_device */ #include <linux/kernel.h> #include <linux/module.h> #include <linux/platform_device.h> #include <linux/i2c.h> #include <linux/err.h> #include <linux/regmap.h> #include <linux/slab.h> static struct i2c_client *at24cxx_client; static const unsigned short addr_list[] = 0x60, 0x50, I2C_CLIENT_END ; static int at24cxx_dev_init(void) struct i2c_adapter *i2c_adap; struct i2c_board_info at24cxx_info; memset(&at24cxx_info, 0, sizeof(struct i2c_board_info)); strlcpy(at24cxx_info.type, "at24c08", I2C_NAME_SIZE); i2c_adap = i2c_get_adapter(0); at24cxx_client = i2c_new_probed_device(i2c_adap, &at24cxx_info, addr_list, NULL); i2c_put_adapter(i2c_adap); if (at24cxx_client) return 0; else return -ENODEV; static void at24cxx_dev_exit(void) i2c_unregister_device(at24cxx_client); module_init(at24cxx_dev_init); module_exit(at24cxx_dev_exit); MODULE_LICENSE("GPL");第三种方法
从用户空间创建设备；
创建设备：echo eeprom 0x50 > /sys/bus/i2c/devices/i2c-3/new_device
其中“eeprom ”为设备名字，“0x50 ”为设备地址，最终会构造一个i2c_board_info，再调用i2c_new_device()；
删除设备：echo 0x50 > /sys/bus/i2c/devices/i2c-3/delete_device
可参考内核源码目录下kernel/Documentation/i2c/dev-interface文档；
通常，i2c设备由内核驱动程序控制，但它也是可以从用户空间访问适配器上的所有设备，通过/dev接口，这需要i2c-tools这个包的支持；
注意：如果内核中已经有了(安装了)该设备的驱动程序，那么这种方法就不能使用了(在使用i2cdev_ioctl接口时，内部会调用i2cdev_check_addr()进行校验，如果这个设备地址已经有驱动绑定了，就会返回-EBUSY)；
具体参考代码如下：
#include <stdio.h> #include <stdlib.h> #include <string.h> #include <sys/types.h> #include <sys/stat.h> #include <fcntl.h> #include "i2c-dev.h" /* 需要该文件支持，文件来自i2c-tools包，可网上下载 */ /* i2c_usr_test </dev/i2c-0> <dev_addr> r addr * i2c_usr_test </dev/i2c-0> <dev_addr> w addr val */ void print_usage(char *file) printf("%s </dev/i2c-0> <dev_addr> r addr\n", file); printf("%s </dev/i2c-0> <dev_addr> w addr val\n", file); int main(int argc, char **argv) int fd; unsigned char addr, data; int dev_addr; if ((argc != 5) && (argc != 6)) print_usage(argv[0]); return -1; fd = open(argv[1], O_RDWR); if (fd < 0) printf("can't open %s\n", argv[1]); return -1; dev_addr = strtoul(argv[2], NULL, 0); if (ioctl(fd, I2C_SLAVE, dev_addr) < 0) /* ERROR HANDLING; you can check errno to see what went wrong */ printf("set addr error!\n"); return -1; if (strcmp(argv[3], "r") == 0) addr = strtoul(argv[4], NULL, 0); data = i2c_smbus_read_word_data(fd, addr); printf("data: %c, %d, 0x%2x\n", data, data, data); else if ((strcmp(argv[3], "w") == 0) && (argc == 6)) addr = strtoul(argv[4], NULL, 0); data = strtoul(argv[5], NULL, 0); i2c_smbus_write_byte_data(fd, addr, data); else print_usage(argv[0]); return -1; return 0;第四种方法
前面三种方法都要事先确定好适配器(I2C控制器)，同时也推荐使用前三种方法；
第四种方法的参考代码如下：
/* at24cxx_drv.c */ #include <linux/kernel.h> #include <linux/module.h> #include <linux/platform_device.h> #include <linux/i2c.h> #include <linux/err.h> #include <linux/regmap.h> #include <linux/slab.h> static int __devinit at24cxx_probe(struct i2c_client *client, const struct i2c_device_id *id) printk("%s %s %d\n", __FILE__, __FUNCTION__, __LINE__); return 0; static int __devexit at24cxx_remove(struct i2c_client *client) printk("%s %s %d\n", __FILE__, __FUNCTION__, __LINE__); return 0; static const struct i2c_device_id at24cxx_id_table[] = "at24c08", 0 , ; static int at24cxx_detect(struct i2c_client *client, struct i2c_board_info *info) /* 能运行到这里, 表示该addr的设备是存在的 * 但是有些设备单凭地址无法分辨(A芯片的地址是0x50, B芯片的地址也是0x50) * 还需要进一步读写I2C设备来分辨是哪款芯片 * detect就是用来进一步分辨这个芯片是哪一款，并且设置info->type */ printk("at24cxx_detect : addr = 0x%x\n", client->addr); /* 进一步判断是哪一款 */ strlcpy(info->type, "at24c08", I2C_NAME_SIZE); return 0; static const unsigned short addr_list[] = 0x60, 0x50, I2C_CLIENT_END ; /* 1. 分配/设置i2c_driver */ static struct i2c_driver at24cxx_driver = .class = I2C_CLASS_HWMON, /* 表示去哪些适配器上找设备 */ .driver = .name = "100ask", .owner = THIS_MODULE, , .probe = at24cxx_probe, .remove = __devexit_p(at24cxx_remove), .id_table = at24cxx_id_table, .detect = at24cxx_detect, /* 用这个函数来检测设备确实存在 */ .address_list = addr_list, /* 这些设备的地址 */ ; static int at24cxx_drv_init(void) /* 2. 注册i2c_driver */ i2c_add_driver(&at24cxx_driver); return 0; static void at24cxx_drv_exit(void) i2c_del_driver(&at24cxx_driver); module_init(at24cxx_drv_init); module_exit(at24cxx_drv_exit); MODULE_LICENSE("GPL");
注册I2C驱动
参考代码如下：
/* at24cxx_drv.c */
#include <linux/kernel.h>
#include <linux/module.h>
#include <linux/platform_device.h>
#include <linux/i2c.h>
#include <linux/err.h>
#include <linux/regmap.h>
#include <linux/slab.h>
#include <linux/fs.h>
#include <asm/uaccess.h>
static int major;
static struct class *class;
static struct i2c_client *at24cxx_client;
/* 传入: buf[0] : addr
* 输出: buf[0] : data
*/
static ssize_t at24cxx_read(struct file * file, char __user *buf, size_t count, loff_t *off)
unsigned char addr, data;
copy_from_user(&addr, buf, 1);
data = i2c_smbus_read_byte_data(at24cxx_client, addr);
copy_to_user(buf, &data, 1);
return 1;
/* buf[0] : addr
* buf[1] : data
*/
static ssize_t at24cxx_write(struct file *file, const char __user *buf, size_t count, loff_t *off)
unsigned char ker_buf[2];
unsigned char addr, data;
copy_from_user(ker_buf, buf, 2);
addr = ker_buf[0];
data = ker_buf[1];
printk("addr = 0x%02x, data = 0x%02x\n", addr, data);
if (!i2c_smbus_write_byte_data(at24cxx_client, addr, data))
return 2;
else
return -EIO;
static struct file_operations at24cxx_fops =
.owner = THIS_MODULE,
.read = at24cxx_read,
.write = at24cxx_write,
;
static int __devinit at24cxx_probe(struct i2c_client *client,
const struct i2c_device_id *id)
at24cxx_client = client;
//printk("%s %s %d\n", __FILE__, __FUNCTION__, __LINE__);
major = register_chrdev(0, "at24cxx", &at24cxx_fops);
class = class_create(THIS_MODULE, "at24cxx");
device_create(class, NULL, MKDEV(major, 0), NULL, "at24cxx"); /* /dev/at24cxx */
return 0;
static int __devexit at24cxx_remove(struct i2c_client *client)
//printk("%s %s %d\n", __FILE__, __FUNCTION__, __LINE__);
device_destroy(class, MKDEV(major, 0));
class_destroy(class);
unregister_chrdev(major, "at24cxx");
return 0;
static const struct i2c_device_id at24cxx_id_table[] =
"at24c08", 0 ,
;
/* 1. 分配/设置i2c_driver */
static struct i2c_driver at24cxx_driver =
.driver =
.name = "100ask",
.owner = THIS_MODULE,
,
.probe = at24cxx_probe,
.remove = __devexit_p(at24cxx_remove),
.id_table = at24cxx_id_table,
;
static int at24cxx_drv_init(void)
/* 2. 注册i2c_driver */
i2c_add_driver(&at24cxx_driver);
return 0;
static void at24cxx_drv_exit(void)
i2c_del_driver(&at24cxx_driver);
module_init(at24cxx_drv_init);
module_exit(at24cxx_drv_exit);
MODULE_LICENSE("GPL");以上是关于I2C总线设备驱动的主要内容，如果未能解决你的问题，请参考以下文章