【Linux驱动层】iTOP-RK3568学习之路(三):字符设备驱动框架

2024-04-22 00:04

本文主要是介绍【Linux驱动层】iTOP-RK3568学习之路(三):字符设备驱动框架,希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!


一、总体框架图


在这里插入图片描述


二、字符设备相关函数


静态申请设备号 register_chrdev_region

函数原型:register_chrdev_region(dev_t from, unsigned count, const char *name)
函数作用:静态申请设备号,可以一次性申请多个连续的号,count指定申请的个数,from指定起始的设备号
参数含义:from: 自定义的 dev_t 类型设备号count: 申请设备的数量name: 申请的设备名称
函数返回值:申请成功返回 0,申请失败返回负数

动态申请设备号 alloc_chrdev_region

函数原型:alloc_chrdev_region(dev_t *dev, unsigned baseminor, unsigned count,const char *name)
函数作用:动态申请设备号,可以一次性申请多个连续的号,count指定申请的个数,baseminor指定起始的次设备号,相较于静态申请设备号,动态申请会避免注册设备号相同引发冲突的问题。
参数含义:dev: 分配得到的第一个设备号baseminor: 次设备号可申请的最小值,我一般写0count: 申请设备的数量name: 申请的设备名称
函数返回值:申请成功返回 0,申请失败返回负数
ps: dev2.dev_num = dev1.dev_num + 1        

字符设备初始化 cdev_init


cdev 结构体

struct cdev {struct kobject kobj; 		//内嵌的内核对象. struct module *owner; 		//该字符设备所在的内核模块的对象指针. const struct file_operations *ops; //该结构描述了字符设备所能实现的方法,是极为关键的一个结构体.struct list_head list; 		//用来将已经向内核注册的所有字符设备形成链表. dev_t dev; 					//字符设备的设备号,由主设备号和次设备号构成. unsigned int count; 		//隶属于同一主设备号的次设备号的个数. 
};

cdev_init在“内核源码/include/fs/char_dev.c文件中定义

void cdev_init(struct cdev *cdev, const struct file_operations *fops)
{memset(cdev, 0, sizeof *cdev);		//将整个结构体清零;INIT_LIST_HEAD(&cdev->list);		//初始化 list 成员使其指向自身;kobject_init(&cdev->kobj, &ktype_cdev_default);		//初始化 kobj 成员;cdev->ops = fops;					//初始化 ops 成员,建立 cdev 和 file_operations 之间的连接
}

void cdev_init(struct cdev *, const struct file_operations *);
函数作用:初始化传入的 cdev 类型的结构体,并与自定义的 file_operations * 类型的结构体进行链接。
参数含义:cdev: 要传入的 cdev 类型结构体,为要初始化的字符设备。fops:要传入的 file_operations * 类型结构体,关于 file_operations 结构体的相关的知识会在下一章节进行讲解。
函数返回值:无返回值。

字符设备的注册 cdev_add


函数原型:int cdev_add(struct cdev *p, dev_t dev, unsigned count)
函数作用:该函数向内核注册一个 struct cdev 结构体
参数含义:(1)第一个参数为要添加的 struct cdev 类型的结构体(2)第二个参数为申请的字符设备号(3)第三个参数为和该设备关联的设备编号的数量。
函数返回值:添加成功返回 0,添加失败返回负数。

字符设备的注销 cdev_del


函数原型:void cdev_del(struct cdev *p);
函数作用:该函数会向内核删除一个 struct cdev 类型结构体
参数含义:该函数只有一个参数,为要删除的 struct cdev 类型的结构体
函数返回值:无返回值

手动创建设备节点

原型:mknod NAME TYPE MAJOR MINOR
参数含义:NAME: 要创建的节点名称TYPE: b 表示块设备,c 表示字符设备,p 表示管道MAJOR:要链接设备的主设备号MINOR: 要链接设备的从设备号

例如,使用以下命令创建一个名为 device_test 的字符设备节点,链接设备的主设备号和从设备号分别为 236 和 0:

 mknod /dev/device_test c 236 0

