利用linux中iic子系统做IIC驱动

利用linux中IIC设备子系统移植IIC设备驱动

1. 背景描述

IIC总线在嵌入式系统中应用十分广泛，常见的有eeprom，rtc。一般的处理器会包含IIC的控制器，用来完成IIC时序的控制；另外一方面，由于IIC的时序简单，使用GPIO口来模拟时序也是常见的做法。面对不同的IIC控制器，各种各样的芯片以及linux源码，如何更快做好IIC设备驱动。

2. 问题描述

在我们的方案中，我们会用到eeprom，rtc以及tw2865。由于Hi3520的IIC控制器设计有问题，无法正常使用。而IIC控制器的SDA和SCL管脚正好是和两个GPIO管脚复用的。Hisi将控制gpio来实现IIC的时序，从而对IIC设备进行操作。这种设计方式简单明了，但使用IIC子系统，可以更方便的移植和维护其他的设备驱动。

3. 问题分析

Hisi对于gpio口，rtc芯片以及tw2865的处理方式如下：将gpio口做成一个模块化的驱动，该驱动模拟IIC时序，并向外提供一些函数接口，比如：EXPORT_SYMBOL(gpio_i2c_read_tw2815);等。对于具体的rtc芯片，将其注册为一个misc设备，并利用gpio模块导出的函数进行rtc芯片的配置操作。

其实对于linux-2.6.24\drivers\i2c目录下代码，我们可以加以利用。

Linux的IIC字结构分为三个组成部分：

IIC核心

IIC核心提供了IIC总线驱动和设备驱动的注册、注销方法，IICalgorithm上层的、与具体适配器无关的代码以及探测设备、检测设备地址的上层代码。

IIC总线驱动

IIC总线驱动是对IIC硬件体系结构中适配器端的实现。

IIC设备驱动

IIC设备驱动是对IIC硬件体系总设备端的实现。

我们查看下该目录下的makefile和kconfig：

obj-$(CONFIG_I2C_BOARDINFO) +=i2c-boardinfo.o

obj-$(CONFIG_I2C) += i2c-core.o

obj-$(CONFIG_I2C_CHARDEV) +=i2c-dev.o

obj-y +=busses/ chips/ algos/

i2c-core.c就是IIC核心，buses中的文件是主流处理器中IIC总线的总线驱动，而chips中的文件就是常用芯片的驱动，algos中的文件实现了一些总线适配器的algorithm，其中就包括我们要用到的i2c-algo-bit.c文件。

我们首先利用i2c-gpio.c和i2c-algo-bit.c做好总线驱动。

在i2c-gpio.c中，module_initi2c_gpio_initplatform_driver_probe(&i2c_gpio_driver,i2c_gpio_probe);

将其注册为platform虚拟总线的驱动。

在staticint __init i2c_gpio_probe(struct platform_device *pdev)中，

定义了如下三个结构体：

structi2c_gpio_platform_data *pdata;//平台相关的gpio的设置

structi2c_algo_bit_data *bit_data;//包含algorithm的具体函数，setor get SDA和SCL

structi2c_adapter *adap;//适配器

i2c_gpio_probe主要做了下面几件事：

填充bit_data结构的各个函数指针，关联到具体的操作SDA和SCl函数。

填充adap结构，adap->algo_data= bit_data;

pdata= pdev->dev.platform_data;

bit_data->data= pdata;

pdev->dev->driver_data= adap;

在i2c-core中注册适配器类型。

inti2c_bit_add_numbered_bus(struct i2c_adapter *adap)

在staticint i2c_bit_prepare_bus(struct i2c_adapter *adap)中

adap->algo= &i2c_bit_algo;

将i2c_bit_algo与adap关联上。

static const structi2c_algorithm i2c_bit_algo = {

.master_xfer = bit_xfer,

.functionality = bit_func,

};

其中，master_xfer函数指针就是IIC传输函数指针。

I2c-algo-bit.c还实现了IIC开始条件，结束条件的模拟，发送字节，接收字节以及应答位的处理。

i2c-gpio.c中的i2c_gpio_setsda_val等函数是与具体平台gpio相关的。

修改对应arch-hi3520v100目录下的gpio.h中的各个函数，这些函数是通过操作寄存器来控制gpio的方向和值。

在对应mach-hi3520v100中的platform-devices.c中添加如下：

static structi2c_gpio_platform_data pdata = {

.sda_pin = 1<<0,

.sda_is_open_drain = 1,

.scl_pin = 1<<1,

.scl_is_open_drain = 1,

.udelay = 4, /* ~100 kHz */

};

static struct platform_devicehisilicon_i2c_gpio_device = {

.name = "i2c-gpio",

.id = -1,

.dev.platform_data = &pdata,

};

static struct platform_device*hisilicon_plat_devs[] __initdata = {

&hisilicon_i2c_gpio_device,

};

int __inithisilicon_register_platform_devices(void)

{

platform_add_devices(hisilicon_plat_devs,ARRAY_SIZE (hisilicon_plat_devs));

return 0;

}

通过platform添加devices和driver，使得pdev->dev.platform_data=pdata

综合上面的过程，我们完成了adapter的注册，并将用gpio口模拟的algorithm与adapter完成了关联。

这样，在rtc-x1205.c中，x1205_attach函数利用i2c核心完成client和adap的关联。

在x1205_probe函数中填充i2c_client结构体，并调用i2c_attach_client通知iic核心。

接着注册rtc驱动。

最后我们要读取时间，就需要构造i2c_msg结构体，如下所示：

struct i2c_msg msgs[] = {

{ client->addr, 0, 2,dt_addr }, /* setup read ptr */

{ client->addr, I2C_M_RD,8, buf }, /* read date */

};

/* read date registers */

if((i2c_transfer(client->adapter, &msgs[0], 2)) != 2) {

dev_err(&client->dev,"%s: read error\n", __FUNCTION__);

return -EIO;

}

dt_addr是寄存器的地址，I2C_M_RD表示iicread。

4. 经验总结

IIC总线虽然并不复杂，但linux下的IIC子系统却有相当的复杂度。做了很多的抽象工作，代码变得得难理解，但为后续移植驱动工作提供了很多便利条件。在调试gpio的adap时，最关键的是对于busdevice driver设备模型的理解。对sysfs和proc文件系统很熟悉的话，在调试驱动和后期维护方面大有益处。