3. 驱动中断注册接口：request_irq()、request_threaded_irq()、devm_request_irq() 函数原型与参数详解

在 MSI 中断配置流程中，驱动侧的核心任务是将分配到的中断向量（IRQ 号）与具体的中断处理逻辑绑定。Linux 内核提供了三个层次的中断注册接口，分别适用于不同的场景：request_irq() 用于注册标准中断处理函数；request_threaded_irq() 支持将中断处理拆分为快速顶半部和可睡眠的底半部线程；devm_request_irq() 则是资源管理版本，自动在设备移除或驱动卸载时释放中断。

理解这三个函数的原型、参数含义及差异，是正确实现 MSI 中断使能的关键前提。

3.1 核心接口：request_irq()

request_irq() 是最基础的中断注册函数，用于将给定的 IRQ 号与一个中断处理函数（handler）关联。该函数会设置中断描述符、配置触发方式，并将处理函数挂入中断处理链。

函数原型

int request_irq(unsigned int irq,
                irq_handler_t handler,
                unsigned long flags,
                const char *name,
                void *dev);

参数详解

常用 flags 标志

返回值

• 0：注册成功。
• -EINVAL：参数无效，如 irq 号无效或 handler 为 NULL。
• -EBUSY：中断号已被占用且未设置 IRQF_SHARED。
• -ENOMEM：内存分配失败。

3.2 线程化中断：request_threaded_irq()

request_threaded_irq() 是 request_irq() 的扩展版本，允许将中断处理拆分为两个部分：一个快速顶半部（handler）和一个可睡眠的底半部线程（thread_fn）。顶半部在中断上下文中执行，负责处理紧急硬件操作并决定是否需要唤醒底半部；底半部在独立内核线程中运行，可以执行耗时操作、访问睡眠锁、进行 I/O 操作等。

函数原型

int request_threaded_irq(unsigned int irq,
                         irq_handler_t handler,
                         irq_handler_t thread_fn,
                         unsigned long flags,
                         const char *name,
                         void *dev);

参数详解

顶半部与底半部协作流程

3.3 资源管理版本：devm_request_irq()

devm_request_irq() 是 request_irq() 的设备资源管理（devres）版本。它自动将中断注册与设备生命周期绑定：当设备被移除、驱动卸载或 probe 失败时，内核会自动释放该中断，无需驱动显式调用 free_irq()。这大大简化了错误处理路径和移除路径的代码。

函数原型

int devm_request_irq(struct device *dev,
                     unsigned int irq,
                     irq_handler_t handler,
                     unsigned long flags,
                     const char *name,
                     void *dev_id);

参数详解

3.4 三个接口的对比与选择

3.5 典型 MSI 驱动注册示例

以下代码展示了在 PCIe MSI 驱动中，使用 devm_request_irq() 注册中断的典型模式：

static irqreturn_t my_msi_handler(int irq, void *dev_id)
{
    struct my_device *mydev = dev_id;

    /* 读取 MSI 状态寄存器，确认中断来源 */
    u32 status = readl(mydev->regs + MSI_STATUS_REG);

    if (!(status & MY_DEVICE_INT_PENDING))
        return IRQ_NONE;

    /* 清除中断挂起位 */
    writel(status, mydev->regs + MSI_STATUS_REG);

    /* 处理数据（快速操作，不睡眠） */
    mydev->packet_count++;

    return IRQ_HANDLED;
}

static int my_pci_probe(struct pci_dev *pdev,
                        const struct pci_device_id *ent)
{
    struct my_device *mydev;
    int ret, irq;

    /* 分配设备私有结构体 */
    mydev = devm_kzalloc(&pdev->dev, sizeof(*mydev), GFP_KERNEL);
    if (!mydev)
        return -ENOMEM;

    pci_set_drvdata(pdev, mydev);

    /* 启用 MSI 并分配中断向量 */
    ret = pci_alloc_irq_vectors(pdev, 1, 1, PCI_IRQ_MSI);
    if (ret < 0)
        return ret;

    /* 获取第一个 MSI 中断号 */
    irq = pci_irq_vector(pdev, 0);

    /* 注册中断处理函数（资源管理版本） */
    ret = devm_request_irq(&pdev->dev, irq,
                           my_msi_handler,
                           0,           /* flags: MSI 不需要特殊标志 */
                           "my_msi_dev",
                           mydev);      /* dev_id 传入设备结构体 */
    if (ret) {
        dev_err(&pdev->dev, "Failed to request MSI IRQ %d\n", irq);
        return ret;
    }

    /* 启用设备 DMA 和 MSI 消息生成 */
    writel(MY_DEVICE_ENABLE, mydev->regs + MSI_CTRL_REG);

    return 0;
}

/* 注意：remove 函数中不需要调用 free_irq()，
 * devm_request_irq() 会在设备移除时自动释放 */
static void my_pci_remove(struct pci_dev *pdev)
{
    struct my_device *mydev = pci_get_drvdata(pdev);

    /* 禁用设备中断生成 */
    writel(0, mydev->regs + MSI_CTRL_REG);

    /* 释放 MSI 向量 */
    pci_free_irq_vectors(pdev);

    /* devm 资源自动释放，无需手动 free_irq */
}

3.6 中断注册流程总览

3.7 常见错误与调试