4. BAR空间映射

PCIe设备的BAR（Base Address Register）空间是设备与主机通信的关键窗口。驱动必须将BAR对应的物理地址映射到内核或用户虚拟地址空间，才能通过指针读写设备寄存器或数据缓冲区。本章深入分析三种映射机制的原理、适用场景与调试要点。

4.1 BAR空间与物理地址获取

每个PCIe设备最多可拥有6个BAR（Type 0）或2个BAR（Type 1）。BAR寄存器存储设备请求的地址空间类型（Memory或I/O）、大小及属性（可预取、64位等）。系统固件或PCI子系统在枚举时分配物理地址并写入BAR。

4.2 ioremap：内核态通用映射

ioremap() 是Linux内核提供的通用物理地址到内核虚拟地址的映射函数。它将BAR的物理基地址映射到内核的vmalloc区域，返回一个可用于 readl()/writel() 等访问函数的虚拟地址。

#include <linux/io.h>

void __iomem *ioremap(phys_addr_t phys_addr, unsigned long size);
void iounmap(void __iomem *addr);

使用步骤：

1. 从 struct pci_dev 的 resource[] 数组获取BAR物理起始地址和长度。
2. 调用 ioremap(pci_resource_start(pdev, bar), pci_resource_len(pdev, bar))。
3. 通过返回的 void __iomem * 指针访问寄存器。
4. 驱动卸载时调用 iounmap() 解除映射。

4.3 pci_ioremap_bar：专用封装接口

pci_ioremap_bar() 是内核为PCIe驱动提供的便捷封装，内部自动处理BAR资源获取、属性检查和映射。它比直接使用 ioremap() 更安全、更简洁。

#include <linux/pci.h>

void __iomem *pci_ioremap_bar(struct pci_dev *pdev, int bar);
void pci_iounmap(struct pci_dev *pdev, void __iomem *addr);

优势对比：

// 典型用法
void __iomem *regs;
regs = pci_ioremap_bar(pdev, 0);
if (!regs) {
    dev_err(&pdev->dev, "Failed to ioremap BAR0\n");
    return -ENOMEM;
}
// 访问寄存器
writel(0x1, regs + 0x10);
// 卸载时
pci_iounmap(pdev, regs);

4.4 mmap用户态映射

用户态程序通过 mmap() 系统调用将PCIe设备的BAR空间映射到进程地址空间，实现零拷贝寄存器访问或数据流传输。内核驱动需实现 struct file_operations 中的 .mmap 回调。

内核侧实现要点：

1. 在驱动中创建字符设备或使用 pci_dev 的 dev 属性。
2. 在 .mmap 回调中调用 remap_pfn_range() 或 io_remap_pfn_range()。
3. 将BAR物理地址右移PAGE_SHIFT作为pfn参数。
4. 设置VMA标志：vma->vm_flags |= VM_IO | VM_DONTEXPAND | VM_DONTDUMP。

static int pci_mmap(struct file *filp, struct vm_area_struct *vma)
{
    struct pci_dev *pdev = filp->private_data;
    unsigned long pfn = pci_resource_start(pdev, 0) >> PAGE_SHIFT;
    unsigned long size = vma->vm_end - vma->vm_start;

    vma->vm_page_prot = pgprot_noncached(vma->vm_page_prot);
    vma->vm_flags |= VM_IO | VM_DONTEXPAND | VM_DONTDUMP;

    if (io_remap_pfn_range(vma, vma->vm_start, pfn, size, vma->vm_page_prot))
        return -EAGAIN;
    return 0;
}

用户态调用示例：

int fd = open("/dev/my_pcie_dev", O_RDWR);
void *bar_map = mmap(NULL, BAR_SIZE, PROT_READ | PROT_WRITE,
                     MAP_SHARED, fd, 0);
// 直接访问寄存器
volatile uint32_t *reg = (volatile uint32_t *)(bar_map + 0x10);
*reg = 0x1;
munmap(bar_map, BAR_SIZE);
close(fd);

4.5 三种映射机制对比与选择

4.6 BAR映射故障定位流程

当BAR映射失败或访问异常时，按以下步骤排查：

1. 确认BAR物理地址： cat /sys/bus/pci/devices/0000:03:00.0/resource 检查地址是否非零。
2. 检查映射返回值： 内核驱动中打印 ioremap 返回地址，确认非NULL且在vmalloc范围。
3. 验证访问属性： 使用 devmem2 工具从用户态读取BAR物理地址，确认设备响应正常。
4. 检查页对齐： mmap要求BAR物理地址和长度按PAGE_SIZE对齐，否则 remap_pfn_range 失败。
5. 查看内核日志： dmesg | grep -i "BAR\|ioremap\|mmap" 捕获映射错误信息。

4.7 调试条件断点设置

在映射函数处设置条件断点，可快速定位BAR参数错误或映射失败原因。

# kgdb条件断点示例
(gdb) break pci_ioremap_bar if bar == 2
(gdb) break ioremap if size > 0x100000
(gdb) break remap_pfn_range if pfn == 0