Linux驱动开发之IIC驱动实验【完整教程】

拼个世界给自己

已于 2022-03-29 16:31:41 修改

阅读量6.6k

点赞数 27

分类专栏： Linux 驱动开发文章标签： vscode linux 驱动开发

于 2022-03-29 16:19:28 首次发布

本文链接：https://blog.csdn.net/weixin_57037095/article/details/123801283

版权

本实验基于正点原子ALPHT开发板上的AP3216C作为实验开展对象

基础知识
1.IIC总线驱动
IIC总线驱动是对IIC硬件体系结构中适配器端的实现，适配器可由CPU控制，甚至可以直接集成在CPU内部。IIC适配器在内核中使用了i2c_adapter结构体，IIC适配器核心就是申请一个i2c_adapter结构体，然后设置 i2c_algorithm 中的 master_xfer 函数。
（1）i2c_adapter和 i2c_algorithm
i2c_adapter对应物理上的一个适配器，而 i2c_algorithm对应一套通信方法。它们两个缺少哪一个都是什么都做不了。

2.IIC设备驱动
IIC设备驱动是对IIC硬件体系结构中设备端的实现，设备一般挂载在受CPU控制的IIC适配器上，通过IIC适配器与CPU交换数据。IIC设备驱动重点关注两个数据结构：i2c_client和i2c_driver。注意，i2c_client是不需要我们编写的，但是i2c_driver是重点，是需要我们去编写的，i2c_driver类似platform平台，也存在probe函数。
i2c_client和i2c_driver定义如下：
（1）i2c_client和i2c_driver
i2c_driver对应一套驱动方法，主要成员有probe、remove、suspend等；而i2c_client的信息通常在BSP的文件中通过i2c_board_info填充。

struct i2c_client {
   
	unsigned short flags; /* 标志 */
	unsigned short addr; /* 芯片地址， 7 位，存在低 7 位*/
	char name[I2C_NAME_SIZE]; /* 名字 */
	struct i2c_adapter *adapter; /* 对应的 I2C 适配器 */
	struct device dev; /* 设备结构体 */
	int irq; /* 中断 */
	struct list_head detected;
..
};


struct i2c_driver {
   
	unsigned int class;
	int (*attach_adapter)(struct i2c_adapter *) __deprecated;
	int (*probe)(struct i2c_client *, const struct i2c_device_id *);
	int (*remove)(struct i2c_client *);
	void (*shutdown)(struct i2c_client *);
	void (*alert)(struct i2/
	int (*command)(struct i2c_client *client, unsigned int cmd,
	void *arg);
	struct device_driver driver;
	const struct i2c_device_id *id_table;
	int (*detect)(struct i2c_client *, struct i2c_board_info *);
	const unsigned short *address_list;
	struct list_head clients;
};

驱动编写过程：

1.修改设备树，如修改IO结点、添加AP3216C设备结点
修改IO

