4. 任务创建与删除：API函数详解（如xTaskCreate），任务句柄与栈空间配置

好，咱们直接进入正题。任务创建与删除，这是RTOS里最基础、也是最容易踩坑的地方。我见过不少新手，甚至有些老手，在任务栈配置上翻过车。今天我就把这块掰开了揉碎了讲清楚。

4.1 xTaskCreate —— 你第一个要背下来的API

在FreeRTOS里，创建任务的核心函数就是 xTaskCreate()。它的原型长这样：

BaseType_t xTaskCreate(
    TaskFunction_t pvTaskCode,      // 任务函数指针
    const char * const pcName,      // 任务名字（调试用）
    configSTACK_DEPTH_TYPE usStackDepth, // 栈深度，单位是字（word）
    void *pvParameters,             // 传给任务函数的参数
    UBaseType_t uxPriority,         // 任务优先级
    TaskHandle_t *pxCreatedTask     // 返回的任务句柄
);

返回值是 pdPASS 或 errCOULD_NOT_ALLOCATE_REQUIRED_MEMORY。嗯，说白了就是成功或失败。

我个人习惯，每次调用完 xTaskCreate 都会检查返回值。别嫌麻烦，我曾在项目里因为堆不够，任务没创建成功，结果系统跑起来跟死机一样，查了半天才发现是创建失败了。

4.2 任务句柄 —— 你的“遥控器”

任务句柄 TaskHandle_t，你可以把它理解成任务的身份证。有了它，你才能对任务做后续操作，比如删除、挂起、恢复、改变优先级。

看个例子：

TaskHandle_t xMyTaskHandle = NULL;

void vTaskFunction(void *pvParameters) {
    // 任务代码
}

void vStartMyTask(void) {
    xTaskCreate(vTaskFunction, "MyTask", 256, NULL, 1, &xMyTaskHandle);
}

这里 xMyTaskHandle 就是任务的句柄。如果你不需要后续操作，最后一个参数可以传 NULL。但我建议你永远不要传NULL，因为你永远不知道后面会不会需要它。

4.3 栈空间配置 —— 最容易翻车的地方

栈空间配置，说白了就是给任务分配多少内存。这个参数 usStackDepth 的单位是“字”（word），在32位处理器上，一个字就是4字节。

举个例子：

// 分配 256 个字，也就是 1024 字节
xTaskCreate(vTaskFunction, "MyTask", 256, NULL, 1, NULL);

那么问题来了：到底分配多大合适？

我一般遵循这个经验法则：

• 简单任务（只有几个局部变量，没有嵌套调用）：128~256字（512~1024字节）
• 中等任务（有函数调用、局部数组）：256~512字（1024~2048字节）
• 复杂任务（有递归、大数组、printf等）：512~1024字（2048~4096字节）

4.4 如何检测栈溢出？

FreeRTOS 提供了两种栈溢出检测机制，你需要在 FreeRTOSConfig.h 里开启：

#define configCHECK_FOR_STACK_OVERFLOW 2

然后实现钩子函数：

void vApplicationStackOverflowHook(TaskHandle_t xTask, char *pcTaskName) {
    // 这里可以记录错误，或者直接复位系统
    // 我一般会在这里点亮一个LED，方便调试
}

方法1和方法2的区别，说白了就是检测的时机和精度不同。方法2更可靠，但会稍微增加一点开销。我个人建议直接用方法2，省心。

4.5 任务删除 —— 善始善终

删除任务用 vTaskDelete()：

void vTaskDelete(TaskHandle_t xTaskToDelete);

如果传 NULL，就是删除自己。注意：删除任务后，任务占用的栈空间和TCB会被释放回堆，但任务自己分配的其他资源（比如动态申请的内存、信号量等）需要你自己清理。

4.6 知识体系一览

下面这张图，是我自己总结的任务创建与删除的核心逻辑，你看一眼就能明白整个流程：

4.7 实际项目中的配置建议

最后，我分享几个实际项目中的配置经验：

嗯，任务创建与删除这块，说白了就是三个核心点：API参数别搞错、栈空间给够、句柄要管好。你只要把这三点记住了，基本不会出大问题。