2. PCIe配置空间与BAR空间

PCIe配置空间是软件发现、枚举和初始化设备的核心入口。每个PCIe Function都拥有独立的4KB配置空间（传统PCI仅256字节），其中前64字节为兼容的配置头，剩余部分用于扩展能力结构。BAR（Base Address Register）位于配置头中，负责将设备内部寄存器/内存映射到系统地址空间，是驱动与设备交互的桥梁。

2.1 配置空间结构

PCIe配置空间采用分层结构，兼容传统PCI配置头（Type 0/Type 1），并在256字节之后扩展了PCIe能力结构。Type 0用于Endpoint，Type 1用于Switch/Root Port。

2.1.1 配置头关键字段

2.2 BAR寄存器解析

BAR（Base Address Register）位于配置头偏移0x10~0x24，共6个32位寄存器（64位BAR占用连续两个）。BAR定义了设备请求的地址空间类型、大小和对齐要求。驱动通过读取BAR值并执行“写全1再读回”的探测流程来确定BAR空间大小。

2.2.1 BAR寄存器位域定义

2.2.2 BAR类型与映射方式

2.3 内存映射与IO映射机制

系统软件（BIOS/UEFI或操作系统）在枚举PCIe设备时，为每个BAR分配系统物理地址空间。驱动通过ioremap()或mmap()将物理地址映射到内核/用户虚拟地址空间，从而实现对设备寄存器的读写访问。

2.3.1 内存映射I/O（MMIO）

MMIO将设备BAR空间映射到系统的物理内存地址区域，CPU通过普通的load/store指令访问设备寄存器。MMIO支持字节、半字、字、双字等任意粒度访问，但必须保证访问对齐和顺序性。

/* Linux内核驱动MMIO映射示例 */
#include <linux/pci.h>
#include <linux/io.h>

static int my_pci_probe(struct pci_dev *pdev, const struct pci_device_id *id)
{
    struct my_dev *dev;
    unsigned long mmio_start, mmio_len;
    void __iomem *mmio_base;

    // 启用PCI设备
    pci_enable_device(pdev);
    // 设置总线主控（DMA）
    pci_set_master(pdev);

    // 获取BAR0的物理地址和长度
    mmio_start = pci_resource_start(pdev, 0);
    mmio_len   = pci_resource_len(pdev, 0);

    // 将物理地址映射到内核虚拟地址空间
    mmio_base = ioremap(mmio_start, mmio_len);
    if (!mmio_base) {
        dev_err(&pdev->dev, "ioremap failed\n");
        return -ENOMEM;
    }

    // 通过MMIO读写设备寄存器
    u32 val = ioread32(mmio_base + 0x100);  // 读偏移0x100
    iowrite32(0x1, mmio_base + 0x104);      // 写偏移0x104

    // 使用readl/writel等带内存屏障的访问函数
    writel(0x2, mmio_base + 0x200);

    dev->mmio_base = mmio_base;
    pci_set_drvdata(pdev, dev);
    return 0;
}

2.3.2 I/O映射（Port-Mapped I/O）

I/O映射使用独立的I/O地址空间，通过in/out指令（x86）访问。I/O空间大小限制为64KB（0x0000~0xFFFF），且不支持64位地址。在非x86平台上，I/O空间通常通过MMIO模拟或直接不存在。

/* Linux内核驱动I/O映射示例（x86平台） */
#include <asm/io.h>

static int my_pci_probe_io(struct pci_dev *pdev, const struct pci_device_id *id)
{
    unsigned long io_start, io_len;
    unsigned long io_flags;

    // 获取BAR1的I/O基地址
    io_start = pci_resource_start(pdev, 1);
    io_len   = pci_resource_len(pdev, 1);
    io_flags = pci_resource_flags(pdev, 1);

    if (!(io_flags & IORESOURCE_IO)) {
        dev_err(&pdev->dev, "BAR1 is not I/O space\n");
        return -EINVAL;
    }

    // 请求I/O端口区域
    if (!request_region(io_start, io_len, "my_device")) {
        dev_err(&pdev->dev, "I/O port region busy\n");
        return -EBUSY;
    }

    // 通过inb/outb访问I/O端口
    u8 status = inb(io_start + 0x0);   // 读状态寄存器
    outb(0x80, io_start + 0x4);        // 写控制寄存器

    return 0;
}

2.3.3 MMIO与I/O映射对比

2.4 BAR空间探测与地址分配流程

2.5 跨平台移植关键点

• I/O空间不可移植： ARM/ARM64/RISC-V平台没有in/out指令，驱动必须使用MMIO方式访问设备。如果硬件强制使用I/O BAR，需在驱动中通过平台抽象层（如pci_iomap()）统一处理。
• 内存屏障与顺序性： MMIO访问在x86上默认是强序的，但在ARM/PowerPC等弱序平台上必须使用wmb()/rmb()/mmiowb()保证访问顺序。推荐使用readl/writel系列带屏障的函数。
• 64位BAR支持： 32位系统无法访问64位BAR的高32位地址。跨平台驱动应检查BAR类型，必要时使用dma_set_mask()设置64位DMA掩码。
• 资源申请与释放： 使用pci_request_region()/pci_release_region()管理BAR资源，避免多个驱动冲突。
• 设备树与ACPI： 嵌入式平台（ARM）通常使用设备树描述PCIe地址映射，x86使用ACPI。驱动应通过pci_resource_start()等通用API获取资源，不直接解析固件表。

/* 跨平台推荐的BAR映射方式 */
#include <linux/pci.h>
#include <linux/io.h>

static int universal_pci_probe(struct pci_dev *pdev, const struct pci_device_id *id)
{
    void __iomem *bar0_base;
    unsigned long bar0_len;

    // pci_iomap 自动处理 MMIO 和 I/O 空间差异
    bar0_base = pci_iomap(pdev, 0, 0);  // bar=0, maxlen=0表示映射全部
    if (!bar0_base)
        return -ENOMEM;

    bar0_len = pci_resource_len(pdev, 0);

    // 使用带内存屏障的访问函数（跨平台安全）
    u32 reg_val = ioread32(bar0_base + 0x10);
    iowrite32(reg_val | 0x1, bar0_base + 0x10);

    // 或者使用 readl/writel（ARM/x86均支持）
    writel(0x3, bar0_base + 0x20);

    // 清理
    pci_iounmap(pdev, bar0_base);
    return 0;
}

2.6 常见问题与调试方法