Linux之字符设备驱动框架

Linux之字符设备驱动框架
目录

一、驱动介绍

1.内核模块

2.日志级别

3.模块符号的导出

4.内核模块参数

二、字符设备驱动(一)

1.模块加载

2.注册字符设备驱动

3.内存映射

三、字符设备驱动(二)

1.模块加载

2.申请设备号

3.注册字符设备

4.自动创建设备节点

5.文件私有数据

总结

前言

一、驱动介绍

Linux驱动属于内核的一部分，学习驱动开发时将驱动设计为内核模块，内核模块是一种可以在系统运行时加载和卸载的机制。

内核编程的注意事项

1.不能使用C标准库和C标准头文件

2.使用GNU C

3.没有内存保护机制

4.不能处理浮点运算

5.注意并发互斥和可移植性问题

1.内核模块

Linux 驱动有两种运行方式，第一种是将驱动编译进 Linux 内核中，当 Linux 内核启动的时就会自动运行驱动程序。第二种是将驱动编译成模块(Linux 下模块扩展名为.ko)，在Linux 内核启动以后使用insmod或者modprobe命令加载驱动模块。在调试驱动的时候一般都选择将其编译为模块。

模块的加载和卸载注册函数如下
```
#include 
#include  //需要包含头文件
 
module_init(xxx_init); //注册模块加载函数
module_exit(xxx_exit); //注册模块卸载函数
```
module_init 函数用来向 Linux 内核注册一个模块加载函数，参数 xxx_init 就是需要注册的具体函数，当使用insmod命令加载驱动的时候， xxx_init 这个函数就会被调用。 module_exit()函数用来向 Linux 内核注册一个模块卸载函数，参数 xxx_exit 就是需要注册的具体函数，当使用“rmmod”命令卸载具体驱动的时候 xxx_exit 函数就会被调用。

字符设备驱动模块加载和卸载模板如下所示：
```
#include 
#include 
 
/* 驱动入口函数 */
static int __init xxx_init(void)
{
    /* 入口函数具体内容 */
 
    return 0;
}
 
 
/* 驱动出口函数 */
static void __exit xxx_exit(void)
{
    /* 出口函数具体内容 */
}
 
/* 将上面两个函数指定为驱动的入口和出口函数 */
module_init(xxx_init);
module_exit(xxx_exit)
 
MODULE_LICENSE("GPL");//GPL模块许可证
```
注：在编写模块时必须加上模块许可证，防止内核被污染，造成某些功能无法使用。

驱动编译完成以后扩展名为.ko，有两种命令可以加载驱动模块： insmod和 modprobe。

insmod drv.ko //加载驱动模块

rmmod drv.ko //卸载驱动模块

modprobe drv.ko //加载或者卸载驱动模块

区别：insmod 命令不能解决模块的依赖关系，但是 modprobe 不会存在这个问题， modprobe 会分析模块的依赖关系，然后会将所有的依赖模块都加载到内核中。比如 drv.ko 依赖 first.ko 这个模块，就必须先使用insmod 命令加载 first.ko 这个模块，然后再加载 drv.ko 这个模块。

modprobe 命令主要智能在提供了模块的依赖性分析、错误检查、错误报告等功能，推荐使用modprobe 命令来加载驱动。 modprobe 命令默认会去/lib/modules/目录中查找模块。

同时 modprobe 命令也可以卸载掉驱动模块所依赖的其他模块，前提是这些依赖模块已经没有被其他模块所使用，否则就不能使用 modprobe 来卸载驱动模块。所以对于模块的卸载，推荐使用 rmmod 命令。

2.日志级别

printk在内核中用来记录日志信息的函数，只能在内核源码范围内使用。和printf非常相似。printk函数主要做两件事情：①将信息记录到log中 ②调用控制台驱动来将信息输出。
```
#define KERN_EMERG	"<0>"	/*系统不可用*/
#define KERN_ALERT	"<1>"	/*必须立即处理的错误信息*/
#define KERN_CRIT	"<2>"	/*严重错误信息*/
#define KERN_ERR	"<3>"	/*错误信息*/
#define KERN_WARNING	"<4>"	/*警告信息*/
#define KERN_NOTICE	"<5>"	/*需要注意的信息*/
#define KERN_INFO	"<6>"	/*一般信息*/
#define KERN_DEBUG	"<7>"	/*调试信息*/
```
```
printk(KERN_DEBUG"debug\r\n");
```
printk打印的内容是否显示取决于日志级别，只有当printk的日志级别高于内核默认打印级别时才打印(打印日志级别数值小于内核默认打印级别)。数字越小，优先级越高。

