【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

相关文章

HarmonyOS学习(七)——UI(五)常用布局总结

自适应布局 1.1、线性布局(LinearLayout) 通过线性容器Row和Column实现线性布局。Column容器内的子组件按照垂直方向排列,Row组件中的子组件按照水平方向排列。 属性说明space通过space参数设置主轴上子组件的间距,达到各子组件在排列上的等间距效果alignItems设置子组件在交叉轴上的对齐方式,且在各类尺寸屏幕上表现一致,其中交叉轴为垂直时,取值为Vert

Ilya-AI分享的他在OpenAI学习到的15个提示工程技巧

Ilya(不是本人,claude AI)在社交媒体上分享了他在OpenAI学习到的15个Prompt撰写技巧。 以下是详细的内容: 提示精确化:在编写提示时,力求表达清晰准确。清楚地阐述任务需求和概念定义至关重要。例:不用"分析文本",而用"判断这段话的情感倾向:积极、消极还是中性"。 快速迭代:善于快速连续调整提示。熟练的提示工程师能够灵活地进行多轮优化。例:从"总结文章"到"用

【前端学习】AntV G6-08 深入图形与图形分组、自定义节点、节点动画(下)

【课程链接】 AntV G6:深入图形与图形分组、自定义节点、节点动画(下)_哔哩哔哩_bilibili 本章十吾老师讲解了一个复杂的自定义节点中,应该怎样去计算和绘制图形,如何给一个图形制作不间断的动画,以及在鼠标事件之后产生动画。(有点难,需要好好理解) <!DOCTYPE html><html><head><meta charset="UTF-8"><title>06

linux-基础知识3

打包和压缩 zip 安装zip软件包 yum -y install zip unzip 压缩打包命令: zip -q -r -d -u 压缩包文件名 目录和文件名列表 -q:不显示命令执行过程-r:递归处理,打包各级子目录和文件-u:把文件增加/替换到压缩包中-d:从压缩包中删除指定的文件 解压:unzip 压缩包名 打包文件 把压缩包从服务器下载到本地 把压缩包上传到服务器(zip

学习hash总结

2014/1/29/   最近刚开始学hash,名字很陌生,但是hash的思想却很熟悉,以前早就做过此类的题,但是不知道这就是hash思想而已,说白了hash就是一个映射,往往灵活利用数组的下标来实现算法,hash的作用:1、判重;2、统计次数;

Linux 网络编程 --- 应用层

一、自定义协议和序列化反序列化 代码: 序列化反序列化实现网络版本计算器 二、HTTP协议 1、谈两个简单的预备知识 https://www.baidu.com/ --- 域名 --- 域名解析 --- IP地址 http的端口号为80端口,https的端口号为443 url为统一资源定位符。CSDNhttps://mp.csdn.net/mp_blog/creation/editor

【Python编程】Linux创建虚拟环境并配置与notebook相连接

1.创建 使用 venv 创建虚拟环境。例如,在当前目录下创建一个名为 myenv 的虚拟环境: python3 -m venv myenv 2.激活 激活虚拟环境使其成为当前终端会话的活动环境。运行: source myenv/bin/activate 3.与notebook连接 在虚拟环境中,使用 pip 安装 Jupyter 和 ipykernel: pip instal

零基础学习Redis(10) -- zset类型命令使用

zset是有序集合,内部除了存储元素外,还会存储一个score,存储在zset中的元素会按照score的大小升序排列,不同元素的score可以重复,score相同的元素会按照元素的字典序排列。 1. zset常用命令 1.1 zadd  zadd key [NX | XX] [GT | LT]   [CH] [INCR] score member [score member ...]

【机器学习】高斯过程的基本概念和应用领域以及在python中的实例

引言 高斯过程(Gaussian Process,简称GP)是一种概率模型,用于描述一组随机变量的联合概率分布,其中任何一个有限维度的子集都具有高斯分布 文章目录 引言一、高斯过程1.1 基本定义1.1.1 随机过程1.1.2 高斯分布 1.2 高斯过程的特性1.2.1 联合高斯性1.2.2 均值函数1.2.3 协方差函数(或核函数) 1.3 核函数1.4 高斯过程回归(Gauss