2. PCIe 配置空间：配置空间结构（Type0/Type1）、Capability 结构、BAR 空间与地址映射

PCIe 配置空间是软件与硬件交互的核心接口，驱动通过读取/写入配置空间来发现设备、分配资源、使能中断及控制链路状态。本章深入解析 Type0/Type1 配置空间布局、Capability 链表机制、BAR 空间定义及地址映射原理，为后续驱动加载与调试打下坚实基础。

2.1 配置空间访问机制

PCIe 保留了 PCI 的配置空间访问模型，但扩展为 4 KB（PCI 仅为 256 字节）。前 256 字节（Offset 0x00–0xFF）称为 PCI 兼容配置空间，与 PCI 标准完全兼容；扩展部分（Offset 0x100–0xFFF）称为 PCIe 扩展配置空间，用于存放 PCIe 能力结构（Capability Structure）及 Vendor-Specific 扩展。

2.2 Type0 与 Type1 配置空间结构

PCIe 配置空间头部（Header）分为两种类型：Type0 用于 Endpoint（端点设备），Type1 用于 Bridge（桥设备，如 Root Port、Switch Port）。两者前 16 字节结构相同，从 Offset 0x10 开始布局不同。

2.2.1 Type0 配置空间（Endpoint）

2.2.2 Type1 配置空间（Bridge）

2.3 Capability 结构

PCIe 使用 Capability 链表 来扩展功能，每个 Capability 结构以 Cap ID（1 字节）和 Next Cap Pointer（1 字节）开头，形成单向链表。Capabilities Pointer 寄存器（Offset 0x34）指向第一个 Capability 的偏移。

2.3.1 常见 Capability ID

2.3.2 Capability 链表遍历示例

/* 伪代码：遍历 PCIe Capability 链表 */
uint8_t cap_ptr = pci_read_config_byte(dev, 0x34);
while (cap_ptr != 0) {
    uint8_t cap_id = pci_read_config_byte(dev, cap_ptr);
    uint8_t next   = pci_read_config_byte(dev, cap_ptr + 1);
    printf("Capability ID 0x%02X at offset 0x%02X\n", cap_id, cap_ptr);
    if (cap_id == 0x10) {  /* PCIe Capability */
        uint16_t cap_reg = pci_read_config_word(dev, cap_ptr + 2);
        uint8_t  pcie_cap_type = (cap_reg >> 4) & 0x0F;
        printf("  PCIe Capability Type: %d\n", pcie_cap_type);
    }
    cap_ptr = next;
}

2.4 BAR 空间与地址映射

Base Address Register (BAR) 是设备向系统声明所需地址空间的窗口。每个 BAR 可配置为 MMIO（Memory-Mapped I/O） 或 I/O 空间。系统固件（BIOS/UEFI）或操作系统在枚举时写入 BAR 以分配物理地址。

2.4.1 BAR 格式

2.4.2 BAR 大小探测方法

驱动通过 写全 1 再读回 的方式探测 BAR 所需空间大小：

/* 探测 BAR0 大小（32-bit MMIO 示例） */
uint32_t bar_orig = pci_read_config_dword(dev, 0x10);
pci_write_config_dword(dev, 0x10, 0xFFFFFFFF);
uint32_t bar_mask = pci_read_config_dword(dev, 0x10);
pci_write_config_dword(dev, 0x10, bar_orig);  /* 恢复原值 */

/* 计算大小：取反后 +1，再与 ~0xF 对齐 */
uint32_t size = (~(bar_mask & 0xFFFFFFF0)) + 1;
printf("BAR0 size = 0x%X (%d bytes)\n", size, size);

2.4.3 地址映射流程

1. 枚举阶段：系统读取每个设备的 BAR，探测大小和类型。
2. 分配地址：系统根据拓扑和地址空间布局，为每个 BAR 分配物理基址。
3. 写入 BAR：系统将分配好的基址写入 BAR 寄存器。
4. 驱动映射：驱动通过 ioremap() 将物理地址映射到内核虚拟地址空间，之后可通过 readl()/writel() 访问设备寄存器。

void __iomem *bar0_virt = ioremap(pci_resource_start(dev, 0),
                                   pci_resource_len(dev, 0));
if (!bar0_virt) {
    dev_err(&dev->dev, "ioremap failed for BAR0\n");
    return -ENOMEM;
}
/* 访问设备寄存器 */
uint32_t val = readl(bar0_virt + REG_OFFSET);
writel(0x1, bar0_virt + REG_CTRL);

2.5 配置空间结构总览（SVG）

2.6 配置空间调试实用技巧

• lspci -vvv： 查看完整配置空间及 Capability 列表，包括 BAR 地址、大小、中断信息。
• setpci： 直接读写配置空间寄存器，适合快速验证 BAR 探测或 Capability 遍历。
• /sys/bus/pci/devices/.../config： 通过 sysfs 导出配置空间二进制文件，可用 hexdump 分析。
• 内核调试： 在驱动中打印 BAR 资源：dev_info(&dev->dev, "BAR0: phys=%pa, size=%#x\n", &pci_resource_start(dev, 0), pci_resource_len(dev, 0));