📚 课程目录第4章 BAR空间映射

4. BAR空间映射：ioremap与pci_ioremap_bar函数详解、物理地址到虚拟地址的转换

PCIe设备通过基地址寄存器（BAR）向系统暴露其内部寄存器或内存区域。CPU无法直接访问这些物理地址，必须通过MMU将物理地址映射到内核虚拟地址空间。本章深入解析BAR空间映射的核心机制、ioremap与pci_ioremap_bar的实现原理，以及物理地址到虚拟地址的完整转换流程。

4.1 BAR空间与物理地址获取

每个PCIe功能最多支持6个BAR（Type 0）或2个BAR（Type 1）。BAR中存储的是设备内部寄存器或内存的物理基地址，该地址由系统固件（BIOS/UEFI）在枚举阶段分配。

BAR类型	地址空间	可预取	典型用途
Memory BAR	32-bit / 64-bit	是/否	DMA描述符环、数据缓冲区、控制寄存器
I/O BAR	16-bit / 32-bit	否	传统I/O端口（x86平台）

关键概念：BAR中存储的地址是总线地址，经过PCIe桥的地址转换后，最终映射到系统物理地址空间。驱动开发者通过pci_resource_start()获取的已经是系统物理地址。

4.2 物理地址到虚拟地址的转换原理

Linux内核运行在虚拟地址空间，设备寄存器必须映射到内核虚拟地址才能被CPU访问。转换过程涉及两个关键层次：

系统物理地址层：BAR中存储的地址经过PCIe域转换后，成为CPU可寻址的物理地址。
内核虚拟地址层：通过页表将物理地址映射到内核虚拟地址空间（vmalloc区域或固定映射区域）。

转换公式：

虚拟地址 = ioremap(物理地址, 大小);
// 或使用封装函数：
虚拟地址 = pci_ioremap_bar(pdev, bar);

4.3 ioremap函数详解

ioremap是内核提供的核心映射函数，用于将I/O内存物理地址映射到内核虚拟地址空间。

#include <linux/io.h>

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

参数/返回值	说明
`phys_addr`	要映射的物理起始地址（通常来自`pci_resource_start()`）
`size`	映射区域的大小（字节），通常为`pci_resource_len()`返回值
`返回值`	映射后的内核虚拟地址（`__iomem`标记），失败返回`NULL`

重要注意事项：

ioremap返回的地址必须使用readl()/writel()等访问函数，不能直接解引用。
映射大小必须与BAR实际资源大小匹配，过大会浪费虚拟地址空间，过小会导致访问越界。
驱动卸载时必须调用iounmap()释放映射，否则会造成虚拟地址泄漏。

4.4 pci_ioremap_bar函数详解

pci_ioremap_bar是PCI子系统提供的便捷封装，内部自动完成BAR资源获取和ioremap调用。

#include <linux/pci.h>

void __iomem *pci_ioremap_bar(struct pci_dev *pdev, int bar);
// 内部实现等价于：
void __iomem *pci_ioremap_bar(struct pci_dev *pdev, int bar)
{
    resource_size_t start = pci_resource_start(pdev, bar);
    resource_size_t len   = pci_resource_len(pdev, bar);
    return ioremap(start, len);
}

特性	ioremap	pci_ioremap_bar
参数复杂度	需要手动获取start和len	只需传入pdev和bar编号
错误检查	无内置资源有效性检查	内部检查BAR是否有效、资源是否已分配
代码可读性	较低，需多行代码	高，一行完成映射
推荐场景	需要精细控制映射参数时	标准PCIe设备驱动（90%场景）

4.5 完整映射流程与代码示例

以下展示一个完整的BAR0映射流程，包含资源获取、映射、访问和释放四个阶段：

static int my_pcie_probe(struct pci_dev *pdev, const struct pci_device_id *id)
{
    void __iomem *bar0_virt;
    unsigned long bar0_start, bar0_len;
    u32 reg_val;

    // 1. 启用PCIe设备
    pci_enable_device(pdev);

    // 2. 获取BAR0物理地址和大小
    bar0_start = pci_resource_start(pdev, 0);
    bar0_len   = pci_resource_len(pdev, 0);

    // 3. 检查BAR0是否为Memory BAR
    if (!(pci_resource_flags(pdev, 0) & IORESOURCE_MEM)) {
        dev_err(&pdev->dev, "BAR0 is not a memory BAR\n");
        return -ENODEV;
    }

    // 4. 映射BAR0到内核虚拟地址空间
    bar0_virt = pci_ioremap_bar(pdev, 0);
    if (!bar0_virt) {
        dev_err(&pdev->dev, "Failed to ioremap BAR0\n");
        pci_disable_device(pdev);
        return -ENOMEM;
    }

    // 5. 通过虚拟地址访问设备寄存器
    reg_val = readl(bar0_virt + 0x00);  // 读取控制寄存器
    writel(0x01, bar0_virt + 0x04);     // 写入命令寄存器

    // 6. 保存虚拟地址供后续使用
    pci_set_drvdata(pdev, bar0_virt);

    return 0;
}

static void my_pcie_remove(struct pci_dev *pdev)
{
    void __iomem *bar0_virt = pci_get_drvdata(pdev);

    // 7. 解除映射
    iounmap(bar0_virt);

    // 8. 禁用设备
    pci_disable_device(pdev);
}

4.6 常见错误与调试技巧

映射大小不匹配：使用pci_resource_len()获取精确大小，不要硬编码。
未检查BAR类型：Memory BAR使用ioremap，I/O BAR使用ioport_map。
虚拟地址泄漏：确保每个ioremap都有对应的iounmap，建议在remove回调中统一释放。
访问越界：映射区域外的访问会导致总线错误（Oops），使用devm_ioremap_resource可自动检查边界。

调试命令：

# 查看PCIe设备的BAR空间分配
lspci -vvv -s 01:00.0 | grep -A 5 "Region"

# 查看内核虚拟地址映射情况
cat /proc/iomem | grep "PCI"

# 使用devres自动管理映射资源（推荐）
void __iomem *bar_virt = devm_ioremap_resource(&pdev->dev,
                            pci_resource_start(pdev, 0),
                            pci_resource_len(pdev, 0));

📚 课程目录

4. BAR空间映射：ioremap与pci_ioremap_bar函数详解、物理地址到虚拟地址的转换

4.1 BAR空间与物理地址获取

4.2 物理地址到虚拟地址的转换原理

4.3 ioremap函数详解

4.4 pci_ioremap_bar函数详解

4.5 完整映射流程与代码示例

4.6 常见错误与调试技巧

4.7 总结