RK28-Linux I2C使用说明

RK28-Linux I2C使用说明

目 录

一、 版本号和版本说明... 2

二、 模块功能描述... 2

三、 模块软件设计思路... 2

四、 模块主体流程... 2

五、 系统资源占用情况... 2

六、 目录和文件说明... 2

七、 接口函数说明和注意事项... 2

八、 遗留问题... 2

一、 版本号和版本说明

本文给出了linux下I2C驱动的调用使用方法

二、 模块功能描述

I2C总线的驱动在linux上分多层，程序和数据结构较为复杂，这里不作介绍，只介绍在I2C总线上挂载设备驱动的基本方法，便于使用。

1、 添加设备描述符

将您的I2C设备信息描述统一添加在board-rk28.c文件的board_i2c_devices结构中。必要的包括驱动名，所属类等。驱动名的字符串要和驱动中的名称对应。

2、添加驱动

以I2C设备asb100为例如下图，使用i2c_add_driver函数将一个设备驱动搭载到I2C总线上，并定义改模块的初始化信息等：

3、驱动描述

其中的asb100_driver即是注册的I2C总线设备上的一个设备驱动描述，其初始化为如下，启动的DR驱动名.name应和签名前面注册的设备驱动名一致，其中attach函数和detach函数是探测和移除设备的函数，用户可注册该函数并在其中进行设备的探测，初始化和私有数据的初始化。

4、设备探测

attach_adapter函数参考下列写法，其中addr_data中是包含了normal_i2c的设备地址，其地址通常是8位地址经过右移1位的7位地址，i2c_probe的第三个函数是模块的私有探测函数，可在该函数中初始化私有的client数据等。

5、设备的client初始化

在设置client数据时，有三个成员需要注意，如下图

分别是地址段，访问模式和通道，其中地址位段有四种如下：

I2C_7BIT_ADDRESS_8BIT_REG —— 7位地址8位数据

I2C_10BIT_ADDRESS_16BIT_REG, —— 10位地址16位数据

I2C_10BIT_ADDRESS_8BIT_REG, —— 10位地址8位数据

I2C_7BIT_ADDRESS_16BIT_REG —— 7位地址16位数据

访问模式有三种：nomal,direct,register

通道有两种：0和1。

如果未设置这三个参数，则默认为Normal模式7位地址8位数据访问0通道。

i2c_set_clientdata函数是将设备驱动的私有数据连接到设备client中。

6、读写访问函数

完成以上初始化，即可对注册的I2C设备进行读写，一个一般的读写函数写法如下图，其中client位设备对应的I2C client，reg为寄存器地址，buf为读写到的数据指针，len为字节数。

除了使用i2c_transfer函数进行读写封装操作外，也可以使用i2c_master_recv，i2c_master_send等进行收发，需要注意的是，当数据为16bit时，不要使用smbus系列接口进行读写，也使用以上提供的方法进行读写，只是读写的数据分为高低字节进行。

有了以上接口，基本上一般的设备即可使用，限于作者水平有限，如有错误和纰漏望指正，后续进行升级优化。

三、 模块软件设计思路

描述模块软件的设计思路

四、 模块主体流程

用流程图画出模块内部主体流程

五、 系统资源占用情况

描述模块使用的 堆/栈 使用情况和RO/RW/ZI 空间、硬件资源使用情况、调用系统函数和驱动软件的接口情况。

六、 目录和文件说明

说明模块内部各个目录和文件的功能

七、 接口函数说明和注意事项

说明接口函数的调用方式和注意事项

八、 遗留问题

描述设计中的遗留问题