4、任务创建与删除：任务函数原型、xTaskCreate与xTaskCreateStatic、任务参数传递、任务删除与自删除、任务句柄与任务状态

FreeRTOS 的核心调度单位是任务（Task），而任务的生命周期管理——创建、运行、删除——是开发者接触 RTOS 后首先要掌握的基础能力。与裸机编程中“函数被调用后返回”不同，RTOS 任务一旦创建，便拥有了独立的栈空间、优先级和任务控制块（TCB），并由调度器决定何时运行。本章将围绕任务创建与删除的完整链路展开，深入剖析动态创建与静态创建的差异、任务参数的传递机制、任务删除的边界条件，以及任务句柄与任务状态之间的映射关系。理解这些内容，是后续学习队列、信号量、互斥量等 IPC 机制的前提。

上图展示了任务从创建到删除的完整生命周期。左侧是两种创建方式，中间是任务控制块（TCB）与句柄的关系，右侧是任务状态与删除操作。可以看到，任务句柄是连接外部代码与内核对象的桥梁，而任务状态则决定了调度器如何对待该任务。下面我们将逐一展开每个环节的细节。

4.1 任务函数原型与任务控制块

在 FreeRTOS 中，任务本质上是一个永不返回的 C 函数。其原型必须符合以下签名：

void vTaskFunction(void *pvParameters);

任务函数通常包含一个无限循环，因为任务一旦返回，就相当于隐式调用了 vTaskDelete(NULL) 进行自删除。但更规范的做法是显式地让任务在循环中等待事件或延时，而不是直接返回。任务函数内部可以使用局部变量，这些变量存储在任务自己的栈空间中，因此每个任务都有独立的栈，互不干扰。

任务控制块（TCB）是内核维护任务元数据的核心结构体，它包含了任务栈指针、优先级、任务状态、事件列表项等字段。TCB 在任务创建时被初始化，并在任务删除时被释放（动态创建）或标记为未使用（静态创建）。开发者通常不需要直接操作 TCB 的字段，而是通过任务句柄（TaskHandle_t）来间接访问。

4.2 xTaskCreate 与 xTaskCreateStatic：动态与静态创建

FreeRTOS 提供两种创建任务的方式，它们的核心区别在于内存来源。动态创建使用内核堆（heap），静态创建使用开发者提供的静态缓冲区。

动态创建的函数原型如下：

BaseType_t xTaskCreate(
    TaskFunction_t pxTaskCode,      // 任务函数指针
    const char *pcName,             // 任务名称（仅用于调试）
    configSTACK_DEPTH_TYPE usStackDepth, // 栈深度，单位是字（4字节）
    void *pvParameters,             // 任务参数
    UBaseType_t uxPriority,         // 任务优先级（0~configMAX_PRIORITIES-1）
    TaskHandle_t *pxCreatedTask     // 返回的任务句柄（可为NULL）
);

静态创建的原型与之类似，但多了两个参数：pxTaskBuffer（指向 StaticTask_t 结构体）和 puxStackBuffer（指向 StackType_t 数组）。使用静态创建时，开发者必须保证这些缓冲区在任务生命周期内始终有效，通常定义为全局变量或静态变量。

4.3 任务参数传递：灵活的数据入口

任务参数 pvParameters 是一个 void* 指针，这意味着它可以传递任何类型的数据。常见用法有三种：

• 传递整数值：直接将整数强制转换为 void*，例如 (void*)1。这种方式简单高效，但要注意整数宽度必须能容纳在指针中（32 位 MCU 上没问题）。
• 传递结构体指针：将结构体地址作为参数传入，任务内部通过类型转换访问结构体字段。这种方式适合传递多个参数。
• 传递字符串指针：用于传递常量字符串或共享缓冲区。

一个典型的多任务参数传递示例如下：

typedef struct {
    uint8_t led_id;
    uint16_t blink_rate_ms;
} led_config_t;

static void vLEDTask(void *pvParameters) {
    led_config_t *config = (led_config_t *)pvParameters;
    while (1) {
        // 根据 config->led_id 和 config->blink_rate_ms 控制 LED
        vTaskDelay(pdMS_TO_TICKS(config->blink_rate_ms));
    }
}

void app_main(void) {
    static led_config_t led1_cfg = {1, 500};
    static led_config_t led2_cfg = {2, 250};
    xTaskCreate(vLEDTask, "LED1", 128, &led1_cfg, 2, NULL);
    xTaskCreate(vLEDTask, "LED2", 128, &led2_cfg, 2, NULL);
}

4.4 任务删除与自删除：释放资源的正确姿势

任务删除使用 vTaskDelete(TaskHandle_t pxTask) 函数。当参数为 NULL 时，表示删除当前正在运行的任务（即自删除）。删除操作本身并不立即释放内存，而是将任务从就绪/阻塞/挂起列表中移除，并标记为待删除。实际的内存回收由空闲任务（Idle Task）在下一个调度周期完成。

自删除是嵌入式开发中常见的需求，例如一个临时任务完成初始化后自我销毁。自删除的代码模式如下：

void vTempTask(void *pvParameters) {
    // 执行一次性初始化工作
    // ...
    // 自删除
    vTaskDelete(NULL);
}