若是printk不提供打印级别使用默认打印级别，可以通过查看/proc/sys/kernel/printk来查看，第二个数字就是printk的默认打印级别。

而/proc/sys/kernel/printk中的第一个数字就是内核默认打印级别，可以通过uboot的环境变量bootargs传递内核默认打印级别。在uboot的bootargs中加入loglevel=X指令。

内核的默认打印级别修改为8。

3.模块符号的导出

模块导出符号可以将模块中的变量/函数导出，供内核其他代码/模块使用。内核中提供了相应的宏来实现模块的导出：

EXPORT_SYMBOL -------------- 使用无限制

EXPORT_SYMBOL_GPL ---------- 只有遵循GPL协议的代码才可以使用

需注意的是，如果一个模块使用了另一个模块的变量/函数，该模块依赖于另一个模块，加载模块时必须先加载依赖的模块，如果一个模块被内核使用，该模块不得卸载。

4.内核模块参数

内核的模块参数不但可以在编写代码时设置其的值，还可以在加载模块时设置其的值，甚至可以再加载模块后修改其的值。在模块中声明一些变量，使用以下语法将这些变量设置为模块参数：

module_param(模块参数名,模块参数类型,访问权限);

module_param_array(数组模块参数名,数组元素类型,NULL,访问权限);

在代码其他地方使用模块参数和使用普通变量没有区别。加载模块时可以通过 "模块参数名=值" 的方式来修改模块参数的值。当模块加载成功后，访问权限非0的模块参数就会出现在以下路径下 /sys/module/模块名/parameters 存在和模块参数名相同的文件，这些文件的权限来自于模块参数的权限，内容来自于模块参数的值。同时也可以通过修改文件中保存的数据来修改对应模块参数。

二、字符设备驱动(一)

驱动是沟通底层硬件和上层应用的桥梁，访问设备文件通过文件系统IO，在用户层访问设备文件和访问普通文件没有区别。

1.模块加载

模块加载和卸载模板：
```
#include 
#include 
 
/* 驱动入口函数 */
static int __init xxx_init(void)
{
    /* 入口函数具体内容 */
 
    return 0;
}
 
 
/* 驱动出口函数 */
static void __exit xxx_exit(void)
{
    /* 出口函数具体内容 */
}
 
/* 将上面两个函数指定为驱动的入口和出口函数 */
module_init(xxx_init);
module_exit(xxx_exit)
 
MODULE_LICENSE("GPL");//GPL模块许可证
```
2.注册字符设备驱动

对于字符设备驱动而言，当驱动模块加载成功以后需要注册字符设备。卸载驱动模块的时也需要注销掉字符设备。

