迅为Exynos4412开发板例程及注释——注册字符类设备

本文参考了知秋一叶的文章《Linux 字符设备驱动结构（一）——cdev 结构体、设备号相关知识解析》，这边给出链接：http://blog.csdn.net/zqixiao_09/article/details/50839042

首先，我们需要明确，字符类设备的注册流程

1.注册设备号。这里有静态和动态两种方式，静态采用register_chrdev_region()，动态通过alloc_chrdev_region()来创建。注意，在释放的时候需要通过uregister_chrdev_region来完成。在采用静态时，需要用户自己指定主次设备号，可以通过驱动模块传递函数来完成，详见之前的文章。采用动态时，获取的设备节点直接返回至函数的第一次参数dev_t，获取后容易的到major_dev和minor_dev.。

2.初始化cdev，这里一定要注意cdev这个结构体。这我给出cdev的结构体——

struct cdev {
        struct kobject kobj;
		下面两个参数通过init添加
        struct module *owner;
        const struct file_operations *ops;
        struct list_head list;
		下面两个参数通过add添加
        dev_t dev;
        unsigned int count;
};

在这个结构体中我给出两句注释，这是我自己的理解。其实int函数就是绑定了cdev和file_operations，事实上也可以看到init函数中的两个参数就是这两个。

void cdev_init(struct cdev *, const struct file_operations *);

绑定后，我们发现cdev结构体中的参数我们还没有赋值，那么给.owner = THIS_MOUDLE;.ops = my_fops；此处的my_fops从哪里来呢？我们需要实例化一个结构体，然后将他的.owner指定为THIS_MOUDLE;

struct file_operations my_fops = {
	.owner = THIS_MODULE,
};

3.我们需要继续对cdev结构体添加一些参数，我们可以利用add函数。

int cdev_add(struct cdev *, dev_t, unsigned);

很显然，第一个参数是cdev的实例化结构体，dev_t是32位的设备号，usigned指的是有多少个设备。

4.注意，我们需要在卸载驱动的时候释放掉我们用的这些资源。我们采用cedv_del和uregister函数来解决。

下面是迅为例程和我的注释。

/*包含初始化宏定义的头文件,代码中的module_init和module_exit在此文件中*/
#include <linux/init.h>
/*包含初始化加载模块的头文件,代码中的MODULE_LICENSE在此头文件中*/
#include <linux/module.h>
/*定义module_param module_param_array的头文件*/
#include <linux/moduleparam.h>
/*定义module_param module_param_array中perm的头文件*/
#include <linux/stat.h>
/*三个字符设备函数*/
#include <linux/fs.h>
/*MKDEV转换设备号数据类型的宏定义*/
#include <linux/kdev_t.h>
/*定义字符设备的结构体*/
#include <linux/cdev.h>
/*
struct cdev {
        struct kobject kobj;
		下面两个参数通过init添加
        struct module *owner;
        const struct file_operations *ops;
        struct list_head list;
		下面两个参数通过add添加
        dev_t dev;
        unsigned int count;
};
void cdev_init(struct cdev *, const struct file_operations *);
init函数用于绑定cdev与file_operations，但是具体*owner和*ops的赋值要用语句完成
dev->cdev.owner = THIS_MODULE;
dev->cdev.ops = &my_fops;
int cdev_add(struct cdev *, dev_t, unsigned);

*/
/*分配内存空间函数头文件*/
#include <linux/slab.h>

#define DEVICE_NAME "ascdev"
#define DEVICE_MINOR_NUM 2
#define DEV_MAJOR 0
#define DEV_MINOR 0
#define REGDEV_SIZE 3000

MODULE_LICENSE("Dual BSD/GPL");
/*声明是开源的，没有内核版本限制*/
MODULE_AUTHOR("iTOPEET_dz");
/*声明作者*/

int numdev_major = DEV_MAJOR;
int numdev_minor = DEV_MINOR;

/*输入主设备号*/
module_param(numdev_major,int,S_IRUSR);
/*输入次设备号*/
module_param(numdev_minor,int,S_IRUSR);

struct reg_dev
{
	char *data;
	unsigned long size;
	struct cdev cdev;
};
struct reg_dev *my_devices;//定义一个结构体数组，因为有两个子设备

struct file_operations my_fops = {
	.owner = THIS_MODULE,
};


