事件标志组

什么是事件标志组？

事件标志位：表明某个事件是否发生，联想：全局变量 flag。通常按位表示，每一个位表示一个事件（高8位不算）事件标志组是一组事件标志位的集合， 可以简单的理解事件标志组，就是一个整数。事件标志组本质是一个 16 位或 32 位无符号的数据类型 EventBits_t ，由 configUSE_16_BIT_TICKS决定。
虽然使用了 32 位无符号的数据类型变量来存储事件标志， 但其中的高8位用作存储事件标志组的控制信息，低 24 位用作存储事件标志 ，所以说一个事件组最多可以存储 24 个事件标志！

事件标志组相关 API 函数

创建事件标志组

参数：
无
返回值：
成功，返回对应事件标志组的句柄；
失败，返回 NULL 。

创建示例

设置事件标志位

参数：
xEventGroup：对应事件组句柄。 uxBitsToSet：指定要在事件组中设置的一个或多个位的按位值。
一次性对多个位进行Set，可以用 | 运算进行，则可以免去多次使用此函数！
返回值：
设置之后事件组中的事件标志位值。

使用示例

清除事件标志位

参数：
xEventGroup：对应事件组句柄。 uxBitsToClear：指定要在事件组中清除的一个或多个位的按位值。
返回值：
清零之前事件组中事件标志位的值。

等待事件标志位

参数：
xEventGroup：对应的事件标志组句柄
uxBitsToWaitFor：指定事件组中要等待的一个或多个事件位的按位值 xClearOnExit：pdTRUE——清除对应事件位，pdFALSE——不清除 xWaitForAllBits：pdTRUE——所有等待事件位全为1（逻辑与），pdFALSE——等待的事件位有一个为1（逻辑或）
xTicksToWait：超时

返回值：
等待的事件标志位值：等待事件标志位成功，返回等待到的事件标志位
其他值：等待事件标志位失败，返回事件组中的事件标志位

使用示例