Linux驱动之I2C创建实例

在上一节中，简单的介绍了Linux-3.4内核中的i2c驱动框架，那么，接下来，就来实际的创建i2c的驱动实例，加深对Linux内核中的i2c驱动的理解

1、方法一

第一中方法其实就是上节内容中所说的方法，现在来简单回顾一下，上节的内容最后的出来的结论是

• 在系统开始运行之后，和架构相关的mach-xxxx.c文件先运行起来，这个文件中定义有i2c_board_info相关的结构体，结构体包含i2c设备的名字和地址，然后调用i2c_register_board_info 注册i2c_board_info结构体，这个函数会把i2c_board_info结构体链接进内核的  __i2c_board_list链表中
• 然后是单板i2c驱动相关的文件i2c-xxx.c运行起来，这个文件中会调用i2c_add_numbered_adapter -> i2c_register_adapter  在这个函数里会调用i2c_scan_static_board_info 函数，它会遍历内核__i2c_board_list 链表，如果某个i2c_board_info可以和在这个文件里构建的adapter  匹配上（通过adapter->nr）,就调用i2c_new_device  传入i2c_adapter和i2c_board_info结构体(具备数据发送和接收的函数和设备的地址)构建i2c_client结构体并连接进内核的链表中去
• 生成了i2c_client结构体之后，就可以使用i2c_client结构体去操作设备

所以，根据这种机制，我们就可以添加我们自己的i2c程序在内核里，这就是第一中方法

1. 在与架构对应的mach-xxx.c文件里添加i2c设备的i2c_board_info结构体，设置“名字”和“设备地址” ，这个结构体会在内核运行之后加载进内核链表里
2. 然后在i2c目录下的和单板对应的i2c-xxx.c文件里去设置、注册i2c_adapter,在注册i2c_adapter的时候就会遍历内核i2c_board_info链表，如果成功匹配，就会根据这两个结构体生成i2c_client，就可以使用了

缺点： 第一种方法具备明显的不足，就是需要把程序直接编译进内核里，每一次的改动就需要去更新内核，显然不具备灵活性

 

2、方法二

上面的方法最后其实调的是i2c_new_device,使用i2c_adapter和i2c_board_info结构体生成i2c_client,所以，我们可以跳过前面的那些步骤，直接使用i2c_new_device来构造i2c_client就行了,如下

//i2c_board_info结构体包含设备信息
static struct i2c_board_info at24cxx_info = {	
	I2C_BOARD_INFO("at24c08", 0x50),
};

//这个函数需要i2c_adapter结构体，
//使用i2c_get_adapter函数获取系统i2c_adapter
static int at24cxx_dev_init(void)
{
	struct i2c_adapter *i2c_adap;

	i2c_adap = i2c_get_adapter(0);
        //直接生成i2c_client结构体
	at24cxx_client = i2c_new_device(i2c_adap, &at24cxx_info);
	i2c_put_adapter(i2c_adap);
	
	return 0;
}

module_init(at24cxx_dev_init);

那么，这个i2c_client何时使用？或者怎么使用呢？这就要用到i2c_driver了，在2.6内核注册i2c的时候，它是通过注册i2c_driver，然后去遍历内核i2c_adapter链表，把有回应的设备生成i2c_client,那么，3.4内核中的注册i2c_driver是不是一样呢，来看一看

使用i2c_add_driver函数注册i2c_driver结构体，调用i2c_register_driver

在该函数里，调用driver_register函数把i2c_driver放入内核的drv链表，对于每一个适配器，调用__process_new_driver

再去调用i2c_do_add_adapter -> i2c_detect , 在i2c_detect会遍历注册的i2c_driver中的addr_list，通过调用i2c_detect_address来判断这个地址是否存在，如下

i2c_detect_address ->  i2c_default_probe

i2c_default_probe:判断这个设备是否存在：简单的发出S信号确定有ACK

需要注意的是，检测到设备存在就返回，然后调用driver->detect函数再次确认是我们想要操作的设备，因为有的设备仅仅通过地址无法确定

最后还是调用到了i2c_new_device,到这里就结束了，成功识别到设备之后调用i2c_driver结构体中的回调函数probe,下面是注册i2c_driver的简单代码

//地址列表
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);
}

/* ####################### 为了层次结构，把代码写到后面 ####################### */
//这个函数可不写
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;
}

//回调函数，保存识别成功之后的i2c_client，至于做什么事情由自己决定
//这里去注册字符设备驱动，然后通过i2c_client提供读写函数
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 struct file_operations at24cxx_fops = {
	.owner = THIS_MODULE,
	.read  = at24cxx_read,
	.write = at24cxx_write,
};

/* 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;	
}

/* 传入: 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;
}

简单的驱动程序框架到这里基本上就完成了

3、方法三 

不自己写i2c驱动程序，使用i2c工具i2c-tools-3.1.0.tar.bz2，这个工具其实也只是应用程序，它会调用内核中的i2c驱动，对应的文件是dricer/i2c/i2c-dev.c,简单看一下这个驱动程序

驱动程序的入口函数注册了字符设备驱动，为上层应用提供操作接口，

字符驱动程序open函数，在应用程序打开设备的时候，会根据打开的设备的此设备号，从内核里获取对应的i2c_adapter,然后设置i2c_client,将i2c_client保存至文件的私有数据

read函数调用i2c_master_recv,然后调用i2c_transfer传输数据，write函数也是一样，调用i2c_master_send -> i2c_transfer

如果想使用其他的接口，在ioctl函数中定义，

常用的是i2cdev_ioctl_smbus，总之，在这个文件中已经把i2c的驱动已经写好了，我们只需要在上层调用即可，现在就来使用

i2c-tool进行测试，工具里定义的函数都在 include/i2c-dev.h中实现，包含即可

#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_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-dev.c这个驱动程序文件，必须把它编译进内核里

依赖CONFIG_I2C_CHARDEV这个宏，make menuconfig搜索

配置、编译内核，就可以使用测试程序进行测试了