class_create(…)函数

函数原型:#define class_create(owner, name) ({ static struct lock_class_key __key; __class_create(owner, name, &__key); })函数作用:用于动态创建设备的逻辑类,并完成部分字段的初始化,然后将其添加进 Linux 内核系统。
参数含义:owner:struct module 结构体类型的指针,指向函数即将创建的这个 struct class 的模块。一般赋值为 THIS_MODULE。
name:char 类型的指针,代表即将创建的 struct class 变量的名字。
返回值:struct class * 类型的结构体。

class_destroy(…)函数

函数原型:extern void class_destroy(struct class *cls);
函数作用:用于删除设备的逻辑类,即从 Linux 内核系统中删除设备的逻辑类。
参数含义:cls:代表即将要删除的 struct class 变量的名字。
返回值:无

device_create(…)函数

函数原型:
struct device *device_create(struct class *cls, struct device *parent, dev_t devt, void *drvdata, const char *fmt, ...);函数作用:用来在 class 类中下创建一个设备属性文件,udev 会自动识别从而进行设备节点的创建。
参数含义:cls:指定所要创建的设备所从属的类。parent:指定该设备的父设备,如果没有就指定为 NULL。devt:指定创建设备的设备号。drvdata:被添加到该设备回调的数据,没有则指定为 NULL。fmt:添加到系统的设备节点名称。
返回值:struct device * 类型结构体

device_destroy(…)函数

函数原型:extern void device_destroy(struct class *cls, dev_t devt);
函数作用:用来删除 class 类中的设备属性文件,udev 会自动识别从而进行设备节点的删除。
参数含义:cls:指定所要创建的设备所从属的类。devt:指定创建设备的设备号。
返回值:无

container_of 函数

函数原型:container_of(ptr,type,member);
函数作用:通过结构体变量中某个成员的首地址获取到整个结构体变量的首地址。
参数含义:ptr 是结构体变量中某个成员的地址。type 是结构体的类型member 是该结构体变量的具体名字
container_of 宏的作用是通过结构体内某个成员变量的地址和该变量名,以及结构体类型。找到该结构体变量的地址。

三、实例代码


file.c

