📚 课程目录第4章中断映射原理

4. 中断映射原理：硬件中断号到系统IRQ的映射、中断描述符、中断绑定

在QNX设备驱动开发中，中断映射是连接物理硬件中断信号与操作系统中断处理框架的核心桥梁。理解从硬件中断号到系统IRQ的映射过程、中断描述符的结构以及中断绑定的机制，是编写可靠中断驱动的基础。本章将深入剖析这一链路中的关键环节。

4.1 硬件中断号与系统IRQ的映射

硬件中断号（通常称为IRQ线号）由SoC或外设控制器定义，而QNX系统内部使用一个全局的、逻辑的系统IRQ编号来标识每个中断源。映射过程通常发生在系统启动或驱动加载阶段，由内核或平台初始化代码完成。

  核心概念： 硬件中断号是物理的、平台相关的；系统IRQ是逻辑的、操作系统全局唯一的。映射表通常存储在平台的中断控制器驱动或设备树（如QNX的.build文件或startup代码）中。

映射流程一般包含以下步骤：

硬件枚举： 启动代码扫描中断控制器（如GIC、APIC、NVIC）的寄存器，获取每个外设的硬件中断号。
系统IRQ分配： 内核为每个有效的中断源分配一个唯一的系统IRQ编号（通常从0或一个基础值开始递增）。
映射表建立： 在内存中维护一个映射数组或哈希表，键为硬件中断号，值为系统IRQ编号。
驱动注册： 驱动通过 InterruptAttach() 或 InterruptAttachEvent() 函数，使用系统IRQ编号来绑定中断处理程序。

下表展示了典型的映射关系：

硬件中断号 (HW IRQ)	外设名称	系统IRQ编号 (SysIRQ)	中断控制器
32	UART1	64	GIC-400
33	I2C0	65	GIC-400
50	GPIO Bank A	82	GIC-400
101	Ethernet MAC	133	GIC-500

调试技巧： 在QNX系统下，可以使用 pci -vvv 或 io-pkt -v 查看部分设备的中断映射。对于嵌入式平台，通常需要查阅BSP文档中的 intrdef.h 或 sys/intr.h 文件来确认系统IRQ的分配。

4.2 中断描述符 (Interrupt Descriptor)

中断描述符是内核内部用于管理每个系统IRQ的数据结构。它包含了中断处理所需的所有元数据，是驱动与内核中断子系统交互的核心对象。在QNX中，中断描述符通常由 struct intr 或类似结构体表示，但驱动开发者通常通过API间接操作。

中断描述符的主要字段包括：

系统IRQ编号： 唯一标识该中断。
中断处理函数指针： 指向驱动注册的 InterruptHandler() 或 InterruptServiceRoutine()。
处理函数参数： 传递给中断处理函数的上下文指针（通常为设备实例结构体）。
中断优先级： 用于中断嵌套和抢占控制。
中断状态标志： 如是否启用、是否正在处理、是否共享等。
绑定信息： 指向绑定的CPU、中断控制器实例等。
统计计数器： 记录中断触发次数、处理耗时等调试信息。

  关键点： 中断描述符在内核空间维护，驱动通过 InterruptAttach() 返回的ID（或句柄）来间接引用它。不要直接操作描述符结构体，应始终使用QNX提供的API。

以下是一个典型的中断描述符结构示意（伪代码，用于理解）：

struct qnx_intr_descriptor {
    uint32_t        sysirq;         // 系统IRQ编号
    uint32_t        hwirq;          // 硬件中断号
    void            *handler;       // 中断处理函数
    void            *arg;           // 处理函数参数
    uint32_t        priority;       // 中断优先级
    uint32_t        flags;          // 状态标志 (ENABLED, SHARED, ...)
    cpu_t           cpu_affinity;   // CPU亲和性
    uint64_t        trigger_count;  // 触发次数统计
    struct intr_ctrl *ctrl;         // 所属中断控制器
};

4.3 中断绑定 (Interrupt Binding)

中断绑定是指将特定的系统IRQ与一个或多个中断处理实体（如进程、线程、中断服务例程）关联起来的过程。QNX提供了灵活的中断绑定机制，支持多种绑定模式。

主要的绑定方式包括：

