1. PCIe BAR空间基础：BAR寄存器的作用、类型与地址映射原理

1.1 BAR寄存器的作用

Base Address Register（BAR）是PCIe设备配置空间（Configuration Space）中最重要的寄存器之一，位于配置空间的偏移0x10~0x24处（每个BAR占4字节，最多6个）。BAR的核心作用是向系统软件（如BIOS、OS内核）声明设备需要多少地址空间，以及该空间属于哪种类型，从而让系统为设备分配物理地址范围，使CPU能够通过内存或I/O指令访问设备内部的寄存器、FIFO或内存缓冲区。

1.2 BAR的类型：Memory BAR 与 IO BAR

PCIe规范定义了两种BAR类型，其差异直接影响驱动开发中的访问方式与错误处理路径：

1.3 BAR寄存器的硬件编码与空间大小计算

BAR寄存器的低比特位被硬件用于类型标识，高比特位用于空间大小声明。系统软件通过“写全1再读回”的经典算法来确定BAR所需空间：

1. 保存原始值： 读取BAR当前值并保存。
2. 写入全1： 向BAR写入 0xFFFFFFFF（32位）或 0xFFFFFFFFFFFFFFFF（64位）。
3. 读回掩码值： 读取BAR，硬件会返回一个值，其中低比特位固定为类型标识，高比特位中实际可用的地址位被置0，不可用的位被置1。
4. 计算大小： 对读回值取反后加1，即得到BAR所需地址空间的大小（必须是2的幂次）。
5. 恢复原始值： 写回第一步保存的原始值。

以下是一个典型的BAR大小探测代码片段：

// 探测BAR0的大小（32位Memory BAR示例）
uint32_t bar_orig = pci_read_config_dword(pdev, 0x10);
pci_write_config_dword(pdev, 0x10, 0xFFFFFFFF);
uint32_t bar_mask = pci_read_config_dword(pdev, 0x10);
pci_write_config_dword(pdev, 0x10, bar_orig);

// 解析类型：bit0 = 0 表示Memory BAR
if ((bar_mask & 0x1) == 0) {
    // 低4位为类型标识，屏蔽后取反+1得大小
    uint32_t size = (~(bar_mask & 0xFFFFFFF0)) + 1;
    printk("BAR0 size = %u bytes\n", size);
}

1.4 地址映射原理：从PCIe总线地址到CPU虚拟地址

PCIe地址映射涉及三个层次：PCIe总线地址（Bus Address）、系统物理地址（Physical Address）和CPU虚拟地址（Virtual Address）。驱动开发者最关心的是如何将BAR中分配的物理地址转换为内核可访问的虚拟地址。

1.5 BAR类型编码速查表

BAR寄存器的低比特位编码决定了其类型和地址宽度，驱动开发者在解析BAR时必须正确识别：

1.6 常见BAR操作错误与调试思路预览

在后续章节中，我们将深入解析以下BAR操作相关的典型错误码及其调试方法。这里先列出与BAR基础概念直接相关的几类：

• 错误码 -EINVAL (Invalid argument)： 通常因BAR类型解析错误导致，如将64-bit BAR的低32位当作独立BAR处理。
• 错误码 -ENOMEM (Out of memory)： ioremap失败，可能因BAR请求空间过大或系统预留MMIO空间不足。
• 错误码 -EIO (I/O error)： 访问BAR映射区域时发生PCIe致命错误（如UR/CA），通常与地址对齐或BAR未使能有关。
• 错误码 -EBUSY (Device or resource busy)： BAR已被其他驱动或子系统占用，常见于IO BAR冲突。