3. PCIe设备枚举：Linux内核PCI子系统初始化、设备扫描、资源分配、驱动匹配

PCIe设备枚举是设备驱动开发的基石。当系统上电后，Linux内核PCI子系统会经历四个关键阶段：子系统初始化、总线扫描与设备发现、资源分配（BAR空间、中断）、驱动匹配与绑定。理解这一流程，是编写正确、高效PCIe驱动的第一步。

3.1 PCI子系统初始化流程

Linux内核在启动早期，通过pci_subsys_init()函数初始化PCI子系统。该过程主要完成以下工作：

1. 解析ACPI表：从UEFI/BIOS获取PCIe主桥（Root Complex）的MMIO和I/O端口基地址。
2. 创建pci_host_bridge：为每个PCIe域（Domain）创建一个主机桥结构体，管理该域下的所有总线。
3. 注册总线操作集：绑定pci_ops（如pci_read_config_word），用于后续配置空间访问。
4. 初始化资源管理器：准备struct resource树，用于管理MEM、I/O、BUS号等资源。

3.2 设备扫描：从总线0到叶子节点

内核使用深度优先搜索（DFS）算法遍历PCIe总线拓扑。扫描从总线0（Root Bus）开始，逐级向下发现桥设备（Bridge）和端点设备（Endpoint）。

扫描的核心函数是pci_scan_bus()，其内部逻辑如下表所示：

以下SVG图展示了PCIe总线扫描的递归流程：

3.3 资源分配：BAR空间与中断号

设备扫描完成后，内核进入资源分配阶段。每个PCIe功能（Function）最多支持6个Base Address Register（BAR），用于声明设备需要的MMIO或I/O空间大小。

3.3.1 BAR空间分配流程

1. 读取BAR原始值：向BAR写入全1（0xFFFFFFFF），再读回，通过低比特位的0的个数计算所需空间大小（2^N对齐）。
2. 判断类型：检查BAR的bit 0（I/O vs Memory）和bit 1-2（32-bit vs 64-bit）。
3. 分配地址：内核资源管理器从pci_host_bridge的可用窗口中切割一段地址，写入BAR。
4. 使能MEM/I/O空间：设置Command Register的bit 0（I/O Space Enable）和bit 1（Memory Space Enable）。

3.3.2 中断资源分配

PCIe中断分为三种类型，其资源分配方式如下表：

以下SVG图展示了BAR空间分配与中断资源分配的协同关系：

3.4 驱动匹配：设备ID与驱动绑定

资源分配完成后，内核将扫描到的struct pci_dev插入设备模型。驱动匹配基于设备ID表（struct pci_device_id）进行，匹配成功后调用驱动的probe()函数。

3.4.1 匹配机制

内核通过pci_match_device()函数执行匹配，优先级如下：

1. 精确匹配：Vendor ID + Device ID + Subsystem Vendor ID + Subsystem Device ID + Class + Class Mask 全部匹配。
2. 通配匹配：使用PCI_ANY_ID（0xFFFF）匹配任意厂商或设备。
3. Class匹配：仅匹配设备类别（如Network Controller、Storage Controller）。

3.4.2 典型驱动模板

以下是一个标准的PCIe驱动probe流程代码片段：

// 设备ID表
static const struct pci_device_id my_pci_ids[] = {
    { PCI_DEVICE(0x10EE, 0x1234) },  // Vendor: Xilinx, Device: DMA Engine
    { PCI_DEVICE(0x8086, 0xABCD) },  // Vendor: Intel, Device: Custom FPGA
    { 0, }  // 结束标记
};
MODULE_DEVICE_TABLE(pci, my_pci_ids);

// probe函数
static int my_pci_probe(struct pci_dev *pdev, const struct pci_device_id *id)
{
    int ret;
    struct my_dev *dev;

    // 1. 使能PCIe设备
    ret = pci_enable_device(pdev);
    if (ret)
        return ret;

    // 2. 设置DMA掩码（64-bit优先）
    ret = dma_set_mask_and_coherent(&pdev->dev, DMA_BIT_MASK(64));
    if (ret)
        ret = dma_set_mask_and_coherent(&pdev->dev, DMA_BIT_MASK(32));
    if (ret)
        goto err_disable;

    // 3. 分配BAR资源
    ret = pci_request_regions(pdev, "my_driver");
    if (ret)
        goto err_disable;

    // 4. 映射BAR0到CPU虚拟地址
    dev->bar0 = pci_iomap(pdev, 0, 0);
    if (!dev->bar0) {
        ret = -ENOMEM;
        goto err_release;
    }

    // 5. 分配MSI-X中断向量
    ret = pci_alloc_irq_vectors(pdev, 1, 4, PCI_IRQ_MSIX);
    if (ret < 0)
        goto err_unmap;

    // 6. 注册中断处理函数
    ret = request_irq(pci_irq_vector(pdev, 0), my_isr, 0,
                      "my_pcie_dev", dev);
    if (ret)
        goto err_free_vectors;

    // 7. 保存设备私有数据
    pci_set_drvdata(pdev, dev);

    return 0;

err_free_vectors:
    pci_free_irq_vectors(pdev);
err_unmap:
    pci_iounmap(pdev, dev->bar0);
err_release:
    pci_release_regions(pdev);
err_disable:
    pci_disable_device(pdev);
    return ret;
}

3.5 枚举阶段常见问题与调试

通过以上四个阶段的协同工作，Linux内核完成了从硬件拓扑发现到驱动绑定的完整枚举流程。下一阶段，驱动开发者将在此基础上，实现DMA引擎的初始化和中断处理逻辑。