字符设备的注册和注销函数原型：
```
static inline int register_chrdev(unsigned int major, const char *name,
const struct file_operations *fops)
 
static inline void unregister_chrdev(unsigned int major, const char *name)
```
register_chrdev 函数用于注册字符设备，需要传入主设备号，设备名称和指向设备操作函数集合变量。这种注册函数会将后面所有的次设备号全部占用，而且主设备号需要我们自己去设置，现在不推荐这样使用。一般字符设备的注册在驱动模块的入口函数 xxx_init 中进行，字符设备的注销在驱动模块的出口函数 xxx_exit 中进行。
```
/*
 * @description		: 打开设备
 * @param - inode 	: 传递给驱动的inode
 * @param - filp 	: 设备文件，file结构体有个叫做private_data的成员变量
 * 					  一般在open的时候将private_data指向设备结构体。
 * @return 			: 0 成功;其他 失败
 */
static int led_open(struct inode *inode, struct file *filp)
{
	return 0;
}
 
/*
 * @description		: 从设备读取数据 
 * @param - filp 	: 要打开的设备文件(文件描述符)
 * @param - buf 	: 返回给用户空间的数据缓冲区
 * @param - cnt 	: 要读取的数据长度
 * @param - offt 	: 相对于文件首地址的偏移
 * @return 			: 读取的字节数，如果为负值，表示读取失败
 */
static ssize_t led_read(struct file *filp, char __user *buf, size_t cnt, loff_t *offt)
{
	return 0;
}
 
/*
 * @description		: 向设备写数据 
 * @param - filp 	: 设备文件，表示打开的文件描述符
 * @param - buf 	: 要写给设备写入的数据
 * @param - cnt 	: 要写入的数据长度
 * @param - offt 	: 相对于文件首地址的偏移
 * @return 			: 写入的字节数，如果为负值，表示写入失败
 */
static ssize_t led_write(struct file *filp, const char __user *buf, size_t cnt, loff_t *offt)
{
	return 0;
}
 
/*
 * @description		: 关闭/释放设备
 * @param - filp 	: 要关闭的设备文件(文件描述符)
 * @return 			: 0 成功;其他 失败
 */
static int led_release(struct inode *inode, struct file *filp)
{
	return 0;
}
 
//设备操作函数 
static struct file_operations led_fops = {
	.owner = THIS_MODULE,
	.open = led_open,
	.read = led_read,
	.write = led_write,
	.release = 	led_release,
};
 
//驱动入口函数
static int __init led_init(void)
{
	int retvalue = 0;
 
	/*注册字符设备驱动 */
	retvalue = register_chrdev(LED_MAJOR, LED_NAME, &led_fops);
	if(retvalue < 0){
		printk("register chrdev failed!\r\n");
		return -EIO;
	}
	return 0;
}
//驱动出口函数
static void __exit led_exit(void)
{
 
	/* 注销字符设备驱动 */
	unregister_chrdev(LED_MAJOR, LED_NAME);
}
 
module_init(led_init);
module_exit(led_exit);
MODULE_LICENSE("GPL");
```
3.内存映射

在Linux中不能直接访问寄存器，要想要操作寄存器需要完成物理地址到虚拟空间的映射。
```
#include 
#include 
 
#define ioremap(cookie,size) __arm_ioremap((cookie), (size),
MT_DEVICE)
 
void __iomem * __arm_ioremap(phys_addr_t phys_addr, size_t size,
unsigned int mtype)
{
    return arch_ioremap_caller(phys_addr, size, mtype,
    __builtin_return_address(0));
}
```
返回值： __iomem 类型的指针，指向映射后的虚拟空间首地址。

建立映射：映射的虚拟地址 = ioremap(IO内存起始地址，映射长度)；一旦映射成功，访问对应的虚拟地址就相当于访问对应的IO内存。
```
void iounmap (volatile void __iomem *addr)
```
```
/* 寄存器物理地址 */
#define CCM_CCGR1_BASE				(0X020C406C)	
 
/* 映射后的寄存器虚拟地址指针 */
static void __iomem *IMX6U_CCM_CCGR1;
 
/* 寄存器地址映射 */
IMX6U_CCM_CCGR1 = ioremap(CCM_CCGR1_BASE, 4);
if(IS_ERR_OR_NULL(IMX6U_CCM_CCGR1))
{
    //...
}
```
解除映射：
```
void iounmap (volatile void __iomem *addr)
 
iounmap(IMX6U_CCM_CCGR1);
```
内存映射后，就可以通过I/O 内存访问函数对寄存器进行相应的操作，和裸机开发那部分差不多一样。编写完成后，在写应用测试程序，但是在测试的时候需要手动创建设备文件，对应开发非常不方便。以上就是一个最简单的字符设备驱动框架。

三、字符设备驱动(二)

前面的字符设备驱动框架比较简单，不灵活。不仅需要设定主设备号，在测试时还需要手动创建设备文件。新字符设备驱动框架刚好能解决这两个大问题。

1.模块加载

这一步和前面是一样的。

2.申请设备号

前面设备号的申请是开发者检查当前系统中所有被使用了的设备号，然后挑选一个没有使用的设备号给驱动。这样很不方便。Linux 社区推荐使用动态分配设备号，在注册字符设备之前先申请一个设备号，系统会自动给你一个没有被使用的设备号。

