---

前言

  本文将通过字符驱动正式展开Linux驱动开发的学习。

一、字符设备驱动程序框架

  字符设备驱动是一种Linux驱动，用于支持以字符为单位进行I/O操作的设备，如串口、终端等。字符设备驱动的设计原理主要包括定义一个结构体，该结构体内部定义了一些设备的打开、关闭、读、写、控制函数；在结构体外分别实现这些函数；并向内核中注册或删除驱动模块。
  字符设备驱动框架主要涉及Linux软件系统的层次关系，包括应用程序与底层驱动程序之间的交互过程。我们从下面的思维导图来解读内核源码。

二、基本原理

1. 设备号的申请与归还

  Linux中提供了两种字符定义方式：第一种方式，就是我们常见的变量定义；第二种方式，是内核提供的动态分配方式，调用该函数之 后，会返回一个struct cdev类型的指针，用于描述字符设备，笔者这里习惯性使用第一种。

//第一种方式
static struct cdev chrdev;
//第二种方式
struct cdev *cdev_alloc(void);

  register_chrdev_region函数用于静态地为一个字符设备申请一个或多个设备编号。函数原型如下所示：

//保存新设备号到哈希表中防止冲突
int register_chrdev_region(dev_t from, unsigned count, const char *name)

• 参数

  • from：dev_t类型的变量，用于指定字符设备的起始设备号，如果要注册的设备号已经被其他的设备注册了，那么就会导致注册失败。
  • count：指定要申请的设备号个数，count的值不可以太大，否则会与下一个主设备号重叠。
  • name：用于指定该设备的名称，我们可以在/proc/devices中看到该设备。

• 返回值： 返回0表示申请成功，失败则返回错误码

  使用register_chrdev_region函数时，都需要去查阅内核源码的Documentation/devices.txt文件， 这就十分不方便。因此，内核又为我们提供了一种能够动态分配设备编号的方式：alloc_chrdev_region。调用该函数，内核会自动分配给我们一个尚未使用的主设备号。 我们可以通过命令“cat /proc/devices”查询内核分配的主设备号。

int alloc_chrdev_region(dev_t *dev, unsigned baseminor, unsigned count, const char *name)

• 参数：

  • dev：指向dev_t类型数据的指针变量，用于存放分配到的设备编号的起始值；

  • baseminor：次设备号的起始值，通常情况下，设置为0；

  • count、name：同register_chrdev_region类型，用于指定需要分配的设备编号的个数以及设备的名称。

• 返回值： 返回0表示申请成功，失败则返回错误码

  内核还提供了register_chrdev函数用于分配设备号。该函数是一个内联函数，它不仅支持静态申请设备号，也支持动态申请设备号，并将主设备号返回，函数原型如下所示。

static inline int register_chrdev(unsigned int major, const char *name,
const struct file_operations *fops)
{return __register_chrdev(major, 0, 256, name, fops);
}

• 参数：

  • major：用于指定要申请的字符设备的主设备号，等价于register_chrdev_region函数，当设置为0时，内核会自动分配一个未使用的主设备号。
  • name：用于指定字符设备的名称
  • fops：用于操作该设备的函数接口指针。

• 返回值： 主设备号

  使用register函数申请的设备号，则应该使用unregister_chrdev函数进行注销。我们从以上代码中可以看到，使用register_chrdev函数向内核申请设备号，同一类字符设备(即主设备号相同)，会在内核中申请了256个，通常情况下，我们不需要用到这么多个设备，这就造成了极大的资源浪费。

//使用register函数申请的设备号，则应该使用unregister_chrdev函数进行注销。
static inline void unregister_chrdev(unsigned int major, const char *name)
{
__unregister_chrdev(major, 0, 256, name);
}

• 参数：

  • major：指定需要释放的字符设备的主设备号，一般使用register_chrdev函数的返回值作为实参。

  • name：执行需要释放的字符设备的名称。

