Linux——驱动——杂项设备

一、杂项设备驱动

1、概念

     杂项设备（Miscellaneous Devices）在Linux内核中是一种特殊的设备类型，用于表示那些不适合被归类为其他标准设备类型的设备。这些设备通常具有不规则的特性和非标准的通信协议或接口。

2、操作流程

杂项设备注册过程

1. 寻找未使用的次设备号（可选）：
   • 当注册杂项设备时，如果调用者没有指定次设备号（即指定为MISC_DYNAMIC_MINOR），内核将自动在misc_minors数组中查找一个未使用的次设备号。这个数组用于跟踪哪些次设备号已经被占用。
   • 如果指定了次设备号，内核将检查该次设备号是否已被占用。
2. 将新的杂项设备挂在misc_list链表中：
   • 一旦找到了可用的次设备号（或者如果次设备号已经被指定且可用），内核就会将新的杂项设备添加到全局的misc_list链表中。这个链表包含了所有已注册的杂项设备。
3. 新建设备：
   • 内核会为新注册的杂项设备在/dev目录下创建一个设备节点（除非使用udev等动态设备管理系统）。设备节点的名称通常基于设备的名称或驱动程序提供的其他信息。
   • 设备的主设备号固定为10，次设备号是新分配的或指定的那个。

杂项设备调用过程

(1)应用程序打开杂项设备节点：

用户空间的应用程序通过标准的系统调用（如open()）打开/dev目录下的杂项设备节点。

(2)内核识别杂项设备：

当open()系统调用到达内核时，内核会根据设备的主设备号（10）识别出这是一个杂项设备。

(3)调用杂项设备的misc_open（实际上是fops->open）：

内核并不直接调用misc_open函数（因为这样的函数并不存在）。相反，它会根据杂项设备在misc_list链表中注册时提供的fops（即file_operations结构体）中的open函数指针来调用相应的打开函数。

这里的fops是设备操作函数集，包含了open、read、write、release等函数指针，分别对应于用户空间程序对设备的打开、读取、写入和关闭等操作。

(4)在misc_list链表中找出设备（实际上是通过次设备号进行匹配）：

虽然这里提到了在misc_list链表中找出设备，但实际上这个过程是在内核内部完成的，通常是通过inode结构体的i_rdev字段（它包含了设备的主设备号和次设备号）来匹配并找到对应的杂项设备。

(5)将设备的fops赋值给文件结构体struct file *file：

一旦找到了对应的杂项设备，内核就会将该设备的fops（即设备操作函数集）赋值给表示打开文件的struct file结构体中的f_op字段。这样，后续的用户空间操作（如读取、写入）就会通过这个f_op指针来调用相应的设备操作函数。

二、相关函数介绍

misc的结构体

1、注册杂项设备

int misc_register(struct miscdevice *misc);

功能：
该函数用于向内核注册一个杂项设备。注册成功后，该设备将在/dev目录下创建相应的设备节点，用户空间程序可以通过标准的文件操作接口来访问该设备。

参数：

• struct miscdevice *misc：指向杂项设备结构体的指针，该结构体包含了设备的次设备号、名称、操作函数指针等信息。

返回值：

• 成功时返回0。
• 失败时返回负的errno代码，表示注册过程中发生的错误。

注意：

• 杂项设备的主设备号是固定的（通常为10），次设备号可以指定，但也可以设置为MISC_DYNAMIC_MINOR，让内核自动分配次设备号。
• 在注册杂项设备时，需要填写struct miscdevice结构体中的各个字段，特别是操作函数指针fops，它指向一个包含设备操作函数的struct file_operations结构体。

函数源代码

static int __init misc_init(void)
{   
    int err;   
#ifdef CONFIG_PROC_FS   
    /*创建一个proc入口项*/  
    proc_create("misc", 0, NULL, &misc_proc_fops);                   
#endif   
    /*在/sys/class/目录下创建一个名为misc的类*/  
    misc_class = class_create(THIS_MODULE, "misc");   
    err = PTR_ERR(misc_class);   
    if (IS_ERR(misc_class))   
        goto fail_remove;   
    err = -EIO;  
    /*注册设备，其中设备的主设备号为MISC_MAJOR，为10。设备名为misc，misc_fops是操作函数的集合*/   
    if (register_chrdev(MISC_MAJOR,"misc",&misc_fops))   
        goto fail_printk;   
    return 0;   
   
fail_printk:   
    printk("unable to get major %d for misc devices/n", MISC_MAJOR);   
    class_destroy(misc_class);   
fail_remove:   
    remove_proc_entry("misc", NULL);   
    return err;   
} 
/*misc作为一个子系统被注册到linux内核中,系统开机后会自动调用misc_init*/  
subsys_initcall(misc_init);   

