嵌入式 Linux 与 RTOS / 系统课时

用 UIO 访问 FPGA 寄存器

用 UIO 访问 FPGA 寄存器

当 FPGA 只暴露一段 MMIO 寄存器和一根中断线,而逻辑本身不需要复杂内核框架时,UIO 可以把资源留在内核中登记,把寄存器访问与事件处理放到用户态。本节完成设备树描述、mmap 映射和阻塞等待中断,并给出何时不该继续用 UIO 的判断边界。

学习目标

  • 把 FPGA 的寄存器窗口与中断资源描述成 UIO 设备,并确认 /dev/uioX 已创建。
  • 在用户态映射 map0,读取 MMIO 寄存器并等待一次中断事件。
  • 判断简单寄存器控制适合 UIO,哪些需求应升级为完整内核驱动。

把硬件资源交给 UIO

UIO 的分工很直接:内核负责资源占用、地址映射入口和中断转发,用户程序通过 /dev/uioX 使用这些资源。对于设备树平台设备,常见做法是使用 uio_pdrv_genirq。下面是片段示例,需放入当前板级 DTS,并把地址、中断号和 GIC 编码改成实际硬件值。

text
fpga_regs@a0000000 {
    compatible = "generic-uio";
    reg = <0x0 0xa0000000 0x0 0x10000>;
    interrupt-parent = <&gic>;
    interrupts = <0 89 4>;
};

该节点表示一个 64 KiB 的寄存器窗口和一根中断。内核需启用 CONFIG_UIO 与 CONFIG_UIO_PDRV_GENIRQ;若驱动编译为模块,可显式指定要匹配的设备树 compatible。

bash
modprobe uio_pdrv_genirq of_id=generic-uio
ls -l /dev/uio*
cat /sys/class/uio/uio0/maps/map0/addr
cat /sys/class/uio/uio0/maps/map0/size

预期输出

text
crw------- ... /dev/uio0
0x00000000a0000000
0x0000000000010000

设备编号和权限可能不同;地址与大小必须和设备树中的 reg 对应。若没有 /dev/uio0,应先检查 dmesg 中是否存在资源冲突、设备树节点未加载或驱动未匹配。

UIO 从 FPGA 到用户态的访问路径

在用户态映射寄存器并等待中断

下面程序以 map0 大小作为参数,映射 /dev/uio0,读取偏移 0x0 的 32 位寄存器,然后阻塞到下一次 IRQ。uio_pdrv_genirq 会在中断处理时屏蔽该 IRQ,因此读取事件后写入 1 重新使能它。

c
#include <fcntl.h>
#include <stdint.h>
#include <stdio.h>
#include <stdlib.h>
#include <sys/mman.h>
#include <unistd.h>

int main(int argc, char **argv) {
    if (argc != 3) {
        fprintf(stderr, "usage: %s /dev/uioX <map_size>\n", argv[0]);
        return 2;
    }

    size_t map_size = strtoull(argv[2], NULL, 0);
    int fd = open(argv[1], O_RDWR);
    if (fd < 0) {
        perror("open");
        return 1;
    }

    /* offset 0 表示映射 UIO 的 map0。 */
    volatile uint32_t *regs = mmap(NULL, map_size, PROT_READ | PROT_WRITE,
                                   MAP_SHARED, fd, 0);
    if (regs == MAP_FAILED) {
        perror("mmap");
        close(fd);
        return 1;
    }

    printf("REG0=0x%08x\n", regs[0]);

    /* read 会阻塞,直到 UIO 收到下一次硬件中断。 */
    uint32_t irq_count;
    if (read(fd, &irq_count, sizeof(irq_count)) != sizeof(irq_count)) {
        perror("read irq");
        munmap((void *)regs, map_size);
        close(fd);
        return 1;
    }

    printf("irq_count=%u\n", irq_count);

    uint32_t enable = 1;
    if (write(fd, &enable, sizeof(enable)) != sizeof(enable)) {
        perror("reenable irq");
    }

    munmap((void *)regs, map_size);
    close(fd);
    return 0;
}

编译并运行:

bash
cc -O2 -Wall -Wextra uio_fpga.c -o uio_fpga
sudo ./uio_fpga /dev/uio0 0x10000

预期输出

text
REG0=0x<REGISTER_VALUE>
irq_count=<ID>

<REGISTER_VALUE> 取决于 FPGA 当前寄存器值,<ID> 是 UIO 累计的中断计数。程序会停在 read,直到硬件真正产生中断;如果一直阻塞,应先确认 FPGA 已置位中断源,再检查 GIC 触发类型与设备树描述。

明确 UIO 的边界

UIO 适合寄存器面较小、事件模型简单、主要由单个受控进程使用的 FPGA 控制面,例如状态寄存器、低速命令邮箱或原型验证。它的优势是迭代快,用户态可以直接调试业务协议。

当设备需要 DMA 映射与缓存一致性、多个进程并发访问、精细电源管理、复杂错误恢复、与网络、块设备、TTY、IIO 等内核子系统集成,或必须建立强隔离和稳定 ABI 时,应改写为完整内核驱动。UIO 不是完整设备驱动的万能替代,而是把简单硬件控制逻辑留给用户态的一种受限接口。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

用 UIO 访问 FPGA 寄存器

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通