FreeRTOS V9.0.0在Cortex-M3上GPIO中断调用TaskResumeFromISR断言失败

首先，你遇到的断言失败本质是FreeRTOS的中断安全规则被违反：FreeRTOS要求只有优先级足够低（即硬件优先级数值足够大）的中断才能调用其提供的中断安全API（比如TaskResumeFromISR）。高优先级中断（硬件数值小）会绕过FreeRTOS的内核锁机制，导致数据不一致，因此被断言拦截。

关键数值解析 #

从你的配置和测试结果来看：

• configPRIO_BITS=3：说明Cortex-M3的NVIC使用3位作为抢占优先级，因此逻辑优先级数值范围是0~7（数值越小，硬件优先级越高）。
• configLIBRARY_MAX_SYSCALL_INTERRUPT_PRIORITY=0x05：这是FreeRTOS允许调用API的最低逻辑优先级阈值（数值越大，优先级越低）。映射到硬件优先级数值是 0x05 << (8-3) = 160，也就是ucMaxSysCallPriority=160。
• 你的GPIO中断默认优先级是0（硬件数值0），远小于160，触发断言；设为7时硬件数值是7<<5=224，满足224>=160，断言通过。

可用优先级数值范围 #

结合你的需求（自定义中断优先级低于内核的PendSV/SysTick，且能安全调用FreeRTOS API）：

1. 可调用FreeRTOS API的数值范围：逻辑优先级数值 >=5（即5、6、7），对应的硬件数值分别是160、192、224，都满足ucCurrentPriority >= ucMaxSysCallPriority。
2. 关于“低于内核优先级”的说明：内核的PendSV和SysTick用的是数值7（硬件优先级最低），所以：
   • 如果你希望自定义中断优先级不高于内核（即优先级比内核还低）：只能用数值7（因为7是3位范围内的最大值）。
   • 如果你希望自定义中断优先级可以比内核高，但仍能安全调用API：可以用数值5或6，这两个数值的优先级比7高，但仍符合FreeRTOS的API调用规则。

注意：由于configPRIO_BITS=3，逻辑优先级数值最大只能到7，不存在8及以上的数值，这是硬件NVIC的限制（3位只能表示0~7共8个优先级等级）。

配置建议 #

你可以在初始化中断时，将GPIO等需要调用FreeRTOS API的中断优先级设置为5、6或7，比如：

// 设置GPIO_EVEN中断优先级为6（逻辑优先级，数值越大优先级越低）
hal::nvic::setPriority(GPIO_EVEN_IRQn, 6);
hal::nvic::setPriority(GPIO_ODD_IRQn, 6);

这样既满足FreeRTOS的中断安全要求，也能根据你的需求调整优先级等级。

内容的提问来源于stack exchange，提问作者user82375897897928347