动态申请设备号：
```
int alloc_chrdev_region(dev_t *dev, unsigned baseminor, unsigned count, const char *name)
```
dev：保存申请到的设备号。
baseminor：次设备号起始地址，该函数可以申请一段连续的多个设备号，初始值一般为0
count：要申请的设备号数量。
name：设备名字。

静态申请设备号
```
int register_chrdev_region(dev_t from, unsigned count, const char *name);
```
from - 要申请的起始设备号

count - 设备号个数

name - 设备号在内核中的名称

返回0申请成功，否则失败

注销字符设备之后要释放掉设备号，设备号释放函数
```
void unregister_chrdev_region(dev_t from, unsigned count)
```
from：要释放的设备号。
count：表示从 from 开始，要释放的设备号数量。

新字符设备驱动模板:
```
 
//创建设备号 
if (newchrled.major)   //定义了设备号就静态申请
{		
	newchrled.devid = MKDEV(newchrled.major, 0);
	register_chrdev_region(newchrled.devid, NEWCHRLED_CNT, NEWCHRLED_NAME);
} 
else   //没有定义设备号就动态申请
{		
  
	alloc_chrdev_region(&newchrled.devid, 0, NEWCHRLED_CNT, NEWCHRLED_NAME);//申请设备号 
	newchrled.major = MAJOR(newchrled.devid);	//获取分配号的主设备号
	newchrled.minor = MINOR(newchrled.devid);	// 获取分配号的次设备号
}
```
3.注册字符设备

在 Linux 中使用 cdev 结构体表示一个字符设备， cdev 结构体在 include/linux/cdev.h 文件中的定义如下
```
struct cdev {
	struct kobject kobj;
	struct module *owner;
	const struct file_operations *ops;//操作函数集合
	struct list_head list;
	dev_t dev;//设备号
	unsigned int count;
};
```
在 cdev 中有两个重要的成员变量:ops 和 dev，字符设备文件操作函数集合file_operations 以及设备号 dev_t。

向Linux内核添加字符设备

①初始化cdev结构体变量

定义好 cdev 变量以后就要使用 cdev_init 函数对其进行初始化， cdev_init 函数原型如下：
```
void cdev_init(struct cdev *cdev, const struct file_operations *fops);
```
参数 cdev 就是要初始化的 cdev 结构体变量，参数 fops 就是字符设备文件操作函数集合。
```
struct cdev testcdev;
 
//设备操作函数
static struct file_operations test_fops = {
    .owner = THIS_MODULE,
    //其他具体的初始项 
};
 
testcdev.owner = THIS_MODULE;
 
//初始化 cdev 结构体变量
cdev_init(&testcdev, &test_fops); 
```
② 将设备添加到内核

cdev_add 函数用于向 Linux 系统添加字符设备(cdev 结构体变量)，首先使用 cdev_init 函数完成对 cdev 结构体变量的初始化，然后使用 cdev_add 函数向 Linux 系统添加这个字符设备。
```
int cdev_add(struct cdev *p, dev_t dev, unsigned count)
```
p - 要添加的cdev结构

dev - 绑定的起始设备号

count - 设备号个数
```
cdev_add(&testcdev, devid, 1); //添加字符设备
```
将cdev添加到内核同时绑定设备号。

其实这里申请设备号和注册设备在第一中驱动中直接使用register_chrdev函数完成者两步操作。卸载也是一样的。

卸载驱动的时候一定要使用 cdev_del 函数从 Linux 内核中删除相应的字符设备
```
void cdev_del(struct cdev *p);
 
cdev_del(&testcdev); //删除 cdev
```
4.自动创建设备节点

上面的驱动框架，当使用 modprobe 加载驱动程序以后还需要使用命令mknod手动创建设备节点。在驱动中实现自动创建设备节点的功能以后，使用 modprobe 加载驱动模块成功的话就会自在/dev 目录下创建对应的设备文件。

在 Linux 下通过 udev 来实现设备文件的创建与删除，但是在嵌入式 Linux 中使用mdev 来实现设备节点文件的自动创建与删除， Linux 系统中的热插拔事件也由 mdev 管理。具体关于mdev和udev可以参考前面的笔记。

自动创建设备节点的工作是在驱动程序的入口函数中完成的，一般在 cdev_add 函数后面添
加自动创建设备节点相关代码。