/*设备注册到系统*/
static void reg_init_cdev(struct reg_dev *dev,int index){
	int err;
	int devno = MKDEV(numdev_major,numdev_minor+index);
	
	cedv_init(&dev->cdev,&my_fops)；
	dev->cdev.owner = THIS_MODULE;
	dev->cdev.ops= &my_fops;
	
	/*数据初始化
	cdev_init(&dev->cdev,&my_fops);
	dev->cdev.owner = THIS_MODULE;
	dev->cdev.ops = &my_fops;
	*/
	/*注册到系统*/
	
	err = cdev_add(&dev->cdev,devno,1);
	/*
	int cdev_add(struct cdev *p, dev_t dev, unsigned count);

       该函数向内核注册一个struct cdev结构，即正式通知内核由struct cdev *p代表的字符设备已经可以使用了。
	(1)第一个设备号 dev，
	(2)和该设备关联的设备编号的数量。
	这两个参数直接赋值给struct cdev 的dev成员和count成员。

	*/
	if(err){
		printk(KERN_EMERG "cdev_add %d is fail! %d\n",index,err);
	}
	else{
		printk(KERN_EMERG "cdev_add %d is success!\n",index);
	}
}

static int scdev_init(void)
{
	int ret = 0,i;
	dev_t num_dev;
	
	
	printk(KERN_EMERG "numdev_major is %d!\n",numdev_major);
	printk(KERN_EMERG "numdev_minor is %d!\n",numdev_minor);
	
	if(numdev_major){
		num_dev = MKDEV(numdev_major,numdev_minor);
		ret = register_chrdev_region(num_dev,DEVICE_MINOR_NUM,DEVICE_NAME);
	}
	else{
		/*动态注册设备号*/
		ret = alloc_chrdev_region(&num_dev,numdev_minor,DEVICE_MINOR_NUM,DEVICE_NAME);
		/*获得主设备号*/
		numdev_major = MAJOR(num_dev);
		printk(KERN_EMERG "adev_region req %d !\n",numdev_major);
	}
	if(ret<0){
		printk(KERN_EMERG "register_chrdev_region req %d is failed!\n",numdev_major);		
	}
	
	my_devices = kmalloc(DEVICE_MINOR_NUM * sizeof(struct reg_dev),GFP_KERNEL);
	if(!my_devices){
		ret = -ENOMEM;
		goto fail;
	}
	memset(my_devices,0,DEVICE_MINOR_NUM * sizeof(struct reg_dev));
	/*
	kzalloc与kmalloc的区别——
	类似于C语言里的malloc，常用手法
	malloc(n*sizeof(int));
	char buffer[4];
	memset(buffer,0,sizeof(char)*4)
	但是在Linux中可以用kzalloc快速完成，kzalloc(size,FLAG);
	
	static inline void *kzalloc(size_t size, gfp_t flags);该函数比kmalloc多了一个功能,就是会把申请得到的内存块初始化为0;
	*/
	/*设备初始化*/
	for(i=0;i<DEVICE_MINOR_NUM;i++){
		my_devices[i].data = kmalloc(REGDEV_SIZE,GFP_KERNEL);
		memset(my_devices[i].data,0,REGDEV_SIZE);
		/*设备注册到系统*/
		reg_init_cdev(&my_devices[i],i);
	}
	
		
	printk(KERN_EMERG "scdev_init!\n");
	/*打印信息，KERN_EMERG表示紧急信息*/
	return 0;

fail:
	/*注销设备号*/
	unregister_chrdev_region(MKDEV(numdev_major,numdev_minor),DEVICE_MINOR_NUM);
	printk(KERN_EMERG "kmalloc is fail!\n");
	
	return ret;
}

static void scdev_exit(void)
{
	int i;
	printk(KERN_EMERG "scdev_exit!\n");
	
	/*除去字符设备*/
	for(i=0;i<DEVICE_MINOR_NUM;i++){
		cdev_del(&(my_devices[i].cdev));
	}
	/*
	d -- void cdev_del(struct cdev *p)；

     该函数向内核注销一个struct cdev结构，即正式通知内核由struct cdev *p代表的字符设备已经不可以使用了。

     从上述的接口讨论中，我们发现对于struct cdev的初始化和注册的过程中，我们需要提供几个东西
	 cdev_add(&cdev,devno,1);
	(1) struct file_operations结构指针；
	struct file_operations my_fops{
		
		.owner = THIS_MODULE;
	};
	(2) dev设备号；
	devno = MKDEV(dev_major,dev_minor);
	(3) count次设备号个数。
	1
*/	
	unregister_chrdev_region(MKDEV(numdev_major,numdev_minor),DEVICE_MINOR_NUM);
}


module_init(scdev_init);
/*初始化函数*/
module_exit(scdev_exit);
/*卸载函数*/