2. PCI 子系统概述：总线拓扑、配置空间、BAR 空间与中断机制

PCI（Peripheral Component Interconnect）子系统是 Linux 内核中连接 CPU 与外围设备的核心总线架构。对于网络设备驱动开发者而言，理解 PCI 的拓扑结构、配置空间、BAR 空间以及中断机制，是编写稳定、高性能驱动的基础。本章将系统梳理这些关键概念，并辅以图表与代码示例，帮助你建立完整的 PCI 驱动知识框架。

2.1 PCI 总线拓扑结构

PCI 总线采用树形拓扑结构，由 根桥（Root Bridge）、PCI 桥（PCI Bridge） 和 PCI 设备（PCI Device） 组成。根桥连接 CPU 与主 PCI 总线，PCI 桥用于扩展总线层级，每个 PCI 设备挂载在一条逻辑总线上。

2.2 PCI 配置空间

每个 PCI 设备都拥有 256 字节 的配置空间（Configuration Space），其中前 64 字节为预定义头部（Header Type 0），包含设备识别、控制、状态和基地址寄存器等信息。Linux 内核通过 pci_read_config_* 和 pci_write_config_* 系列函数访问配置空间。

2.3 BAR 空间：内存映射与 I/O 映射

基地址寄存器（BAR）是 PCI 设备与 CPU 通信的桥梁。每个 BAR 描述一段设备地址空间，可以是 内存映射（Memory-Mapped） 或 I/O 映射（I/O-Mapped）。驱动通过读取 BAR 获取物理地址，再通过 ioremap() 将其映射到内核虚拟地址空间。

// 获取 BAR0 的物理地址和大小
resource_size_t bar_start = pci_resource_start(pdev, 0);
resource_size_t bar_len   = pci_resource_len(pdev, 0);

// 将物理地址映射到内核虚拟地址
void __iomem *regs = ioremap(bar_start, bar_len);
if (!regs) {
    dev_err(&pdev->dev, "ioremap failed\n");
    return -ENOMEM;
}

// 通过映射后的地址读写寄存器
u32 val = readl(regs + REG_OFFSET);
writel(val | BIT(0), regs + REG_OFFSET);

2.4 中断机制：INTx、MSI 与 MSI-X

PCI 设备支持三种中断机制：传统的 INTx（中断引脚）、MSI（Message Signaled Interrupts）和 MSI-X（扩展 MSI）。现代高性能网络设备普遍采用 MSI-X，因为它支持每个队列独立中断，极大提升多核系统的负载均衡能力。

2.5 中断处理函数注册示例

以下代码展示了在 PCI 驱动探测函数中注册 MSI-X 中断的典型流程：

static int my_pci_probe(struct pci_dev *pdev, const struct pci_device_id *id)
{
    struct my_adapter *adapter;
    int ret, i, nvec;

    // 1. 启用 PCI 设备
    ret = pci_enable_device(pdev);
    if (ret)
        return ret;

    // 2. 申请 MSI-X 中断向量（每个队列一个）
    nvec = pci_alloc_irq_vectors(pdev, 1, num_queues, PCI_IRQ_MSIX);
    if (nvec < 0) {
        dev_err(&pdev->dev, "Failed to allocate MSI-X vectors\n");
        pci_disable_device(pdev);
        return nvec;
    }

    // 3. 为每个向量注册中断处理函数
    for (i = 0; i < nvec; i++) {
        int irq = pci_irq_vector(pdev, i);
        ret = request_irq(irq, my_interrupt_handler, 0,
                          "my_driver", &adapter->queue[i]);
        if (ret) {
            dev_err(&pdev->dev, "Failed to request IRQ %d\n", irq);
            goto err_free_irqs;
        }
    }

    // ... 其他初始化 ...

    return 0;

err_free_irqs:
    while (--i >= 0)
        free_irq(pci_irq_vector(pdev, i), &adapter->queue[i]);
    pci_free_irq_vectors(pdev);
    pci_disable_device(pdev);
    return ret;
}

2.6 本章小结

• PCI 拓扑 采用树形结构，BDF 编号唯一标识设备。
• 配置空间 包含设备识别、BAR 地址和中断信息，是驱动探测的入口。
• BAR 空间 通过 ioremap() 映射到内核虚拟地址，驱动通过 readl/writel 访问。
• 中断机制 优先使用 MSI-X，其次 MSI，最后 INTx。MSI-X 支持每个队列独立中断，是多队列网卡的最佳选择。