📚 课程目录第3章 UIO驱动架构详解

3. UIO驱动架构详解

UIO（Userspace I/O）是Linux内核提供的一套用户态驱动框架，允许设备中断和内存映射资源直接暴露给用户空间，而无需编写完整的内核驱动。在DPDK早期版本中，UIO是唯一支持用户态网卡收发的底层机制。本章深入剖析UIO的设备模型、mmap机制、中断处理流程以及与DPDK的交互细节。

3.1 UIO设备模型

UIO在内核中抽象为一个字符设备，主设备号固定为10，次设备号动态分配。每个UIO设备对应一个/dev/uioX节点，用户态通过标准文件操作（open、read、mmap、write）与硬件交互。

  核心概念：UIO将设备资源划分为两类——内存区域（通过mmap映射）和中断事件（通过read/wait捕获）。内核部分仅做最少的硬件初始化与中断响应，所有业务逻辑都在用户态完成。

3.2 UIO设备注册与生命周期

UIO设备通过struct uio_info结构体描述，驱动开发者需要填充以下关键字段：

字段	类型	说明
`name`	const char *	设备名称，用于sysfs标识
`version`	const char *	驱动版本号
`mem[]`	struct uio_mem	内存区域描述数组，最多UIO_MAX_REGIONS（5）个
`port[]`	struct uio_port	I/O端口区域描述（非x86架构常用）
`irq`	unsigned int	中断号，或UIO_IRQ_CUSTOM/UIO_IRQ_NONE
`irq_flags`	unsigned long	中断标志，如IRQF_SHARED
`handler`	irqreturn_t ()(int, struct uio_info )	中断处理回调（可选）
`mmap`	int ()(struct uio_info , struct vm_area_struct *)	自定义mmap回调（可选）

实践要点：DPDK使用的igb_uio模块就是基于UIO框架的标准实现。它注册PCIe设备的BAR空间作为UIO内存区域，并将设备中断重定向到UIO中断处理路径。

3.3 mmap机制详解

UIO通过mmap系统调用将设备物理内存（如PCIe BAR空间）直接映射到用户进程的虚拟地址空间。这是DPDK实现零拷贝收发的核心机制。

3.3.1 映射流程

用户态调用：addr = mmap(NULL, size, PROT_READ|PROT_WRITE, MAP_SHARED, fd, offset)
内核处理：UIO框架根据offset参数定位到对应的uio_mem区域
物理地址解析：从uio_mem->addr获取物理基地址
页表建立：通过remap_pfn_range()建立用户虚拟地址到物理地址的映射
返回虚拟地址：用户态直接操作该地址访问硬件寄存器或描述符队列

3.3.2 offset编码规则

UIO的mmap offset参数并非普通文件偏移，而是编码了区域索引和页内偏移：

offset = (region_index << PAGE_SHIFT) | page_offset
// 例如：映射第2个区域（index=1）的起始地址
// offset = (1 << 12) = 4096
addr = mmap(NULL, size, PROT_READ|PROT_WRITE, MAP_SHARED, fd, 4096);

常见错误：如果offset未按PAGE_SHIFT对齐，mmap会返回EINVAL。DPDK的eal_pci_uio.c中通过RTE_PGSIZE宏确保偏移正确。

3.4 中断处理机制

UIO的中断处理采用“事件通知”模型，用户态通过read()阻塞等待中断事件，内核在中断发生时递增一个32位计数器并唤醒等待队列。

3.4.1 中断处理流程

步骤	角色	操作
1	硬件	设备产生中断（如网卡收到数据包）
2	内核UIO	调用注册的`handler`回调，或执行默认中断处理
3	内核UIO	递增`uio_event->count`，唤醒等待队列
4	用户态	`read(fd, &count, 4)`返回，获取中断计数
5	用户态	处理数据包（如轮询RX描述符）
6	用户态	重新调用`read()`等待下一个中断

3.4.2 中断控制

用户态可以通过write()向/dev/uioX写入一个32位整数来控制中断使能：

// 启用中断
int enable = 1;
write(fd, &enable, sizeof(enable));

// 禁用中断
int disable = 0;
write(fd, &disable, sizeof(disable));

性能提示：在DPDK的轮询模式下，中断通常仅在初始化阶段用于检测链路状态，运行时完全禁用中断以避免上下文切换开销。通过rte_eth_dev_stop()和rte_eth_dev_start()间接控制UIO中断的启用/禁用。

3.5 DPDK与UIO的交互流程

DPDK通过EAL（Environment Abstraction Layer）与UIO驱动交互，完整流程如下：

设备扫描：EAL遍历/sys/class/uio/目录，发现所有UIO设备
PCI信息读取：通过/sys/class/uio/uioX/device/读取vendor_id、device_id、BAR地址等
设备打开：open("/dev/uioX", O_RDWR)获取文件描述符
内存映射：对每个BAR区域调用mmap()，映射到用户虚拟地址
中断配置：通过write()启用中断，注册信号处理函数
设备初始化：PMD驱动通过映射后的地址配置硬件寄存器
运行时：轮询RX/TX描述符，零拷贝收发数据包

3.6 UIO关键数据结构

DPDK中与UIO交互的核心数据结构定义在eal_pci_uio.c中：

struct uio_resource {
    char uio_name[PATH_MAX];      // /dev/uioX 路径
    int uio_fd;                   // 文件描述符
    struct rte_pci_device *dev;   // 关联的PCI设备
    struct rte_intr_handle intr_handle; // 中断句柄
    struct mapped_pci_resource {
        int nb_maps;
        struct rte_mem_resource maps[PCI_MAX_RESOURCE];
    } rsrc;
};

  关键代码路径：rte_eal_pci_probe() → pci_uio_map_resource() → pci_uio_map_resource_by_index() → mmap()。每个BAR区域映射后，物理地址与虚拟地址的对应关系保存在rte_mem_resource中，供PMD驱动使用。

3.7 UIO的局限性

局限	说明	影响
不支持DMA隔离	UIO不提供IOMMU支持，任何用户态进程都可以访问映射的物理内存	安全风险，恶意进程可篡改网卡描述符
中断延迟较高	中断路径经过内核UIO框架再到用户态，路径较长	高吞吐场景下轮询模式更优
不支持设备热插拔	UIO没有标准的热插拔通知机制	运维复杂度增加
多进程支持弱	多个进程同时mmap同一UIO设备可能导致竞争	DPDK多进程需额外同步
中断共享问题	IRQF_SHARED标志下，UIO可能与其他驱动共享中断线	中断处理不确定性

选型提示：UIO适用于开发测试、功能验证以及不支持VT-d/AMD-Vi的旧平台。对于生产环境，尤其是多租户或安全敏感场景，强烈建议使用VFIO驱动（详见下一章）。

3.8 本章小结

UIO驱动架构通过最小内核代理的设计哲学，将设备内存映射和中断通知机制暴露给用户空间，为DPDK提供了零拷贝收发的底层基础。理解UIO的设备模型、mmap编码规则和中断处理流程，是掌握DPDK用户态驱动原理的关键一步。然而，UIO在安全性和功能完整性上的不足，也推动了VFIO驱动的诞生与发展。