需要注意的是，自删除后，任务函数中 vTaskDelete(NULL) 之后的代码不会被执行。如果任务持有互斥量或信号量，必须在删除前手动释放，否则会造成资源泄漏。

4.5 任务句柄与任务状态：从创建到删除的完整映射

任务句柄（TaskHandle_t）本质上是 TCB 的指针。通过句柄，我们可以查询任务状态、修改优先级、挂起/恢复任务等。任务状态包括：

• 运行态（Running）：当前正在使用 CPU 的任务。
• 就绪态（Ready）：具备运行条件，等待调度器分配 CPU。
• 阻塞态（Blocked）：等待某个事件或延时，不占用 CPU。
• 挂起态（Suspended）：通过 vTaskSuspend() 显式挂起，只能通过 vTaskResume() 恢复。

一个任务从创建到删除的典型状态迁移路径如下：

1. 创建：调用 xTaskCreate() 后，任务进入就绪态。
2. 调度：如果任务优先级最高，则进入运行态。
3. 阻塞：调用 vTaskDelay() 或等待队列/信号量时，进入阻塞态。
4. 就绪：延时结束或事件到达，回到就绪态。
5. 挂起：调用 vTaskSuspend()，进入挂起态。
6. 恢复：调用 vTaskResume()，回到就绪态。
7. 删除：调用 vTaskDelete()，任务从内核列表中移除，内存由空闲任务回收。

下表总结了句柄操作与状态查询的常用 API：

4.6 实战案例：多任务创建与自删除的完整闭环

下面通过一个实际案例来串联本章所有知识点。假设我们正在开发一个智能传感器节点，需要完成以下功能：

• 启动时创建一个“初始化任务”，负责读取传感器校准参数并配置外设。
• 初始化完成后，该任务自删除，并创建两个工作任务：数据采集任务和通信任务。
• 数据采集任务每 100ms 读取一次传感器数据，并通过队列发送给通信任务。
• 通信任务将数据打包后通过 UART 发送。

初始现象与目标：系统上电后，初始化任务运行一次，然后让出 CPU 给工作任务。目标是验证任务创建、参数传递、自删除和句柄管理的正确性。

关键代码实现：

// 任务句柄
static TaskHandle_t xSensorTaskHandle = NULL;
static TaskHandle_t xCommTaskHandle = NULL;

// 初始化任务
static void vInitTask(void *pvParameters) {
    // 读取校准参数（模拟）
    uint32_t calib_value = 0x12345678;
    // 创建数据采集任务，传递校准值
    xTaskCreate(vSensorTask, "Sensor", 256, (void *)calib_value, 3, &xSensorTaskHandle);
    // 创建通信任务
    xTaskCreate(vCommTask, "Comm", 256, NULL, 2, &xCommTaskHandle);
    // 自删除
    vTaskDelete(NULL);
}

// 数据采集任务
static void vSensorTask(void *pvParameters) {
    uint32_t calib = (uint32_t)pvParameters;
    while (1) {
        // 读取传感器并发送到队列
        vTaskDelay(pdMS_TO_TICKS(100));
    }
}

// 通信任务
static void vCommTask(void *pvParameters) {
    while (1) {
        // 从队列接收数据并发送
        vTaskDelay(pdMS_TO_TICKS(10));
    }
}

分析判断过程：初始化任务中，calib_value 是局部变量，但它的值被直接转换为 void* 传递，而不是传递地址，因此不存在生命周期问题。两个工作任务的句柄被保存为全局变量，便于后续调试或删除。初始化任务在创建完工作任务后立即自删除，释放了栈空间。

结果与复盘：系统运行后，通过调试器观察任务列表，可以看到初始化任务已消失，数据采集任务和通信任务正常运行。如果初始化任务不调用 vTaskDelete(NULL)，它会继续占用栈空间并参与调度，造成资源浪费。此外，如果创建任务失败（返回 errCOULD_NOT_ALLOCATE_REQUIRED_MEMORY），需要检查堆大小配置（configTOTAL_HEAP_SIZE）。

4.7 常见误区与总结复盘

在任务创建与删除的学习中，开发者常犯以下错误：

• 误区一：在任务函数中直接 return，而不是调用 vTaskDelete(NULL)。虽然效果相同，但显式调用更清晰，且便于代码审查。
• 误区二：传递局部变量地址作为任务参数。例如在 for 循环中创建多个任务时，传递 &i，导致所有任务读到相同的 i 值。
• 误区三：删除任务后仍使用其句柄。这会导致未定义行为，甚至系统崩溃。
• 误区四：静态创建时，将栈数组定义为局部变量。栈数组必须在任务生命周期内有效，局部变量在函数返回后失效。
• 误区五：忽略 xTaskCreate 的返回值。在内存紧张的系统上，创建失败是常见问题，必须检查返回值。

总结本章核心要点：任务创建是 RTOS 应用的起点，动态创建灵活但依赖堆，静态创建确定性强但需要手动管理内存；任务参数通过 void* 传递，注意生命周期；任务删除分为外部删除和自删除，自删除后代码不再执行；任务句柄是操作任务的钥匙，任务状态反映了调度器的决策依据。掌握这些基础，才能在设计多任务系统时游刃有余。