直接绑定 (InterruptAttach)： 将中断处理函数直接绑定到系统IRQ。处理函数在中断上下文中执行，适用于快速、轻量的处理。
事件绑定 (InterruptAttachEvent)： 将中断与一个事件对象绑定。当中断触发时，内核发送一个事件（如SIGEV_INTR）给指定进程或线程，处理在进程上下文中执行，更安全但延迟稍高。
CPU亲和性绑定： 通过 InterruptCpuAffinity() 将中断绑定到特定的CPU核心，用于负载均衡和性能优化。

注意事项： 中断绑定必须在驱动初始化阶段完成。在中断处理函数中，应避免调用可能导致阻塞的API（如 malloc()、printf()）。对于需要复杂处理的中断，推荐使用 InterruptAttachEvent() 结合工作线程的模式。

中断绑定的典型流程如下：

驱动获取系统IRQ编号（通常从BSP头文件或启动参数获取）。
调用 InterruptAttach() 或 InterruptAttachEvent() 进行绑定。
内核创建或更新对应的中断描述符，填充处理函数、参数、优先级等信息。
驱动调用 InterruptUnmask() 启用中断。
在卸载时，调用 InterruptDetach() 解除绑定。

以下是一个简单的中断绑定代码示例：

#include <sys/neutrino.h>
#include <hw/inout.h>  // 假设是x86平台

#define UART1_IRQ 64   // 系统IRQ编号

// 中断处理函数
const struct sigevent *uart_isr(void *arg, int id) {
    struct sigevent *event = (struct sigevent *)arg;
    // 读取中断状态寄存器，清除中断标志
    uint8_t status = in8(UART_BASE + LSR);
    // ... 处理接收/发送数据 ...
    // 返回事件通知工作线程
    return event;
}

int main(int argc, char *argv[]) {
    int irq_id;
    struct sigevent event;

    // 初始化事件
    SIGEV_INTR_INIT(&event);

    // 绑定中断
    irq_id = InterruptAttach(UART1_IRQ, uart_isr, &event, sizeof(event), 0);
    if (irq_id == -1) {
        perror("InterruptAttach failed");
        return EXIT_FAILURE;
    }

    // 启用中断
    InterruptUnmask(UART1_IRQ, irq_id);

    // ... 主循环或等待事件 ...
    // 卸载时
    InterruptDetach(irq_id);
    return EXIT_SUCCESS;
}

4.4 中断映射与绑定的调试实践

在实际开发中，中断映射和绑定问题是最常见的调试难点之一。以下是一些实用的调试方法和工具：

使用 pidin -p <pid> -v 查看进程中断信息： 可以显示进程绑定的中断ID和处理函数地址。
使用 sloginfo 查看内核中断日志： 当中断触发异常时，内核通常会输出错误信息到系统日志。
使用 InterruptAttach() 的返回值： 检查返回值是否为-1，并打印 errno 以获取失败原因（如 EAGAIN、EINVAL）。
验证硬件中断号： 使用示波器或逻辑分析仪确认硬件引脚上的中断信号是否正常。
检查中断控制器配置： 确认中断触发方式（电平/边沿）、极性等是否与驱动配置一致。

实战建议： 在驱动初始化阶段，添加打印语句输出系统IRQ编号和绑定结果。使用 InterruptMask() 和 InterruptUnmask() 在调试时手动控制中断的启用/禁用，以隔离问题。

下表总结了常见的中断映射与绑定问题及排查方向：

问题现象	可能原因	排查方向
中断从未触发	系统IRQ编号错误、中断被屏蔽、硬件信号未到达	检查映射表、`InterruptUnmask()` 调用、硬件连接
中断触发后系统崩溃	中断处理函数中调用了阻塞API、栈溢出、指针错误	检查ISR代码、使用 `InterruptAttachEvent()` 替代
中断响应延迟过高	中断优先级设置不当、CPU亲和性未优化、其他高优先级中断抢占	调整优先级、绑定专用CPU核心
中断丢失	中断共享冲突、未及时清除中断标志、中断控制器FIFO溢出	检查共享中断处理逻辑、优化ISR执行时间

通过深入理解中断映射原理、中断描述符的结构以及中断绑定的多种方式，开发者能够更高效地定位和解决中断相关的驱动问题，为后续的数据传输调试打下坚实基础。