RK28-Linux I2C使用说明
目 录
一、 版本号和版本说明
本文给出了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 空间、硬件资源使用情况、调用系统函数和驱动软件的接口情况。
六、 目录和文件说明
说明模块内部各个目录和文件的功能
七、 接口函数说明和注意事项
说明接口函数的调用方式和注意事项
八、 遗留问题
描述设计中的遗留问题