2. QNX中断子系统架构

在QNX BSP移植中，中断子系统是连接硬件异常与软件处理的桥梁。理解其架构层次——从硬件中断控制器到内核向量表，再到用户态ISR注册——是排查DMA中断映射故障的前提。本章聚焦于QNX对中断控制器的抽象模型、向量表布局以及ISR注册的核心机制。

2.1 中断控制器抽象：GIC与INTC的统一接口

QNX内核通过一个统一的中断控制器抽象层来屏蔽不同SoC的GIC（Generic Interrupt Controller）或INTC（Interrupt Controller）差异。该抽象层定义了一组标准操作接口，BSP开发者只需实现这些接口即可完成移植。

下图展示了QNX中断控制器抽象层与硬件GIC/INTC之间的分层关系：

2.2 中断向量表：从硬件异常到软件入口

QNX的中断向量表（IVT）并非传统意义上固定地址的跳转表，而是一个由内核管理的中断描述符数组。每个中断源对应一个表项，包含ISR地址、参数、优先级和标志位。

向量表的核心数据结构如下：

// QNX 内核中断描述符结构（简化）
struct intr_entry {
    uintptr_t   isr_addr;       // ISR 函数地址
    uintptr_t   isr_arg;        // ISR 参数（通常为设备上下文）
    uint32_t    vector;         // 硬件中断向量号
    uint32_t    flags;          // 触发方式、CPU亲和性等标志
    uint32_t    priority;       // 中断优先级（0-255）
    void        *next;          // 链表指针（用于共享中断）
};

向量表的布局与硬件中断号映射关系如下表所示：

下图展示了中断向量表的组织方式以及中断触发后的查找流程：

2.3 中断服务例程(ISR)注册机制

QNX提供了一套完整的ISR注册API，允许驱动程序在用户态或内核态注册中断处理函数。注册机制的核心是InterruptAttach()和InterruptAttachEvent()函数。

2.3.1 ISR注册API对比

2.3.2 典型ISR注册流程

以下代码展示了在QNX用户态驱动中注册DMA中断的标准流程：

#include <sys/neutrino.h>
#include <hw/inout.h>

// DMA 中断服务例程
const struct sigevent *dma_isr(void *arg, int id) {
    uintptr_t *status_reg = (uintptr_t *)arg;

    // 1. 读取DMA状态寄存器，确认中断源
    uint32_t status = in32(*status_reg);

    // 2. 清除中断标志
    out32(*status_reg, status | DMA_DONE_MASK);

    // 3. 返回事件通知线程（使用 InterruptAttachEvent 时）
    return (NULL);  // 或返回 &event
}

// 驱动初始化函数
int dma_driver_init(void) {
    int intr_id;
    uintptr_t dma_base = 0xFFE01000;  // DMA控制器基地址
    uintptr_t status_reg = dma_base + DMA_STATUS_OFFSET;

    // 注册中断：向量号 65（假设硬件IRQ 33）
    intr_id = InterruptAttach(65, dma_isr, &status_reg,
                              sizeof(status_reg), 0);
    if (intr_id == -1) {
        perror("InterruptAttach failed");
        return (-1);
    }

    // 使能DMA中断
    InterruptUnmask(65, intr_id);

    return (0);
}

2.3.3 中断注册的内部机制

当驱动程序调用InterruptAttach()时，QNX内核执行以下步骤：

1. 参数校验：检查中断向量号是否在有效范围内（32-1019），以及调用进程是否具有权限。
2. 向量表锁定：获取中断向量表的互斥锁，防止并发修改。
3. 创建中断描述符：分配struct intr_entry，填充ISR地址、参数和标志。
4. 插入链表：如果该向量已有ISR注册（共享中断），则将新描述符插入链表头部。
5. 硬件配置：调用中断控制器驱动的intr_attach()回调，配置GIC/INTC寄存器。
6. 使能中断：默认情况下中断处于屏蔽状态，驱动需调用InterruptUnmask()显式使能。

下图展示了ISR注册的完整内部流程：

2.4 中断映射故障排查要点

在DMA与中断映射的BSP移植中，以下三个环节最容易出现问题：

• 中断号偏移错误：硬件手册中的IRQ号通常从0开始，但QNX向量表从32开始。例如，DMA控制器IRQ 33对应QNX向量65。计算错误会导致ISR注册到错误的中断源。
• 中断控制器初始化顺序：必须在注册任何ISR之前完成GIC/INTC的初始化，包括设置优先级掩码（GICC_PMR）和使能组0/1中断。否则中断会被硬件屏蔽。
• ISR上下文限制：在ISR中不能调用任何可能阻塞的函数（如malloc()、printf()、pthread_mutex_lock()）。如果需要复杂处理，应使用InterruptAttachEvent()将工作委托给线程。