4. FreeRTOS 任务管理：任务通知、任务挂起与恢复、任务删除与栈溢出检测

任务管理是 RTOS 的核心。说白了，你写的每个功能模块，最终都要拆成一个或多个任务。任务怎么互相打招呼？怎么暂停再继续？怎么安全退出？栈溢出了怎么办？这些坑我早年都踩过，今天一次性讲清楚。

4.1 任务通知：轻量级的“敲门砖”

任务通知是 FreeRTOS 里一个很巧妙的设计。它比队列轻，比信号量快。我刚开始用的时候，总觉得它不够正式，后来才发现——很多场景下，它就是最优解。

任务通知的本质：每个任务内部都有一个 32 位的通知值和一个状态标志。别的任务可以直接往这个“信箱”里塞数据或发信号，不需要经过队列或信号量这种中间件。

常用 API 一览：

看个实际例子。假设你有一个按键任务，按下时通知 LED 任务切换状态：

// 按键中断服务函数
void HAL_GPIO_EXTI_Callback(uint16_t GPIO_Pin) {
    BaseType_t xHigherPriorityTaskWoken = pdFALSE;
    // 发送通知给 LED 任务
    vTaskNotifyGiveFromISR(ledTaskHandle, &xHigherPriorityTaskWoken);
    portYIELD_FROM_ISR(xHigherPriorityTaskWoken);
}

// LED 任务
void vLEDTask(void *pvParameters) {
    for (;;) {
        // 等待通知，超时设为 portMAX_DELAY
        ulTaskNotifyTake(pdTRUE, portMAX_DELAY);
        // 收到通知，翻转 LED
        HAL_GPIO_TogglePin(LED_GPIO_Port, LED_Pin);
    }
}

4.2 任务挂起与恢复：让任务“睡个午觉”

挂起和恢复，说白了就是让任务暂时“冻结”，不参与调度。跟阻塞不一样，挂起的任务不会被任何事件唤醒，只能由其他任务主动恢复它。

什么时候用挂起？我个人的习惯是：

• 系统进入低功耗模式前，挂起所有非必要任务
• 调试时，暂时冻结某个任务以观察系统行为
• OTA 升级过程中，挂起业务任务，只保留升级任务

核心 API：

// 挂起指定任务
vTaskSuspend(TaskHandle_t xTaskToSuspend);

// 恢复指定任务
vTaskResume(TaskHandle_t xTaskToResume);

// 从中断中恢复任务
xTaskResumeFromISR(TaskHandle_t xTaskToResume);

这里有个容易忽略的点：vTaskSuspend(NULL) 可以挂起当前任务。我早期做项目时，想暂停当前任务，却传了一个无效句柄进去，结果系统直接卡死。嗯，这个坑我替你们踩过了。

4.3 任务删除：优雅地“退场”

任务不是只能创建，也得能删除。但删除不是简单地把任务结构体从链表里摘掉——你得确保它占用的资源被正确释放。

删除任务的正确姿势：

void vSomeTask(void *pvParameters) {
    // 分配动态内存
    uint8_t *pBuffer = pvPortMalloc(256);
    if (pBuffer == NULL) {
        vTaskDelete(NULL);  // 内存分配失败，直接删除自己
    }

    for (;;) {
        // 任务主循环
        // ...
        if (/* 退出条件 */) {
            vPortFree(pBuffer);  // 先释放自己分配的资源
            vTaskDelete(NULL);   // 再删除任务自己
        }
    }
}

删除后的清理工作清单：

1. 释放任务内部动态申请的内存（pvPortFree）
2. 关闭任务占用的外设（如定时器、DMA）
3. 关闭任务打开的文件或网络连接
4. 最后调用 vTaskDelete(NULL) 删除自身

4.4 栈溢出检测：给任务装个“水位报警器”

栈溢出是嵌入式开发中最隐蔽的杀手。它不会立刻报错，而是悄悄覆盖相邻内存，导致系统随机崩溃。你想想看，一个任务栈只有几百字节，递归调用深一点，或者局部变量大一点，栈就爆了。

FreeRTOS 提供了两种检测方法：

我个人强烈建议用方法2。方法1只能检测到栈指针跑飞的情况，而方法2能检测到栈内数据被静默覆盖——这才是最常见的溢出方式。

实现一个栈溢出钩子函数：

void vApplicationStackOverflowHook(TaskHandle_t xTask, char *pcTaskName) {
    // 任务栈溢出！立即处理
    // 可以记录错误日志、保存现场、重启系统
    Serial.printf("栈溢出！任务: %s\n", pcTaskName);

    // 我习惯的做法：点亮错误 LED，然后软复位
    HAL_GPIO_WritePin(ERROR_LED_Port, ERROR_LED_Pin, GPIO_PIN_SET);
    NVIC_SystemReset();
}

如何估算任务栈大小？我分享一个土办法：

• 先给一个保守值（比如 256 字节）
• 运行所有功能路径，调用 uxTaskGetStackHighWaterMark() 查看剩余栈空间
• 根据剩余空间调整：保留 20% 余量，其余砍掉

举个例子，你测出来高水位标记是 80 字节，说明任务最多用了 176 字节（256-80）。那你可以把栈设为 220 字节，既安全又不浪费。