#include <linux/module.h>
#include <linux/init.h>
#include <linux/moduleparam.h>
#include <linux/fs.h>
#include <linux/kdev_t.h>
#include <linux/cdev.h>
#include <linux/device.h>
#include <linux/uaccess.h>struct device_test{int major;                  // 主设备号int minor;                  // 次设备号dev_t dev_num;              // 用来一个32位无符号整形的设备号struct cdev cdev_test;      // 定义一个字符设备的cdev结构体struct class *class;        // 类struct device *device;      // 设备文件char kbuf[32];
};struct device_test dev1;        // 定义一个设备文件结构体static int cdev_test_open(struct inode * inode, struct file * file){file->private_data = &dev1;     // 设置私有数据printk("This is cdev_test_open!\n");return 0;
}static ssize_t cdev_test_read(struct file * file, char __user *buf, size_t size, loff_t *off){struct device_test *temp_dev = (struct device_test *)file->private_data;// strcpy(temp_dev->kbuf, "This is cdev_test_read!")   //模拟内核空间数据// copy_to_user 成功返回0,失败返回没有拷贝成功的数据字节数if(copy_to_user(buf, temp_dev->kbuf, strlen(temp_dev->kbuf)) != 0){printk("copy_to_user error\r\n"); //打印 copy_to_user 函数执行失败return -1;}printk("This is cdev_test_read!\n");return 0;
}static ssize_t cdev_test_write(struct file * file, const char __user * buf, size_t size, loff_t *off){struct device_test *temp_dev = (struct device_test *)file->private_data;if(copy_from_user(temp_dev->kbuf, buf, size) != 0){   // copy_from_user:用户空间向内核空间传数据printk("copy_from_user error\r\n");//打印 copy_from_user 函数执行失败return -1;}printk("This is cdev_test_write!\n");printk("kbuf is %s! \n", temp_dev->kbuf);return 0;
}static int cdev_test_release(struct inode * inode, struct file * file){printk("This is cdev_test_release!\n");return 0;
}struct file_operations cdev_test_ops={.owner = THIS_MODULE,    // 文件操作结构体.open = cdev_test_open,.read = cdev_test_read,.write = cdev_test_write,.release = cdev_test_release,
};static int chardev_init(void){int ret;     //返回值判断// 动态注册一个设备号,成功返回0,失败返回复数ret = alloc_chrdev_region(&dev1.dev_num, 0, 1, "char_devname");if(ret < 0){printk("动态注册设备号失败!\n");goto err_alloc;}printk("动态注册设备号成功!\n");dev1.major = MAJOR(dev1.dev_num);     //通过 MAJOR()函数进行主设备号获取dev1.minor = MINOR(dev1.dev_num);     //通过 MINOR()函数进行次设备号获取printk("major = %d!\n",dev1.major);printk("minor = %d!\n",dev1.minor);cdev_init(&dev1.cdev_test, &cdev_test_ops);  //初始化字符设备结构体cdev_test,并连接到文件操作结构体cdev_test_opsdev1.cdev_test.owner = THIS_MODULE;ret = cdev_add(&dev1.cdev_test, dev1.dev_num, 1); //使用cdev_add()函数进行字符设备的添加。if(ret < 0){printk("字符设备注册失败!\n");goto err_cdev_add;}printk("字符设备注册成功!\n");dev1.class = class_create(THIS_MODULE, "class");   // 初始化class_createif(IS_ERR(dev1.class)){ret = PTR_ERR(dev1.class);goto err_class_create;}dev1.device = device_create(dev1.class, NULL, dev1.dev_num, NULL, "device"); //if(IS_ERR(dev1.device)){ret = PTR_ERR(dev1.device);goto err_device_create;}err_device_create:class_destroy(dev1.class);      //设备节点建立失败,删除类err_class_create:cdev_del(&dev1.cdev_test);      //类创建失败,删除设备cdeverr_cdev_add:unregister_chrdev_region(dev1.dev_num, 1);  //注册设备失败,释放设备号err_alloc:return ret;     //申请设备号失败,返回return 0;
}static void chardev_exit(void){//先删除字符设备cdev_del(&dev1.cdev_test);//再释放字符驱动设备号unregister_chrdev_region(dev1.dev_num, 1);//删除创建的设备device_destroy(dev1.class, dev1.dev_num);//删除创建的类class_destroy(dev1.class);printk("chardev_exit!\n");
}module_init(chardev_init);
module_exit(chardev_exit);MODULE_LICENSE("GPL v2");
MODULE_AUTHOR("ZSY");
MODULE_VERSION("V1.0");

Makefile

# 只对当前终端有效
export ARCH=arm64
export CROSS_COMPILE=/home/topeet/source/linux/rk356x_linux/prebuilts/gcc/linux-x86/aarch64/gcc-linaro-6.3.1-2017.05-x86_64_aarch64-linux-gnu/bin/aarch64-linux-gnu-obj-m += file.o
KDIR := /home/topeet/source/linux/rk356x_linux/kernel
PWD ?= $(shell pwd)
all:make -C $(KDIR) M=$(PWD) modules
clean:make -C $(KDIR) M=$(PWD) clean #make clean 操作 

app.c

#include <stdio.h>
#include <sys/types.h>
#include <sys/stat.h>
#include <fcntl.h>
#include <unistd.h>int main(int argc, char *argv[]){int fd;char buf1[32] = {0};        // 定义读写缓存区buf1char buf2[32] = "nihao!";   // 定义读写缓存区buf2fd = open("/dev/device",O_RDWR);   // 打开字符设备驱动文件"device_test"if(fd < 0){perror("open error \n");return fd;}// read(fd, buf1, sizeof(buf1));// printf("buf1 is %s! \n", buf1);write(fd, buf2,sizeof(buf2));close(fd);return 0;
}



这篇关于【Linux驱动层】iTOP-RK3568学习之路(三):字符设备驱动框架的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!