• 返回值： 无

  当我们删除字符设备时候，我们需要把分配的设备编号交还给内核，对于使用register_chrdev_region函数以及alloc_chrdev_region函数分配得到的设备编号，可以使用unregister_chrdev_region函数实现该功能。

void unregister_chrdev_region(dev_t from, unsigned count)

• 参数：

  • from：指定需要注销的字符设备的设备编号起始值，我们一般将定义的dev_t变量作为实参。

  • count：指定需要注销的字符设备编号的个数，该值应与申请函数的count值相等，通常采用宏定义进行管理。

• 返回值： 无

2. 保存file_operations接口

  在完成第一步的设备号申请之后，我们要开始着手考虑如何利用file_operations这个结构体中来编写读写函数。那如何将该结构体与我们的字符设备结构体相关联呢？内核提供了cdev_init函数，来实现这个过程（cdev结构体在上节已经介绍过了）。

void cdev_init(struct cdev *cdev, const struct file_operations *fops)
{//将cdev中的所有值清零memset(cdev, 0, sizeof *cdev);//用于初始化这个 list_head 成员，使其成为一个空的链表头。INIT_LIST_HEAD(&cdev->list);//用于初始化一个已经分配好的 struct kobject 结构体，并将其与指定的类型、父对象以及名称关联起来。kobject_init(&cdev->kobj, &ktype_cdev_default);cdev->ops = fops;
}

• 参数：
  • cdev：struct cdev类型的指针变量，指向需要关联的字符设备结构体；
  • fops：file_operations类型的结构体指针变量，一般将实现操作该设备的结构体file_operations结构体作为实参。
• 返回值： 无

  cdev_add函数用于向内核的cdev_map散列表添加一个新的字符设备，如下所示：

int cdev_add(struct cdev *p, dev_t dev, unsigned count)
{int error;//赋值字符设备的设备号p->dev = dev;//赋值设备驱动程序控制的实际同类设备的数量p->count = count;error = kobj_map(cdev_map, dev, count, NULL,exact_match, exact_lock, p);if (error)return error;kobject_get(p->kobj.parent);return 0;
}

• 参数：
  • p：struct cdev类型的指针，用于指定需要添加的字符设备；
  • dev：dev_t类型变量，用于指定设备的起始编号；
  • count：指定注册多少个设备。
• 返回值： 错误码

  cdev_del函数用于从Linux内核系统中移除一个字符设备。当调用这个函数时，输入参数所代表的字符设备将从系统中注销，使其不可用。从系统中删除cdev，cdev设备将无法再打开，但任何已经打开的cdev将保持不变， 即使在cdev_del返回后，它们的FOP仍然可以调用。

//从内核中移除该字符设备
void cdev_del(struct cdev *p)

• 参数（p）： struct cdev类型的指针，用于指定需要删除的字符设备

• 返回值： 无

  需要注意的是，cdev_del函数并不负责释放cdev结构体本身所占用的内存。如果cdev结构体是通过动态内存分配（如使用cdev_alloc函数）创建的，那么在调用cdev_del之后，还需要手动释放这块内存，以避免内存泄漏。

3. 设备节点的创建和销毁

  device_create是 Linux 内核中的一个函数，用于在内核中创建一个新的设备对象。这个函数是设备驱动开发中非常重要的一部分，它允许你将设备和其对应的类关联起来，并为设备提供一组属性和操作。

struct device *device_create(struct class *class, struct device *parent, dev_t devt, void *drvdata, const char *fmt, ...) 

• 参数
  • class: 指向一个 class 结构体的指针，表示这个设备所属的类
  • parent: 指向父设备的指针，如果设备没有父设备，可以设置为 NULL
  • dev_t devt: 设备的设备号
  • drvdata: 要进行回调的数据
  • fmt: 指定设备的名称
• 返回值：成功：新创建的 device 结构体的指针；失败：ERR_PTR( )

  device_destroy 函数的主要功能是销毁指定的设备对象，并将其从内核的设备模型中移除。当设备不再需要时（例如，驱动被卸载或设备被移除），应该调用这个函数来清理相关的资源。

