1)实验平台:正点原子领航者ZYNQ 开发板
2)平台购买地址:https://item.taobao.com/item.htm?&id=606160108761
3)全套实验源码+手册+视频下载地址:http://www.openedv.com/docs/boards/ FPGA/zdyz_linhanz.html
4)对正点原子FPGA感兴趣的同学可以加群讨论:876744900
5)关注正点原子公众号,获取最新资料
第二十一章字符设备驱动开发
本章我们从Linux驱动开发中最基础的字符设备驱动开始,重点学习Linux下字符设备驱动开发框架。本章会以一个虚拟的设备为例,讲解如何进行字符设备驱动开发,以及如何编写测试APP来测试驱动工作是否正常,为以后的学习打下坚实的基础。
字符设备驱动简介
字符设备是Linux驱动中最基本的一类设备驱动,字符设备就是一个一个字节,按照字节流进行读写操作的设备,读写数据是分先后顺序的。比如我们最常见的LED、按键、IIC、SPI,LCD等等都是字符设备,这些设备的驱动就叫做字符设备驱动。
在详细的学习字符设备驱动架构之前,我们先来简单的了解一下Linux下的应用程序是如何调用驱动程序的,Linux应用程序对驱动程序的调用如下图所示:
图 32.1.1 Linux应用程序对驱动程序的调用流程
在Linux中一切皆为文件,驱动加载成功以后会在“/dev”目录下生成一个相应的文件,应用程序通过对这个名为“/dev/xxx”(xxx是具体的驱动文件名字)的文件进行相应的操作即可实现对硬件的操作。比如现在有个叫做/dev/led的驱动文件,此文件是led的驱动文件。应用程序使用open函数来打开文件/dev/led,使用完成以后使用close函数关闭/dev/led这个文件。open和close就是打开和关闭led驱动的函数,如果要点亮或关闭led,那么就使用write函数来操作,也就是向此驱动写入数据,这个数据就是要关闭还是要打开led的控制参数。如果要获取led灯的状态,就用read函数从驱动中读取相应的状态。
应用程序运行在用户空间,而Linux驱动属于内核的一部分,因此驱动运行于内核空间。当我们在用户空间想要实现对内核的操作,比如使用open函数打开/dev/led这个驱动,因为用户空间不能直接对内核进行操作,因此必须使用一个叫做“系统调用”的方法来实现从用户空间陷入到内核空间,这样才能实现对底层驱动的操作。open、close、write和read等这些函数是有C库提供的,在Linux系统中,系统调用作为C库的一部分。当我们调用open函数的时候流程如下图所示:
图 32.1.2 open函数调用流程
其中关于C库以及如何通过系统调用陷入到内核空间这个我们不用去管,我们重点关注的是应用程序和具体的驱动,应用程序使用到的函数在具体驱动程序中都有与之对应的函数,比如应用程序中调用了open这个函数,那么在驱动程序中也得有一个名为open的函数。每一个系统调用,在驱动中都有与之对应的一个驱动函数,在Linux内核文件include/linux/fs.h中有个叫做file_opera tions的结构体,此结构体就是Linux内核驱动操作函数集合,内容如下所示:
示例代码21.1.1 file_operations结构体
- 1692 struct file_operations {
- 1693 struct module *owner;
- 1694 loff_t (*llseek) (struct file *, loff_t, int);
- 1695 ssize_t (*read) (struct file *, char __user *, size_t, loff_t *);
- 1696 ssize_t (*write) (struct file *, const char __user *, size_t, loff_t *);
- 1697 ssize_t (*read_iter) (struct kiocb *, struct iov_iter *);
- 1698 ssize_t (*write_iter) (struct kiocb *, struct iov_iter *);
- 1699 int (*iterate) (struct file *, struct dir_context *);
- 1700 int (*iterate_shared) (struct file *, struct dir_context *);
- 1701 unsigned int (*poll) (struct file *, struct poll_table_struct *);
- 1702 long (*unlocked_ioctl) (struct file *, unsigned int, unsigned long);
- 1703 long (*compat_ioctl) (struct file *, unsigned int, unsigned long);
- 1704 int (*mmap) (struct file *, struct vm_area_struct *);
- 1705 int (*open) (struct inode *, struct file *);
- 1706 int (*flush) (struct file *, fl_owner_t id);
- 1707 int (*release) (struct inode *, struct file *);
- 1708 int (*fsync) (struct file *, loff_t, loff_t, int datasync);
- 1709 int (*fasync) (int, struct file *, int);
- 1710 int (*lock) (struct file *, int, struct file_lock *);
- 1711 ssize_t (*sendpage) (struct file *, struct page *, int, size_t, loff_t *, int);
- 1712 unsigned long (*get_unmapped_area)(struct file *, unsigned long, unsigned long, unsigned long, unsigned long);
- 1713 int (*check_flags)(int);
- 1714 int (*flock) (struct file *, int, struct file_lock *);
- 1715 ssize_t (*splice_write)(struct pipe_inode_info *, struct file *, loff_t *, size_t, unsigned int);
- 1716 ssize_t (*splice_read)(struct file *, loff_t *, struct pipe_inode_info *, size_t, unsigned int);
- 1717 int (*setlease)(struct file *, long, struct file_lock **, void **);
- 1718 long (*fallocate)(struct file *file, int mode, loff_t offset,
- 1719 loff_t len);
- 1720 void (*show_fdinfo)(struct seq_file *m, struct file *f);
- 1721 #ifndef CONFIG_MMU
- 1722 unsigned (*mmap_capabilities)(struct file *);
- 1723 #endif
- 1724 ssize_t (*copy_file_range)(struct file *, loff_t, struct file *,
- 1725 loff_t, size_t, unsigned int);
- 1726 int (*clone_file_range)(struct file *, loff_t, struct file *, loff_t,
- 1727 u64);
- 1728 ssize_t (*dedupe_file_range)(struct file *, u64, u64, struct file *,
- 1729 u64);
- 1730 } __randomize_layout;
简单介绍一下file_operation结构体中比较重要的、常用的函数:
第1693行,owner拥有该结构体的模块的指针,一般设置为THIS_MODULE。
第1694行,llseek函数用于修改文件当前的读写位置。
第1695行,read函数用于读取设备文件。
第1696行,write函数用于向设备文件写入(发送)数据。
第1701行,poll是个轮询函数,用于查询设备是否可以进行非阻塞的读写。
第1702行,unlocked_ioctl函数提供对于设备的控制功能,与应用程序中的ioctl函数对应。
第1703行,compat_ioctl函数与unlocked_ioctl函数功能一样,区别在于在64位系统上,32位的应用程序调用将会使用此函数。在32位的系统上运行32位的应用程序调用的是unlocked_ioctl。
第1704行,mmap函数用于将设备的内存映射到进程空间中(也就是用户空间),一般帧缓冲设备会使用此函数,比如LCD驱动的显存,将帧缓冲(LCD显存)映射到用户空间中以后应用程序就可以直接操作显存了,这样就不用在用户空间和内核空间之间来回复制。
第1705行,open函数用于打开设备文件。
第1707行,release函数用于释放(关闭)设备文件,与应用程序中的close函数对应。
第1709行,fsync函数用于刷新待处理的数据,用于将缓冲区中的数据刷新到磁盘中。
第1605行,fasync函数与fsync函数的功能类似,只是fasync是异步刷新待处理的数据。
在字符设备驱动开发中最常用的就是上面这些函数,关于其他的函数大家可以查阅相关文档。我们在字符设备驱动开发中最主要的工作就是实现上面这些函数,不一定全部都要实现,但是向open、release、write、read等都是需要实现的,当然了,具体需要实现哪些函数还是要看具体的驱动要求。
字符设备驱动开发步骤
上一小节我们简单的介绍了一下字符设备驱动,那么字符设备驱动开发都有哪些步骤呢?我们在学习裸机或者 STM32的时候关于驱动的开发就是初始化相应的外设寄存器,在Linux驱动开发中肯定也是要初始化相应的外设寄存器,这个是毫无疑问的。只是在Linux驱动开发中我们需要按照其规定的框架来编写驱动,所以说学Linux驱动开发重点是学习其驱动框架。
驱动模块的加载和卸载
Linux驱动有两种运行方式,第一种就是将驱动编译进Linux内核中,这样当Linux内核启动的时候就会自动运行驱动程序。第二种就是将驱动编译成模块(Linux下模块扩展名为.ko),在Linux内核启动以后使用“insmod”命令加载驱动模块。在调试驱动的时候一般都选择将其编译为模块,这样我们修改驱动以后只需要编译一下驱动代码即可,不需要编译整个Linux代码。而且在调试的时候只需要加载或者卸载驱动模块即可,不需要重启整个系统。总之,将驱动编译为模块最大的好处就是方便开发,当驱动开发完成,确定没有问题以后就可以将驱动编译进Linux内核中,当然也可以不编译进Linux内核中,具体看自己的需求。
模块有加载和卸载两种操作,我们在编写驱动的时候需要注册这两种操作函数,模块的加载和卸载注册函数如下:
- module_init(xxx_init); //注册模块加载函数
- module_exit(xxx_exit); //注册模块卸载函数
module_init函数用来向Linux内核注册一个模块加载函数,参数xxx_init就是需要注册的具体函数,当使用“insmod”命令加载驱动的时候,xxx_init这个函数就会被调用。module_exit()函数用来向Linux内核注册一个模块卸载函数,参数xxx_exit就是需要注册的具体函数,当使用“rmmod”命令卸载具体驱动的时候xxx_exit函数就会被调用。字符设备驱动模块加载和卸载模板如下所示:
示例代码21.2.1.1 字符设备驱动模块加载和卸载函数模板
- 1 /* 驱动入口函数 */
- 2 static int __init xxx_init(void)
- 3 {
- 4 /* 入口函数具体内容 */
- 5 return 0;
- 6 }
- 7
- 8 /* 驱动出口函数 */
- 9 static void __exit xxx_exit(void)
- 10 {
- 11 /* 出口函数具体内容 */
- 12 }
- 13
- 14 /* 将上面两个函数指定为驱动的入口和出口函数 */
- 15 module_init(xxx_init);
- 16 module_exit(xxx_exit);
第2行,定义了个名为xxx_init的驱动入口函数,并且使用了“__init”来修饰。
第9行,定义了个名为xxx_exit的驱动出口函数,并且使用了“__exit”来修饰。
第15行,调用函数module_init来声明xxx_init为驱动入口函数,当加载驱动的时候xxx_init函数就会被调用。
第16行,调用函数module_exit来声明xxx_exit为驱动出口函数,当卸载驱动的时候xxx_exit函数就会被调用。
驱动编译完成以后扩展名为.ko,有两种命令可以加载驱动模块:insmod和modprobe,insmod是最简单的模块加载命令,此命令用于加载指定的.ko模块,比如加载drv.ko这个驱动模块,命令如下:
insmod命令不能解决模块的依赖关系,比如drv.ko依赖first.ko这个模块,就必须先使用insmod命令加载first.ko这个模块,然后再加载drv.ko这个模块,但是modprobe就不会存在这个问题。modprobe会分析模块的依赖关系,然后将所有依赖的模块都加载到内核中,因此modprobe命令相比insmod要智能一些。modprobe命令主要智能在提供了模块的依赖性分析、错误检查、错误报告等功能,推荐使用modprobe命令来加载驱动。modprobe命令默认会去/lib/modules/ 目录中查找模块,比如本书使用的Linux kernel的版本号为4.14.0,因此modprobe命令默认会到/lib/modules/4.14.0这个目录中查找相应的驱动模块,一般自己制作的根文件系统中是不会有这个目录的,所以需要自己手动创建。
驱动模块的卸载使用命令“rmmod”即可,比如要卸载drv.ko,使用如下命令即可:
也可以使用“modprobe -r”命令卸载驱动,比如要卸载drv.ko,命令如下:
使用modprobe命令可以卸载掉驱动模块所依赖的其他模块,前提是这些依赖模块已经没有被其他模块所使用,否则就不能使用modprobe来卸载驱动模块。所以对于模块的卸载,还是推荐使用rmmod命令。
字符设备注册与注销
对于字符设备驱动而言,当驱动模块加载成功以后需要注册字符设备,同样,卸载驱动模块的时候也需要注销掉字符设备。字符设备的注册和注销函数原型如下所示:
- 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函数用于注册字符设备,此函数一共有三个参数,这三个参数的含义如下:
major:主设备号,Linux下每个设备都有一个设备号,设备号分为主设备号和次设备号两部分,关于设备号后面会详细讲解。
name:设备名字,指向一串字符串。
fops:结构体file_operations类型指针,指向设备的操作函数集合变量。
unregister_chrdev函数用于注销字符设备,此函数有两个参数,这两个参数含义如下:
major:要注销的设备对应的主设备号。
name:要注销的设备对应的设备名。
一般字符设备的注册在驱动模块的入口函数xxx_init中进行,字符设备的注销在驱动模块的出口函数xxx_exit中进行。字符设备的注册和注销示例代码内容如下所示:
示例代码21.2.2.1 加入字符设备注册和注销
- 1 static struct file_operations test_fops;
- 2
- 3 /* 驱动入口函数 */
- 4 static int __init xxx_init(void)
- 5 {
- 6 /* 入口函数具体内容 */
- 7 int retvalue = 0;
- 8
- 9 /* 注册字符设备驱动 */
- 10 retvalue = register_chrdev(200, "chrtest", &test_fops);
- 11 if(retvalue < 0){
- 12 /* 字符设备注册失败,自行处理 */
- 13 }
- 14 return 0;
- 15 }
- 16
- 17 /* 驱动出口函数 */
- 18 static void __exit xxx_exit(void)
- 19 {
- 20 /* 注销字符设备驱动 */
- 21 unregister_chrdev(200, "chrtest");
- 22 }
- 23
- 24 /* 将上面两个函数指定为驱动的入口和出口函数 */
- 25 module_init(xxx_init);
- 26 module_exit(xxx_exit);
第1行,定义了一个file_operations结构体变量test_fops,test_fops就是设备的操作函数集合,只是此时我们还没有初始化test_fops中的open、release等这些成员变量,所以这个操作函数集合还是空的。
第10行,调用函数register_chrdev注册字符设备,主设备号为200,设备名为“chrtest”,设备操作函数集合就是第1行定义的test_fops。要注意的一点就是,选择没有被使用的主设备号,输入命令“cat /proc/devices”可以查看当前已经被使用掉的设备号,如下图所示(限于篇幅原因,只展示一部分):
图 32.2.1查看当前设备
上图列出了当前系统中所有的字符设备和块设备,其中第1列就是设备对应的主设备号。200这个主设备号在我的开发板中并没有被使用,所以我这里就用了200这个主设备号。
第21行,调用函数unregister_chrdev注销主设备号为200的这个设备。
实现设备的具体操作函数
file_operations结构体就是设备的具体操作函数,在字符设备注册和注销的示例代码中我们定义了file_operations结构体类型的变量test_fops,但是还没对其进行初始化,也就是初始化其中的open、release、read和write等具体的设备操作函数。本小节我们就完成变量test_fops的初始化,设置好针对chrtest设备的操作函数。在初始化test_fops之前我们要分析一下需求,也就是要对chrtest这个设备进行哪些操作,只有确定了需求以后才知道我们应该实现哪些操作函数。假设对chrtest这个设备有如下两个要求:
1、能够对chrtest进行打开和关闭操作
设备打开和关系是最基本的要求,几乎所有的设备都得提供打开和关闭的功能。因此我们需要实现file_operations中的open和release这两个函数。
2、对chrtest进行读写操作
假设chrtest这个设备控制着一段缓冲区(内存),应用程序需要通过read和write这两个函数对chrtest的缓冲区进行读写操作,所以需要实现file_operations中的read和write这两个函数。
需求很清晰了,修改字符设备注册和注销的示例代码,在其中加入test_fops这个结构体变量的初始化操作,完成以后的内容如下所示:
示例代码21.2.3.1 加入设备操作函数
- 1 /* 打开设备 */
- 2 static int chrtest_open(struct inode *inode, struct file *filp)
- 3 {
- 4 /* 用户实现具体功能 */
- 5 return 0;
- 6 }
- 7
- 8 /* 从设备读取 */
- 9 static ssize_t chrtest_read(struct file *filp, char __user *buf, size_t cnt, loff_t *offt)
- 10 {
- 11 /* 用户实现具体功能 */
- 12 return 0;
- 13 }
- 14
- 15 /* 向设备写数据 */
- 16 static ssize_t chrtest_write(struct file *filp,
- const char __user *buf,
- size_t cnt, loff_t *offt)
- 17 {
- 18 /* 用户实现具体功能 */
- 19 return 0;
- 20 }
- 21
- 22 /* 关闭/释放设备 */
- 23 static int chrtest_release(struct inode *inode, struct file *filp)
- 24 {
- 25 /* 用户实现具体功能 */
- 26 return 0;
- 27 }
- 28
- 29 static struct file_operations test_fops = {
- 30 .owner = THIS_MODULE,
- 31 .open = chrtest_open,
- 32 .read = chrtest_read,
- 33 .write = chrtest_write,
- 34 .release = chrtest_release,
- 35 };
- 36
- 37 /* 驱动入口函数 */
- 38 static int __init xxx_init(void)
- 39 {
- 40 /* 入口函数具体内容 */
- 41 int retvalue = 0;
- 42
- 43 /* 注册字符设备驱动 */
- 44 retvalue = register_chrdev(200, "chrtest", &test_fops);
- 45 if(retvalue < 0){
- 46 /* 字符设备注册失败,自行处理 */
- 47 }
- 48 return 0;
- 49 }
- 50
- 51 /* 驱动出口函数 */
- 52 static void __exit xxx_exit(void)
- 53 {
- 54 /* 注销字符设备驱动 */
- 55 unregister_chrdev(200, "chrtest");
- 56 }
- 57
- 58 /* 将上面两个函数指定为驱动的入口和出口函数 */
- 59 module_init(xxx_init);
- 60 module_exit(xxx_exit);
在上面的示例代码中我们一开始编写了四个函数:chrtest_open、chrtest_read、chrtest_write和chrtest_release。这四个函数就是chrtest设备的open、read、write和release操作函数。第29行~35行初始化test_fops的open、read、write和release这四个成员变量。
添加LICENSE和作者信息
最后我们需要在驱动中加入LICENSE信息和作者信息,其中LICENSE是必须添加的,否则的话编译的时候会报错,作者信息可以添加也可以不添加。LICENSE和作者信息的添加使用如下两个函数:
- MODULE_LICENSE() //添加模块LICENSE信息
- MODULE_AUTHOR() //添加模块作者信息
最后给加入设备操作函数的示例代码加入LICENSE和作者信息,完成以后的内容如下:
示例代码21.2.4.1 字符设备驱动最终的模板
- 1 /* 打开设备 */
- 2 static int chrtest_open(struct inode *inode, struct file *filp)
- 3 {
- 4 /* 用户实现具体功能 */
- 5 return 0;
- 6 }
- ......
- 57
- 58 /* 将上面两个函数指定为驱动的入口和出口函数 */
- 59 module_init(xxx_init);
- 60 module_exit(xxx_exit);
- 61
- 62 MODULE_LICENSE("GPL");
- 63 MODULE_AUTHOR("alientek");
第62行,LICENSE采用GPL协议。
第63行,添加作者名字。
至此,字符设备驱动开发的完整步骤就讲解完了,而且也编写好了一个完整的字符设备驱动模板,以后字符设备驱动开发都可以在此模板上进行。
Linux设备号
设备号的组成
为了方便管理,Linux中每个设备都有一个设备号,设备号由主设备号和次设备号两部分组成,主设备号表示某一个具体的驱动,次设备号表示使用这个驱动的各个设备。Linux提供了一个名为dev_t的数据类型表示设备号,dev_t定义在文件include/linux/types.h里面,定义如下:
示例代码21.3.1.1 设备号dev_t
- 12 typedef __u32 __kernel_dev_t;
- ......
- 15 typedef __kernel_dev_t dev_t;
可以看出dev_t是__u32类型的,而__u32定义在文件include/uapi/asm-generic/int-ll64.h里面,定义如下:
示例代码21.3.1.2 __u32类型
- 26 typedef unsigned int __u32;
综上所述,dev_t其实就是unsigned int类型,是一个32位的数据类型。这32位的数据构成了主设备号和次设备号两部分,其中高12位为主设备号,低20位为次设备号。因此Linux系统中主设备号范围为0~4095,所以大家在选择主设备号的时候一定不要超过这个范围。在文件include/linux/kdev_t.h中提供了几个关于设备号的操作函数(本质是宏),如下所示:
示例代码21.3.1.3 设备号操作函数
- 7 #define MINORBITS 20
- 8 #define MINORMASK ((1U << MINORBITS) - 1)
- 9
- 10 #define MAJOR(dev) ((unsigned int) ((dev) >> MINORBITS))
- 11 #define MINOR(dev) ((unsigned int) ((dev) & MINORMASK))
- 12 #define MKDEV(ma,mi) (((ma) << MINORBITS) | (mi))
第7行,宏MINORBITS表示次设备号位数,一共是20位。
第8行,宏MINORMASK表示次设备号掩码。
第10行,宏MAJOR用于从dev_t中获取主设备号,将dev_t右移20位即可。
第11行,宏MINOR用于从dev_t中获取次设备号,取dev_t的低20位的值即可。
第12行,宏MKDEV用于将给定的主设备号和次设备号的值组合成dev_t类型的设备号。
设备号的分配
1、静态分配设备号
本小节讲的设备号分配主要是主设备号的分配。前面讲解字符设备驱动的时候说过了,注册字符设备的时候需要给设备指定一个设备号,这个设备号可以是驱动开发者静态的指定一个设备号,比如选择200这个主设备号。有一些常用的设备号已经被Linux内核开发者给分配掉了,具体分配的内容可以查看文档Documentation/devices.txt。并不是说内核开发者已经分配掉的主设备号我们就不能用了,具体能不能用还得看我们的硬件平台运行过程中有没有使用这个主设备号,使用“cat /proc/devices”命令即可查看当前系统中所有已经使用了的设备号。
2、动态分配设备号
静态分配设备号需要我们检查当前系统中所有被使用了的设备号,然后挑选一个没有使用的。而且静态分配设备号很容易带来冲突问题,Linux社区推荐使用动态分配设备号,在注册字符设备之前先申请一个设备号,系统会自动给你一个没有被使用的设备号,这样就避免了冲突。卸载驱动的时候释放掉这个设备号即可,设备号的申请函数如下:
- int alloc_chrdev_region(dev_t *dev, unsigned baseminor, unsigned count, const char *name)
函数alloc_chrdev_region用于申请设备号,此函数有4个参数:
dev:保存申请到的设备号。
baseminor:次设备号起始地址,alloc_chrdev_region可以申请一段连续的多个设备号,这些设备号的主设备号一样,但是次设备号不同,次设备号以baseminor为起始地址并逐次递增。一般baseminor为0,也就是说次设备号从0开始。
count:要申请的设备号数量。
name:设备名字。
注销字符设备之后要释放掉设备号,设备号释放函数如下:
void unregister_chrdev_region(dev_t from, unsigned count)
此函数有两个参数:
from:要释放的设备号。
count:表示从from开始,要释放的设备号数量。
chrdevbase字符设备驱动开发实验
字符设备驱动开发的基本步骤我们已经了解了,本节我们就以chrdevbase这个虚拟设备为例,完整的编写一个字符设备驱动模块。chrdevbase不是实际存在的一个设备,是笔者为了方便讲解字符设备的开发而引入的一个虚拟设备。chrdevbase设备有两个缓冲区,一个为读缓冲区,一个为写缓冲区,这两个缓冲区的大小都为100字节。在应用程序中可以向chrdevbase设备的写缓冲区中写入数据,从读缓冲区中读取数据。chrdevbase这个虚拟设备的功能很简单,但是它包含了字符设备的最基本功能。
实验程序编写
本实验对应的例程路径为(以7010的核心板为例):ZYNQ开发板光盘资料(A盘)4_SourceCodeZYNQ_70103_Embedded_LinuxLinux驱动例程1_chrdevbase。
应用程序调用open函数打开chrdevbase这个设备,打开以后可以使用write函数向chrdevbase的写缓冲区writebuf中写入数据(不超过100个字节),也可以使用read函数读取读缓冲区readbuf中的数据操作,操作完成以后应用程序使用close函数关闭chrdevbase设备。
1、创建工程
在Ubuntu中创建一个目录用来存放Linux驱动程序,比如我在/home/zynq/linux目录下创建了一个名为drivers的目录来存放所有的Linux驱动。在drivers目录下新建一个名为1_chrdevbase的子目录来存放本实验所有文件,如下图所示:
图 32.4.1 linux驱动目录
2、编写实验程序
工程建立好以后就可以开始编写驱动程序了,在1_chrdevbase目录下新建的chrdevbase.c源文件,打开该文件里面输入如下内容,关于在Ubuntu下编写代码,笔者一直喜欢用vim和Windows下的Notepad++软件,当然每个人都有自己喜欢的开发方式,看个人了!
示例代码21.4.1.1 chrdevbase.c文件
- 1 #include
- 2 #include
- 3 #include
- 4 #include
- 5 #include
- 6 #include
- 7 /***************************************************************
- 8 Copyright © ALIENTEK Co., Ltd. 1998-2029. All rights reserved.
- 9 文件名 : chrdevbase.c
- 10 作者 : 正点原子
- 11 版本 : V1.0
- 12 描述 : chrdevbase驱动文件。
- 13 其他 : 无
- 14 论坛 : www.openedv.com
- 15 日志 : 初版V1.0 2019/1/30 左忠凯创建
- 16 ***************************************************************/
- 17
- 18 #define CHRDEVBASE_MAJOR 200 // 主设备号
- 19 #define CHRDEVBASE_NAME "chrdevbase" // 设备名
- 20
- 21 static char readbuf[100]; // 读缓冲区
- 22 static char writebuf[100]; // 写缓冲区
- 23 static char kerneldata[] = {"kernel data!"};
- 24
- 25 /*
- 26 * @description : 打开设备
- 27 * @param – inode : 传递给驱动的inode
- 28 * @param - filp : 设备文件,file结构体有个叫做private_data的成员变量
- 29 * 一般在open的时候将private_data指向设备结构体。
- 30 * @Return : 0 成功;其他 失败
- 31 */
- 32 static int chrdevbase_open(struct inode *inode, struct file *filp)
- 33 {
- 34 //printk("chrdevbase open!rn");
- 35 return 0;
- 36 }
- 37
- 38 /*
- 39 * @description : 从设备读取数据
- 40 * @param - filp : 要打开的设备文件(文件描述符)
- 41 * @param - buf : 返回给用户空间的数据缓冲区
- 42 * @param - cnt : 要读取的数据长度
- 43 * @param - offt : 相对于文件首地址的偏移
- 44 * @return : 读取的字节数,如果为负值,表示读取失败
- 45 */
- 46 static ssize_t chrdevbase_read(struct file *filp, char __user *buf, size_t cnt, loff_t *offt)
- 47 {
- 48 int retvalue = 0;
- 49
- 50 /* 向用户空间发送数据 */
- 51 memcpy(readbuf, kerneldata, sizeof(kerneldata));
- 52 retvalue = copy_to_user(buf, readbuf, cnt);
- 53 if(retvalue == 0){
- 54 printk("kernel senddata ok!rn");
- 55 }else{
- 56 printk("kernel senddata failed!rn");
- 57 }
- 58
- 59 //printk("chrdevbase read!rn");
- 60 return 0;
- 61 }
- 62
- 63 /*
- 64 * @description : 向设备写数据
- 65 * @param - filp : 设备文件,表示打开的文件描述符
- 66 * @param - buf : 要写给设备写入的数据
- 67 * @param - cnt : 要写入的数据长度
- 68 * @param - offt : 相对于文件首地址的偏移
- 69 * @return : 写入的字节数,如果为负值,表示写入失败
- 70 */
- 71 static ssize_t chrdevbase_write(struct file *filp, const char __user *buf, size_t cnt, loff_t *offt)
- 72 {
- 73 int retvalue = 0;
- 74 /* 接收用户空间传递给内核的数据并且打印出来 */
- 75 retvalue = copy_from_user(writebuf, buf, cnt);
- 76 if(retvalue == 0){
- 77 printk("kernel recevdata:%srn", writebuf);
- 78 }else{
- 79 printk("kernel recevdata failed!rn");
- 80 }
- 81
- 82 //printk("chrdevbase write!rn");
- 83 return 0;
- 84 }
- 85
- 86 /*
- 87 * @description : 关闭/释放设备
- 88 * @param - filp : 要关闭的设备文件(文件描述符)
- 89 * @return : 0 成功;其他 失败
- 90 */
- 91 static int chrdevbase_release(struct inode *inode, struct file *filp)
- 92 {
- 93 //printk("chrdevbase release!rn");
- 94 return 0;
- 95 }
- 96
- 97 /*
- 98 * 设备操作函数结构体
- 99 */
- 100 static struct file_operations chrdevbase_fops = {
- 101 .owner = THIS_MODULE,
- 102 .open = chrdevbase_open,
- 103 .read = chrdevbase_read,
- 104 .write = chrdevbase_write,
- 105 .release = chrdevbase_release,
- 106 };
- 107
- 108 /*
- 109 * @description : 驱动入口函数
- 110 * @param : 无
- 111 * @return : 0 成功;其他 失败
- 112 */
- 113 static int __init chrdevbase_init(void)
- 114 {
- 115 int retvalue = 0;
- 116
- 117 /* 注册字符设备驱动 */
- 118 retvalue = register_chrdev(CHRDEVBASE_MAJOR, CHRDEVBASE_NAME, &chrdevbase_fops);
- 119 if(retvalue < 0){
- 120 printk("chrdevbase driver register failedrn");
- 121 }
- 122 printk("chrdevbase_init()rn");
- 123 return 0;
- 124 }
- 125
- 126 /*
- 127 * @description : 驱动出口函数
- 128 * @param : 无
- 129 * @return : 无
- 130 */
- 131 static void __exit chrdevbase_exit(void)
- 132 {
- 133 /* 注销字符设备驱动 */
- 134 unregister_chrdev(CHRDEVBASE_MAJOR, CHRDEVBASE_NAME);
- 135 printk("chrdevbase_exit()rn");
- 136 }
- 137
- 138 /*
- 139 * 将上面两个函数指定为驱动的入口和出口函数
- 140 */
- 141 module_init(chrdevbase_init);
- 142 module_exit(chrdevbase_exit);
- 143
- 144 /*
- 145 * LICENSE和作者信息
- 146 */
- 147 MODULE_LICENSE("GPL");
- 148 MODULE_AUTHOR("alientek");
第32~36行,chrdevbase_open函数,当应用程序调用open函数的时候此函数就会调用,本例程中我们没有做任何工作,只是输出一串字符,用于调试。这里使用了printk来输出信息,而不是printf。因为在Linux内核中没有printf这个函数。printk相当于printf的孪生兄妹,printf运行在用户态,printk运行在内核态。在内核中想要向控制台输出或显示一些内容,必须使用printk这个函数。不同之处在于,printk可以根据日志级别对消息进行分类,一共有8个消息级别,这8个消息级别定义在文件include/linux/kern_levels.h里面,定义如下:
- #define KERN_SOH " 01" /* ASCII Start Of Header */
- #define KERN_SOH_ASCII '
|