3. 中断注册与释放：request_irq()、free_irq()、irq_handler_t原型、中断标志位详解

中断处理程序的注册与释放是驱动开发中与硬件交互的核心环节。正确使用 request_irq() 和 free_irq()，理解中断处理函数原型及标志位含义，是保证系统稳定性和实时性的基础。本节将深入剖析这些接口的底层机制与调优参数。

3.1 irq_handler_t 原型与中断处理函数设计

Linux 内核中，中断处理函数通过 irq_handler_t 类型定义。该类型是一个函数指针，驱动开发者必须遵循其签名来实现具体的中断服务例程（ISR）。

typedef irqreturn_t (*irq_handler_t)(int irq, void *dev_id);

返回值设计原则：

• IRQ_HANDLED：表示该中断由本驱动程序正确处理，内核会停止向其他共享中断处理函数传递该中断。
• IRQ_NONE：表示该中断并非由本设备产生，内核将继续调用其他注册在同一中断线上的处理函数。

3.2 request_irq() 函数详解与中断标志位

request_irq() 是注册中断处理函数的入口，其原型及参数含义如下：

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

参数说明：

3.3 中断标志位 flags 详解

flags 参数是中断调优的关键，通过位掩码组合控制中断行为。以下为最常用的标志位：

3.4 free_irq() 函数与中断释放机制

free_irq() 用于在驱动卸载或设备移除时释放已注册的中断。其原型如下：

void free_irq(unsigned int irq, void *dev_id);

关键行为：

• 非共享中断：直接释放中断线，删除 /proc/interrupts 中的对应条目。
• 共享中断：仅当 dev_id 匹配时，移除当前驱动注册的处理函数；若还有其他驱动注册在同一中断线上，中断线保持活跃。
• 同步等待：free_irq() 会等待当前正在执行的 ISR 完成，确保释放后不会再有该中断的处理函数被调用。

3.5 中断注册与释放的典型流程

以下代码展示了在 SPI 设备驱动中注册与释放中断的完整流程：

/* 设备结构体 */
struct my_spi_device {
    struct spi_device *spi;
    int irq;
    struct completion data_ready;
};

/* 中断处理函数 */
static irqreturn_t my_spi_irq_handler(int irq, void *dev_id)
{
    struct my_spi_device *dev = (struct my_spi_device *)dev_id;

    /* 检查硬件状态寄存器，确认中断来源 */
    if (!(readl(dev->reg_base + STATUS_REG) & INT_PENDING))
        return IRQ_NONE;

    /* 清除中断标志 */
    writel(INT_CLEAR, dev->reg_base + CLEAR_REG);

    /* 唤醒等待队列 */
    complete(&dev->data_ready);

    return IRQ_HANDLED;
}

/* 中断注册 */
static int my_spi_probe(struct spi_device *spi)
{
    struct my_spi_device *dev;
    int ret;

    dev = devm_kzalloc(&spi->dev, sizeof(*dev), GFP_KERNEL);
    dev->spi = spi;
    init_completion(&dev->data_ready);

    /* 获取中断号 */
    dev->irq = spi->irq;
    if (dev->irq < 0)
        return dev->irq;

    /* 注册中断：下降沿触发 + 共享 + oneshot */
    ret = request_irq(dev->irq, my_spi_irq_handler,
                      IRQF_TRIGGER_FALLING | IRQF_SHARED | IRQF_ONESHOT,
                      "my_spi_dev", dev);
    if (ret) {
        dev_err(&spi->dev, "Failed to request IRQ %d\n", dev->irq);
        return ret;
    }

    spi_set_drvdata(spi, dev);
    return 0;
}

/* 中断释放 */
static void my_spi_remove(struct spi_device *spi)
{
    struct my_spi_device *dev = spi_get_drvdata(spi);

    free_irq(dev->irq, dev);
}

3.6 中断注册的调试与验证

注册完成后，可通过以下方式验证中断是否正常工作：

3.7 中断注册常见错误与排查

• -EBUSY：中断号已被占用，且未设置 IRQF_SHARED。检查硬件中断号是否冲突，或添加共享标志。
• -EINVAL：中断号无效或 flags 包含非法组合。确认中断号范围及标志位兼容性。
• 中断丢失：ISR 执行时间过长，导致后续中断被屏蔽。考虑使用 IRQF_ONESHOT 或线程化中断。
• 系统卡死：ISR 中调用了可能导致睡眠的函数（如 mutex_lock、msleep）。确保 ISR 为原子上下文。