http://www.chinasem.cn/article/924364

相关文章

Linux join命令的使用及说明

《Linuxjoin命令的使用及说明》`join`命令用于在Linux中按字段将两个文件进行连接,类似于SQL的JOIN,它需要两个文件按用于匹配的字段排序,并且第一个文件的换行符必须是LF,`jo... 目录一. 基本语法二. 数据准备三. 指定文件的连接key四.-a输出指定文件的所有行五.-o指定输出

Linux jq命令的使用解读

《Linuxjq命令的使用解读》jq是一个强大的命令行工具,用于处理JSON数据,它可以用来查看、过滤、修改、格式化JSON数据,通过使用各种选项和过滤器,可以实现复杂的JSON处理任务... 目录一. 简介二. 选项2.1.2.2-c2.3-r2.4-R三. 字段提取3.1 普通字段3.2 数组字段四.

Linux kill正在执行的后台任务 kill进程组使用详解

《Linuxkill正在执行的后台任务kill进程组使用详解》文章介绍了两个脚本的功能和区别,以及执行这些脚本时遇到的进程管理问题,通过查看进程树、使用`kill`命令和`lsof`命令,分析了子... 目录零. 用到的命令一. 待执行的脚本二. 执行含子进程的脚本,并kill2.1 进程查看2.2 遇到的

Linux云服务器手动配置DNS的方法步骤

《Linux云服务器手动配置DNS的方法步骤》在Linux云服务器上手动配置DNS(域名系统)是确保服务器能够正常解析域名的重要步骤,以下是详细的配置方法,包括系统文件的修改和常见问题的解决方案,需要... 目录1. 为什么需要手动配置 DNS?2. 手动配置 DNS 的方法方法 1:修改 /etc/res

Linux创建服务使用systemctl管理详解

《Linux创建服务使用systemctl管理详解》文章指导在Linux中创建systemd服务,设置文件权限为所有者读写、其他只读,重新加载配置,启动服务并检查状态,确保服务正常运行,关键步骤包括权... 目录创建服务 /usr/lib/systemd/system/设置服务文件权限:所有者读写js,其他

Linux下利用select实现串口数据读取过程

《Linux下利用select实现串口数据读取过程》文章介绍Linux中使用select、poll或epoll实现串口数据读取,通过I/O多路复用机制在数据到达时触发读取,避免持续轮询,示例代码展示设... 目录示例代码(使用select实现)代码解释总结在 linux 系统里,我们可以借助 select、

Linux挂载linux/Windows共享目录实现方式

《Linux挂载linux/Windows共享目录实现方式》:本文主要介绍Linux挂载linux/Windows共享目录实现方式,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地... 目录文件共享协议linux环境作为服务端(NFS)在服务器端安装 NFS创建要共享的目录修改 NFS 配

linux系统中java的cacerts的优先级详解

《linux系统中java的cacerts的优先级详解》文章讲解了Java信任库(cacerts)的优先级与管理方式,指出JDK自带的cacerts默认优先级更高,系统级cacerts需手动同步或显式... 目录Java 默认使用哪个?如何检查当前使用的信任库?简要了解Java的信任库总结了解 Java 信

Linux命令rm如何删除名字以“-”开头的文件

《Linux命令rm如何删除名字以“-”开头的文件》Linux中,命令的解析机制非常灵活,它会根据命令的开头字符来判断是否需要执行命令选项,对于文件操作命令(如rm、ls等),系统默认会将命令开头的某... 目录先搞懂:为啥“-”开头的文件删不掉?两种超简单的删除方法(小白也能学会)方法1:用“--”分隔命

Java 缓存框架 Caffeine 应用场景解析

《Java缓存框架Caffeine应用场景解析》文章介绍Caffeine作为高性能Java本地缓存框架,基于W-TinyLFU算法,支持异步加载、灵活过期策略、内存安全机制及统计监控,重点解析其... 目录一、Caffeine 简介1. 框架概述1.1 Caffeine的核心优势二、Caffeine 基础2