Linux下自定义PCIe设备通信遇mmap()错误求助（UIO驱动）

作为刚接触Linux设备驱动和系统调用编程的新手，遇到UIO设备的mmap问题太正常了，我来帮你一步步排查和解决。

先把你的问题背景和代码片段整理清楚：

我正尝试在Linux系统中与一款自定义PCIe设备通信，此前无系统调用编程及Linux设备驱动开发经验。我为该设备加载uio_pci_generic驱动后生成字符设备/dev/uio0，该设备仅含一个128K大小的BAR0。我编写如下C程序以导出设备中128K数据至文件时，遇到UIO设备（uio_pci_generic）的mmap()错误：

#include <sys/stat.h>
#include <fcntl.h>
#include <sys/mman.h>
#include <stdio.h>
#define MMBLOCK_SIZE 0x20000  // 128K = 131072字节 = 0x20000
int main() {
    int fd = open("/dev/uio0", O_RDWR);
    if (fd < 0) {
        perror("Failed to open /dev/uio0");
        return 1;
    }
    // 假设这里的mmap调用出现错误
    void *map_addr = mmap(NULL, MMBLOCK_SIZE, PROT_READ | PROT_WRITE, MAP_SHARED, fd, 0);
    if (map_addr == MAP_FAILED) {
        perror("mmap failed");
        close(fd);
        return 1;
    }
    // 后续导出数据到文件的逻辑...
    munmap(map_addr, MMBLOCK_SIZE);
    close(fd);
    return 0;
}

常见的mmap错误原因及解决方法 #

• 权限问题：默认情况下/dev/uio0的访问权限仅限root用户，如果你用普通用户运行程序，大概率会触发"Permission denied"错误。可以临时用sudo ./your_program运行，或者修改设备权限sudo chmod 666 /dev/uio0（重启后权限会恢复默认）。
• 错误的内存保护参数：如果你的BAR0硬件本身是只读的，代码中用PROT_READ | PROT_WRITE会导致mmap失败。可以先尝试只传PROT_READ测试是否能映射成功，再根据硬件实际权限调整。
• 偏移量或长度不符合页对齐要求：Linux的mmap要求映射长度和偏移量必须是系统页大小（通常是4K）的整数倍。虽然128K是4K的整数倍，但如果你的代码中硬编码的长度和实际BAR大小不匹配，或者偏移量不是map编号 * 页大小（BAR0对应map0，偏移量应为0），也会触发错误。
• 驱动未正确识别BAR：可以通过sysfs节点确认驱动是否正确读取了BAR信息，比如查看/sys/class/uio/uio0/maps/map0/size确认大小是否为0x20000，查看/sys/class/uio/uio0/maps/map0/perm确认权限是否符合预期。

调试与修正后的示例代码 #

首先，一定要看perror输出的具体错误信息，这是定位问题的关键。比如"Invalid argument"通常指向参数错误，"Permission denied"就是权限问题。

下面是修正后的代码，加入了从sysfs读取真实BAR信息的逻辑，避免硬编码错误：

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

int main() {
    // 打开UIO设备
    int fd = open("/dev/uio0", O_RDWR);
    if (fd < 0) {
        perror("Failed to open /dev/uio0");
        return 1;
    }

    // 从sysfs读取BAR0的实际大小
    FILE *size_file = fopen("/sys/class/uio/uio0/maps/map0/size", "r");
    if (!size_file) {
        perror("Failed to open size file");
        close(fd);
        return 1;
    }
    unsigned long mmblock_size;
    fscanf(size_file, "%lx", &mmblock_size);
    fclose(size_file);

    // 确保映射长度对齐到系统页大小
    size_t page_size = getpagesize();
    unsigned long mapped_size = ((mmblock_size + page_size - 1) / page_size) * page_size;

    // 执行mmap映射
    void *map_addr = mmap(NULL, mapped_size, PROT_READ | PROT_WRITE, MAP_SHARED, fd, 0);
    if (map_addr == MAP_FAILED) {
        perror("mmap failed");
        close(fd);
        return 1;
    }

    // 将BAR0数据导出到文件
    FILE *out_file = fopen("pcie_bar0_data.bin", "wb");
    if (!out_file) {
        perror("Failed to open output file");
        munmap(map_addr, mapped_size);
        close(fd);
        return 1;
    }
    fwrite(map_addr, 1, mmblock_size, out_file);
    fclose(out_file);

    // 清理资源
    munmap(map_addr, mapped_size);
    close(fd);
    printf("Successfully exported %lu bytes from BAR0 to pcie_bar0_data.bin\n", mmblock_size);
    return 0;
}

额外注意事项 #

• 编译时直接用gcc your_program.c -o your_program即可，不需要额外链接库。
• 可以用lspci -v确认设备是否被uio_pci_generic驱动正确接管，查看输出中的Kernel driver in use字段。
• 如果映射成功后读写数据出现异常，要检查硬件端的BAR配置是否正确，比如是否启用了BAR、地址范围是否正确。

内容的提问来源于stack exchange，提问作者ayazar