【产出】 > 在 FreeRTOS 工程里正确地从中断调用内核 API:会用 FromISR 系列函数和
pxHigherPriorityTaskWoken/portYIELD_FROM_ISR(),在 Cortex-M 上把中断优先级配到configMAX_SYSCALL_INTERRUPT_PRIORITY允许的范围内,并用任务通知把中断里的耗时处理推迟到任务中完成。
【版本】 > 依据 FreeRTOS 内核官方手册(FreeRTOS Kernel Book)第 7 章 Interrupt Management、第 10 章 Task Notifications 和内核源码
task.h、queue.h、timers.h编写,适用于 FreeRTOS V10 / V11。中断优先级一节以 ARM Cortex-M3 / M4 / M7 为例,示例代码使用 STM32 HAL。
一、中断里只能调用 FromISR 函数
普通的内核 API,比如 xQueueSend()、xSemaphoreTake(),都可能让调用它的任务进入阻塞态。中断服务程序(ISR)不是任务,没有"调用者任务"可以阻塞,所以这些函数在中断里不能用。
FreeRTOS 的解决办法是把需要在中断中使用的函数单独做一份,名字以 FromISR 结尾。官方手册的规则只有一句:名字里没有 FromISR 的 API,绝不能在 ISR 里调用。
常用的对应关系:
| 任务中使用 | 中断中使用 |
|---|---|
xQueueSendToBack() / xQueueSend() | xQueueSendToBackFromISR() / xQueueSendFromISR() |
xQueueSendToFront() | xQueueSendToFrontFromISR() |
xQueueReceive() | xQueueReceiveFromISR() |
xSemaphoreGive() | xSemaphoreGiveFromISR() |
xTaskNotifyGive() | vTaskNotifyGiveFromISR() |
xTaskNotify() | xTaskNotifyFromISR() |
xTimerStart() / xTimerReset() | xTimerStartFromISR() / xTimerResetFromISR() |
xTaskResumeAll() 等 | 无对应版本,中断里不能用 |
FromISR 函数没有 xTicksToWait 参数,因为中断里不能等。队列满、发不进去时直接返回失败。
为什么不做成一个函数自动判断上下文?官方手册给的理由是:那样每个 API 都要多一段判断逻辑,参数在两种场合里各有一部分用不上,而且每个移植层都得提供判断"当前是不是在中断里"的方法,有的架构做这件事很麻烦。分成两套之后,任务侧和中断侧的代码都更短更快。
二、pxHigherPriorityTaskWoken 和 portYIELD_FROM_ISR
问题从哪来
在任务里调用 xQueueSend(),如果唤醒了一个比自己优先级高的任务,并且 configUSE_PREEMPTION 为 1,内核会在函数返回之前就切换过去。
在中断里调用 xQueueSendFromISR() 唤醒了高优先级任务时,内核不会自动切换,只是把一个变量置为 pdTRUE,告诉你"该切换了"。这个变量就是 FromISR 函数最后一个参数 pxHigherPriorityTaskWoken 指向的变量。
标准写法
void XXX_IRQHandler(void)
{
BaseType_t xHigherPriorityTaskWoken = pdFALSE; /* 必须先初始化为 pdFALSE */
/* 清中断标志、读数据…… */
xSemaphoreGiveFromISR(xSem, &xHigherPriorityTaskWoken);
xQueueSendFromISR(xQueue, &data, &xHigherPriorityTaskWoken); /* 可以共用同一个变量 */
portYIELD_FROM_ISR(xHigherPriorityTaskWoken); /* 为 pdTRUE 时请求切换 */
}
要点:
| 规则 | 原因 |
|---|---|
变量先初始化为 pdFALSE | FromISR 函数只会把它置为 pdTRUE,从不清零 |
| 一个 ISR 里调用多个 FromISR 函数时共用一个变量 | 任何一个唤醒了高优先级任务,最后都能切换,而且只切换一次 |
portYIELD_FROM_ISR() 放在 ISR 最后 | 大多数移植允许在 ISR 任意位置调用,但少数小架构的移植只允许在最末尾调用,放最后总是对的 |
不想处理时可以传 NULL | 合法,但高优先级任务要等到下一次调度(最坏是下一个 tick 中断)才运行 |
portEND_SWITCHING_ISR() 和 portYIELD_FROM_ISR() 作用相同。历史上前者用于需要汇编包装的移植,后者用于整个中断函数可以写成 C 的移植。有的移植只提供其中一个,Cortex-M 上两个都有,官方示例统一用 portYIELD_FROM_ISR()。
不调用会怎样
不会出错,只是响应变慢。中断返回后回到被打断的低优先级任务继续跑,被唤醒的高优先级任务停在就绪态,直到下一次调度点。对于"中断唤醒处理任务"这种设计,这段延迟最长可达一个节拍周期,等于白白损失了实时性。
官方说明了不自动切换的理由:比如串口中断每收一个字符都可能唤醒任务,但任务只在收完整条字符串后才有事做,每个字符都切换一次就是浪费。由应用决定什么时候真正需要切换。
三、Cortex-M 上的中断优先级限制
这是 FreeRTOS 移植到 STM32 等 Cortex-M 芯片时最常见的死机原因。
两个配置项
| 配置项 | 作用 |
|---|---|
configKERNEL_INTERRUPT_PRIORITY | 内核自身中断(SysTick、PendSV)的优先级,必须是最低优先级 |
configMAX_SYSCALL_INTERRUPT_PRIORITY | 允许调用 FromISR 函数的最高中断优先级。较新的移植也叫 configMAX_API_CALL_INTERRUPT_PRIORITY,含义相同 |
内核进入临界区时,会屏蔽 configMAX_SYSCALL_INTERRUPT_PRIORITY 及以下(逻辑优先级)的中断,比它更高的中断不受影响。由此得到分界:
| 中断的逻辑优先级 | 临界区期间 | 能否调用 FreeRTOS API |
|---|---|---|
高于 configMAX_SYSCALL_INTERRUPT_PRIORITY | 照常响应,内核不会推迟它 | 任何 API 都不能调用,包括 FromISR |
| 等于或低于它 | 会被临界区推迟 | 可以调用 FromISR 函数 |
高于分界线的中断不受内核影响,响应延迟只取决于硬件,官方手册建议把电机控制这类对时序要求极严的中断放在这里,代价是它们不能和内核交互。
Cortex-M 的"数字越小,优先级越高"
Cortex-M 用数值小表示逻辑优先级高,0 是最高优先级。所以"中断优先级不能高于 configMAX_SYSCALL_INTERRUPT_PRIORITY"落到数值上就是:要调用 FromISR 的中断,优先级数值必须大于等于分界值。
Cortex-M 的优先级寄存器最多 8 位,但芯片通常只实现高几位(STM32F1/F4 实现 4 位,即 0–15 共 16 级)。没实现的是低位,所以同一个优先级有两种写法:
| 写法 | 4 位实现下优先级 5 的写法 | 谁这样用 |
|---|---|---|
| 未移位的值 | 5 | HAL_NVIC_SetPriority()、CMSIS NVIC_SetPriority() |
| 移到高位后的值 | 5 << 4 = 80(低位不用;官方手册示例把未实现位置 1,得到 95,效果相同) | 直接写寄存器 |
官方要求 configMAX_SYSCALL_INTERRUPT_PRIORITY 和 configKERNEL_INTERRUPT_PRIORITY 都用移位后的值,因为内核直接把它们写进寄存器。configKERNEL_INTERRUPT_PRIORITY 是最低优先级,未实现位可以置 1,所以不论实现了几位,都可以直接写 255。
常见的写法是先定义"未移位"的值,再统一移位(CubeMX 生成的 FreeRTOSConfig.h 就是这样组织的):
/* FreeRTOSConfig.h 片段 */
#ifdef __NVIC_PRIO_BITS
#define configPRIO_BITS __NVIC_PRIO_BITS
#else
#define configPRIO_BITS 4
#endif
#define configLIBRARY_LOWEST_INTERRUPT_PRIORITY 15
#define configLIBRARY_MAX_SYSCALL_INTERRUPT_PRIORITY 5
#define configKERNEL_INTERRUPT_PRIORITY \
(configLIBRARY_LOWEST_INTERRUPT_PRIORITY << (8 - configPRIO_BITS))
#define configMAX_SYSCALL_INTERRUPT_PRIORITY \
(configLIBRARY_MAX_SYSCALL_INTERRUPT_PRIORITY << (8 - configPRIO_BITS))
按这个配置,在 HAL 里设置中断优先级时:
/* 要调用 FromISR 的中断:数值 5..15 */
HAL_NVIC_SetPriority(USART2_IRQn, 6, 0);
HAL_NVIC_EnableIRQ(USART2_IRQn);
/* 不和内核交互、需要最快响应的中断:数值 0..4 */
HAL_NVIC_SetPriority(TIM1_UP_TIM10_IRQn, 2, 0);
【注意】 > - Cortex-M 的中断默认优先级是 0,也就是最高。官方手册强调,硬件不允许把
configMAX_SYSCALL_INTERRUPT_PRIORITY设为 0,所以任何要调用 FreeRTOS API 的中断都不能保持默认优先级,必须显式设置。
- STM32 HAL 工程建议把优先级分组设为全部是抢占优先级(
NVIC_PRIORITYGROUP_4),子优先级填 0,否则抢占优先级的位数变少,上表的数值范围就不成立了。- 一定要定义
configASSERT()。官方说明 Cortex-M 移植会自动检查中断优先级配置,但只有定义了configASSERT()才检查。优先级配错时,断言会停在vPortValidateInterruptPriority()里,比随机死机好查得多。- 以上内容对 Cortex-M0 / M0+ 只部分适用。
四、中断延迟处理:ISR 只做最少的事
官方手册建议 ISR 尽量短,理由包括:ISR 执行时,优先级再高的任务也不能运行;ISR 会给任务的启动和执行时间带来抖动;ISR 和任务同时访问变量、外设需要额外保护;中断越长越容易发生嵌套。
做法是 ISR 只负责记录中断原因、清除中断标志,其余处理交给一个任务完成,这叫"中断延迟处理"(deferred interrupt processing)。处理任务的优先级如果高于其他所有任务,配合 portYIELD_FROM_ISR(),中断一返回就直接进入它,效果和在 ISR 里处理一样及时,但处理期间其他中断可以正常响应,任务里也能使用全部 API(打印、分配内存、阻塞等待)。
官方手册列出的适合延迟处理的情况:
- 处理工作不轻,例如 ADC 结果还要过一遍软件滤波;
- 要做中断里不能做的事,例如写控制台、分配内存;
- 处理时间不确定。
只是把 ADC 结果存进变量这种一两条语句的事,留在 ISR 里即可。
五、用任务通知唤醒处理任务
唤醒处理任务可以用二值信号量,但官方手册指出,任务通知更快、更省内存:每个任务自带通知值,不需要单独创建对象,默认每个任务只占 5 字节(configTASK_NOTIFICATION_ARRAY_ENTRIES 默认为 1)。
用到的两个函数:
void vTaskNotifyGiveFromISR(TaskHandle_t xTaskToNotify,
BaseType_t *pxHigherPriorityTaskWoken);
uint32_t ulTaskNotifyTake(BaseType_t xClearCountOnExit,
TickType_t xTicksToWait);
vTaskNotifyGiveFromISR()把目标任务的通知值加 1,相当于"给"一次计数信号量。ulTaskNotifyTake()阻塞等待通知值大于 0,返回值是减之前的通知值。xClearCountOnExit为pdTRUE时返回前清零,为pdFALSE时只减 1。
用 pdTRUE 时,返回值就是上次取走之后累积的中断次数,二值信号量那种"任务忙时连来几次中断只记一次"的问题不存在了。
完整示例:串口空闲中断 + DMA,任务处理整帧
#include "main.h"
#include "FreeRTOS.h"
#include "task.h"
#define RX_BUF_SIZE 128
extern UART_HandleTypeDef huart2;
static uint8_t rx_buf[RX_BUF_SIZE];
static volatile uint16_t rx_len;
static TaskHandle_t xUartTaskHandle = NULL;
/* HAL 回调在 USART2 / DMA 的中断里执行,属于 ISR 上下文 */
void HAL_UARTEx_RxEventCallback(UART_HandleTypeDef *huart, uint16_t Size)
{
if (huart->Instance != USART2 || xUartTaskHandle == NULL) {
return;
}
BaseType_t xWoken = pdFALSE;
rx_len = Size; /* 只记录长度 */
vTaskNotifyGiveFromISR(xUartTaskHandle, &xWoken);
portYIELD_FROM_ISR(xWoken);
}
static void vUartTask(void *pv)
{
(void)pv;
const TickType_t xMaxWait = pdMS_TO_TICKS(1000);
HAL_UARTEx_ReceiveToIdle_DMA(&huart2, rx_buf, RX_BUF_SIZE);
__HAL_DMA_DISABLE_IT(huart2.hdmarx, DMA_IT_HT);
for (;;) {
uint32_t ulEvents = ulTaskNotifyTake(pdTRUE, xMaxWait);
if (ulEvents == 0) {
/* 1 s 内没有收到任何数据,可在这里做超时处理 */
continue;
}
if (ulEvents > 1) {
/* 处理期间又来了新帧,单缓冲已被覆盖,这里计一次丢帧 */
}
uint16_t len = rx_len;
/* 在任务里解析 rx_buf[0 .. len-1],可以打印、可以阻塞 */
HAL_UARTEx_ReceiveToIdle_DMA(&huart2, rx_buf, RX_BUF_SIZE);
__HAL_DMA_DISABLE_IT(huart2.hdmarx, DMA_IT_HT);
}
}
void uart_task_start(void)
{
/* USART2 与对应 DMA 中断的优先级数值必须 >= configLIBRARY_MAX_SYSCALL_INTERRUPT_PRIORITY */
xTaskCreate(vUartTask, "uart", 384, NULL, configMAX_PRIORITIES - 2, &xUartTaskHandle);
}
这个例子里接收在任务处理完之后才重新启动,所以处理期间 DMA 不会写缓冲区;若要处理期间也能接收,需要双缓冲,并把"哪个缓冲、多长"通过队列交给任务。
【提示】 > 中断要传给任务的不只是"发生了",还有少量数据时,可以用
xTaskNotifyFromISR(xTask, ulValue, eAction, &xWoken)。eAction取eSetBits时可以把多个事件源按位合并到一个通知值里,任务用xTaskNotifyWait()取出全部位后逐位处理。
任务通知的限制
官方手册列出了任务通知不适用的场合,遇到时改用队列、信号量或事件组:
| 限制 | 替代 |
|---|---|
| 只能发给一个指定任务,不能有多个接收者 | 信号量、队列 |
| 不能从任务发给中断 | 队列 |
| 通知值一次只存一个值,不能缓存多条数据 | 队列 |
| 不能同时广播给多个任务 | 事件组 |
| 发送方不能阻塞等待接收方取走上一次通知 | 队列 |
六、另一种延迟处理:交给守护任务执行
如果不想为某个中断单独建一个任务,可以把处理函数交给 RTOS 守护任务(软件定时器服务任务)执行:
BaseType_t xTimerPendFunctionCallFromISR(PendedFunction_t xFunctionToPend,
void *pvParameter1,
uint32_t ulParameter2,
BaseType_t *pxHigherPriorityTaskWoken);
PendedFunction_t 的原型是 void func(void *arg1, uint32_t arg2)。使用前要在 FreeRTOSConfig.h 中把 INCLUDE_xTimerPendFunctionCall 和 configUSE_TIMERS 都设为 1。处理函数在守护任务里运行,优先级就是 configTIMER_TASK_PRIORITY,和所有软件定时器回调共用一个任务,因此同样不能阻塞。
七、排查清单
| 现象 | 优先查 |
|---|---|
进中断后卡死在 vPortValidateInterruptPriority 的断言 | 该中断优先级数值小于分界值,或保持了默认的 0 |
| 不定期 HardFault、内核链表损坏 | 没定义 configASSERT(),优先级配错未被发现;或在 ISR 里调用了非 FromISR 函数 |
| 任务被唤醒总是慢一拍 | ISR 里没有调用 portYIELD_FROM_ISR() |
| 连续中断只处理了一次 | 用的是二值信号量;改用 ulTaskNotifyTake(pdTRUE, ...) 并使用返回的计数 |
| 第一次中断就崩溃 | 中断在任务创建前就使能了,通知的任务句柄还是 NULL |
参考资料
- FreeRTOS 内核官方手册 第 7 章 Interrupt Management:https://github.com/FreeRTOS/FreeRTOS-Kernel-Book/blob/main/ch07.md
- FreeRTOS 内核官方手册 第 10 章 Task Notifications:https://github.com/FreeRTOS/FreeRTOS-Kernel-Book/blob/main/ch10.md
- FreeRTOS 内核源码 task.h、queue.h、timers.h:https://github.com/FreeRTOS/FreeRTOS-Kernel/tree/main/include
评价 (0)