事件标志组

事件：事件是一种实现任务间通信的机制，主要用于实现多任务间的同步，但事件通信只能

是事件类型的通信，无数据传输。与信号量不同的是，它可以实现一对多，多对多的同步。

即一个任务可以等待多个事件的发生：可以是任意一个事件发生时唤醒任务进行事件处理；

也可以是几个事件都发生后才唤醒任务进行事件处理。同样，也可以是多个任务同步多个

事件。 （相当于裸机中的标志位，控制任务的执行）

事件标志组创建

 EventGroupHandle_t xEventGroupCreate( void );

参数：

无

返回：

如果创建了事件组， 则返回事件组的句柄。 如果没有足够的 FreeRTOS 堆可用于创建事件组， 则返回 NULL。

注意：对于返回任务句柄的函数，一定要接收返回值，不然后面使用函数会出现错误。

事件标志组指定标志位设置

 EventBits_t xEventGroupSetBits( EventGroupHandle_t xEventGroup,
                                 const EventBits_t uxBitsToSet );

参数：

xEventGroup	要设置位的事件组。 该 必须已通过 通过调用 xEventGroupCreate() 创建。
uxBitsToSet	指定要在事件组中设置的一个或多个位的按位值。 例如，将 uxBitsToSet 设置为 0x08，可仅设置位 3。 将 uxBitsToSet 设置 为 0x09，可设置位 3 和位 0。

返回：

调用 xEventGroupSetBits() 返回时事件组的值（即uxBitsToSet 的值）。

返回值可能会 清除 uxBitsToSet 参数指定的位（为0），有如下两个原因：

1. 如果设置某个位导致正在等待该位的任务 解除阻塞态， 则可能该位 已被自动清除（请参阅 xEventGroupWaitBits() 的 xClearBitOnExit 参数）。

2. 将执行任何处于阻塞态（或就绪态）且优先级 高于调用 xEventGroupSetBits() 的任务， 并可能在调用 xEventGroupSetBits() 返回之前 更改事件组值。

等待事件标志组：

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

参数：

xEventGroup	正在测试位的事件组。 此前 必须已通过 xEventGroupCreate() 创建好事件组。
uxBitsToWaitFor	指定事件组中要测试的一个或多个事件位 的按位值。 例如，要等待第 0 位和/或第 2 位， 请将 uxBitsToWaitFor 设置为 0x05。 要等待第 0 位和/或第 1 位和/或第 2 位， 请设置 uxBitsToWaitFor 为 0x07， 以此类推。 uxBitsToWaitFor 不得设置为 0。
xClearOnExit	如果 xClearOnExit 设置为 pdTRUE， 那么在作为 uxBitsToWaitFor 参数传递的值中设置的任何位 会在 xEventGroupWaitBits() 返回某个值之前在事件组中清除掉， 前提是 xEventGroupWaitBits() 因超时以外的原因而返回值 。 超时值由 xTicksToWait 参数设置。 如果 xClearOnExit 设置为 pdFALSE， 那么当调用 xEventGroupWaitBits() 返回时，事件组中设置的位不会改变 ， pdFLASh会导致事件标志组一直触发，任务一直执行，设置为pdTRUE。
xWaitForAllBits	xWaitForAllBits 用于创建逻辑与测试 （必须设置所有位）或逻辑或测试（必须设置一个 或多个位），如下所示： 如果 xWaitForAllBits 设置为 pdTRUE， 那么当在作为 uxBitsToWaitFor 参数传递的值中设置的所有位 均已在事件组中设置好，或指定的阻塞时间已过期，则 xEventGroupWaitBits() 会返回相应值。 如果 xWaitForAllBits 设置为 pdFALSE，那么当在作为 uxBitsToWaitFor 参数传递的值中设置的任何位已在事件组中设置好， 或指定的阻塞时间已过期，则 xEventGroupWaitBits() 会返回相应值。 pdFALS->逻辑或，其中一个比特位置1，任务就唤醒
xTicksToWait	等待 uxBitsToWaitFor 指定的一个/所有（取决于 xWaitForAllBits 的值）位完成设置的最大时间 （单位：tick）。

返回值：

返回事件中的哪些事件标志位被置位，返回值很可能并不是用户指定的事件位，需要 对返回值进行判断再处理。

中断事件标志位设置

 BaseType_t xEventGroupSetBitsFromISR(
                          EventGroupHandle_t xEventGroup,
                          const EventBits_t uxBitsToSet,
                          BaseType_t *pxHigherPriorityTaskWoken );

见xEventGroupSetBitsFromISR() - Set a bit (flag) or bits in an RTOS event group from an interrupt