void device_destroy(struct class *class, dev_t devt)

• 参数
  • class：指向注册此设备的struct类的指针；
  • devt：以前注册的设备的开发；
• 返回值： 无
• 注意事项
  • 顺序性：通常，你应该在调用 device_destroy 之前，确保没有任何线程正在使用或引用这个设备对象。如果还有其他线程正在使用设备，销毁操作可能会导致未定义的行为或崩溃。
  • 引用计数：内核中的设备对象通常使用引用计数来管理其生命周期。在调用 device_destroy 之前，确保没有其他地方持有对该设备对象的引用是很重要的。否则，设备对象可能不会被正确销毁。
  • 错误处理：虽然 device_destroy 函数本身没有返回值来表示操作是否成功，但在调用它之前，你应该检查传入的参数是否有效，以确保不会传递无效的设备类或设备号。
  • 同步：如果你的驱动在多个线程或中断上下文中操作设备对象，你需要确保对 device_destroy 的调用是同步的，以避免竞态条件。

  注：除了使用代码创建设备节点，还可以使用mknod命令创建设备节点。

4. 创建文件设备

4.1 mknod

  mknod命令在Linux系统中用于创建特殊文件，包括字符设备文件和块设备文件。这些特殊文件为设备提供了接口，使得用户空间程序能够与内核空间的设备进行交互。mknod命令的语法为：

mknod [- 选项(可不选)] [文件名称] [类型] [主设备号] [次设备号]

• 选项
  • Z：设置安全的上下文。
  • m：设置权限信息。
  • help：显示帮助信息。
  • version：显示版本信息。
    参数包括：
• 文件名：要创建的设备文件名。
• 类型：指定要创建的设备文件类型
  • c、u代表（无缓冲区）字符设备文件
  • b代表（有缓冲区）块设备文件
  • p代表FIFO型特殊文件
• 主设备号：指定设备文件的主设备号，用于区分不同种类的设备。
• 次设备号：指定设备文件的次设备号，用于区分同一类型的多个设备。

4.2 init_special_incode( )函数

  当我们使用上述命令，创建了一个字符设备文件时，实际上就是创建了一个设备节点inode结构体， 并且将该设备的设备编号记录在成员i_rdev，将成员f_op指针指向了字符设备通用的def_chr_fops结构体。

void init_special_inode(struct inode *inode, umode_t mode, dev_t rdev)
{inode->i_mode = mode;//是否是字符类型if (S_ISCHR(mode)) {inode->i_fop = &def_chr_fops;inode->i_rdev = rdev;} //是否是块类型else if (S_ISBLK(mode)) {inode->i_fop = &def_blk_fops;inode->i_rdev = rdev;} //是否是FIFO类型else if (S_ISFIFO(mode))inode->i_fop = &pipefifo_fops;else if (S_ISSOCK(mode));	/* leave it no_open_fops */elseprintk(KERN_DEBUG "init_special_inode: bogus i_mode (%o) for inode %s:%lu\n", mode, inode->i_sb->s_id,inode->i_ino);
}
EXPORT_SYMBOL(init_special_inode);

5. 查找file_operation接口

  用户空间使用open()系统调用函数打开一个字符设备时(int fd = open(“dev/xxx”, O_RDWR))大致有以下过程：

1. 在虚拟文件系统VFS中的查找对应与字符设备对应 struct inode节点
2. 遍历散列表cdev_map，根据inod节点中的 cdev_t设备号找到cdev对象
3. 创建struct file对象(系统采用一个数组来管理一个进程中的多个被打开的设备，每个文件秒速符作为数组下标标识了一个设备对象)
4. 初始化struct file对象，将 struct file对象中的 file_operations成员指向 struct cdev对象中的 file_operations成员(file->fops = cdev->fops)
5. 回调file->fops->open函数
     下图中列出了open函数执行的大致过程：
   

函数速查表

  看到这么多函数，笔者已经头晕了，以下是一个函数表，大家可以比对一下：

