从零实现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)
- 在
.ioc中启用 FreeRTOS,接口选 CMSIS_V1 或 CMSIS_V2 均可,本文用原生API。 -
configUSE_EVENT_GROUPS设为 1(CubeMX 默认已开)。 - 确认
configUSE_16_BIT_TICKS为 0,这样事件组有24个可用bit(高8位被内核保留)。 - 在
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上写出清晰、无竞态的多任务同步代码。
暂无评论,来抢沙发~