【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

相关文章

Java学习手册之Filter和Listener使用方法

《Java学习手册之Filter和Listener使用方法》:本文主要介绍Java学习手册之Filter和Listener使用方法的相关资料,Filter是一种拦截器,可以在请求到达Servl... 目录一、Filter(过滤器)1. Filter 的工作原理2. Filter 的配置与使用二、Listen

usb接口驱动异常问题常用解决方案

《usb接口驱动异常问题常用解决方案》当遇到USB接口驱动异常时,可以通过多种方法来解决,其中主要就包括重装USB控制器、禁用USB选择性暂停设置、更新或安装新的主板驱动等... usb接口驱动异常怎么办,USB接口驱动异常是常见问题,通常由驱动损坏、系统更新冲突、硬件故障或电源管理设置导致。以下是常用解决

Linux命令之firewalld的用法

《Linux命令之firewalld的用法》:本文主要介绍Linux命令之firewalld的用法,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教... 目录linux命令之firewalld1、程序包2、启动firewalld3、配置文件4、firewalld规则定义的九大

Linux之计划任务和调度命令at/cron详解

《Linux之计划任务和调度命令at/cron详解》:本文主要介绍Linux之计划任务和调度命令at/cron的使用,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教... 目录linux计划任务和调度命令at/cron一、计划任务二、命令{at}介绍三、命令语法及功能 :at

Linux下如何使用C++获取硬件信息

《Linux下如何使用C++获取硬件信息》这篇文章主要为大家详细介绍了如何使用C++实现获取CPU,主板,磁盘,BIOS信息等硬件信息,文中的示例代码讲解详细,感兴趣的小伙伴可以了解下... 目录方法获取CPU信息:读取"/proc/cpuinfo"文件获取磁盘信息:读取"/proc/diskstats"文

Linux内核参数配置与验证详细指南

《Linux内核参数配置与验证详细指南》在Linux系统运维和性能优化中,内核参数(sysctl)的配置至关重要,本文主要来聊聊如何配置与验证这些Linux内核参数,希望对大家有一定的帮助... 目录1. 引言2. 内核参数的作用3. 如何设置内核参数3.1 临时设置(重启失效)3.2 永久设置(重启仍生效

kali linux 无法登录root的问题及解决方法

《kalilinux无法登录root的问题及解决方法》:本文主要介绍kalilinux无法登录root的问题及解决方法,本文给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,... 目录kali linux 无法登录root1、问题描述1.1、本地登录root1.2、ssh远程登录root2、

Linux ls命令操作详解

《Linuxls命令操作详解》通过ls命令,我们可以查看指定目录下的文件和子目录,并结合不同的选项获取详细的文件信息,如权限、大小、修改时间等,:本文主要介绍Linuxls命令详解,需要的朋友可... 目录1. 命令简介2. 命令的基本语法和用法2.1 语法格式2.2 使用示例2.2.1 列出当前目录下的文

Linux中的计划任务(crontab)使用方式

《Linux中的计划任务(crontab)使用方式》:本文主要介绍Linux中的计划任务(crontab)使用方式,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教... 目录一、前言1、linux的起源与发展2、什么是计划任务(crontab)二、crontab基础1、cro

Linux换行符的使用方法详解

《Linux换行符的使用方法详解》本文介绍了Linux中常用的换行符LF及其在文件中的表示,展示了如何使用sed命令替换换行符,并列举了与换行符处理相关的Linux命令,通过代码讲解的非常详细,需要的... 目录简介检测文件中的换行符使用 cat -A 查看换行符使用 od -c 检查字符换行符格式转换将