3. 设备枚举与资源获取：pci_get_device、pci_enable_device、pci_request_regions、BAR空间解析

在PCIe驱动开发的初始化阶段，核心任务是从总线拓扑中定位目标设备、激活设备电源管理、申请I/O与内存资源，并解析基地址寄存器（BAR）所映射的地址空间。本章围绕这四个关键步骤展开，提供标准API的调用规范、参数含义及常见陷阱。

3.1 设备查找：pci_get_device

驱动首先需要通过 Vendor ID 和 Device ID 在 PCI 总线树上定位目标设备。内核提供 pci_get_device 系列函数完成深度优先遍历。

// 典型查找模式
struct pci_dev *dev = NULL;
while ((dev = pci_get_device(PCI_VENDOR_ID_INTEL, 0x1234, dev)) != NULL) {
    if (pci_dev_is_present(dev)) {
        // 找到目标设备，保存 dev 指针
        break;
    }
}
// 使用完毕后释放引用
pci_dev_put(dev);

3.2 设备使能：pci_enable_device

在访问设备任何资源之前，驱动必须调用 pci_enable_device 使设备脱离 D3cold 状态，开启 I/O 和内存地址解码，并分配必要的电源资源。

int ret;
ret = pci_enable_device(pdev);
if (ret) {
    dev_err(&pdev->dev, "Failed to enable PCI device: %d\n", ret);
    return ret;
}

使能后，设备配置空间中的 Command 寄存器（偏移 0x04）的 Bit 0（I/O Space）和 Bit 1（Memory Space）会被置位，允许总线访问 BAR 映射的地址区域。

3.3 资源申请：pci_request_regions

为防止多个驱动冲突访问同一物理地址范围，内核要求驱动通过 pci_request_regions 声明对设备所有 BAR 区域的独占使用权。

if (pci_request_regions(pdev, "my_pcie_driver")) {
    dev_err(&pdev->dev, "Failed to request PCI regions\n");
    pci_disable_device(pdev);
    return -EBUSY;
}

3.4 BAR空间解析

每个 PCIe 设备最多支持 6 个 BAR（Base Address Register），位于配置空间偏移 0x10~0x24。BAR 寄存器存储了设备请求的地址空间基址、类型（Memory 或 I/O）、可预取属性及地址宽度（32-bit 或 64-bit）。

3.4.1 BAR 寄存器结构

3.4.2 内核解析 API

内核提供 pci_resource_start、pci_resource_end、pci_resource_flags 和 pci_resource_len 宏来安全读取 BAR 信息，无需直接操作配置空间。

// 遍历所有 BAR，打印资源信息
int i;
for (i = 0; i < 6; i++) {
    if (pci_resource_len(pdev, i) == 0)
        continue;  // 未实现的 BAR

    unsigned long start  = pci_resource_start(pdev, i);
    unsigned long end    = pci_resource_end(pdev, i);
    unsigned long flags  = pci_resource_flags(pdev, i);
    unsigned long length = pci_resource_len(pdev, i);

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

    if (flags & IORESOURCE_MEM) {
        // 内存映射 BAR，后续调用 ioremap
        void __iomem *addr = ioremap(start, length);
        if (!addr) {
            dev_err(&pdev->dev, "ioremap failed for BAR%d\n", i);
        }
    } else if (flags & IORESOURCE_IO) {
        // I/O 端口 BAR，使用 inb/outb 系列函数
    }
}

3.5 完整初始化流程 SVG

下图展示了从设备查找到 BAR 映射的完整数据流与函数调用关系：

3.6 常见陷阱与最佳实践

• 64-bit BAR 处理：当 pci_resource_flags 包含 IORESOURCE_MEM_64 时，当前 BAR 与下一个 BAR 共同组成 64-bit 地址。遍历时需跳过下一个 BAR，否则会重复映射。
• BAR 未实现检测：通过 pci_resource_len(pdev, bar) == 0 判断 BAR 是否有效，避免对无效 BAR 执行 ioremap。
• 错误路径清理：在 pci_enable_device 失败后，不应调用 pci_release_regions；在 pci_request_regions 失败后，必须调用 pci_disable_device 回滚使能状态。
• 电源管理交互：如果设备支持 D3cold，pci_enable_device 可能触发电源状态切换，耗时较长。在原子上下文中不可调用。