2. Linux内核驱动基础回顾：字符设备驱动框架与file_operations结构体

在网关外设驱动移植工作中，绝大多数外设（如GPIO、I2C传感器、SPI Flash、UART控制器）在Linux内核中均以字符设备的形式呈现。字符设备驱动是Linux驱动模型中最基础、最核心的框架，理解其运作机制是进行驱动移植的前提。

2.1 字符设备驱动核心概念

字符设备是指以字节流形式进行读写操作的设备，数据按顺序访问，不支持随机定位（如键盘、串口）。Linux内核通过设备号来标识和管理字符设备。

2.2 字符设备驱动框架：四步注册流程

一个标准的字符设备驱动在初始化阶段需要完成以下四个关键步骤。下面的SVG图展示了完整的注册流程与内核对象关系。

2.3 file_operations结构体深度解析

struct file_operations 是字符设备驱动的核心接口，它定义了驱动能够响应的所有用户空间系统调用。每个成员都是一个函数指针，驱动开发者通过实现这些函数来提供具体的设备操作能力。

// Linux内核源码 include/linux/fs.h
struct file_operations {
    struct module *owner;
    loff_t (*llseek) (struct file *, loff_t, int);
    ssize_t (*read) (struct file *, char __user *, size_t, loff_t *);
    ssize_t (*write) (struct file *, const char __user *, size_t, loff_t *);
    __poll_t (*poll) (struct file *, struct poll_table_struct *);
    long (*unlocked_ioctl) (struct file *, unsigned int, unsigned long);
    int (*open) (struct inode *, struct file *);
    int (*release) (struct inode *, struct file *);
    int (*mmap) (struct file *, struct vm_area_struct *);
    // ... 其他可选成员
};

2.4 完整字符设备驱动模板

以下是一个最小化的字符设备驱动模板，展示了上述框架的具体代码实现。该模板可直接作为网关外设驱动移植的起点。

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

#define DEVICE_NAME "gateway_dev"
#define CLASS_NAME  "gateway"

static int major;
static struct class *dev_class;
static struct cdev gateway_cdev;

// 设备打开回调
static int gateway_open(struct inode *inode, struct file *file) {
    pr_info("Gateway device opened\n");
    return 0;
}

// 设备释放回调
static int gateway_release(struct inode *inode, struct file *file) {
    pr_info("Gateway device released\n");
    return 0;
}

// 设备读取回调
static ssize_t gateway_read(struct file *file, char __user *buf,
                            size_t len, loff_t *off) {
    char kernel_buf[64] = "Hello from gateway driver!";
    size_t datalen = strlen(kernel_buf);

    if (*off >= datalen)
        return 0;
    if (len > datalen - *off)
        len = datalen - *off;

    if (copy_to_user(buf, kernel_buf + *off, len))
        return -EFAULT;

    *off += len;
    return len;
}

// 设备写入回调
static ssize_t gateway_write(struct file *file, const char __user *buf,
                             size_t len, loff_t *off) {
    char kernel_buf[128];

    if (len > sizeof(kernel_buf))
        len = sizeof(kernel_buf);

    if (copy_from_user(kernel_buf, buf, len))
        return -EFAULT;

    pr_info("Received %zu bytes from user: %s\n", len, kernel_buf);
    return len;
}

// file_operations 实例化
static struct file_operations gateway_fops = {
    .owner   = THIS_MODULE,
    .open    = gateway_open,
    .release = gateway_release,
    .read    = gateway_read,
    .write   = gateway_write,
};

// 模块初始化
static int __init gateway_init(void) {
    dev_t dev_num;

    // 步骤1：动态分配设备号
    alloc_chrdev_region(&dev_num, 0, 1, DEVICE_NAME);
    major = MAJOR(dev_num);
    pr_info("Allocated major number: %d\n", major);

    // 步骤2：初始化cdev
    cdev_init(&gateway_cdev, &gateway_fops);
    gateway_cdev.owner = THIS_MODULE;

    // 步骤3：添加cdev到内核
    cdev_add(&gateway_cdev, dev_num, 1);

    // 步骤4：创建类与设备文件（自动生成/dev/节点）
    dev_class = class_create(THIS_MODULE, CLASS_NAME);
    device_create(dev_class, NULL, dev_num, NULL, DEVICE_NAME);

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

// 模块退出
static void __exit gateway_exit(void) {
    dev_t dev_num = MKDEV(major, 0);

    device_destroy(dev_class, dev_num);
    class_destroy(dev_class);
    cdev_del(&gateway_cdev);
    unregister_chrdev_region(dev_num, 1);

    pr_info("Gateway driver unloaded\n");
}

module_init(gateway_init);
module_exit(gateway_exit);

MODULE_LICENSE("GPL");
MODULE_AUTHOR("Gateway Driver Team");
MODULE_DESCRIPTION("Minimal character device driver for gateway porting");

2.5 驱动兼容性测试要点

在网关外设驱动移植过程中，完成驱动编码后必须进行兼容性验证。以下测试清单覆盖了字符设备驱动的核心验证点：

• 设备节点验证：驱动加载后检查 /dev/gateway_dev 是否存在，主次设备号是否正确。
• 基本I/O测试：使用 echo "test" > /dev/gateway_dev 和 cat /dev/gateway_dev 验证读写通路。
• 并发访问测试：多个进程同时打开设备，验证驱动是否出现死锁或数据错乱。
• 边界条件测试：读取空缓冲区、写入超长数据、重复打开/关闭设备。
• 卸载重载测试：反复执行 insmod 和 rmmod，验证资源无泄漏。

2.6 本章小结