事件组 Event Group

关键概念

为什么需要事件组：信号量做不到的"组合等待"

设想一个联网任务：必须等到 WiFi 已连接 且 时间已同步 且 配置已加载 三件事全部就绪，才能开始上报。用三个信号量要写复杂的嵌套等待逻辑，用事件组一行 AND 等待即可：

AND 等待：全部条件就绪

#include "FreeRTOS.h"
#include "event_groups.h"

#define BIT_WIFI  (1UL << 0)
#define BIT_TIME  (1UL << 1)
#define BIT_CFG   (1UL << 2)
#define ALL_READY (BIT_WIFI | BIT_TIME | BIT_CFG)

EventGroupHandle_t g_sysEvents;

void ReportTask(void *arg) {
  for (;;) {
    /* 等三位全部置位(AND)，超时 5s；退出时清除这些位 */
    EventBits_t bits = xEventGroupWaitBits(
        g_sysEvents,
        ALL_READY,          /* 关心的位 */
        pdTRUE,             /* xClearOnExit：清除 */
        pdTRUE,             /* xWaitForAllBits：AND */
        pdMS_TO_TICKS(5000));

    if ((bits & ALL_READY) == ALL_READY) {
      start_reporting();   /* 三者齐备，开始上报 */
    } else {
      printf("not ready in 5s, got 0x%lx\r\n", bits);
    }
  }
}

/* 其他任务在各自完成时置位 */
void on_wifi_up(void) { xEventGroupSetBits(g_sysEvents, BIT_WIFI); }
void on_time_ok(void) { xEventGroupSetBits(g_sysEvents, BIT_TIME); }
void on_cfg_ok(void)  { xEventGroupSetBits(g_sysEvents, BIT_CFG);  }

OR 等待：任一事件都处理

#define EVT_BTN   (1UL << 0)
#define EVT_ALARM (1UL << 1)
#define EVT_TIMER (1UL << 2)
#define ANY_EVT   (EVT_BTN | EVT_ALARM | EVT_TIMER)

void UiTask(void *arg) {
  for (;;) {
    EventBits_t b = xEventGroupWaitBits(
        g_sysEvents, ANY_EVT,
        pdTRUE,      /* 清除 */
        pdFALSE,     /* OR：任一即可 */
        portMAX_DELAY);
    if (b & EVT_BTN)   on_button();
    if (b & EVT_ALARM) on_alarm();
    if (b & EVT_TIMER) on_timer();
  }
}

任务同步点：多任务集合屏障

#define SYNC_A (1UL << 0)
#define SYNC_B (1UL << 1)
#define SYNC_C (1UL << 2)
#define SYNC_ALL (SYNC_A | SYNC_B | SYNC_C)

/* 三个初始化任务，各自跑完在同步点集合，全到齐再放行 */
void InitTaskA(void *arg) {
  init_hardware();
  /* 置自己的位 SYNC_A，等待所有位到齐 */
  xEventGroupSync(g_sysEvents, SYNC_A, SYNC_ALL, portMAX_DELAY);
  run_phase2();   /* 三任务同时抵达此处 */
  vTaskDelete(NULL);
}
/* InitTaskB 用 SYNC_B，InitTaskC 用 SYNC_C，逻辑相同 */

事件组 vs 队列 vs 信号量：如何选