4. 字符设备驱动框架

字符设备是Linux驱动开发中最基础的设备类型，其核心框架围绕file_operations结构体、设备号、cdev接口三大要素构建。本章将系统讲解字符设备驱动的完整骨架，包括设备号的分配与释放、cdev的初始化与添加、以及驱动与VFS（虚拟文件系统）的交互机制。

4.1 字符设备驱动核心架构总览

字符设备驱动的本质是内核模块通过注册cdev结构体，将设备号与file_operations回调函数绑定到VFS层。用户空间的open/read/write/ioctl等系统调用，最终会通过VFS跳转到驱动实现的对应函数。

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

file_operations是字符设备驱动的核心数据结构，定义在<linux/fs.h>中。它是一组函数指针的集合，每个指针对应一个系统调用。驱动开发者根据设备特性实现其中部分或全部回调。

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

#define DEVICE_NAME "my_char_dev"
#define BUF_SIZE 1024

static char device_buffer[BUF_SIZE];
static int open_count = 0;

static int my_open(struct inode *inode, struct file *filp) {
    open_count++;
    printk(KERN_INFO "Device opened %d times\n", open_count);
    return 0;
}

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

static ssize_t my_read(struct file *filp, char __user *buf,
                       size_t count, loff_t *f_pos) {
    size_t available = BUF_SIZE - *f_pos;
    size_t to_read = count < available ? count : available;

    if (to_read == 0) return 0;

    if (copy_to_user(buf, device_buffer + *f_pos, to_read)) {
        return -EFAULT;
    }

    *f_pos += to_read;
    return to_read;
}

static ssize_t my_write(struct file *filp, const char __user *buf,
                        size_t count, loff_t *f_pos) {
    size_t available = BUF_SIZE - *f_pos;
    size_t to_write = count < available ? count : available;

    if (to_write == 0) return -ENOSPC;

    if (copy_from_user(device_buffer + *f_pos, buf, to_write)) {
        return -EFAULT;
    }

    *f_pos += to_write;
    return to_write;
}

static struct file_operations my_fops = {
    .owner   = THIS_MODULE,
    .open    = my_open,
    .release = my_release,
    .read    = my_read,
    .write   = my_write,
};

4.3 主次设备号：设备的唯一标识

每个字符设备在Linux内核中由设备号唯一标识。设备号是dev_t类型（32位无符号整数），其中高12位为主设备号，低20位为次设备号。

4.3.1 设备号操作宏

内核提供一组宏用于设备号的编码与解码，避免手动位操作：

4.3.2 静态分配 vs 动态分配

4.4 cdev接口：字符设备的内核抽象

cdev结构体是内核用于管理字符设备的核心对象，定义在<linux/cdev.h>中。每个字符设备在内核中对应一个cdev实例，它封装了设备号与file_operations的绑定关系。

4.4.1 cdev结构体定义

struct cdev {
    struct kobject kobj;          // 内核对象，用于sysfs和引用计数
    struct module *owner;         // 所属模块，通常设为 THIS_MODULE
    const struct file_operations *ops;  // 设备操作函数集
    struct list_head list;        // 内核内部链表节点
    dev_t dev;                    // 设备号
    unsigned int count;           // 次设备号数量
};

4.4.2 cdev操作流程

4.4.3 完整注册与注销代码模板

#include <linux/module.h>
#include <linux/fs.h>
#include <linux/cdev.h>
#include <linux/slab.h>

#define DEVICE_NAME "my_cdev"
#define MINOR_COUNT 1

static dev_t dev_num;
static struct cdev *my_cdev;

/* file_operations 定义（此处省略具体实现） */
static struct file_operations my_fops = {
    .owner   = THIS_MODULE,
    .open    = my_open,
    .release = my_release,
    .read    = my_read,
    .write   = my_write,
};

static int __init my_init(void) {
    int ret;

    /* 1. 动态分配设备号 */
    ret = alloc_chrdev_region(&dev_num, 0, MINOR_COUNT, DEVICE_NAME);
    if (ret < 0) {
        printk(KERN_ERR "Failed to allocate device number\n");
        return ret;
    }
    printk(KERN_INFO "Allocated major=%d minor=%d\n",
           MAJOR(dev_num), MINOR(dev_num));

    /* 2. 分配并初始化cdev */
    my_cdev = cdev_alloc();
    if (!my_cdev) {
        printk(KERN_ERR "Failed to allocate cdev\n");
        unregister_chrdev_region(dev_num, MINOR_COUNT);
        return -ENOMEM;
    }
    cdev_init(my_cdev, &my_fops);
    my_cdev->owner = THIS_MODULE;

    /* 3. 将cdev添加到内核 */
    ret = cdev_add(my_cdev, dev_num, MINOR_COUNT);
    if (ret < 0) {
        printk(KERN_ERR "Failed to add cdev\n");
        cdev_del(my_cdev);
        unregister_chrdev_region(dev_num, MINOR_COUNT);
        return ret;
    }

    printk(KERN_INFO "Character device registered successfully\n");
    return 0;
}

static void __exit my_exit(void) {
    /* 逆序释放：先删除cdev，再释放设备号 */
    cdev_del(my_cdev);
    unregister_chrdev_region(dev_num, MINOR_COUNT);
    printk(KERN_INFO "Character device unregistered\n");
}

module_init(my_init);
module_exit(my_exit);

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

4.5 设备注册与注销的完整流程

综合以上内容，字符设备驱动的注册与注销遵循对称设计原则：初始化时按顺序执行，清理时逆序执行。

4.6 本章小结

字符设备驱动框架是嵌入式Linux驱动开发的基石。掌握以下核心要点即可快速上手：

• file_operations：驱动与VFS的契约，实现open/read/write/release等回调。
• 设备号：主设备号标识驱动类型，次设备号标识设备实例；优先使用动态分配。
• cdev接口：内核管理字符设备的抽象，通过cdev_init/cdev_add完成注册。
• 对称设计：注册与注销严格逆序，确保资源正确释放。