📚 课程目录第4章 VxWorks中断管理框架

4. VxWorks 中断管理框架：intLib、intConnect、intContext、中断栈配置

VxWorks 的中断管理框架是 BSP 与硬件中断控制器之间的核心桥梁。本章深入剖析 intLib 库、intConnect 连接机制、intContext 上下文判定以及中断栈的独立配置，帮助调试人员精准定位中断相关故障。

4.1 intLib 库：中断管理的核心 API

intLib 是 VxWorks 提供的中断管理标准库，封装了从注册、使能到屏蔽的全套接口。BSP 开发者通过该库与中断控制器（如 GIC、IOAPIC）交互，无需直接操作硬件寄存器。

API 函数	功能描述	典型调用场景
`intConnect()`	将中断向量与 C 语言 ISR 绑定	驱动初始化时注册中断处理函数
`intEnable()`	使能指定中断向量	中断控制器初始化后打开中断线
`intDisable()`	屏蔽指定中断向量	临界区保护或设备暂停时关闭中断
`intLock()`	全局关中断，返回旧 CPU 状态	互斥操作、原子性保护
`intUnlock()`	恢复之前保存的 CPU 状态	配合 intLock 成对使用
`intContext()`	判断当前是否在中断上下文中	调试断言、资源分配策略选择

调试提示： 在 ISR 中调用 intContext() 应返回 TRUE。若返回 FALSE，说明中断栈或向量表配置异常，需检查 BSP 的 sysIntInit() 实现。

4.2 intConnect 机制：从向量到 C 函数的桥梁

intConnect() 是 VxWorks 中断管理的核心绑定函数。它接收中断向量号、ISR 函数指针和一个参数，在内部生成一段“中断桩代码”（interrupt stub），该桩代码负责保存/恢复寄存器、切换栈指针，并最终调用用户提供的 C 函数。

STATUS intConnect
    (
    VOIDFUNCPTR *vector,   /* 中断向量号 */
    VOIDFUNCPTR routine,   /* ISR 函数指针 */
    int          parameter /* 传递给 ISR 的参数 */
    )

  关键流程：
  根据向量号查找中断描述符表。
分配并初始化中断桩代码（通常位于 RAM 中）。
将桩代码地址写入中断向量表对应条目。
硬件中断触发时，CPU 跳转到桩代码，再由桩代码调用 routine(parameter)。

4.3 intContext：中断上下文判定

intContext() 函数返回一个布尔值，指示当前执行环境是否处于中断服务例程中。其实现原理通常依赖于检查当前栈指针是否位于中断栈区域内，或读取 CPU 的状态寄存器中的中断标志位。

常见陷阱： 在中断上下文中调用 taskDelay()、semTake()（带超时）或 malloc() 会导致系统崩溃。调试时应在 ISR 入口处使用 intContext() 断言保护。

/* 安全 ISR 编写示例 */
void myIsr(int param)
{
    if (!intContext())
    {
        /* 非中断上下文，记录错误 */
        logMsg("myIsr called outside interrupt context!\n", 0,0,0,0,0);
        return;
    }

    /* 使用中断安全的操作：仅操作硬件寄存器、发送信号量 */
    semGive(mySemId);
    *regPtr = param;
}

4.4 中断栈配置：独立栈与共享栈

VxWorks 支持两种中断栈模式，通过 BSP 中的 config.h 宏 ISR_STACK_SIZE 和 INT_STACK_OVERFLOW_CHECK 控制。独立中断栈可防止 ISR 深度嵌套耗尽任务栈空间，但会占用额外的内存。

配置模式	宏定义	优点	缺点
共享任务栈	`#undef ISR_STACK_SIZE`	节省内存，简单	ISR 嵌套易导致任务栈溢出
独立中断栈	`#define ISR_STACK_SIZE 4096`	隔离性好，ISR 安全	额外占用 4KB+ 内存

  调试建议： 在开发阶段始终启用独立中断栈并开启 INT_STACK_OVERFLOW_CHECK。当系统出现随机崩溃或“看门狗复位”时，优先检查中断栈是否溢出。

4.5 中断栈溢出检测与调试

VxWorks 提供 INT_STACK_OVERFLOW_CHECK 宏，启用后会在每次 ISR 入口和出口检查栈边界。若检测到溢出，系统会调用 intStackOverflowHook()，默认行为是触发系统恐慌并打印栈回溯。

/* 在 BSP config.h 中启用溢出检测 */
#define INT_STACK_OVERFLOW_CHECK   TRUE
#define ISR_STACK_SIZE             4096

/* 自定义溢出钩子函数示例 */
void myStackOverflowHook(char *stackBase, int stackSize)
{
    logMsg("!!! ISR STACK OVERFLOW !!!\n"
           "Base: 0x%x, Size: %d\n",
           (int)stackBase, stackSize, 0,0,0);
    /* 保存关键寄存器快照到非易失存储 */
    sysNvRamWrite((char *)0x1000, 64, (char *)&excRegs);
}

实战技巧： 在调试阶段，将 ISR_STACK_SIZE 设置为预期最大使用量的 2 倍，并在每个 ISR 入口填充固定模式（如 0xDEADBEEF），退出时检查填充是否被覆盖，可快速定位栈溢出点。

4.6 中断管理框架与 BSP 的联动关系

BSP 中的 sysIntInit() 函数负责初始化中断控制器，设置向量表基地址，并配置中断栈。该函数在系统启动早期被调用，是中断管理框架正常工作的前提。

向量表初始化： BSP 将中断向量表定位到 RAM 中，并填充默认处理函数（通常指向 intEnt() 桩代码入口）。
中断控制器配置： 设置优先级分组、中断使能寄存器、触发方式（边沿/电平）。
栈指针切换： 若启用独立中断栈，BSP 在 sysIntInit() 中分配栈空间，并将栈指针存入 CPU 的专用寄存器或内存变量中。

  调试检查清单：
  确认 sysIntInit() 在 usrInit() 中被调用。
验证中断向量表地址与 VEC_BASE_ADRS 宏一致。
使用 checkStack 命令在 shell 中查看中断栈使用情况。
在 ISR 中插入 logMsg 打印向量号，确认中断正确路由。