2. PCIe配置空间：配置空间的结构（Type0与Type1）、配置空间寄存器详解（Vendor ID、Device ID、Class Code等）

2.1 配置空间概述

PCIe配置空间是软件与硬件交互的核心接口，用于枚举设备、分配资源、配置中断及控制电源状态。每个PCIe功能（Function）都拥有独立的4KB配置空间，前256字节（偏移0x00~0xFF）兼容传统PCI规范，后256字节（偏移0x100~0xFFF）为PCIe扩展配置空间，包含能力结构（Capability Structures）和扩展能力结构（Extended Capability Structures）。

关键概念：配置空间通过配置读写请求（Configuration Read/Write TLP）访问，由Root Complex（RC）或PCIe桥转发至目标设备。在x86系统中，通过IO端口0xCF8/0xCFC访问传统配置空间；在ARM/嵌入式系统中，通常通过内存映射IO（MMIO）方式访问。

2.2 配置空间结构：Type0与Type1

PCIe配置空间头部（Header）分为两种类型：Type0用于Endpoint（端点设备），Type1用于Switch/Bridge（桥设备）。两者前16字节（偏移0x00~0x0F）结构相同，从偏移0x10开始布局不同。

PCIe配置空间头部结构对比：Type0 vs Type1 Type0 Header（Endpoint） 偏移0x00: Vendor ID (16b) | Device ID (16b) 偏移0x04: Command (16b) | Status (16b) 偏移0x08: Revision ID (8b) | Class Code (24b) 偏移0x0C: Cache Line Size | Latency Timer | Header Type | BIST 偏移0x10~0x24: Base Address Registers (BAR0~BAR5) 偏移0x28~0x2C: Cardbus CIS Pointer / Subsystem IDs 偏移0x30: Expansion ROM Base Address 偏移0x34~0x3C: Capabilities Pointer | Reserved | Interrupt 偏移0x40~0xFF: 能力结构链表（Power Management, MSI, PCIe Cap等） Type1 Header（Bridge/Switch） 偏移0x00~0x0C: 与Type0完全相同（Vendor ID ~ BIST） 偏移0x10~0x14: BAR0, BAR1（仅2个，其余为桥专用） 偏移0x18: Primary Bus Number (8b) 偏移0x19: Secondary Bus Number (8b) 偏移0x1A: Subordinate Bus Number (8b) 偏移0x1C: Secondary Latency Timer (8b) 偏移0x20~0x24: Memory Base/Limit, Prefetchable Base/Limit 偏移0x28~0x3C: I/O Base/Limit, Bridge Control, Interrupt 偏移0x40~0xFF: 能力结构链表（与Type0类似）

2.3 配置空间寄存器详解

2.3.1 关键寄存器字段说明

偏移 寄存器名称 位宽 描述
0x00 Vendor ID 16位 设备制造商标识符，由PCI-SIG分配。例如：0x8086（Intel）、0x10EC（Realtek）、0x1AF4（Red Hat虚拟设备）。
0x02 Device ID 16位 特定设备型号标识符，由厂商自行定义。与Vendor ID组合唯一标识一个设备。
0x04 Command Register 16位 控制设备响应配置/IO/内存访问、总线主控、奇偶校验等行为。位0（IO Space Enable）、位1（Memory Space Enable）、位2（Bus Master Enable）最为常用。
0x06 Status Register 16位 反映设备状态：中断状态、Capabilities List存在、66MHz支持、Fast Back-to-Back等。
0x08 Revision ID 8位 设备修订版本号，由厂商分配。驱动常通过此字段区分不同硬件步进。
0x09 Class Code 24位 设备功能分类：Base Class（字节2）、Sub Class（字节1）、Programming Interface（字节0）。例如：0x010000（Mass Storage Controller - SCSI）、0x020000（Network Controller - Ethernet）、0x030000（Display Controller - VGA）。
0x0C Header Type 8位 位7=0表示多功能设备，位7=1表示单功能设备；位6~0表示头部类型：0x00=Type0（Endpoint）、0x01=Type1（Bridge）。
0x34 Capabilities Pointer 8位 指向能力结构链表的第一个能力结构偏移地址（仅当Status寄存器的Capabilities List位为1时有效）。
调试要点：在驱动初始化阶段，首先读取Vendor ID和Device ID确认设备存在且匹配驱动表。若读取到0xFFFF，表示设备不存在或配置空间访问失败。Class Code用于绑定通用类驱动（如网络、存储、显示），而Subsystem Vendor ID和Subsystem ID用于区分同一芯片的不同板卡变体。

