第一章：任务创建与管理——任务状态机、优先级、堆栈与xTaskCreate详解
大家好，我是你们的嵌入式系统讲师。今天咱们来聊聊FreeRTOS里最核心的东西——任务。说白了，整个操作系统就是靠任务来运转的。你写的业务逻辑，最终都要包装成一个一个的任务。
我个人习惯把任务想象成一个个独立的小工人。每个工人有自己的活干，有自己的工具包（堆栈），还有自己的优先级。系统调度器就是工头，负责安排谁干活、谁休息。
1.1 任务状态机：任务的一生
一个任务从创建到销毁，会经历几种状态。我刚开始学RTOS时，总觉得状态切换很抽象。后来在项目里调试一个死锁问题，才真正理解了这玩意儿有多重要。
FreeRTOS里任务有四种状态：
- 运行态（Running）：正在使用CPU。单核情况下，同一时刻只有一个任务处于此状态。
- 就绪态（Ready）：能跑，但CPU被别人占着。排队等调度。
- 阻塞态（Blocked）：在等某个事件。比如等消息队列、等信号量、等延时结束。
- 挂起态（Suspended）：被vTaskSuspend挂起，调度器直接忽略它。必须手动恢复。
嗯，这里要注意：阻塞和挂起看起来都是“不跑”，但本质不同。阻塞是主动等待，挂起是被动暂停。我曾经在项目里把挂起当阻塞用，结果任务永远醒不过来……
核心记忆点：就绪→运行（调度器选中），运行→就绪（被更高优先级抢占），运行→阻塞（等待事件），阻塞→就绪（事件到达）。挂起态是独立于这三态之外的。
1.2 任务优先级：谁先跑谁后跑
优先级决定了调度器先让谁干活。数值越大，优先级越高。FreeRTOS支持0到(configMAX_PRIORITIES - 1)的优先级范围。
你想想看，如果两个任务优先级不同，高优先级的任务会一直霸占CPU，直到它主动阻塞或挂起。低优先级的任务？嗯，只能等着。这就是所谓的“抢占式调度”。
我曾经踩过的坑：把三个任务的优先级都设成一样，以为它们会公平轮转。结果发现一个任务卡在while循环里，其他两个任务永远没机会跑。后来才意识到，同优先级默认是时间片轮转，但前提是任务要主动让出CPU或者被系统时钟中断打断。如果你的任务一直占着CPU不放，同优先级的兄弟也得等着。
| 优先级值 | 典型用途 | 说明 |
|---|---|---|
| 0（最低） | 空闲任务 | 系统自动创建，优先级最低 |
| 1-3 | 后台处理任务 | 数据记录、状态上报等 |
| 4-6 | 普通业务任务 | 传感器读取、协议处理 |
| 7-9 | 实时性要求高的任务 | 控制环路、紧急响应 |
| configMAX_PRIORITIES-1 | 最高优先级 | 慎用，容易饿死其他任务 |
我的建议：优先级别设太多层级。一般3-5个级别就够用了。层级太多，调度开销大，而且容易搞混。我习惯把实时性要求高的任务放在高优先级，把数据记录、日志输出这类任务放在低优先级。
1.3 任务堆栈：每个任务的小仓库
每个任务都有自己的堆栈空间。局部变量、函数调用时的返回地址、寄存器现场，都保存在这里。堆栈大小直接决定了任务能嵌套调用多深的函数。
我记得有一次，一个任务莫名其妙地崩溃了。查了两天才发现，堆栈设得太小，函数调用一深就把堆栈踩爆了。从那以后，我养成了一个习惯：每个任务至少给256字节，复杂任务给512甚至1024字节。
怎么估算堆栈大小？
- 看任务里最大局部变量占多少字节
- 看函数调用链最深有多少层
- 加上中断嵌套的额外开销（如果任务会被中断打断）
- 留出20%-30%的余量
实用技巧：FreeRTOS提供了uxTaskGetStackHighWaterMark()函数，可以查看任务堆栈还剩多少空间。我每次调试新任务时，都会先跑一遍这个函数，看看堆栈使用情况。如果剩余空间小于20%，我就加大堆栈。
1.4 xTaskCreate API详解：创建任务的正确姿势
终于到重点了。xTaskCreate是创建任务的核心API。它的原型长这样：
BaseType_t xTaskCreate(
TaskFunction_t pvTaskCode, // 任务函数指针
const char * const pcName, // 任务名称（调试用）
configSTACK_DEPTH_TYPE usStackDepth, // 堆栈深度（单位是字，不是字节）
void *pvParameters, // 传递给任务函数的参数
UBaseType_t uxPriority, // 任务优先级
TaskHandle_t *pxCreatedTask // 返回的任务句柄
);每个参数我都给你拆开讲：
- pvTaskCode：就是你的任务函数。函数签名必须是void vTaskFunction(void *pvParameters)。
- pcName：给任务起个名字。调试时用vTaskList或vTaskGetRunTimeStats能看到。名字最长是configMAX_TASK_NAME_LEN个字符。
- usStackDepth：注意！单位是字（word）。在32位处理器上，1个字=4字节。所以如果你想要1KB堆栈，这里填256。
- pvParameters：传给任务函数的参数。可以传整数、结构体指针，甚至NULL。
- uxPriority：优先级。0到configMAX_PRIORITIES-1。
- pxCreatedTask：输出参数。创建成功后，这里会存任务句柄。如果你不需要，可以传NULL。
返回值：pdPASS表示成功，errCOULD_NOT_ALLOCATE_REQUIRED_MEMORY表示堆内存不够。
我曾经犯过的错：把usStackDepth填成了字节数。在STM32上，我填了1024，以为给了1KB堆栈。实际上只给了256字节（1024/4）。任务一跑就崩。后来查手册才发现这个坑。所以，一定要记住：堆栈深度单位是字，不是字节！
来个完整的例子：
void vTask1(void *pvParameters)
{
int count = 0;
while(1)
{
count++;
vTaskDelay(pdMS_TO_TICKS(1000)); // 延时1秒
}
}
void main(void)
{
TaskHandle_t xTask1Handle = NULL;
// 创建任务，堆栈128字=512字节，优先级2
if(xTaskCreate(
vTask1, // 任务函数
"Task1", // 任务名称
128, // 堆栈深度（128字）
NULL, // 无参数
2, // 优先级2
&xTask1Handle // 保存句柄
) != pdPASS)
{
// 创建失败，处理错误
while(1);
}
vTaskStartScheduler(); // 启动调度器
// 程序不会执行到这里
}嗯，这里要注意：vTaskStartScheduler()之后，main函数就“死”了。调度器接管了CPU。所以创建任务一定要在启动调度器之前完成。
我的习惯：创建任务后，我会立即检查返回值。如果失败，我会用断言或者LED闪烁来提示。这样调试时能第一时间发现问题。另外，任务句柄我一般都会保存下来，方便后续用vTaskDelete或vTaskSuspend来管理任务。
好了，任务创建与管理的核心内容就这些。记住：状态机决定了任务怎么切换，优先级决定了谁先跑，堆栈决定了任务能跑多深，xTaskCreate是这一切的起点。把这四个点吃透了，FreeRTOS的任务管理你就掌握了八成。
公众号:蓝海资料掘金营，微信deep3321