【FreeRTOS】EventGroup事件标志组

事件标志组EventGroup

使用信号量来同步任务时只能与单个任务进行同步，而事件标志组可以在多个任务中进行同步，二者的区别从我的理解来说，就是信号量释放后只能读取一次，而事件标志组可以通过设置读取多次。

简介

• 事件位（事件标志位）：事件位用来表示某个事件是否发生。
• 事件组：一个事件组就是一组的事件位，通过位编号来区分事件。事件标志组的数据类型为EventGroupHandle_t，当configUSE_16_BIT_TICKS为1时事件标志组可以存储8个事件位，为0时可以存储24个事件位。

创建事件标志组

函数	描述
EventGroupHandle_t xEventGroupCreate（void）	动态创建事件标志组函数
EventGroupHandle_t xEventGroupCreate（StaticEventGroup_t * pxEventGroupBuffer）	静态创建事件标志组函数

设置事件位

函数	描述
EventBits_t xEventGroupClearBits（EventGroupHandle_t xEventGroup,const EventBits_t uxBitsToClear）	任务级设置事件位为0函数
BaseType_t xEventGroupClearBitsFromISR（EventGroupHandle_t xEventGroup,const EventBits_t uxBitsToClear）	中断级设置事件位为0函数
EventBits_t xEventGroupSetBits（EventGroupHandle_t xEventGroup,const EventBits_t uxBitsToSet）	任务级设置事件位为1函数
BaseType_t xEventGroupSetBitsFromISR（EventGroupHandle_t xEventGroup,const EventBits_t uxBitsToSet，BaseType_t *pxHigherPriorityTaskWoken）	中断级设置事件位为1函数

获取事件标志组

函数	描述
EventBits_t xEventGroupGetBits（EventGroupHandle_t xEventGroup）	任务级获取事件标志组函数
EventBits_t xEventGroupGetBitsFromISR（EventGroupHandle_t xEventGroup）	中断级获取事件标志组函数
EventBits_t xEventGroupWaitBits(…)	阻塞式等待指定事件位

EventBits_t xEventGroupWaitBits( EventGroupHandle_t xEventGroup,
                                 const EventBits_t uxBitsToWaitFor,
                                 const BaseType_t xClearOnExit,
                                 const BaseType_t xWaitForAllBits,
                                 const TickType_t xTicksToWait );

Parameter	Description
xEventGroup	事件标志组
uxBitsToWaitFor	指定等待的事件位，比如等待bit0和bit2，则参数为0x05
xClearOnExit	为pdTRUE则退出此函数会清除参数uxBitsToWaitFor指定的事件位，为pdFALSE则不会改变该事件位
xWaitForAllBits	为pdTRUE时则只有在参数uxBitsToWaitFor都为1或者阻塞时间到函数才会返回，为pdFALSE则uxBitsToWaitFor事件位中任何一位为1都返回
xTickToWait	阻塞时间，单位为节拍数

---