①首先要创建一个 class 类，定义在文件include/linux/device.h 里面。
```
struct class *class_create(struct module *owner, const char *name);
```
class_create 一共有两个参数，参数 owner 一般为 THIS_MODULE，参数 name 是类名字。设备类名对应 /sys/class 目录的子目录名。返回值是个指向结构体 class 的指针，也就是创建的类。

卸载驱动程序的时候需要删除掉类，类删除函数为 class_destroy
```
void class_destroy(struct class *cls); // cls要删除的类
```
②创建设备：

创建好类以后还不能实现自动创建设备节点，还需要在类下创建一个设备,使用 device_create 函数在类下面创建设备。
```
struct device *device_create(struct class *class,
    struct device *parent,
    dev_t devt,
    void *drvdata,
    const char *fmt, ...)
```
简化后
```
struct device *device_create(设备类指针, 父设备指针,设备号, 额外数据, 设备文件名);
```
成功会在 /dev 目录下生成设备文件。

卸载驱动的时候需要删除掉创建的设备，设备删除函数为 device_destroy
```
void device_destroy(struct class *class, dev_t devt);
```
参数 class 是要删除的设备所处的类，参数 devt 是要删除的设备号

小结：

a.创建设备类 ---------------------- class_create

struct class *class_create(struct module *owner, const char *name);

//创建成功会生产该路径： /sys/class/设备类名

b.创建设备文件(设备节点) ------------------ device_create

struct device *device_create(设备类指针, 父设备指针,设备号, 额外数据, 设备文件名);

//成功会在 /dev 目录下生成设备文件

销毁设备类 --------------------- class_destroy

销毁设备文件 ------------------- device_destroy
```
struct class *class; /* 类 */
struct device *device; /* 设备 */
dev_t devid; /* 设备号 */
 
/* 驱动入口函数 */
static int __init led_init(void)
{
	...
	/* 创建类 */
	class = class_create(THIS_MODULE, "xxx");
	/* 创建设备 */
	device = device_create(class, NULL, devid, NULL, "xxx");
	...
	return 0;
}
 
/* 驱动出口函数 */
static void __exit led_exit(void)
{
	...
	/* 删除设备 */
	device_destroy(newchrled.class, newchrled.devid);
	/* 删除类 */
	class_destroy(newchrled.class);
	...
}
 
module_init(led_init);
module_exit(led_exit);
```
5.文件私有数据

每个硬件设备都有一些属性，比如主设备号(dev_t)，类(class)、设备(device)，在编写驱动的时候可以将这些属性全部写成变量的形式，但对于一个设备的所有属性信息最好将其做成一个结构体,编写驱动 open 函数的时候将设备结构体作为私有数据添加到设备文件中。
```
/* newchrled设备结构体 */
struct newchrled_dev{
	dev_t devid;			/* 设备号 	 */
	struct cdev cdev;		/* cdev 	*/
	struct class *class;		/* 类 		*/
	struct device *device;	/* 设备 	 */
	int major;				/* 主设备号	  */
	int minor;				/* 次设备号   */
};
 
struct newchrled_dev newchrled;	/* led设备 */
 
/*
 * @description		: 打开设备
 * @param - inode 	: 传递给驱动的inode
 * @param - filp 	: 设备文件，file结构体有个叫做private_data的成员变量
 * 					  一般在open的时候将private_data指向设备结构体。
 * @return 			: 0 成功;其他 失败
 */
static int led_open(struct inode *inode, struct file *filp)
{
	filp->private_data = &newchrled; /* 设置私有数据 */
	return 0;
}
 
static ssize_t led_read(struct file *filp, char __user *buf, size_t cnt, loff_t *offt)
{
    struct newchrled_dev *dev = (struct newchrled_dev *)filp->private_data;
	return 0;
}
```
在 open 函数里面设置好私有数据后，在 write、 read、 close 函数中直接读取 private_data即可得到设备结构体。

6.应用层和内核层传递数据

应用层和内核层是不能直接进行数据传输的。要想进行数据传输，要借助下面的这两个函数

static inline long copy_from_user(void *to, const void __user * from, unsigned long n)
static inline long copy_to_user(void __user *to, const void *from, unsigned long n)

