4、字符设备驱动框架：字符设备注册、file_operations结构体、设备号分配、cdev_init/add/del、自动创建设备节点

字符设备是Linux驱动开发中最基础、最常用的设备类型，其核心特征是以字节流方式进行数据读写，例如串口、GPIO、I2C控制器、LED灯等。理解字符设备驱动框架，是掌握Linux内核驱动开发的基石。本章将围绕字符设备驱动的完整生命周期，深入剖析设备号分配、cdev结构体操作、file_operations接口实现以及设备节点的自动创建机制，帮助读者建立起从内核空间到用户空间的完整通路认知。

4.1 核心原理：字符设备驱动的分层架构与设备号机制

字符设备驱动的本质是向内核注册一个cdev结构体，并为其绑定一组操作函数指针（file_operations），使得用户空间通过文件系统接口（open/read/write/close）能够间接访问硬件设备。整个框架分为三层：用户空间通过标准系统调用发起请求；VFS层根据文件路径找到对应的inode，再从inode中提取设备号；内核驱动层根据设备号定位到具体的cdev结构体，最终调用其file_operations中的对应函数。

设备号是字符设备在内核中的唯一标识，由dev_t类型表示，这是一个32位无符号整数，其中高12位为主设备号（major），低20位为次设备号（minor）。主设备号用于区分设备类型，通常由内核统一分配；次设备号用于区分同类型下的不同实例。例如，一个USB转串口芯片可以占用同一个主设备号，但每个物理端口对应不同的次设备号。

4.2 操作流程：从设备号分配到设备节点创建

一个完整的字符设备驱动框架包含以下关键步骤，每一步都有对应的内核API和注意事项：

1. 设备号分配：使用register_chrdev_region()或alloc_chrdev_region()获取设备号。前者需要手动指定主设备号，后者由内核动态分配。分配成功后，设备号存储在dev_t变量中。
2. 初始化cdev：调用cdev_init()将cdev结构体与file_operations绑定。该函数会初始化cdev的引用计数和操作表。
3. 注册cdev：调用cdev_add()将cdev添加到内核的设备模型中。此时设备已经可以被内核识别，但用户空间还无法访问，因为没有设备节点。
4. 创建设备节点：通过class_create()创建一个设备类，再调用device_create()在/dev目录下生成设备节点。udev（用户空间守护进程）会监听内核事件，自动创建对应的设备文件。
5. 卸载清理：在模块退出函数中，先调用device_destroy()和class_destroy()删除设备节点和类，再调用cdev_del()注销cdev，最后释放设备号。

4.3 案例拆解：一个完整的LED字符设备驱动

下面通过一个控制GPIO LED的字符设备驱动，完整展示框架的落地实现。该驱动支持用户空间通过write系统调用控制LED的开关状态。

#include <linux/module.h>
#include <linux/fs.h>
#include <linux/cdev.h>
#include <linux/device.h>
#include <linux/uaccess.h>

#define DEVICE_NAME "led_dev"
#define CLASS_NAME "led_class"

static dev_t dev_num;
static struct cdev led_cdev;
static struct class *led_class;
static struct device *led_device;

static ssize_t led_write(struct file *file, const char __user *buf,
                         size_t len, loff_t *offset)
{
    char kbuf[4];
    if (copy_from_user(kbuf, buf, len))
        return -EFAULT;
    if (kbuf[0] == '1')
        gpio_set_value(LED_PIN, 1);  // 点亮LED
    else if (kbuf[0] == '0')
        gpio_set_value(LED_PIN, 0);  // 熄灭LED
    return len;
}

static struct file_operations led_fops = {
    .owner = THIS_MODULE,
    .write = led_write,
};

static int __init led_init(void)
{
    // 1. 动态分配设备号
    alloc_chrdev_region(&dev_num, 0, 1, DEVICE_NAME);
    
    // 2. 初始化cdev并绑定fops
    cdev_init(&led_cdev, &led_fops);
    
    // 3. 注册cdev到内核
    cdev_add(&led_cdev, dev_num, 1);
    
    // 4. 创建设备类
    led_class = class_create(THIS_MODULE, CLASS_NAME);
    
    // 5. 创建设备节点 /dev/led_dev
    led_device = device_create(led_class, NULL, dev_num, NULL, DEVICE_NAME);
    
    return 0;
}

static void __exit led_exit(void)
{
    device_destroy(led_class, dev_num);
    class_destroy(led_class);
    cdev_del(&led_cdev);
    unregister_chrdev_region(dev_num, 1);
}

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

该案例中，用户空间执行echo 1 > /dev/led_dev即可点亮LED。关键点在于：copy_from_user用于安全地从用户空间拷贝数据；gpio_set_value是硬件操作抽象，实际项目中需要根据平台选择GPIO操作API。设备节点/dev/led_dev由udev在驱动加载时自动创建，无需手动mknod。

4.4 常见误区与总结复盘

在实际开发中，以下问题最容易导致驱动异常或系统崩溃：

• cdev_add失败未处理：如果设备号已被占用或内存不足，cdev_add会返回错误码。必须检查返回值并做错误处理，否则后续操作会访问无效的cdev。
• 设备节点创建失败：device_create返回NULL时，需要检查class是否创建成功，以及是否有权限在/dev下创建设备节点。在嵌入式系统中，如果未启用udev，则需要手动mknod。
• file_operations未初始化owner字段：如果.owner未设置为THIS_MODULE，模块卸载时可能引发内核崩溃。
• 设备号释放遗漏：在模块卸载路径中，必须确保所有资源按逆序释放，否则会导致设备号泄漏，后续加载时无法重新分配。

总结而言，字符设备驱动框架的核心在于理解设备号→cdev→file_operations→设备节点这条链路。掌握cdev_init/add/del的调用时机，以及class/device_create的配合使用，就能构建出稳定可靠的字符设备驱动。在实际项目中，建议优先使用动态设备号分配，并充分利用udev的自动节点创建机制，减少手动干预，提高驱动移植性。