2. PCIe基础回顾

PCIe 驱动适配的难点，往往不在“写代码”，而在于把硬件拓扑、配置空间、地址映射、事务层报文、DMA 与中断这几件事串成一条完整的因果链。本节把这条链拆开再合上，帮助你在调试时快速定位问题发生在哪一层。

一、PCIe 拓扑结构：从 Root Complex 到 Endpoint

PCIe 采用树形拓扑。最上层是 Root Complex（RC），它连接 CPU 与内存子系统，并向下发出一个或多个 Root Port。Root Port 之下可以接 Switch，Switch 再扩展出多个下游端口，最终连接 Endpoint（EP）或 Legacy PCIe 设备。每个 PCIe 设备在系统中都有一个唯一的 BDF（Bus:Device.Function）标识，驱动通过 BDF 找到设备，再通过配置空间读取其能力与资源需求。

理解拓扑的意义在于：当设备枚举失败、链路训练不成功或带宽不足时，问题可能出在 RC、Switch 上游端口、下游端口或 EP 本身。驱动调试时，lspci -t 能直观展示这棵树，而 lspci -vv 则给出每个节点的链路状态、协商速率与宽度。

二、配置空间与 BAR：驱动如何“看见”设备

每个 PCIe 功能都拥有 4KB 配置空间。前 256 字节是标准 PCI 配置头，包含 Vendor ID、Device ID、Command、Status、Class Code 等；从 0x100 开始是 PCIe 扩展能力，如 Power Management、MSI/MSI-X、PCIe Capability、AER 等。驱动通过 pci_read_config_dword() 等接口读取这些字段，判断设备类型、能力与资源需求。

BAR（Base Address Register）是配置空间中最关键的资源声明。设备通过 BAR 告诉系统“我需要多大一块 MMIO 或 I/O 空间”。系统枚举时写入全 1 再读回，探测 BAR 大小，然后分配物理地址并回写。驱动在 probe 阶段调用 pci_request_regions() 和 pci_iomap()，把 BAR 映射为内核虚拟地址，之后才能读写设备寄存器。

三、TLP、DMA 与中断：数据如何流动

TLP（Transaction Layer Packet）是 PCIe 事务层的基本传输单元。常见的 TLP 类型包括 Memory Read/Write、Configuration Read/Write、Completion、Message。驱动写寄存器时，CPU 发出 Memory Write TLP；设备 DMA 写内存时，设备发出 Memory Write TLP 到 RC，最终写入 DRAM。理解 TLP 有助于分析“寄存器写不进去”“DMA 数据错位”“Completion 超时”等问题。

DMA 是设备与内存之间直接搬移数据的方式。驱动需要分配 DMA 缓冲区，得到 CPU 虚拟地址和总线地址（DMA address），把总线地址写入设备寄存器，设备据此发起 DMA。现代驱动通常使用 dma_alloc_coherent() 或 dma_map_single()，并注意 cache 一致性与 IOMMU 映射。

中断机制方面，PCIe 支持 INTx、MSI、MSI-X。MSI-X 支持更多向量和独立地址/数据，适合多队列设备。驱动通过 pci_alloc_irq_vectors() 申请向量，注册中断处理函数，在中断中读取状态寄存器、处理完成事件并清除中断。

四、案例与误区复盘

某网卡驱动在 probe 中读取 BAR0 后直接 ioremap，但未调用 pci_request_mem_regions()，导致与另一个驱动争用同一区域，系统随机崩溃。复盘结论：BAR 映射前必须先声明资源占用，否则资源冲突不会在 probe 阶段暴露。

另一个常见误区是忽略 MSI-X 向量数量与队列数量的匹配。驱动申请了 8 个向量，但设备实际只使能了 4 个，剩余中断永远不来，表现为“部分队列超时”。正确做法是读取 MSI-X Capability 中的 Table Size，按实际能力申请向量。