2、注销杂项设备

函数原型

int misc_deregister(struct miscdevice *misc);

功能：
该函数用于注销之前使用misc_register()成功注册的杂项设备。注销后，该设备在/dev目录下的设备节点将被删除，用户空间程序将无法再通过该文件节点访问该设备。

参数：

• struct miscdevice *misc：指向要注销的杂项设备结构体的指针。

返回值：

• 成功时返回0。
• 失败时返回负的errno代码，表示注销过程中发生的错误。

注意：

• 在注销杂项设备之前，应确保没有用户空间程序正在使用该设备，以避免出现数据丢失或系统不稳定的情况。
• 注销杂项设备是驱动模块卸载过程中的一个重要步骤，它确保了系统资源的正确释放和设备的正确关闭。

 函数源代码

int misc_deregister(struct miscdevice *misc)
{
	int i = misc->minor;//取得设备此设备号
	if (list_empty(&misc->list))
		return -EINVAL;
	mutex_lock(&misc_mtx);
	list_del(&misc->list);//将misc从misc_list链表中取出
	device_destroy(misc_class, MKDEV(MISC_MAJOR, misc->minor));//将/dev目录下的相应设备清除
	if (i < DYNAMIC_MINORS && i>0) {
		misc_minors[i>>3] &= ~(1 << (misc->minor & 7));//位图相应为置0
	}
	mutex_unlock(&misc_mtx);
	return 0;
}

三，具体实现

(1)设置结构体

（2）注册以及错误处理

（3）关于错误返回值

（4）代码

#include <linux/init.h>
#include <linux/kernel.h>
#include <linux/fs.h>
#include <linux/module.h>
#include <asm/io.h>
#include <asm/string.h>
#include <asm/uaccess.h>
#include <linux/miscdevice.h>
#include <asm-generic/errno-base.h>

#define DEV_NAME "led"
#define GPBCON 0x56000010
#define GPBDAT 0x56000014

static volatile unsigned long * gpbcon;
static volatile unsigned long * gpbdat;

static void init_led(void)						
{
	// 配置GPB5引脚功能为输出
	*gpbcon &= ~(0xff << 10);
	*gpbcon |= (0x55 << 10);

	// 将GPB5引脚电平置高
	*gpbdat |= (0xf << 5);
}

static void led_on(void)
{
	// 将GPB5引脚电平置低
	*gpbdat &= ~(0xf << 5);
}

static void led_off(void)
{
	// 将GPB5引脚电平置高
	*gpbdat |= (0xf << 5);
}

static int open (struct inode * inode, struct file * file)
{
	init_led();
	printk("led open ...\n");
	return 0;
}

static ssize_t read (struct file * file, char __user * buf, size_t len, loff_t * offset)
{
	//copy_to_user(buf, data, len);
	printk("led read ...\n");
	return 0;
}

static ssize_t write (struct file * file, const char __user * buf, size_t len, loff_t * offset)
{
	unsigned char data[12] = {0};
	size_t len_cp = sizeof(data) < len ? sizeof(data) : len;
	copy_from_user(data, buf, len_cp);

	if(!strcmp(data, "ledon"))
		led_on();
	else if(!strcmp(data, "ledoff"))
		led_off();
	else
		 return -EINVAL;

	printk("led write ...\n");
	return len_cp;
}

static int close (struct inode * inode, struct file * file)
{
	printk("led close ...\n");
	return 0;
}

static struct file_operations fops = 
{
	.owner = THIS_MODULE,
	.open = open,
	.read = read,
	.write = write,
	.release = close
};

static struct miscdevice misc = 
{
	.minor = MISC_DYNAMIC_MINOR,
	.name = DEV_NAME,
	.fops = &fops
};

static int __init led_init(void)
{
	int ret = misc_register(&misc);
	if(ret < 0)
		goto err_misc_register;

	gpbcon = ioremap(GPBCON, sizeof(*gpbcon));
	gpbdat = ioremap(GPBDAT, sizeof(*gpbdat));

	printk("led_init  ...\n");

	return ret;

err_misc_register:
	misc_deregister(&misc);
	printk("led misc_register failed\n");	
	return ret;
}

static void __exit led_exit(void)
{
	iounmap(gpbcon);
	iounmap(gpbdat);
	misc_deregister(&misc);
	printk("led_exit  ###############################\n");
}

module_init(led_init);
module_exit(led_exit);
MODULE_LICENSE("GPL");

小tips：