4. 字符设备驱动核心API变迁

字符设备驱动是Linux驱动开发中最基础、最典型的驱动类型。从4.x到6.x内核，字符设备驱动的核心API经历了显著变化，主要体现在设备号注册、字符设备对象管理以及文件操作接口三个维度。理解这些变迁是完成驱动移植适配的关键前提。

4.1 设备号注册：register_chrdev_region vs alloc_chrdev_region

设备号是字符设备在内核中的唯一标识，由主设备号（major）和次设备号（minor）组成。在4.x内核中，设备号注册存在两种方式，而6.x内核强烈推荐使用动态分配方式。

以下代码展示了从静态注册到动态注册的移植变化：

/* 4.x内核：静态注册方式（移植前） */
#include <linux/fs.h>
#define MY_MAJOR 240
#define MY_MINOR 0
#define DEVICE_COUNT 1

static dev_t dev_num;
dev_num = MKDEV(MY_MAJOR, MY_MINOR);
ret = register_chrdev_region(dev_num, DEVICE_COUNT, "my_device");
if (ret < 0) {
    pr_err("Failed to register chrdev region\n");
    return ret;
}

/* 6.x内核：动态注册方式（移植后） */
#include <linux/fs.h>
#define DEVICE_COUNT 1

static dev_t dev_num;
ret = alloc_chrdev_region(&dev_num, 0, DEVICE_COUNT, "my_device");
if (ret < 0) {
    pr_err("Failed to alloc chrdev region\n");
    return ret;
}
pr_info("Allocated major number: %d\n", MAJOR(dev_num));

4.2 cdev_init/cdev_add接口变化

字符设备对象（cdev）的初始化和添加操作在4.x到6.x内核中保持了基本接口，但内部实现和推荐用法发生了变化。核心变化在于：6.x内核更推荐使用cdev_add一体化注册，并强化了错误处理要求。

4.2.1 传统方式：cdev_init + cdev_add

在4.x内核中，标准的cdev操作分为两步：

/* 4.x内核：cdev_init + cdev_add 分离操作 */
struct cdev my_cdev;
dev_t dev_num;

/* 第一步：初始化cdev对象 */
cdev_init(&my_cdev, &my_fops);
my_cdev.owner = THIS_MODULE;

/* 第二步：添加cdev到内核 */
ret = cdev_add(&my_cdev, dev_num, 1);
if (ret < 0) {
    pr_err("Failed to add cdev\n");
    return ret;
}

4.2.2 6.x内核的变化与推荐用法

在6.x内核中，虽然cdev_init和cdev_add接口仍然存在，但内核社区推荐以下改进：

• 使用cdev_alloc替代cdev_init：cdev_alloc动态分配cdev对象并自动初始化，减少遗漏初始化的风险。
• 强化错误检查：cdev_add返回错误时，必须确保已分配的cdev资源被正确释放。
• 设备号与cdev的关联时机：建议在cdev_add成功后再创建用户空间设备节点，避免设备节点存在但驱动未就绪的竞态条件。

/* 6.x内核：推荐使用cdev_alloc + cdev_add */
struct cdev *my_cdev;
dev_t dev_num;

/* 第一步：动态分配并初始化cdev */
my_cdev = cdev_alloc();
if (!my_cdev) {
    pr_err("Failed to alloc cdev\n");
    return -ENOMEM;
}
my_cdev->owner = THIS_MODULE;
my_cdev->ops = &my_fops;

/* 第二步：添加cdev到内核 */
ret = cdev_add(my_cdev, dev_num, 1);
if (ret < 0) {
    pr_err("Failed to add cdev: %d\n", ret);
    kfree(my_cdev);  /* 释放动态分配的cdev */
    return ret;
}

/* 第三步：cdev_add成功后，再创建设备节点 */
device_create(my_class, NULL, dev_num, NULL, "my_device");

4.3 file_operations结构体成员变更

file_operations结构体是字符设备驱动的核心接口，定义了用户空间通过系统调用访问设备时的回调函数。从4.x到6.x内核，该结构体的成员发生了以下重要变化：

4.3.1 主要变更清单

4.3.2 poll函数返回值类型变更

poll函数的返回值类型从unsigned int变为__poll_t，这是一个强类型枚举，用于提高类型安全性。移植时需要修改返回值类型和使用的标志宏：

/* 4.x内核：poll函数实现 */
unsigned int my_poll(struct file *filp, struct poll_table_struct *wait)
{
    unsigned int mask = 0;
    poll_wait(filp, &my_waitq, wait);
    if (/* 数据可读 */)
        mask |= POLLIN | POLLRDNORM;
    if (/* 可写 */)
        mask |= POLLOUT | POLLWRNORM;
    return mask;
}

/* 6.x内核：poll函数实现（使用__poll_t） */
__poll_t my_poll(struct file *filp, struct poll_table_struct *wait)
{
    __poll_t mask = 0;
    poll_wait(filp, &my_waitq, wait);
    if (/* 数据可读 */)
        mask |= EPOLLIN | EPOLLRDNORM;
    if (/* 可写 */)
        mask |= EPOLLOUT | EPOLLWRNORM;
    return mask;
}

4.3.3 read/write vs read_iter/write_iter

6.x内核强烈推荐驱动实现read_iter和write_iter回调，而非传统的read和write。新的迭代器接口支持更高效的I/O操作，特别是对于支持分散/聚集I/O的设备：

/* 6.x内核：使用read_iter/write_iter */
static ssize_t my_read_iter(struct kiocb *iocb, struct iov_iter *to)
{
    struct file *filp = iocb->ki_filp;
    struct my_device *dev = filp->private_data;
    ssize_t ret;
    
    /* 使用iov_iter接口读取数据 */
    ret = simple_read_from_iter(to, dev->buffer, dev->data_size);
    return ret;
}

static ssize_t my_write_iter(struct kiocb *iocb, struct iov_iter *from)
{
    struct file *filp = iocb->ki_filp;
    struct my_device *dev = filp->private_data;
    ssize_t ret;
    
    /* 使用iov_iter接口写入数据 */
    ret = simple_write_to_iter(from, dev->buffer, dev->buffer_size);
    return ret;
}

static const struct file_operations my_fops = {
    .owner          = THIS_MODULE,  /* 4.x需要，6.x应删除此行 */
    .read_iter      = my_read_iter,
    .write_iter     = my_write_iter,
    .unlocked_ioctl = my_ioctl,
    .open           = my_open,
    .release        = my_release,
    .poll           = my_poll,
};

4.4 移植适配清单与常见问题

基于以上分析，以下是字符设备驱动从4.x移植到6.x内核的完整适配清单：