3. BAR空间原理：BAR寄存器作用、内存映射与IO映射、BAR空间大小计算

BAR（Base Address Register，基地址寄存器）是PCIe设备配置空间中最关键的寄存器组之一。它决定了主机CPU如何访问设备的内部资源（寄存器、FIFO、本地内存等）。理解BAR的工作原理是进行设备驱动开发与DMA传输设计的基础。

3.1 BAR寄存器的作用

每个PCIe Function最多支持6个BAR（Type 0 Header）或2个BAR（Type 1 Header，用于Bridge）。BAR的核心作用包括：

• 资源声明：设备通过BAR向系统报告自己需要多大的地址空间（Memory或IO）。
• 基地址协商：系统固件（BIOS/UEFI）在枚举过程中向BAR写入全1，读取回值以确定空间大小，然后分配实际基地址。
• 地址映射：系统将BAR中存储的基地址映射到CPU的物理地址空间或IO地址空间，驱动通过该地址访问设备。
• 类型指示：BAR的低位比特指示空间类型（Memory/IO）、预取属性、64位寻址等。

3.2 内存映射与IO映射

PCIe BAR支持两种地址空间映射方式：Memory Space（内存空间）和I/O Space（IO空间）。现代PCIe设备几乎全部使用Memory映射，IO映射仅用于兼容老旧设备。

3.3 BAR空间大小计算原理

系统通过“写全1再读回”的机制确定BAR空间大小。这是PCI/PCIe枚举过程中的标准步骤。

3.3.1 计算步骤

1. 保存原始值：读取BAR当前值并保存。
2. 写入全1：向BAR写入0xFFFFFFFF（32位BAR）或0xFFFFFFFFFFFFFFFF（64位BAR）。
3. 读回掩码值：读取BAR，得到的是地址掩码。低比特位被硬件强制置0，表示可编程的地址位。
4. 恢复原始值：将保存的原始值写回BAR。
5. 计算大小：对读回的掩码值取反，加1，即得到BAR空间大小。

3.3.2 示例计算

假设一个32位Memory BAR，硬件设计需要1MB空间：

• 硬件内部将低20位（对应1MB）硬连线为0，高12位可编程。
• 写入0xFFFFFFFF后，读回值为0xFFF00000（低20位为0）。
• 掩掉低4位：0xFFF00000 & 0xFFFFFFF0 = 0xFFF00000。
• 取反：~0xFFF00000 = 0x000FFFFF。
• 加1：0x000FFFFF + 1 = 0x00100000 = 1MB。

3.4 BAR空间大小与对齐规则

BAR空间大小必须是2的幂次，且基地址必须按大小对齐。这是PCIe规范强制要求的硬件设计约束。

3.5 BAR类型与属性编码

BAR寄存器的低4位用于编码空间类型和属性。驱动在读取BAR基地址前，必须先解析这些比特位。

3.6 BAR空间映射完整流程

下图展示了从设备硬件设计到驱动最终访问的完整BAR映射链路：

3.7 驱动中BAR操作代码示例

以下代码展示了Linux驱动中读取BAR信息、计算大小并进行ioremap的标准流程：

#include <linux/pci.h>
#include <linux/io.h>

static int my_pcie_probe(struct pci_dev *pdev, const struct pci_device_id *id)
{
    unsigned long bar_start;
    unsigned long bar_len;
    void __iomem *bar_virt;
    u32 bar_val, bar_mask;
    int i;

    // 遍历所有BAR（最多6个）
    for (i = 0; i < 6; i++) {
        // 读取BAR原始值
        pci_read_config_dword(pdev, PCI_BASE_ADDRESS_0 + i*4, &bar_val);

        // 判断BAR是否有效（全0表示未实现）
        if (bar_val == 0)
            continue;

        // 判断类型：Memory还是IO
        if (bar_val & PCI_BASE_ADDRESS_SPACE_IO) {
            dev_info(&pdev->dev, "BAR%d: I/O Space\n", i);
            continue; // 现代驱动通常跳过IO BAR
        }

        // 获取BAR物理起始地址（掩掉低4位属性位）
        bar_start = bar_val & PCI_BASE_ADDRESS_MEM_MASK;

        // 计算BAR大小：写全1，读回掩码
        pci_write_config_dword(pdev, PCI_BASE_ADDRESS_0 + i*4, 0xFFFFFFFF);
        pci_read_config_dword(pdev, PCI_BASE_ADDRESS_0 + i*4, &bar_mask);
        pci_write_config_dword(pdev, PCI_BASE_ADDRESS_0 + i*4, bar_val); // 恢复

        // 掩掉低4位，取反加1
        bar_mask &= PCI_BASE_ADDRESS_MEM_MASK;
        bar_len = ~bar_mask + 1;

        dev_info(&pdev->dev, "BAR%d: start=0x%lx, len=%lu bytes\n",
                 i, bar_start, bar_len);

        // 映射到内核虚拟地址空间
        bar_virt = pci_ioremap_bar(pdev, i);
        if (!bar_virt) {
            dev_err(&pdev->dev, "ioremap BAR%d failed\n", i);
            return -ENOMEM;
        }

        // 保存虚拟地址供后续访问
        pci_set_drvdata(pdev, bar_virt);

        // 示例：读取设备ID寄存器（假设偏移0x00）
        u32 dev_id = readl(bar_virt + 0x00);
        dev_info(&pdev->dev, "Device ID: 0x%08x\n", dev_id);
    }

    return 0;
}

3.8 常见问题与调试方法