1、字符设备注册与注销的函数原型”
/*字符设备注册的函数原型*/
static inline int register_chrdev(unsigned int major,\
const char *name, \
const struct file_operations *fops)
/*
major:主设备号，Limnux下每个设备都有一个设备号，设备号分为主设备号和次设备号两部分。
name:设备名字，指向一串字符串。
fops:结构体file_operations类型指针，指向设备的操作函数集合变量。
*/
/*字符设备注销的函数原型*/
static inline void unregister_chrdev(unsigned int major,\
const char *name)
/*
major:主设备号，Limnux下每个设备都有一个设备号，设备号分为主设备号和次设备号两部分。
name:设备名字，指向一串字符串。
*/
2、Linux设备号
1)、使用设备号的原因：为了方便管理，Linux 中每个设备都有一个设备号。
2)、设备号的组成
Linux设备号是由主设备号和次设备号两部分组成；
主设备号表示某一个具体的驱动；
次设备号表示使用这个驱动的各个设备。
Linux使用“dev_t的数据类型”表示设备号;
“dev_t的数据类型”定义在文件“include/linux/types.h”里面，定义如下：
typedef __u32 __kernel_dev_t;
//为“__u32”起个别名叫“__kernel_dev_t”
typedef __kernel_dev_t dev_t;
//为“__kernel_dev_t”起个别名叫“dev_t”
由此可见，dev_t是 umsigned int类型，是一个32位的数据类型。这个32位的数据就是Linux设备号，它是由“主设备号”和“次设备号”两部分构成，其中高12位为“主设备号”，低20位为“次设备号”。因此，Linux系统中主设备号范围为0~4095，所以，大家在选择主设备号的时候一定不要超过这个范围。
在文件“include/linux/kdev_t.h”中提供了几个关于设备号的操作函数(本质是宏)，如下所示:
#define MINORBITS 20 //定义“次设备号”占据低20位
#define MINORMASK ((1U << MINORBITS) - 1) //定义“次设备号”的掩码值
#define MAJOR(dev) ((unsigned int) ((dev) >> MINORBITS))
//输入参数dev为“Linux设备号”
//将dev右移20位得到“主设备号”
#define MINOR(dev) ((unsigned int) ((dev) & MINORMASK))
//输入参数dev为“Linux设备号”
//将dev与0xFFFFF相与后得到“次设备号”
#define MKDEV(ma,mi) (((ma) << MINORBITS) | (mi))
//输入参数ma为“主设备号”
//输入参数mi为“次设备号”
//将ma左移20位，再与mi相或，就得到“Linux设备号”
设备号的申请函数
int alloc_chrdev_region(dev_t *dev,\
unsigned baseminor,\
unsigned count,\
const char *name)
//dev：保存申请到的设备号
//baseminor：次设备号的起始地址
//alloc_chrdev_region可以申请一段连续的多个“设备号”，这些“设备号”的“主设备号”是一样的，但是“次设备号”不同。“次设备号”以baseminor为起始值开始递增。通常baseminor的值为0。
//count：要申请的设备号数量；
// name：表示“设备名字”
设备号的释放函数
void unregister_chrdev_region(dev_t from, unsigned count)
// from：要释放的设备号；
// count：表示从from开始，要释放的设备号数量。
3、字符设备加载，注册，注销和卸载的一般模板
#define xxx_MAJOR 200
//定义主设备号
//静态分配设备号：在串口输入“cat/proc/devices”查询当前已用的主设备号
//然后使用一个“没有被使用的设备号”作为该设备的的主设备号
#define xxx_NAME "xxxName" //定义设备的名字。
const struct file_operations xxx_fops = {};
//声明一个file_operations结构变量
/*驱动入口函数 */
static int __init xxx_init(void)
{
int ret;
ret = register_chrdev(xxx_MAJOR, xxx_NAME, &xxx_fops);
//xxx_MAJOR为主设备号，采用宏xxx_NAME定义设备名字
//xxx_fops是设备的操作函数集合，它是file_operations结构变量
if (ret < 0) {
pr_err("xxx_init is failed!!!\r\n");
return ret;
}
else pr_err("xxx_init is ok!!!\r\n");
return 0;
}
/*驱动出口函数 */
static void __exit xxx_exit(void)
{
/*出口函数具体内容 */
unregister_chrdev(xxx_MAJOR, xxx_NAME);
//注销字符设备驱动
//xxx_MAJOR为主设备号，采用宏xxx_NAME定义设备名字
}
module_init(xxx_init); //声明xxx_init()为驱动入口函数
module_exit(xxx_exit); //声明xxx_exit()为驱动出口函数
打开虚拟机上“VSCode”，点击“文件”，点击“打开文件夹”，点击“zgq”，点击“linux”，点击“atk-mp1”，点击“linux”，点击“my_linux”，点击“linux-5.4.31”，见下图：
点击“确定”
点击“查看”，点击“搜索”，输入“register_chrdev”
假如我们点击的是“rtlx-cmp.c”，见下图：
“rtlx-cmp.c”程序如下：
#include <linux/device.h>
#include <linux/fs.h>
#include <linux/err.h>
#include <linux/wait.h>
#include <linux/sched.h>
#include <linux/smp.h>
#include <asm/mips_mt.h>
#include <asm/vpe.h>
#include <asm/rtlx.h>
static int major;//major:设备号
/*从字面意思看，是一个中断*/
static void rtlx_interrupt(void)
{
int i;
struct rtlx_info *info;
struct rtlx_info **p = vpe_get_shared(aprp_cpu_index());
if (p == NULL || *p == NULL)
return;
info = *p;
if (info->ap_int_pending == 1 && smp_processor_id() == 0) {
for (i = 0; i < RTLX_CHANNELS; i++) {
wake_up(&channel_wqs[i].lx_queue);
wake_up(&channel_wqs[i].rt_queue);
}
info->ap_int_pending = 0;
}
}
/*从字面看是讲中断堆栈指针*/
void _interrupt_sp(void)
{
smp_send_reschedule(aprp_cpu_index());
}
/*入口函数初始化*/
int __init rtlx_module_init(void)
{
struct device *dev;
int i, err;
if (!cpu_has_mipsmt) {
pr_warn("VPE loader: not a MIPS MT capable processor\n");
return -ENODEV;
}
if (num_possible_cpus() - aprp_cpu_index() < 1) {
pr_warn("No TCs reserved for AP/SP, not initializing RTLX.\n"
"Pass maxcpus=<n> argument as kernel argument\n");
return -ENODEV;
}
major = register_chrdev(0, RTLX_MODULE_NAME, &rtlx_fops);
//0为主设备号，采用宏RTLX_MODULE_NAME定义设备名字
//rtlx_fops是设备的操作函数集合，它是file_operations结构变量
if (major < 0) {//读取主设备号小于0，则打印错误信息
pr_err("rtlx_module_init: unable to register device\n");
return major;
}
/* initialise the wait queues */
for (i = 0; i < RTLX_CHANNELS; i++) {
init_waitqueue_head(&channel_wqs[i].rt_queue);
//初始化等待队列头
init_waitqueue_head(&channel_wqs[i].lx_queue);
//初始化等待队列头
atomic_set(&channel_wqs[i].in_open, 0);//状态重置
mutex_init(&channel_wqs[i].mutex);//初始化互斥体
dev = device_create(mt_class, NULL, MKDEV(major, i), NULL,
"%s%d", RTLX_MODULE_NAME, i);
//创建设备, major为主设备号,i为次设备号
//参数mt_class表示该设备位于mt_class类下面
// parent为NULL表示没有父设备
//将major左移20位，再与i相或，就得到“Linux设备号”
//drvdata为NULL表示没有使用设备文件
//采用RTLX_MODULE_NAME宏定义指向字符串表示设备名
if (IS_ERR(dev)) {
while (i--)
device_destroy(mt_class, MKDEV(major, i));
//删除创建的设备
//参数mt_class是设备所处的类，参数i是设备号
err = PTR_ERR(dev);
goto out_chrdev;
}
}
/* set up notifiers */
rtlx_notify.start = rtlx_starting;
rtlx_notify.stop = rtlx_stopping;
vpe_notify(aprp_cpu_index(), &rtlx_notify);
if (cpu_has_vint) {
aprp_hook = rtlx_interrupt;
} else {
pr_err("APRP RTLX init on non-vectored-interrupt processor\n");
err = -ENODEV;
goto out_class;
}
return 0;
out_class:
for (i = 0; i < RTLX_CHANNELS; i++)
device_destroy(mt_class, MKDEV(major, i));
//删除创建的设备
//参数mt_class是要删除的设备所处的类，参数i是要删除的设备号
out_chrdev:
unregister_chrdev(major, RTLX_MODULE_NAME);
//注销字符设备驱动
//major为主设备号，采用宏RTLX_MODULE_NAME定义设备
return err;
}
/*出口函数初始化*/
void __exit rtlx_module_exit(void)
{
int i;
for (i = 0; i < RTLX_CHANNELS; i++)
device_destroy(mt_class, MKDEV(major, i));
//删除创建的设备
//参数mt_class是要删除的设备所处的类，参数i是要删除的设备号
unregister_chrdev(major, RTLX_MODULE_NAME);
//注销字符设备驱动
//major为主设备号，采用宏RTLX_MODULE_NAME定义设备名字
aprp_hook = NULL;
}
5、编写“字符设备驱”动注册与注销的程序
1)、创建“/home/zgq/linux/Linux_Drivers/01_MyCharDevice/”目录
输入“cd /home/zgq/linux/Linux_Drivers/”
切换到“/home/zgq/linux/Linux_Drivers/”目录
输入“ls”，查询“/home/zgq/linux/Linux_Drivers/”目录下的文件和文件夹
输入“mkdir 01_MyCharDevice”
创建“/home/zgq/linux/Linux_Drivers/01_MyCharDevice/”目录
输入“ls”，查询“/home/zgq/linux/Linux_Drivers/”目录下的文件和文件夹
输入“cd 01_MyCharDevice/”
切换到“/home/zgq/linux/Linux_Drivers/01_MyCharDevice/”目录
输入“pwd”获取绝对路径
输入“cd /home/zgq/linux/Linux_Drivers/00_My_TestDriver/”
切换到“/home/zgq/linux/Linux_Drivers/00_My_TestDriver/”目录
输入“ls”，查询“/home/zgq/linux/Linux_Drivers/00_My_TestDriver/”目录下的文件和文件夹
输入“cp Makefile /home/zgq/linux/Linux_Drivers/01_MyCharDevice回车”
拷贝“Makefile”
2)、修改Makefile文件
Makefile文件内容如下：
KERNELDIR := /home/zgq/linux/atk-mp1/linux/my_linux/linux-5.4.31
#使用“:=”将其后面的字符串赋值给KERNELDIR
CURRENT_PATH := $(shell pwd)
#采用“shell pwd”获取当前打开的路径
#使用“$(变量名)”引用“变量的值”
obj-m := MyCharDevice.o
#生成“obj-m”需要依赖“MyCharDevice.o”
build: kernel_modules
#生成“build”需要依赖“kernel_modules”
@echo $(KERNELDIR)
#输出KERNELDIR的值为“/home/zgq/linux/atk-mp1/linux/linux-5.4.31”
@echo $(CURRENT_PATH)
#输出CURRENT_PATH的值为/home/zgq/linux/Linux_Drivers/00_My_TestDriver”
@echo $(MAKE)
#输出MAKE的值为make
kernel_modules:
$(MAKE) -C $(KERNELDIR) M=$(CURRENT_PATH) modules
#后面的"modules"表示编译成模块
#“KERNELDIR”上面定义为“/home/zgq/linux/atk-mp1/linux/my_linux/linux-5.4.31”，即“指定的工作目录”
#“CURRENT_PATH”上面定义为“当前的工作目录”
#“-C $(KERNELDIR) M=$(CURRENT_PATH) ”表示将“当前的工作目录”切换到“指定的目录”中
#即切换到“/home/zgq/linux/atk-mp1/linux/my_linux/linux-5.4.31”。
#M表示模块源码目录
#在“make和modules”之间加入“M=$(CURRENT_PATH)”，表示切换到由“CURRENT_PATH”指定的目录中读取源码，同时将其编>译为.ko 文件
clean:
$(MAKE) -C $(KERNELDIR) M=$(CURRENT_PATH) clean
#“KERNELDIR”上面定义为“/home/zgq/linux/atk-mp1/linux/my_linux/linux-5.4.31”，即“指定的工作目录”
#“CURRENT_PATH”上面定义为“当前的工作目录”
3)、使用VSCode创建“MyCharDevice.c”文件
添加内容如下：
#include <linux/init.h> //必须要包含的头文件
#include <linux/module.h> //必须要包含的头文件
#include <linux/string.h> //下面要用到字符串，显然也要包含
#include <linux/kernel.h> //必须要包含的头文件
#include <linux/device.h> //必须要包含的头文件
#include <linux/fs.h> //使能结构体"file_operations"
#define MyCharDevice_MAJOR 200
//定义主设备号
//可以通过串口输入“cat /proc/devices”查询当前已用的主设备号
#define MyCharDevice_NAME "MyCharDeviceName"
//使用MyCharDevice_NAME指向一串字符串表示设备的名字。
const struct file_operations MyCharDevice_fops = {};
//声明file_operations结构变量MyCharDevice_fops
//它是指向设备的操作函数集合变量
/*入口函数初始化*/
static int __init MyCharDevice_init(void)
{
int ret = 0;
printk("MyCharDevice_init\r\n");
ret = register_chrdev(MyCharDevice_MAJOR, MyCharDevice_NAME, &MyCharDevice_fops);
//主设备号为MyCharDevice_MAJOR
//设备名字为RTLX_MODULE_NAME宏定义
//MyCharDevice_fops是设备的操作函数集合
if (ret < 0) {
pr_err("MyCharDevice_init is failed!!!\r\n");
return ret;
}
else printk("ret=%d\r\n",ret);
return ret;
}
/*出口函数初始化*/
static void __exit MyCharDevice_exit(void)
{
printk("MyCharDevice_exit\r\n");
unregister_chrdev(MyCharDevice_MAJOR, MyCharDevice_NAME);
//主设备号为MyCharDevice_MAJOR的值
//设备名字为MyCharDevice_NAME宏定义的字符串“MyCharDeviceName”
}
module_init(MyCharDevice_init);
/*将MyCharDevice_init()指定为入口函数*/
module_exit(MyCharDevice_exit);
/*将MyCharDevice_exit()指定为出口函数*/
MODULE_AUTHOR("Zhanggong");//添加作者名字
MODULE_DESCRIPTION("This is test module!");//模块介绍
MODULE_LICENSE("GPL");//LICENSE采用“GPL协议”
MODULE_INFO(intree,"Y");
//去除显示“loading out-of-tree module taints kernel.”
4)、编译
输入“cd /home/zgq/linux/Linux_Drivers/01_MyCharDevice/”
输入“ls”
输入“sudo cp MyCharDevice.ko /home/zgq/linux/nfs/rootfs/lib/modules/5.4.31”
输入密码“123456回车”
输入“cd /home/zgq/linux/nfs/rootfs/lib/modules/5.4.31”
输入“ls”
5)、测试
启动开发板，从网络下载程序
输入“root”
输入“cd /lib/modules/5.4.31/”
在nfs挂载中，切换到“/lib/modules/5.4.31/”目录，
注意：“lib/modules/5.4.31/”在虚拟机中是位于“/home/zgq/linux/nfs/rootfs/”目录下，但在开发板中，却是位于根目录中。
输入“ls”
输入“depmod”,驱动在第一次执行时，需要运行“depmod”
输入“modprobe MyCharDevice.ko”，加载“MyCharDevice.ko”模块
输入“lsmod”查看有哪些驱动在工作
输入“rmmod MyCharDevice.ko”，卸载“MyCharDevice.ko”模块
注意:输入“rmmod MyCharDevice”也可以卸载“MyCharDevice.ko”模块
输入“lsmod”查看有哪些驱动在工作
输入“modprobe MyCharDevice.ko”，加载“MyCharDevice.ko”模块
输入“cat /proc/devices回车”查询设备号