用户空间-->内核空间
```
copy_from_user(void *to, const void __user *from, unsigned long n)
```
to：目标地址（内核空间)

from:源地址（用户空间）

n:将要拷贝数据的字节数

返回值:成功返回 0，失败返回没有拷贝成功的数据字节数

内核空间-->用户空间
```
copy_to_user(void __user *to, const void *from, unsigned long n)
```
to：目标地址（用户空间）

from：源地址（内核空间）

n：将要拷贝数据的字节数

返回值：成功返回 0，失败返回没有拷贝成功的数据字节数

总结

Linux系统将设备分为3类：字符设备、块设备、网络设备。

Linux中所有的设备文件在/dev目录下，内核中有很多的字符设备驱动，这些字符设备驱动和字符设备文件匹配的方式是通过设备号。

在应用层调用open函数打开设备文件，对于上层open调用到内核时会发生一次软中断中断号是0X80，从用户空间进入到内核空间。

open会调用到system_call(内核函数)，system_call会根据设备文件中的设备名，去找出要操作的设备号。

然后调到虚拟文件VFS （为了上层调用到确切的硬件统一化）,调用VFS里的sys_open，sys_open会找到在驱动链表(管理所有设备的驱动)里面，根据主设备号和次设备号找到字符设备驱动，然后驱动函数里面有通过寄存器操控IO口的代码，进而可以控制IO口实现相关功能。

大致流程：

补充：

1.在Linux文件系统中，每个文件都用一个struct inode结构体来描述，这个结构体记录了这个文件的所有信息，例如文件类型，访问权限等。

2.在linux操作系统中，每个驱动程序在应用层的/dev目录或者其他如/sys目录下都会有一个文件与之对应。

3.在linux操作系统中, 每个驱动程序都有一个设备号

4.在linux操作系统中，每打开一次文件，Linux操作系统会在VFS层分配一个struct file结构体来描述打开的文件。

大致驱动原理：

(1) 当open函数打开设备文件时，可以根据设备文件对应的struct inode结构体描述的信息，可以知道接下来要操作的设备类型（字符设备还是块设备），还会分配一个struct file结构体。

(2) 根据struct inode结构体里面记录的设备号，可以找到对应的驱动程序。在Linux操作系统中每个字符设备都有一个struct cdev结构体。此结构体描述了字符设备所有信息，其中最重要的一项就是字符设备的操作函数接口。

(3) 找到struct cdev结构体后，linux内核就会将struct cdev结构体所在的内存空间首地址记录在struct inode结构体i_cdev成员中，将struct cdev结构体中的记录的函数操作接口地址记录在struct file结构体的f_ops成员中。

(4) 任务完成，VFS层会给应用返回一个文件描述符（fd）。这个fd是和struct file结构体对应的。接下来上层应用程序就可以通过fd找到struct file，然后在struct file找到操作字符设备的函数接口file_operation了。

其中，cdev_init和cdev_add在驱动程序的入口函数中就已经被调用，分别完成字符设备与file_operation函数操作接口的绑定，和将字符驱动注册到内核的工作。
相关阅读:
jsp195ssm饭店餐饮管理系统hsg6034AHA5
springboot 如何编写增删改查后端接口，小白极速入门，附完整代码
 FineBI 项目资源迁移
 单细胞文献学习(part5)--Using Cell-to-Cell Variability— A New Era in Molecular Biology
2023第二届金育杯金融智能投顾大赛全国总决赛圆满完成
 为什么Open3D可视化TensorFlow张量速度超慢
 计网第五章（运输层）（四）（TCP的流量控制）
SQL优化——如何写出高效率SQL
docker搭建Harbor仓库
 ROS 消息订阅服务器客户端客户端通信方式
原文地址：https://blog.csdn.net/qq_53144843/article/details/126652621

前言

一、驱动介绍

1.内核模块

2.日志级别

3.模块符号的导出

4.内核模块参数

二、字符设备驱动(一)

1.模块加载

2.注册字符设备驱动

3.内存映射

三、字符设备驱动(二)

1.模块加载

2.申请设备号

3.注册字符设备

4.自动创建设备节点

5.文件私有数据

6.应用层和内核层传递数据

总结