函数	功能	备注
register_chrdev_region	分配设备号	静态申请
alloc_chrdev_region	分配未使用的设备号	register_chrdev_region上位替代
unregister_chrdev_region	注销设备号	和register_chrdev_region函数及alloc_chrdev_region函数搭配使用
register_chrdev	用于分配设备号	函数是一个内联函数，支持静态/动态，并将主设备号返回，等价于register_chrdev_region函数
unregister_chrdev	注销设备号	注销register_chrdev函数申请的设备号
cdev_init	关联file_operations
cdev_add	添加一个新的字符设备
cdev_del	移除一个字符设备
device_create	创建一个新的设备对象
device_destroy	销毁指定的设备对象

三、程序编写

  具体流程如下：

• 内核模块入口获得相关寄存器并初始化
• 构造file_operations接口并注册到内核
• 创建设备文件，绑定file_operations接口
• 应用程序获得文件句柄后，使用库函数提供的write或ioctl函数发出控制命令。

1. 模块初始化及关闭

#define DEV_NAME "EmbedCharDev"
#define DEV_CNT (1)
#define BUFF_SIZE 128
//定义字符设备的设备号
static dev_t devno;
//定义字符设备结构体chr_dev
static struct cdev chr_dev;
static int __init chrdev_init(void)
{int ret = 0;printk("chrdev init\n");//第一步//采用动态分配的方式，获取设备编号，次设备号为0，//设备名称为EmbedCharDev，可通过命令cat /proc/devices查看//DEV_CNT为1，当前只申请一个设备编号ret = alloc_chrdev_region(&devno, 0, DEV_CNT, DEV_NAME);if (ret < 0) {printk("fail to alloc devno\n");//当获取失败时，直接返回对应的错误码goto alloc_err;}//第二步//关联字符设备结构体cdev与文件操作结构体file_operationscdev_init(&chr_dev, &chr_dev_fops);//第三步//添加设备至cdev_map散列表中ret = cdev_add(&chr_dev, devno, DEV_CNT);if (ret < 0) {printk("fail to add cdev\n");//当添加设备失败的话，需要将申请的设备号注销掉goto add_err;}return 0;add_err://添加设备失败时，需要注销设备号unregister_chrdev_region(devno, DEV_CNT);alloc_err:return ret;}static void __exit chrdev_exit(void)
{printk("chrdev exit\n");unregister_chrdev_region(devno, DEV_CNT);cdev_del(&chr_dev);
}module_init(chrdev_init);
module_exit(chrdev_exit);

2. 文件操作方式的实现

  首先我们先来编写自己的open函数和release函数，考虑到字符设备确实是一种虚拟设备，所以不需要确切的回应，这里选择仅打印。

static int chr_dev_open(struct inode *inode, struct file *filp)
{printk("\nopen\n");return 0;
}static int chr_dev_release(struct inode *inode, struct file *filp)
{printk("\nrelease\n");return 0;
}

  下面，我们开始实现字符设备最重要的部分，即利用文件操作方式结构体file_operations实现write\read函数。当我们的应用程序调用write\read函数，实际上就是调用我们的chr_dev_write\chr_dev_read函数，代码如下（示例）：

static ssize_t chr_dev_write(struct file *filp, const char __user * buf, size_t count, loff_t *ppos)
{unsigned long p = *ppos;int ret;int tmp = count ;if (p > BUFF_SIZE)return 0;if (tmp > BUFF_SIZE - p)tmp = BUFF_SIZE - p;ret = copy_from_user(vbuf, buf, tmp);*ppos += tmp;return tmp;
}static ssize_t chr_dev_read(struct file *filp, char __user * buf, size_t count, loff_t *ppos)
{unsigned long p = *ppos;int ret;int tmp = count ;if (p >= BUFF_SIZE)return 0;if (tmp > BUFF_SIZE - p)tmp = BUFF_SIZE - p;ret = copy_to_user(buf, vbuf+p, tmp);*ppos +=tmp;return tmp;
}