3. MSI/MSI-X 原理：MSI 与 MSI-X 的区别、MSI Capability 结构、MSI-X Table 与 PBA

3.1 概述：从传统中断到消息信号中断

传统 PCI/PCIe 设备使用 INTx 边带信号线（INTA#、INTB#、INTC#、INTD#）来提交中断请求。这种方式存在几个固有缺陷：

• 共享中断线：多个设备可能共用同一物理中断线，导致中断处理程序必须遍历所有设备以确定中断源。
• 电平触发与边沿触发问题：INTx 通常为电平触发，需要复杂的握手协议（如中断服务确认与清除），容易丢失中断或产生虚假中断。
• 可扩展性差：每个设备最多只能使用 4 个中断引脚，无法满足多队列、多核处理器的需求。

MSI（Message Signaled Interrupt） 和 MSI-X 通过 PCIe 内存写事务（MWr）来传递中断消息，彻底解决了上述问题。设备不再使用物理中断线，而是向 CPU 指定的地址写入一个预先配置的数据，触发中断控制器（如 Local APIC）产生中断。

3.2 MSI 与 MSI-X 的核心区别

MSI 是 PCI 2.2 引入的规范，MSI-X 是 PCI 3.0 引入的增强版本。下表列出了两者在关键特性上的差异：

3.3 MSI Capability 结构

MSI Capability 结构位于 PCIe 配置空间中，通过 Capability 链表访问。其结构定义如下：

// MSI Capability 结构（PCIe 配置空间布局）
// 偏移量 0x00: Capability ID (0x05)
// 偏移量 0x01: Next Capability Pointer
// 偏移量 0x02: Message Control (16位)
// 偏移量 0x04: Message Address (32位) 或 Message Address Low (64位模式)
// 偏移量 0x08: Message Address High (64位模式，可选)
// 偏移量 0x0C: Message Data (16位)

// Linux 内核中对应的结构体定义 (include/linux/msi.h)
struct msi_desc {
    struct list_head        list;
    unsigned long           irq;
    unsigned int            nvec_used;
    struct msi_msg          msg;
    struct pci_dev          *dev;
    // ... 其他字段
};

struct msi_msg {
    __u32   address_lo;     // 低32位地址
    __u32   address_hi;     // 高32位地址（仅64位模式）
    __u16   data;           // 数据字段
};

Message Control 寄存器 的位域定义：

• Bit [0]：MSI Enable。置 1 启用 MSI，置 0 禁用。
• Bit [3:1]：Multiple Message Capable。指示设备支持的最大中断向量数（编码值：000=1, 001=2, 010=4, 011=8, 100=16, 101=32）。
• Bit [6:4]：Multiple Message Enable。由系统软件写入，指定实际分配的中断向量数（编码方式同上）。
• Bit [7]：64-bit Address Capable。置 1 表示支持 64 位地址。
• Bit [8]：Per-vector Masking Capable。置 1 表示支持每个向量的独立掩码（可选功能）。

下图展示了 MSI Capability 结构在 PCIe 配置空间中的布局以及中断消息的生成流程：

3.4 MSI-X Table 与 PBA

MSI-X 引入了两个独立的结构：MSI-X Table 和 Pending Bit Array (PBA)。这两个结构位于设备的 BAR 空间（Base Address Register）中，而不是配置空间中。系统软件通过访问 BAR 映射的内存区域来配置 MSI-X 向量。

3.4.1 MSI-X Table 结构

MSI-X Table 是一个条目数组，每个条目对应一个中断向量。每个条目大小为 16 字节，结构如下：

关键特性：

• 每个条目独立配置 Message Address 和 Message Data，因此可以将不同向量路由到不同的 CPU 核心。
• Vector Control 的 Mask 位允许软件动态启用/禁用单个中断向量，而无需影响其他向量。
• Table 的大小由 MSI-X Capability 结构中的 Table Size 字段决定（最大 2048 个条目）。

3.4.2 PBA（Pending Bit Array）

PBA 是一个位图数组，用于记录设备已经发送但尚未被 CPU 处理的中断消息。每个位对应一个 MSI-X 向量：

• 位值为 1：表示该向量有一个或多个待处理的中断消息。
• 位值为 0：表示没有待处理的中断。

PBA 的作用是解决 中断丢失 问题。当设备发送中断消息时，如果 CPU 正在处理同一向量的前一个中断，设备可以将新中断标记在 PBA 中，而不是立即发送新的 MWr 事务。当 CPU 完成当前中断处理后，会检查 PBA，如果发现待处理位被置位，则再次触发中断处理。

下图展示了 MSI-X Table 和 PBA 在设备 BAR 空间中的布局以及它们与中断处理流程的关系：

3.5 MSI-X Capability 结构

MSI-X Capability 结构位于 PCIe 配置空间中，用于描述 MSI-X Table 和 PBA 在 BAR 空间中的位置和大小。其结构如下：

Message Control 寄存器 的位域定义：

• Bit [10:0]：Table Size。指示 MSI-X Table 中的条目数（实际值为 N+1，例如 0x7F 表示 128 个条目）。
• Bit [14]：Function Mask。置 1 时屏蔽该 Function 的所有 MSI-X 中断。
• Bit [15]：MSI-X Enable。置 1 启用 MSI-X，置 0 禁用。

3.6 MSI 与 MSI-X 的选择策略

在 Linux 驱动开发中，中断模式的选择遵循以下优先级：

1. 首选 MSI-X：如果设备支持 MSI-X 且系统能够分配足够的向量，优先使用 MSI-X。它提供了最大的灵活性和可扩展性。
2. 回退到 MSI：如果 MSI-X 分配失败（例如系统不支持、向量数不足），尝试使用 MSI。MSI 的连续向量分配特性在某些场景下更简单。
3. 最后使用 INTx：如果 MSI 和 MSI-X 都不可用，回退到传统的 INTx 中断线。

3.7 本章小结