		pinctrl_i2c1: i2c1grp {
   
			fsl,pins = <
				MX6UL_PAD_UART4_TX_DATA__I2C1_SCL 0x4001b8b0
				MX6UL_PAD_UART4_RX_DATA__I2C1_SDA 0x4001b8b0
			>;
		};

添加AP3216C设备结点

&i2c1 {
   
	clock-frequency = <100000>;
	pinctrl-names = "default";
	pinctrl-0 = <&pinctrl_i2c1>;
	status = "okay";

	ap3216c@1e {
   
		compatible = "alientek,ap3216c";
		reg = <0x1e>;
	};

};

2.新建一个头文件，命名为ap3216creg.h，目的是存放寄存器，这里先创建好，暂时为空

#ifndef AP3216C_H
#define AP3216C_H



#endif

3.新建一个ap3216c.c文件，用来编写驱动代码。这里我直接把基本框架放上来，有需要的可以直接拿去用，并且不用担心头文件缺失。

#include <linux/types.h>
#include <linux/kernel.h>
#include <linux/delay.h>
#include <linux/ide.h>
#include <linux/init.h>
#include <linux/module.h>
#include <linux/errno.h>
#include <linux/gpio.h>
#include <linux/cdev.h>
#include <linux/device.h>
#include <linux/of.h>
#include <linux/of_address.h>
#include <linux/of_gpio.h>
#include <linux/semaphore.h>
#include <linux/timer.h>
#include <linux/of_irq.h>
#include <linux/irq.h>
#include <asm/mach/map.h>
#include <asm/uaccess.h>
#include <asm/io.h>
#include <linux/input.h>
#include <linux/i2c.h>
#include "ap3216creg.h"
#include <linux/delay.h>


/*驱动入口函数*/
static int __init ap3216c_init(void)
{
   
	return 0;
}

/*驱动出口函数*/
static void __exit ap3216c_exit(void)
{
   

}

module_init(ap3216c_init);
module_exit(ap3216c_exit);
MODULE_LICENSE("GPL");
MODULE_AUTHOR("kong");

4.添加i2c_driver结构体，并且在驱动入口函数中用i2c_add_driver注册该结构体，在驱动出口函数中用i2c_del_driver注销该结构体

/*i2c_driver*/
static struct i2c_driver ap3216c_driver = {
   

};

/*驱动入口函数*/
static int __init ap3216c_init(void)
{
   
	int ret =0;

	ret = i2c_add_driver(&ap3216c_driver);




	return ret;
}

/*驱动出口函数*/
static void __exit ap3216c_exit(void)
{
   
	i2c_del_driver(&ap3216c_driver);

}

5.完善i2c_driver结构体。其中的.of_match_table和.id_table在后面编写

/*i2c_driver*/
static struct i2c_driver ap3216c_driver = {
   
	.probe = ap3216c_probe,
	.remove = ap3216c_remove,
	.driver = {
   
		.name = "ap3216c",
		.owner = THIS_MODULE,
		.of_match_table = of_match_ptr(ap3216c_of_match),
	},
	.id_table = ap3216c_id,
};

6.建立ap3216c_of_match和ap3216c_id和probe函数和remove函数函数里面内容暂时不填写

/*probe函数*/
static int ap3216c_probe(struct i2c_client *client, const struct i2c_device_id *id)
{
   
	return 0;
}
/*remove函数*/
static int ap3216c_remove(struct i2c_client *client)
{
   
	return 0;
}
/*匹配表*/
static struct i2c_device_id ap3216c_id[] = {
   
	{
   "alientek,ap3216c", 0},  //匹配名字
	{
   }
};
/*设备树匹配表*/
static struct of_device_id ap3216c_of_match[] = {
   
	{
   .compatible = "alientek,ap3216c"},
	{
   }
};

7.完整的框架基本就构建好了，完整框架如下

#include <linux/types.h>
#include <linux/kernel.h>
#include <linux/delay.h>
#include <linux/ide.h>
#include <linux/init.h>
#include <linux/module.h>
#include <linux/errno.h>
#include <linux/gpio.h>
#include <linux/cdev.h>
#include <linux/device.h>
#include <linux/of.h>
#include <linux/of_address.h>
#include <linux/of_gpio.h>
#include <linux/semaphore.h>
#include <linux/timer.h>
#include <linux/of_irq.h>
#include <linux/irq.h>
#include <asm/mach/map.h>
#include <asm/uaccess.h>
#include <asm/io.h>
#include <linux/input.h>
#include <linux/i2c.h>
#include "ap3216creg.h"
#include <linux/delay.h>

/*probe函数*/
static int ap3216c_probe(struct i2c_client *client, const struct i2c_device_id *id)
{
   
	return 0;
}
/*remove函数*/
static int ap3216c_remove(struct i2c_client *client)
{
   
	return 0;
}
/*匹配表*/
static struct i2c_device_id ap3216c_id[] = {
   
	{
   "alientek,ap3216c", 0},  //匹配名字
	{
   }
};
/*设备树匹配表*/
static struct of_device_id ap3216c_of_match[] = {
   
	{
   .compatible = "alientek,ap3216c"},
	{
   }
};