4. 中断处理函数编写：顶半部与底半部、快速中断与慢速中断、中断处理函数返回值

中断处理函数是驱动与硬件交互最频繁、对实时性要求最高的代码路径。Linux 内核将中断处理拆分为顶半部（Top Half）和底半部（Bottom Half），以平衡中断响应速度与处理复杂度。本章深入剖析中断处理函数的编写规范、快速/慢速中断的区分标准以及返回值语义，帮助开发者写出高效、稳定的中断服务例程（ISR）。

4.1 顶半部与底半部

中断处理函数必须快速执行，否则会阻塞其他中断和系统调度。Linux 将中断处理拆分为两个阶段：

4.1.1 底半部实现机制对比

4.1.2 顶半部与底半部代码示例

/* 传统方式：顶半部 + Tasklet 底半部 */
static void my_device_tasklet_handler(unsigned long data)
{
    struct my_dev *dev = (struct my_dev *)data;
    /* 底半部：开中断环境，可加锁、可调度 */
    spin_lock(&dev->lock);
    /* 读取 FIFO 数据、更新统计、唤醒等待队列 */
    spin_unlock(&dev->lock);
    wake_up_interruptible(&dev->wq);
}

static irqreturn_t my_device_isr(int irq, void *dev_id)
{
    struct my_dev *dev = (struct my_dev *)dev_id;
    /* 顶半部：保存状态，调度底半部 */
    dev->status = readl(dev->regs + REG_STATUS);
    /* 清除中断标志 */
    writel(INT_CLEAR, dev->regs + REG_INT_CLR);
    /* 调度 Tasklet */
    tasklet_schedule(&dev->tasklet);
    return IRQ_HANDLED;
}

/* 线程化中断方式（推荐） */
static irqreturn_t my_device_threaded_isr(int irq, void *dev_id)
{
    struct my_dev *dev = (struct my_dev *)dev_id;
    /* 此函数运行在进程上下文，可睡眠 */
    mutex_lock(&dev->mutex);
    /* 读取硬件状态、处理数据、与用户空间交互 */
    mutex_unlock(&dev->mutex);
    return IRQ_HANDLED;
}

/* 注册线程化中断 */
request_threaded_irq(irq, my_device_isr, my_device_threaded_isr,
                     IRQF_TRIGGER_RISING, "my_device", dev);

4.2 快速中断与慢速中断

Linux 内核在早期版本中区分“快速中断”和“慢速中断”，现代内核虽然不再强制区分，但理解其设计思想对中断性能调优仍然重要。

4.3 中断处理函数返回值

中断处理函数必须返回 irqreturn_t 类型值，内核根据返回值判断中断是否被正确处理。错误返回值会导致内核误判中断状态，引发系统不稳定。

4.3.1 共享中断的正确处理

static irqreturn_t my_device_isr(int irq, void *dev_id)
{
    struct my_dev *dev = (struct my_dev *)dev_id;
    unsigned int status;

    /* 读取中断状态寄存器 */
    status = readl(dev->regs + REG_INT_STATUS);

    /* 检查是否为本设备中断 */
    if (!(status & INT_PENDING)) {
        /* 不是本设备产生，返回 IRQ_NONE */
        return IRQ_NONE;
    }

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

    /* 处理中断（顶半部） */
    dev->event_count++;

    /* 调度底半部 */
    tasklet_schedule(&dev->tasklet);

    /* 返回 IRQ_HANDLED 表示已处理 */
    return IRQ_HANDLED;
}

4.3.2 线程化中断返回值示例

/* 顶半部：仅检查中断源，唤醒线程 */
static irqreturn_t my_device_top_isr(int irq, void *dev_id)
{
    struct my_dev *dev = (struct my_dev *)dev_id;

    if (!(readl(dev->regs + REG_INT_STATUS) & INT_PENDING))
        return IRQ_NONE;

    /* 清除中断标志（必须在顶半部完成） */
    writel(INT_CLEAR, dev->regs + REG_INT_CLR);

    /* 唤醒线程化底半部 */
    return IRQ_WAKE_THREAD;
}

/* 底半部线程：运行在进程上下文，可睡眠 */
static irqreturn_t my_device_bottom_thread(int irq, void *dev_id)
{
    struct my_dev *dev = (struct my_dev *)dev_id;

    /* 可调用睡眠函数 */
    mutex_lock(&dev->mutex);
    /* 复杂数据处理、与用户空间通信 */
    mutex_unlock(&dev->mutex);

    return IRQ_HANDLED;
}

/* 注册线程化中断 */
request_threaded_irq(irq, my_device_top_isr, my_device_bottom_thread,
                     IRQF_SHARED | IRQF_TRIGGER_FALLING,
                     "my_device", dev);

4.4 中断处理函数编写最佳实践