4. 中断注册API详解：request_irq、request_threaded_irq、devm_request_irq

中断注册是驱动与内核中断子系统交互的核心接口。Linux 内核提供了三个主要的中断注册 API，分别适用于不同的场景：传统顶半部、线程化中断以及资源管理型注册。理解它们的差异、适用条件和性能特征，是构建可靠中断驱动的基础。

4.1 传统 API：request_irq

request_irq 是最基础的中断注册函数，注册一个在硬中断上下文中执行的处理函数。它适用于中断处理逻辑极短、不依赖任何可睡眠资源的场景（如 GPIO 电平翻转、状态寄存器读取）。

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

4.2 线程化中断：request_threaded_irq

request_threaded_irq 将中断处理拆分为顶半部（handler）和底半部（thread_fn）。顶半部在硬中断上下文中快速执行，返回 IRQ_WAKE_THREAD 后，内核调度一个内核线程执行 thread_fn，该线程可以睡眠、持有互斥锁、执行 I2C/SPI 传输等阻塞操作。

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

4.3 资源管理型：devm_request_irq

devm_request_irq 是 managed device resource（devres） 框架的一部分。它自动绑定中断生命周期与设备生命周期：当设备被移除或驱动卸载时，内核自动释放中断，无需手动调用 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);

4.4 性能对比与选择矩阵

在实际项目中，选择哪个 API 取决于中断处理的工作量和实时性要求。下表从延迟、吞吐量和代码复杂度三个维度给出参考数据（基于 ARM Cortex-A72 @ 1.5GHz 实测）。

4.5 中断注册的常见错误与调试

• 中断号无效：使用 platform_get_irq 获取中断号后，检查返回值是否小于 0。无效中断号会导致 request_irq 返回 -EINVAL。
• 共享中断未正确传递 dev_id：共享中断（IRQF_SHARED）必须传递唯一的 dev_id，否则 free_irq 无法正确识别。
• 顶半部返回错误值：顶半部必须返回 IRQ_NONE（未处理）或 IRQ_HANDLED（已处理）。返回 IRQ_WAKE_THREAD 但未注册 thread_fn 会导致内核警告。
• 中断丢失：如果顶半部执行时间过长，后续中断可能被合并或丢失。使用 /proc/interrupts 监控中断计数，确认无异常丢失。

// 调试示例：检查中断注册是否成功
int ret;
ret = devm_request_irq(dev, irq, my_handler,
                       IRQF_TRIGGER_RISING | IRQF_SHARED,
                       "my_device", dev);
if (ret) {
    dev_err(dev, "Failed to request IRQ %d, ret=%d\n", irq, ret);
    return ret;
}
// 查看 /proc/interrupts 确认中断计数增长
// cat /proc/interrupts | grep my_device