FreeRTOS：事件标志组
目录
一、简介
二、 事件控制块
三、相关API
四、 应用场景
一、简介
在FreeRTOS中，使用信号量可以实现同步，但是使用信号量来同步的话任务只能与单个的任务进行同步。有时候某个任务可能会需要与多个任务进行同步，此时信号量就无能为力。FreeRTOS为此提供了一个可选的解决方法，那就是事件标志组。
FreeRTOS中的事件标志组（Event Groups） 是一种任务间同步机制，允许多个任务通过设置或等待标志位来同步彼此的行为。每个事件标志组由一组32 位的二进制标志组成，其中每一位标志位可以表示某个事件的状态（0 或 1），任务可以对这些标志进行设置、清除、等待，进而实现更灵活的任务间通信和同步。
二、 事件控制块
在 FreeRTOS 中，事件标志组（Event Group） 的控制块是对事件标志组进行管理和操作的核心数据结构。它存储了事件标志组的状态以及操作这些标志位所需的所有信息。每当创建事件标志组时，FreeRTOS 会为其分配一个控制块（即事件组的句柄），该控制块负责管理事件标志组的标志位及其相关的任务同步信息。
三、相关API
事件标志组的使用一般包含创建事件、置位事件标志、等待事件标志、清除事件标志和删除事件。
1.创建事件
- xEventGroupCreate()
- 无参数，创建成功返回事件句柄；创建失败返回 NULL。
2.置位事件（置1）
- xEventGroupSetBits(xEventGroup, uxBitsToSet)
- 参数为事件句柄xEventGroup和需要置位的位，0x08置位位3（00001000），0x09置位位8和位0（00001001）。
- 当位被置位之后，阻塞在该位上的任务将会被解锁。
3.中断服务例程（ISR）中的置位事件
4.等待事件
- 等待时间xTicksToWait取0~portMAT_DELAY（0表示不等待， portMAT_DELAY表示一直等待）。
5.清除事件 （置0）
- 若在上述等待事件并获取事件标志位时没有选择清除相应的位（复位，置0），则要使用这里的清除事件的函数来清除要清除的位。
6.删除事件
- vEventGroupDelete(xEventGroup)
- 参数为事件句柄。
- 该函数不允许在中断里面使用。
- 当事件组被删除之后，阻塞在该事件组上的任务都会被解锁，并向等待事件的任务返回为0的事件组的值。
四、应用场景
同步多个任务
在这个场景中，任务 A 必须等待任务 B 和任务 C 完成各自的操作，然后再继续执行。如下：
EventGroupHandle_t xEventGroup; //定义一个事件句柄
xEventGroup = xEventGroupCreate(); //创建事件标志组
if (xEventGroup == NULL) //判断是否创建成功
{
//处理创建失败的情况
}
void vTaskA(void *pvParameters) //任务A
{
EventBits_t uxBits; //定义EventBits_t类型的变量
uxBits = xEventGroupWaitBits(xEventGroup,
(1 << 0) | (1 << 1), //等待任务B、C完成（位0、位1被置位）
pdTRUE, //清除标志位
pdTRUE, //等待所有位
portMAX_DELAY); //无限期等待
//任务B和C完成后继续执行接下来的操作
}
void vTaskB(void *pvParameters) //任务B
{
//执行某些操作
xEventGroupSetBits(xEventGroup, (1 << 0)); //操作完成，置位事件组的位0
}
void vTaskC(void *pvParameters) //任务C
{
//执行某些操作
xEventGroupSetBits(xEventGroup, (1 << 1)); //操作完成，置位事件组的位1
}
2.等待任意一个事件发生
在这个场景中，只需通过设置 xWaitForAllBits 参数为 pdFALSE 即可实现。