4. UIO 驱动框架：设计理念、核心数据结构与内核交互

UIO（Userspace I/O）是 Linux 内核提供的一套轻量级框架，旨在将设备中断和内存映射等底层操作暴露给用户空间，从而让驱动程序的主体逻辑运行在用户态。对于 DPDK 这样的高性能数据面应用，UIO 是实现“零拷贝”和“绕过内核协议栈”的关键基石之一。

4.1 设计理念：为什么需要 UIO？

传统 Linux 设备驱动运行在内核空间，开发复杂、调试困难，且一次崩溃可能导致整个系统宕机。UIO 的设计哲学是“内核只做最少的事，用户空间做所有复杂的事”。其核心目标包括：

• 最小化内核代码：内核模块仅负责中断响应、内存映射注册和基本设备访问，通常只有几百行代码。
• 用户态主逻辑：协议栈、数据包处理、控制逻辑全部在用户空间实现，开发效率高，可利用丰富的用户态库（如 glibc）。
• 安全隔离：用户态驱动崩溃不会影响内核稳定性，系统可通过重启用户态进程恢复。
• 直接硬件访问：通过 mmap() 将设备 MMIO 和 DMA 内存映射到用户空间，实现零拷贝。

4.2 核心数据结构：struct uio_info

UIO 驱动的核心是 struct uio_info 结构体，它定义在 <linux/uio_driver.h> 中。内核模块通过填充该结构体并向内核注册，来描述一个 UIO 设备。该结构体是内核与用户空间交互的“契约”。

4.3 与内核的交互方式

UIO 驱动通过一组标准化的文件操作和 sysfs 接口，实现用户空间与内核的通信。主要交互路径包括：

4.3.1 设备注册与文件接口

内核模块调用 uio_register_device() 注册 uio_info，内核自动创建 /dev/uio0、/dev/uio1 等字符设备。用户空间通过标准的 POSIX 文件操作与之交互：

• open()：打开设备文件，触发内核的 open 回调。
• mmap()：将设备内存映射到用户空间，实现零拷贝访问。
• read() / select() / epoll()：等待中断事件。当硬件中断发生时，内核将中断计数写入设备文件，唤醒用户态等待进程。
• write()：用于使能/禁用中断（写入 1 使能，写入 0 禁用）。
• close()：释放资源。

4.3.2 中断处理流程

UIO 的中断处理是“内核快速响应 + 用户态轮询/等待”的混合模式：

1. 硬件中断触发：设备产生中断，CPU 执行内核注册的 handler 函数。
2. 内核态处理：handler 通常只做最少工作（如读取中断状态寄存器确认中断、清除中断标志），然后返回 IRQ_HANDLED。
3. 通知用户态：内核将中断计数（一个 32 位整数）写入与 /dev/uioX 关联的内核缓冲区，并唤醒等待队列。
4. 用户态响应：用户态进程通过 read() 阻塞等待，读取到中断计数后，执行实际的数据处理逻辑。

4.4 典型 UIO 驱动代码骨架

以下是一个简化的 UIO 内核模块示例，展示了如何填充 uio_info 并注册：

#include <linux/module.h>
#include <linux/uio_driver.h>
#include <linux/pci.h>

static struct uio_info my_uio_info = {
    .name = "my_uio_device",
    .version = "1.0",
    .irq = UIO_IRQ_CUSTOM,  // 使用自定义中断处理
};

static irqreturn_t my_handler(int irq, struct uio_info *info)
{
    // 读取中断状态寄存器，确认中断
    // 清除中断标志
    // 返回 IRQ_HANDLED
    return IRQ_HANDLED;
}

static int my_pci_probe(struct pci_dev *pdev, const struct pci_device_id *id)
{
    int ret;
    // 启用 PCI 设备，获取 MMIO 基地址
    my_uio_info.mem[0].addr = pci_resource_start(pdev, 0);
    my_uio_info.mem[0].size = pci_resource_len(pdev, 0);
    my_uio_info.mem[0].memtype = UIO_MEM_PHYS;
    my_uio_info.mem[0].name = "mmio_bar0";

    my_uio_info.handler = my_handler;
    my_uio_info.irq = pdev->irq;

    ret = uio_register_device(&pdev->dev, &my_uio_info);
    if (ret)
        return ret;

    pci_set_drvdata(pdev, &my_uio_info);
    return 0;
}

static void my_pci_remove(struct pci_dev *pdev)
{
    struct uio_info *info = pci_get_drvdata(pdev);
    uio_unregister_device(info);
}

// PCI ID 表、module_init 等省略

4.5 UIO 的局限性

尽管 UIO 设计优雅，但在现代高性能场景下存在一些不足，这也推动了 VFIO 的发展：