3. 任务创建与删除：xTaskCreate API详解、任务句柄、任务参数传递、vTaskDelete使用场景

各位同学，咱们今天聊聊FreeRTOS里最基础、也最核心的操作——任务的创建与删除。

说实话，我刚接触RTOS那会儿，觉得任务创建不就是调个函数嘛，有啥好讲的？结果在实际项目中，因为参数传错了、句柄没保存好，导致系统跑飞的情况，我至少遇到过三次。嗯，咱们今天就把它彻底讲透。

3.1 xTaskCreate API详解

先看这个函数的原型，它是FreeRTOS里创建任务的唯一标准接口（动态创建方式）。

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

返回值：pdPASS 表示创建成功，errCOULD_NOT_ALLOCATE_REQUIRED_MEMORY 表示内存不足。

这里我重点说几个容易踩坑的地方：

  • 栈深度单位：usStackDepth 的单位是“字”，在STM32上就是4字节。如果你要分配512字节的栈，这里填128。我见过有人直接填512，结果栈空间浪费了4倍。
  • 任务名称：这个字符串会被内部拷贝，但长度受 configMAX_TASK_NAME_LEN 限制，默认是16。名字太长会被截断，调试时可能认不出来。
  • 优先级范围：0 是最低优先级，configMAX_PRIORITIES - 1 是最高。别设成负数或超出范围，否则行为未定义。

核心要点：xTaskCreate 是从堆中动态分配TCB和栈空间的。如果系统内存紧张，可以考虑用静态创建 xTaskCreateStatic，但那是另一节课的内容了。

3.2 任务句柄：你的“遥控器”

任务句柄（TaskHandle_t）本质上是一个指向任务控制块（TCB）的指针。你可以把它理解为任务的“身份证”。

为什么要保存句柄？说白了，后续你要操作这个任务——比如删除它、挂起它、改变它的优先级——都得靠这个句柄。不保存？那你就没法精准控制这个任务了。

TaskHandle_t myTaskHandle = NULL;

void create_my_task(void)
{
    BaseType_t ret = xTaskCreate(
        my_task_function,
        "MyTask",
        128,        // 512字节栈
        NULL,       // 无参数传递
        1,          // 优先级1
        &myTaskHandle  // 保存句柄
    );
    
    if (ret != pdPASS) {
        // 创建失败，处理错误
        printf("Task creation failed!\n");
    }
}

我个人习惯在创建任务时，把句柄声明为全局变量或者静态局部变量。这样在任何地方都能通过句柄来操作这个任务。你想想看，如果某个任务需要被其他模块删除，没有句柄怎么行？

小技巧：在任务函数内部，可以通过 xTaskGetCurrentTaskHandle() 获取自己的句柄。这在任务需要自我删除时特别有用。

3.3 任务参数传递

任务参数 pvParameters 是一个 void * 指针，这意味着你可以传递任何类型的数据。但怎么传、传什么，这里头有讲究。

常见传递方式：

  1. 传递整数值：直接把整数强制转为 void *。注意，这只适合传递小整数（比如0-255），别传指针大小的值。
  2. 传递结构体指针：最常用的方式。把多个参数打包成一个结构体，传指针进去。
  3. 传递字符串：直接传 char *，但要注意字符串的生命周期——任务还没用完，字符串就被释放了，那就出大问题了。
// 定义参数结构体
typedef struct {
    uint8_t led_id;
    uint16_t blink_rate;
} led_param_t;

// 任务函数
void led_task(void *pvParameters)
{
    led_param_t *param = (led_param_t *)pvParameters;
    
    while (1) {
        toggle_led(param->led_id);
        vTaskDelay(pdMS_TO_TICKS(param->blink_rate));
    }
}

// 创建任务
void create_led_tasks(void)
{
    static led_param_t led1_param = {1, 500};  // 注意：必须保持有效
    static led_param_t led2_param = {2, 1000};
    
    xTaskCreate(led_task, "LED1", 128, &led1_param, 1, NULL);
    xTaskCreate(led_task, "LED2", 128, &led2_param, 1, NULL);
}

我曾经踩过的坑：把局部变量作为参数传递给任务。任务还没开始运行，局部变量就被销毁了，结果任务拿到的全是垃圾数据。记住：参数指向的内存必须在整个任务生命周期内有效！要么用静态变量，要么用堆分配。

3.4 vTaskDelete使用场景

vTaskDelete(TaskHandle_t xTaskToDelete) 用于删除一个任务。传入 NULL 表示删除自己。

删除任务后，FreeRTOS会回收TCB和栈空间（动态创建的情况下）。但要注意：

  • 被删除任务持有的互斥量、信号量等资源不会被自动释放。你得手动清理。
  • 删除任务后，其句柄变为无效。不要再使用它。

典型使用场景：

场景 说明
一次性初始化任务 系统启动时做一些初始化工作，完成后自我删除
动态任务管理 根据外部事件创建/删除任务，比如网络连接断开时删除网络处理任务
错误恢复 某个任务检测到严重错误，主动删除自己并通知管理任务 
// 一次性初始化任务
void init_task(void *pvParameters)
{
    // 初始化外设
    init_gpio();
    init_uart();
    init_sensor();
    
    // 创建其他任务
    xTaskCreate(main_task, "Main", 256, NULL, 2, NULL);
    
    // 自我删除
    vTaskDelete(NULL);
}

避坑指南：我曾经在一个项目中，用 vTaskDelete 删除了一个正在使用UART发送数据的任务。结果UART的DMA缓冲区还没传完，任务就被干掉了，导致系统死锁。所以删除任务前，一定要确保它已经释放了所有资源。

3.5 知识体系图

下面这张图帮你理清任务创建与删除的核心逻辑：

任务创建与删除核心流程 xTaskCreate() 参数检查：优先级、栈大小、函数指针 堆分配：TCB + 栈空间 初始化TCB、栈、任务控制块 加入就绪队列 → 任务开始运行 vTaskDelete() 从就绪队列移除 回收TCB和栈 注意：删除前需确保资源已释放

这张图展示了从调用 xTaskCreate 到任务开始运行，再到通过 vTaskDelete 删除任务的完整生命周期。每一步都有对应的检查和处理，缺一不可。

3.6 实战建议

最后，给你几个我在项目中总结的经验：

  • 栈大小估算：任务函数里调用的函数越多、局部变量越大，需要的栈就越大。我一般先给个保守值（比如256字），然后用 uxTaskGetStackHighWaterMark() 查看实际使用量，再调整。
  • 句柄管理：建议用一个结构体统一管理所有任务句柄，方便调试和统一操作。
  • 删除回调：FreeRTOS没有提供任务删除回调。如果你需要在任务删除时做清理，可以在任务函数退出前手动调用清理函数。

个人习惯：我通常在任务函数的最后加一个 vTaskDelete(NULL)，而不是让任务函数自然返回。这样代码意图更明确，也方便后续维护。

好了，任务创建与删除的核心内容就这些。记住：创建任务时多花点心思在参数传递和栈大小上，后面能省很多调试时间。

公众号:蓝海资料掘金营，微信deep3321

← 上一章 📖 返回目录 下一章 →