从零实现FreeRTOS事件组:替代全局标志位同步多个任务的配置与踩坑记录

一、为什么全局标志位不够用

很多初学者用 volatile uint8_t g_flag 在中断和任务之间传信号,简单场景没问题,但多任务同步时问题暴露:

  • 竞态条件:多个任务同时读改写标志位,没有原子保护。
  • 忙等待:while(!g_flag); 白白占用CPU,低优先级任务饿死。
  • 逻辑耦合:一个标志位只能表达“有/无”,无法表达“A且B都完成”这类组合条件。
  • 清除时机混乱:谁负责清零?清早了丢事件,清晚了重复触发。

FreeRTOS 的事件组用“位图 + 阻塞等待”解决上述问题:每个 bit 是一个事件,任务可以等待“任意一个”或“全部”位置位,等待期间主动让出CPU。

二、事件组原理

事件组本质是一个 EventBits_t(通常32位)变量,配合等待列表实现:

  • 置位:xEventGroupSetBits() 把指定bit置1,并唤醒满足条件的等待任务。
  • 等待:xEventGroupWaitBits() 检查当前位图是否满足条件(xWaitForAllBits 决定“全满足”还是“任一满足”),不满足则把任务挂到等待列表并阻塞。
  • 清除:xClearOnExit = pdTRUE 时,任务被唤醒后自动清除它等待的bit,避免重复触发。

关键点:事件组是“广播”语义,一个bit置位可以同时唤醒多个等待任务;而二值信号量是“消耗”语义,只能给一个任务。

三、配置步骤(STM32CubeIDE + FreeRTOS)

  1. 在 .ioc 中启用 FreeRTOS,接口选 CMSIS_V1 或 CMSIS_V2 均可,本文用原生API。
  2. configUSE_EVENT_GROUPS 设为 1(CubeMX 默认已开)。
  3. 确认 configUSE_16_BIT_TICKS 为 0,这样事件组有24个可用bit(高8位被内核保留)。
  4. 在 main.c 中 #include "event_groups.h",创建事件组句柄。
#include "FreeRTOS.h"
#include "task.h"
#include "event_groups.h"

#define BIT_SENSOR_READY  (1 << 0)
#define BIT_NET_READY     (1 << 1)
#define BIT_ALL_READY     (BIT_SENSOR_READY | BIT_NET_READY)

static EventGroupHandle_t xEventGroup;

四、完整代码示例

场景:传感器任务和网络任务各自初始化完成后置位,主处理任务等待两者都就绪再开始工作。

static void vSensorTask(void *pvParameters)
{
    (void)pvParameters;
    for (;;) {
        /* 模拟传感器初始化 */
        vTaskDelay(pdMS_TO_TICKS(500));
        xEventGroupSetBits(xEventGroup, BIT_SENSOR_READY);
        vTaskDelay(pdMS_TO_TICKS(1000));
    }
}

static void vNetTask(void *pvParameters)
{
    (void)pvParameters;
    for (;;) {
        vTaskDelay(pdMS_TO_TICKS(800));
        xEventGroupSetBits(xEventGroup, BIT_NET_READY);
        vTaskDelay(pdMS_TO_TICKS(1000));
    }
}

static void vProcessTask(void *pvParameters)
{
    (void)pvParameters;
    EventBits_t uxBits;
    for (;;) {
        /* 等待两个bit都置位,唤醒后自动清除这两个bit */
        uxBits = xEventGroupWaitBits(
                    xEventGroup,
                    BIT_ALL_READY,
                    pdTRUE,      /* xClearOnExit:退出时清除 */
                    pdTRUE,      /* xWaitForAllBits:全部满足 */
                    portMAX_DELAY);

        if ((uxBits & BIT_ALL_READY) == BIT_ALL_READY) {
            /* 两个子系统都就绪,执行处理逻辑 */
            /* ... */
        }
    }
}

void app_main(void)
{
    xEventGroup = xEventGroupCreate();
    configASSERT(xEventGroup != NULL);

    xTaskCreate(vSensorTask,  "Sensor", 256, NULL, 2, NULL);
    xTaskCreate(vNetTask,     "Net",    256, NULL, 2, NULL);
    xTaskCreate(vProcessTask, "Proc",   256, NULL, 3, NULL);

    vTaskStartScheduler();
}

五、踩坑记录

  • 坑1:在中断里调用 xEventGroupSetBits。必须用 xEventGroupSetBitsFromISR(),且它通过定时器守护任务延迟发送,不是立即生效;返回值 pdFAIL 表示队列满,需要加大 configTIMER_QUEUE_LENGTH。
  • 坑2:忘记 xClearOnExit 导致重复触发。若置位方只置一次而等待方不清除,任务会立刻再次满足条件,形成忙循环。
  • 坑3:把事件组当信号量用。事件组不计数,连续两次置同一bit只算一次;需要计数请用计数信号量。
  • 坑4:等待多个bit时误判。xWaitForAllBits = pdFALSE 时任一bit满足即返回,务必用返回值做掩码判断,不能只看函数是否返回。
  • 坑5:优先级设置不当。置位任务优先级低于等待任务时,等待任务被唤醒后可能立即抢占,注意临界区长度。
  • 坑6:bit0~bit7 在部分配置下被内核占用。使用 configUSE_16_BIT_TICKS = 1 时只有8个bit可用,建议统一用 1 << n 宏并避开保留位。

六、小结

事件组用位图表达组合条件、用阻塞等待替代轮询,是替代全局标志位的标准做法。掌握“置位—等待—清除”三要素和ISR版本API,就能在STM32上写出清晰、无竞态的多任务同步代码。