【产出】 > 理解 FreeRTOS 任务的创建、优先级、调度方式和任务状态,能写出不会"饿死"其他任务的周期任务,并会排查最常见的栈溢出问题。
【版本】 > 按 FreeRTOS 内核官方手册(FreeRTOS Kernel Book)编写,适用于 FreeRTOS V10 / V11,与具体芯片无关。STM32、ESP32(ESP-IDF 内置 FreeRTOS)都适用。
一、任务是什么
FreeRTOS 里的"任务"可以理解为一个永不返回的函数,每个任务有自己独立的栈。调度器负责决定某一时刻哪个任务在 CPU 上运行。
一个任务函数的标准写法:
void vLedTask(void *pvParameters)
{
for (;;) {
HAL_GPIO_TogglePin(LED_GPIO_Port, LED_Pin);
vTaskDelay(pdMS_TO_TICKS(500));
}
/* 任务函数不能 return;确实要结束时调用 vTaskDelete(NULL) */
}
二、创建任务:xTaskCreate
BaseType_t xTaskCreate(TaskFunction_t pvTaskCode, // 任务函数
const char * const pcName, // 任务名,调试用
configSTACK_DEPTH_TYPE usStackDepth, // 栈大小,单位是"字"
void *pvParameters, // 传给任务的参数
UBaseType_t uxPriority, // 优先级
TaskHandle_t *pxCreatedTask); // 返回任务句柄,可传 NULL
使用示例:
TaskHandle_t xLedHandle = NULL;
if (xTaskCreate(vLedTask, "led", 128, NULL, 1, &xLedHandle) != pdPASS) {
/* 堆内存不够,任务没有创建成功 */
}
vTaskStartScheduler(); /* 启动调度器,正常情况下不会返回 */
【注意】 >
usStackDepth的单位是字(word)而不是字节。在 32 位 MCU(如 STM32、ESP32)上,128 表示 128 × 4 = 512 字节。很多人按字节填写,导致栈分配了预期的 4 倍,堆很快用光。返回值一定要检查:返回pdFAIL说明 FreeRTOS 堆空间不足。
三、优先级与调度
| 规则 | 说明 |
|---|---|
| 优先级范围 | 0(最低)到 configMAX_PRIORITIES - 1,超出范围会被截到最大值 |
| 空闲任务 | 调度器启动时自动创建,优先级为 0 |
| 调度原则 | 调度器总是运行处于就绪态的最高优先级任务 |
| 同优先级 | 多个同优先级就绪任务轮流运行 |
调度方式由 FreeRTOSConfig.h 里的两个配置决定:
configUSE_PREEMPTION | configUSE_TIME_SLICING | 行为 |
|---|---|---|
| 1 | 1 | 抢占式 + 时间片(最常用):同优先级任务每个系统节拍轮换一次 |
| 1 | 0 | 抢占式、无时间片:只有更高优先级任务就绪或当前任务阻塞时才切换,同优先级任务分到的时间可能很不均匀 |
| 0 | 任意 | 协作式:只有当前任务阻塞或调用 taskYIELD() 才切换 |
四、任务的四种状态
| 状态 | 含义 |
|---|---|
| 运行(Running) | 正在 CPU 上执行 |
| 就绪(Ready) | 可以运行,等待调度器选中 |
| 阻塞(Blocked) | 在等待时间到期,或等待队列、信号量、任务通知等事件;可以同时设置超时 |
| 挂起(Suspended) | 调度器完全不管它,只能通过 vTaskSuspend() 进入、vTaskResume() 或 xTaskResumeFromISR() 退出 |
五、最常见的坑:高优先级任务把其他任务"饿死"
官方手册专门演示过这个例子:一个优先级 2 的任务和一个优先级 1 的任务,如果两个都是死循环、从不阻塞,优先级 1 的任务永远得不到运行,空闲任务也无法运行。
错误写法:
void vSensorTask(void *pv)
{
for (;;) {
read_sensor(); /* 读完立刻进入下一轮,从不让出 CPU */
}
}
正确做法是让任务在等待时进入阻塞态:
void vSensorTask(void *pv)
{
for (;;) {
read_sensor();
vTaskDelay(pdMS_TO_TICKS(10)); /* 阻塞 10 ms,期间低优先级任务可以运行 */
}
}
【提示】 > 写任务时先问自己:这个任务在"没事干"的时候是不是处于阻塞态?等数据就用队列或信号量阻塞等待,等时间就用延时函数,而不是用
while循环去轮询一个标志位。
六、vTaskDelay 和 vTaskDelayUntil 的区别
| 函数 | 计时起点 | 适合 |
|---|---|---|
vTaskDelay(n) | 从调用时刻起阻塞 n 个节拍 | 简单的"等一会儿" |
vTaskDelayUntil(&xLastWake, n) | 相对于上一次唤醒时刻,到达绝对节拍时间后唤醒 | 固定周期任务,如 100 Hz 的控制回路 |
用 vTaskDelay 做周期任务时,任务本身的执行时间会累积到周期里,周期会越来越不准。固定周期应该这样写:
void vControlTask(void *pv)
{
TickType_t xLastWake = xTaskGetTickCount(); /* 只初始化一次 */
const TickType_t xPeriod = pdMS_TO_TICKS(10); /* 100 Hz */
for (;;) {
vTaskDelayUntil(&xLastWake, xPeriod); /* 函数会自动更新 xLastWake */
run_control_loop();
}
}
pdMS_TO_TICKS() 把毫秒换算成节拍数。官方手册指出,当 configTICK_RATE_HZ 大于 1000 时不能使用这个宏。
七、栈溢出排查
栈太小是 FreeRTOS 项目里最常见的"玄学死机"原因:程序跑一会儿就进 HardFault,或者变量值莫名其妙被改。
- 在
FreeRTOSConfig.h中打开栈溢出检测:
#define configCHECK_FOR_STACK_OVERFLOW 2
- 实现钩子函数,溢出时会被调用:
void vApplicationStackOverflowHook(TaskHandle_t xTask, char *pcTaskName)
{
/* 在这里打断点或打印 pcTaskName,就知道是哪个任务栈不够 */
for (;;);
}
- 调试阶段可以用
uxTaskGetStackHighWaterMark(句柄)查看任务栈历史最少剩余量(单位同样是字),剩余太少就加大栈。
【提示】 > 在任务里调用
printf、浮点格式化、大数组局部变量,都会大量占用栈。调试打印较多的任务,栈建议从 256 字起步,跑稳后再用水位值往下调。
参考资料
- FreeRTOS 内核官方手册:https://github.com/FreeRTOS/FreeRTOS-Kernel-Book
- FreeRTOS 官网文档:https://www.freertos.org/Documentation/
评价 (0)