3. Zephyr 中断API详解：IRQ_CONNECT、irq_enable、irq_disable、动态中断注册

在Zephyr RTOS中，中断管理是驱动性能优化的核心环节。正确使用中断API，能够显著降低中断延迟，提升系统实时性。本章节将深入剖析Zephyr提供的静态与动态中断API，包括宏定义与函数调用的底层机制、使用场景及性能差异。

3.1 静态中断注册：IRQ_CONNECT 宏

IRQ_CONNECT 是Zephyr中最常用的静态中断注册宏，它在编译阶段将中断服务例程（ISR）与特定中断号绑定。该宏在链接时生成中断描述符表，避免了运行时的查找开销。

IRQ_CONNECT(irq_num, priority, isr, parameter, flags)

典型使用示例：

#include <zephyr/irq.h>
#include <zephyr/device.h>

void my_uart_isr(const void *arg)
{
    const struct device *dev = (const struct device *)arg;
    /* 处理UART中断 */
}

#define MY_UART_IRQ_NUM  DT_IRQN(DT_NODELABEL(uart0))
#define MY_UART_PRIORITY 2

/* 在驱动初始化函数中注册 */
IRQ_CONNECT(MY_UART_IRQ_NUM, MY_UART_PRIORITY,
            my_uart_isr, DEVICE_DT_GET(DT_NODELABEL(uart0)), 0);
irq_enable(MY_UART_IRQ_NUM);

3.2 中断使能与禁用：irq_enable / irq_disable

irq_enable() 和 irq_disable() 是Zephyr提供的中断控制基础API，用于在运行时控制特定中断源的使能状态。这两个函数直接操作CPU的中断控制器寄存器，具有极低的执行开销。

典型使用模式：

/* 驱动初始化时使能中断 */
void driver_init(const struct device *dev)
{
    /* 注册中断 */
    IRQ_CONNECT(MY_IRQ, MY_PRIO, my_isr, dev, 0);
    /* 使能中断 */
    irq_enable(MY_IRQ);
}

/* 在特定场景下临时禁用中断 */
void driver_suspend(const struct device *dev)
{
    irq_disable(MY_IRQ);
    /* 执行低功耗操作 */
}

/* 恢复中断 */
void driver_resume(const struct device *dev)
{
    irq_enable(MY_IRQ);
}

3.3 动态中断注册：irq_connect_dynamic

对于需要运行时动态绑定中断的场景（如USB热插拔、FPGA加载外设），Zephyr提供了 irq_connect_dynamic() 函数。该函数在运行时分配中断描述符并注册ISR，灵活性更高，但会引入额外的运行时开销。

int irq_connect_dynamic(unsigned int irq, unsigned int priority,
                        void (*isr)(const void *parameter),
                        const void *parameter, uint32_t flags);

动态注册示例：

#include <zephyr/irq.h>

void dynamic_isr(const void *arg)
{
    /* 动态中断处理 */
    uint32_t *counter = (uint32_t *)arg;
    (*counter)++;
}

void register_dynamic_irq(uint32_t irq_num)
{
    static uint32_t isr_counter = 0;
    int ret;

    ret = irq_connect_dynamic(irq_num, 3, dynamic_isr,
                              &isr_counter, 0);
    if (ret != 0) {
        printk("Failed to register dynamic IRQ %u\n", irq_num);
        return;
    }

    irq_enable(irq_num);
    printk("Dynamic IRQ %u registered, counter at %p\n",
           irq_num, &isr_counter);
}

3.4 中断API性能对比与选型建议

在实际驱动开发中，选择静态还是动态中断注册，需要根据应用场景权衡。下表总结了关键性能指标：

3.5 中断API与DMA协同配置要点

在DMA驱动的中断配置中，中断响应速度直接影响数据传输效率。以下是关键协同配置建议：

1. DMA完成中断优先级：设置为最高优先级（priority=0），确保数据传输完成后立即被处理。
2. 使用静态注册：DMA中断频率高，必须使用 IRQ_CONNECT 避免动态查表延迟。
3. 中断服务例程优化：在ISR中仅做最小必要操作（如读取状态、触发下一轮DMA），耗时操作移至线程上下文。
4. 中断嵌套控制：使用 irq_lock() / irq_unlock() 保护DMA描述符链表的临界区，避免竞态。

/* DMA中断协同配置示例 */
#define DMA_IRQ_NUM     DT_IRQN(DT_NODELABEL(dma0))
#define DMA_IRQ_PRIO    0   /* 最高优先级 */

void dma_complete_isr(const void *arg)
{
    const struct device *dev = (const struct device *)arg;
    struct dma_context *ctx = dev->data;

    /* 1. 读取DMA状态寄存器（必须快速） */
    uint32_t status = dma_get_status(dev);

    /* 2. 禁用中断防止重入 */
    irq_disable(DMA_IRQ_NUM);

    /* 3. 提交工作到系统工作队列 */
    k_work_submit(&ctx->dma_work);

    /* 4. 重新使能中断 */
    irq_enable(DMA_IRQ_NUM);
}

/* 驱动初始化 */
IRQ_CONNECT(DMA_IRQ_NUM, DMA_IRQ_PRIO,
            dma_complete_isr, DEVICE_DT_GET(DT_NODELABEL(dma0)), 0);
irq_enable(DMA_IRQ_NUM);