2.3.2 Class Code 编码示例

Class Code是驱动匹配的重要依据，Linux内核通过pci_device_id结构体中的class字段进行匹配。以下为常见Class Code值：

Base Class Sub Class 完整Class Code 设备类型
0x01 0x01 0x010100 IDE Controller
0x01 0x06 0x010600 Serial ATA Controller
0x01 0x08 0x010800 Non-Volatile Memory Controller (NVMe)
0x02 0x00 0x020000 Ethernet Controller
0x03 0x00 0x030000 VGA-Compatible Display Controller
0x06 0x04 0x060400 PCI-to-PCI Bridge
0x0C 0x03 0x0C0300 USB Controller (UHCI)
0x08 0x80 0x088000 Other System Peripheral

2.4 配置空间访问流程

在Linux内核中，访问PCIe配置空间通常通过以下API完成：

/* 读取配置空间32位值 */
u32 pci_read_config_dword(struct pci_dev *dev, int offset, u32 *val);

/* 写入配置空间32位值 */
void pci_write_config_dword(struct pci_dev *dev, int offset, u32 val);

/* 读取Vendor ID和Device ID示例 */
u16 vendor_id, device_id;
pci_read_config_word(dev, PCI_VENDOR_ID, &vendor_id);
pci_read_config_word(dev, PCI_DEVICE_ID, &device_id);

/* 读取Class Code示例 */
u32 class_code;
pci_read_config_dword(dev, PCI_CLASS_REVISION, &class_code);
u8 revision = class_code & 0xFF;
u8 prog_if = (class_code >> 8) & 0xFF;
u8 sub_class = (class_code >> 16) & 0xFF;
u8 base_class = (class_code >> 24) & 0xFF;
注意事项：
  • 配置空间访问必须使用pci_read_config_*/pci_write_config_*系列函数，不要直接对IO端口或MMIO地址操作，以保证跨平台兼容性。
  • 读取配置空间时，若设备不存在或链路断开，可能返回0xFFFFFFFF。驱动应检查此值并优雅处理。
  • 配置空间寄存器大多为只读（RO）或硬件初始化（HwInit），驱动写入前需确认寄存器属性。

2.5 能力结构链表

从偏移0x34的Capabilities Pointer开始，配置空间包含一个能力结构链表。每个能力结构包含：

  • Capability ID（1字节）：标识能力类型，如0x01=Power Management、0x05=MSI、0x10=PCIe Capability。
  • Next Capability Pointer（1字节）：指向下一个能力结构的偏移地址，0x00表示链表结束。
  • 能力特定数据：根据Capability ID不同，后续字节含义各异。
PCIe配置空间能力结构链表 配置空间头部 Cap Pointer
偏移0x34 Capability 1 Power Management (ID=0x01) Capability 2 MSI (ID=0x05) Capability 3 PCIe Cap (ID=0x10) Next = 0x00 (结束) 能力结构格式 字节0: Capability ID 字节1: Next Capability Pointer 字节2+: 能力特定数据

2.6 配置空间调试实战

在Linux用户空间，可以使用lspci和setpci工具直接查看和修改配置空间：

# 查看所有PCIe设备
lspci

# 查看指定设备的详细配置空间（以00:1f.2为例）
lspci -s 00:1f.2 -vvv

# 以十六进制dump配置空间前256字节
lspci -s 00:1f.2 -xxx

# 使用setpci读取Vendor ID
setpci -s 00:1f.2 VENDOR_ID

# 使用setpci读取Class Code
setpci -s 00:1f.2 CLASS_REVISION

# 使用setpci读取Capabilities Pointer
setpci -s 00:1f.2 CAP_POINTER
驱动调试技巧：
  • 在probe()函数中打印关键配置空间寄存器，确认设备识别正确：dev_info(&dev->dev, "vendor=0x%04x device=0x%04x class=0x%06x\n", vendor_id, device_id, class_code);
  • 使用pci_find_capability()遍历能力结构链表，确认设备支持的功能（如MSI、PM、PCIe Cap）。
  • 若设备无法枚举，检查lspci -t的树形拓扑，确认桥设备配置空间中的Bus Number范围是否正确。

2.7 本章小结

← 上一章 📖 返回目录 下一章 →