4. 字符设备驱动基础：file_operations结构体、主次设备号、cdev_init与cdev_add

字符设备是嵌入式Linux驱动中最基础、最常用的设备类型，其核心交互模型为“用户空间通过文件I/O操作访问硬件”。本章将深入剖析字符设备驱动的三大支柱：file_operations结构体、设备号管理机制以及cdev内核对象的初始化与注册流程。

4.1 file_operations结构体：驱动与VFS的契约

file_operations是字符设备驱动的“函数跳转表”，它定义了用户空间系统调用（如open、read、write）如何映射到驱动层的具体实现函数。该结构体位于<linux/fs.h>，是驱动开发者与虚拟文件系统（VFS）之间的二进制接口契约。

4.1.1 关键成员与典型实现

// 典型的file_operations定义示例
static int mydrv_open(struct inode *inode, struct file *filp) {
    pr_info("Device opened\n");
    return 0;
}

static int mydrv_release(struct inode *inode, struct file *filp) {
    pr_info("Device closed\n");
    return 0;
}

static ssize_t mydrv_read(struct file *filp, char __user *buf,
                           size_t count, loff_t *f_pos) {
    // 从内核缓冲区拷贝数据到用户空间
    if (copy_to_user(buf, kernel_buf, count))
        return -EFAULT;
    return count;
}

static ssize_t mydrv_write(struct file *filp, const char __user *buf,
                            size_t count, loff_t *f_pos) {
    // 从用户空间拷贝数据到内核缓冲区
    if (copy_from_user(kernel_buf, buf, count))
        return -EFAULT;
    return count;
}

// 定义file_operations结构体实例
static const struct file_operations mydrv_fops = {
    .owner   = THIS_MODULE,
    .open    = mydrv_open,
    .release = mydrv_release,
    .read    = mydrv_read,
    .write   = mydrv_write,
};

4.1.2 file_operations与VFS交互流程

4.2 主次设备号：设备的“身份证”

设备号是内核识别字符设备的唯一标识，由主设备号（major）和次设备号（minor）组成，类型为dev_t（32位无符号整数，高12位为主设备号，低20位为次设备号）。

4.2.1 设备号分配策略

// 动态分配设备号示例
dev_t dev_num;
int major, minor;

// 动态分配一个设备号，次设备号从0开始，数量为1
if (alloc_chrdev_region(&dev_num, 0, 1, "mydrv") < 0) {
    pr_err("Failed to allocate device number\n");
    return -EIO;
}

major = MAJOR(dev_num);  // 提取主设备号
minor = MINOR(dev_num);  // 提取次设备号
pr_info("Allocated major=%d, minor=%d\n", major, minor);

// 模块卸载时释放
unregister_chrdev_region(dev_num, 1);

4.2.2 设备号与设备节点的关系

4.3 cdev_init与cdev_add：驱动注册的核心步骤

cdev（字符设备）是内核用于管理字符设备驱动的核心数据结构。驱动必须完成初始化和注册两个步骤，才能将file_operations与设备号绑定，使设备对用户空间可见。

4.3.1 cdev生命周期管理

// 完整的字符设备驱动注册模板
#include <linux/module.h>
#include <linux/fs.h>
#include <linux/cdev.h>
#include <linux/slab.h>

#define DEVICE_NAME "mydrv"
#define CLASS_NAME  "mydrv_class"

static struct cdev my_cdev;
static dev_t dev_num;

// file_operations 定义（略，见4.1.1节）

static int __init mydrv_init(void) {
    int ret;

    // 步骤1：动态分配设备号
    ret = alloc_chrdev_region(&dev_num, 0, 1, DEVICE_NAME);
    if (ret < 0) {
        pr_err("Failed to allocate device number\n");
        return ret;
    }
    pr_info("Allocated major=%d minor=%d\n", MAJOR(dev_num), MINOR(dev_num));

    // 步骤2：初始化cdev，关联file_operations
    cdev_init(&my_cdev, &mydrv_fops);
    my_cdev.owner = THIS_MODULE;

    // 步骤3：注册cdev到内核
    ret = cdev_add(&my_cdev, dev_num, 1);
    if (ret < 0) {
        pr_err("Failed to add cdev\n");
        unregister_chrdev_region(dev_num, 1);
        return ret;
    }

    pr_info("mydrv driver loaded successfully\n");
    return 0;
}

static void __exit mydrv_exit(void) {
    // 步骤4：注销cdev
    cdev_del(&my_cdev);
    // 释放设备号
    unregister_chrdev_region(dev_num, 1);
    pr_info("mydrv driver unloaded\n");
}

module_init(mydrv_init);
module_exit(mydrv_exit);

MODULE_LICENSE("GPL");
MODULE_AUTHOR("Embedded Linux Expert");
MODULE_DESCRIPTION("A simple character device driver example");

4.3.2 cdev_init与cdev_add的底层机制

4.4 完整驱动注册流程总结

将上述三个核心要素串联起来，字符设备驱动的注册遵循以下六步法：

1. 定义 file_operations：实现 open/release/read/write 等回调函数，填充结构体。
2. 分配设备号：使用 alloc_chrdev_region() 动态获取 dev_t。
3. 初始化 cdev：调用 cdev_init() 将 file_operations 绑定到 cdev 对象。
4. 注册 cdev：调用 cdev_add() 将设备号与 cdev 关联并加入内核。
5. 创建设备节点（用户空间操作）：通过 mknod 或 udev 自动创建 /dev/xxx。
6. 注销清理：模块卸载时依次调用 cdev_del() 和 unregister_chrdev_region()。

4.4.1 常见错误与调试