3. PCIe中断机制：INTx中断、MSI/MSI-X中断、中断处理函数注册与释放

PCIe中断机制是驱动与设备进行异步事件通知的核心通道。与传统的共享中断不同，PCIe提供了三种中断模型：INTx（传统中断线）、MSI（消息信号中断）和MSI-X（扩展消息信号中断）。理解这三种机制的差异、配置流程以及中断处理函数的生命周期管理，是驱动跨平台移植的关键环节。

3.1 中断机制概览与对比

下表从触发方式、向量数量、可扩展性、平台兼容性四个维度对比三种中断机制：

3.2 INTx中断：传统中断线的兼容性设计

INTx是PCI/PCIe时代遗留的中断模型，通过设备配置空间中的中断引脚寄存器（Offset 0x3D）和中断线寄存器（Offset 0x3C）来路由中断。在PCIe中，INTx通过虚拟中断线（Virtual INTx）在链路层以消息形式传递，但软件接口与PCI保持一致。

INTx中断的典型注册流程如下：

1. 读取中断引脚：从配置空间读取中断引脚寄存器，判断设备使用INTA/INTB/INTC/INTD。
2. 获取中断线：读取中断线寄存器，获取系统分配的IRQ号。
3. 注册中断处理函数：调用request_irq()或request_threaded_irq()注册。
4. 处理共享中断：在中断处理函数中检查设备中断状态寄存器，确认是否为本设备触发。

/* INTx中断注册示例（Linux内核） */
static irqreturn_t pcie_intx_handler(int irq, void *dev_id)
{
    struct pci_dev *pdev = (struct pci_dev *)dev_id;
    u32 status;

    /* 读取设备中断状态寄存器，确认中断源 */
    pci_read_config_dword(pdev, DEVICE_INT_STATUS_OFFSET, &status);
    if (!(status & INT_PENDING_MASK))
        return IRQ_NONE;  /* 非本设备中断 */

    /* 处理中断事件 */
    handle_device_event(pdev);

    /* 清除中断状态 */
    pci_write_config_dword(pdev, DEVICE_INT_CLEAR_OFFSET, status);
    return IRQ_HANDLED;
}

/* 注册INTx中断 */
int pcie_intx_setup(struct pci_dev *pdev)
{
    int irq = pdev->irq;  /* 从配置空间获取IRQ号 */
    return request_irq(irq, pcie_intx_handler,
                       IRQF_SHARED, "pcie_intx_dev", pdev);
}

3.3 MSI/MSI-X中断：消息信号中断的高效实现

MSI/MSI-X通过向特定内存地址写入数据来触发中断，无需经过中断控制器路由，显著降低了延迟。MSI支持1、2、4、8、16、32个向量（2的幂次），而MSI-X支持最多2048个独立向量，每个向量拥有独立的消息地址和消息数据寄存器。

下图展示了MSI-X中断的触发路径：

3.4 中断处理函数注册与释放

中断处理函数的生命周期管理包括注册、使能、禁用和释放四个阶段。在跨平台移植中，不同操作系统（Linux、VxWorks、Windows）的API差异较大，但核心逻辑一致。

3.4.1 注册流程（Linux内核示例）

/* MSI-X中断注册示例 */
static int pcie_msix_setup(struct pci_dev *pdev)
{
    int ret, i;
    struct msix_entry entries[MAX_MSIX_VECTORS];

    /* 1. 查询设备支持的MSI-X向量数量 */
    ret = pci_msix_vec_count(pdev);
    if (ret < 0)
        return ret;

    /* 2. 分配MSI-X向量 */
    for (i = 0; i < min(ret, MAX_MSIX_VECTORS); i++)
        entries[i].entry = i;

    ret = pci_enable_msix_range(pdev, entries, 1, MAX_MSIX_VECTORS);
    if (ret < 0)
        return ret;

    /* 3. 为每个向量注册中断处理函数 */
    for (i = 0; i < ret; i++) {
        snprintf(dev->irq_name[i], sizeof(dev->irq_name[i]),
                 "pcie_dev_msix_%d", i);
        ret = request_irq(entries[i].vector,
                          pcie_msix_handler,
                          0, dev->irq_name[i], &pdev->dev);
        if (ret)
            goto err_free_irqs;
    }
    return 0;

err_free_irqs:
    while (--i >= 0)
        free_irq(entries[i].vector, &pdev->dev);
    pci_disable_msix(pdev);
    return ret;
}

3.4.2 释放流程

中断释放必须遵循“先释放中断处理函数，再禁用中断机制”的顺序，避免在禁用过程中产生未处理的中断：

1. 禁用设备中断：写设备控制寄存器，屏蔽所有中断源。
2. 同步中断：调用synchronize_irq()等待正在执行的中断处理函数完成。
3. 释放中断处理函数：调用free_irq()注销处理函数。
4. 禁用中断机制：调用pci_disable_msix()或pci_disable_msi()。

/* MSI-X中断释放示例 */
static void pcie_msix_teardown(struct pci_dev *pdev)
{
    int i;

    /* 1. 禁用设备中断 */
    pci_write_config_word(pdev, DEVICE_CTRL_REG, 0);

    /* 2. 同步并释放所有中断向量 */
    for (i = 0; i < dev->msix_count; i++) {
        synchronize_irq(dev->msix_entries[i].vector);
        free_irq(dev->msix_entries[i].vector, &pdev->dev);
    }

    /* 3. 禁用MSI-X */
    pci_disable_msix(pdev);
}

3.5 中断机制选择策略与移植适配

下表总结了不同平台下中断机制的推荐选择策略：

3.6 中断处理函数设计规范

中断处理函数的设计直接影响系统实时性和稳定性，以下是必须遵守的规范：

• 快速路径与慢速路径分离：中断上半部（Top Half）只做最小必要操作（如读取状态、清除中断），耗时操作（如数据处理、DMA操作）推迟到下半部（Bottom Half / Tasklet / Workqueue）。
• 可重入性：中断处理函数必须可重入，避免使用全局变量或静态缓冲区，必要时使用自旋锁保护共享数据。
• 中断状态确认：对于INTx共享中断，必须检查设备中断状态寄存器，返回IRQ_NONE或IRQ_HANDLED。
• 错误处理：在中断处理函数中捕获硬件错误（如PCIe致命错误），记录错误日志并触发恢复流程。