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");
原文地址:https://www.cnblogs.com/jasontian996/p/11569067.html