Linux PCIe驱动开发调试与部署 - 第3节

3.1 PCIe 子系统整体架构

Linux PCIe 子系统采用分层设计，从底层的硬件访问到上层的驱动绑定，形成了一条清晰的数据与控制路径。理解 pci_bus、pci_dev、pci_driver 这三个核心数据结构及其相互关系，是掌握 PCIe 驱动开发的基础。

下图展示了 PCIe 子系统在 Linux 内核中的层次位置与核心组件关系：

3.2 核心数据结构详解

3.2.1 pci_bus：总线管理单元

pci_bus 结构体代表一条 PCI 总线，是总线拓扑管理的核心。每个 PCI 段（Segment）下的每条总线都有一个对应的 pci_bus 实例。

3.2.2 pci_dev：设备描述符

pci_dev 是 PCIe 设备在内核中的核心描述符，包含设备的配置空间信息、资源分配、电源管理状态等。每个物理功能（PF）和虚拟功能（VF）都对应一个 pci_dev 实例。

struct pci_dev {
    struct list_head bus_list;      // 总线设备链表节点
    struct pci_bus  *bus;           // 所属总线
    struct pci_bus  *subordinate;   // 下游总线（仅桥设备有效）
    unsigned int    devfn;          // 设备号 (device << 3 | function)
    unsigned short  vendor;         // Vendor ID
    unsigned short  device;         // Device ID
    unsigned short  subsystem_vendor; // Subsystem Vendor ID
    unsigned short  subsystem_device; // Subsystem Device ID
    unsigned int    class;          // Class Code
    u8              revision;       // Revision ID
    u8              hdr_type;       // 配置空间头部类型
    struct resource resource[DEVICE_COUNT_RESOURCE]; // BAR 资源数组
    unsigned int    irq;            // 中断号
    struct pci_driver *driver;      // 绑定的驱动
    // ... 更多成员
};

3.2.3 pci_driver：驱动实体

pci_driver 是驱动开发者需要直接操作的结构体。它定义了驱动的生命周期回调函数以及设备 ID 匹配表。

struct pci_driver {
    const char *name;                       // 驱动名称
    const struct pci_device_id *id_table;   // 支持的设备 ID 表
    int  (*probe)  (struct pci_dev *dev, const struct pci_device_id *id);
    void (*remove) (struct pci_dev *dev);
    int  (*suspend)(struct pci_dev *dev, pm_message_t state);
    int  (*resume) (struct pci_dev *dev);
    // ... 其他回调
};

设备 ID 表 pci_device_id 用于驱动与设备的匹配：

struct pci_device_id {
    __u32 vendor, device;           // Vendor/Device ID
    __u32 subvendor, subdevice;     // Subsystem ID
    __u32 class, class_mask;        // Class Code 及其掩码
    unsigned long driver_data;      // 驱动私有数据
};

3.3 内核 PCI 核心 API

PCI 核心 API 是驱动开发者与内核 PCI 子系统交互的桥梁。以下按功能分类列出最常用的 API。

3.3.1 驱动注册与注销

3.3.2 设备资源访问

3.3.3 配置空间访问

// 读取配置空间
int pci_read_config_byte (struct pci_dev *dev, int where, u8 *val);
int pci_read_config_word (struct pci_dev *dev, int where, u16 *val);
int pci_read_config_dword(struct pci_dev *dev, int where, u32 *val);

// 写入配置空间
int pci_write_config_byte (struct pci_dev *dev, int where, u8 val);
int pci_write_config_word (struct pci_dev *dev, int where, u16 val);
int pci_write_config_dword(struct pci_dev *dev, int where, u32 val);

3.3.4 DMA 与中断

3.4 设备枚举与驱动绑定流程

从系统启动到驱动 probe 被调用，经历了完整的设备枚举与匹配过程。下图展示了这一关键流程：

3.5 数据结构关系总结

下表总结了三个核心数据结构在 PCIe 子系统中的角色与关系：