二十、事件组

1、基本概念

事件组存储在一个EventBits_t 类 型的变量中 ， 该 变量在事件组结构体中定义 。
事件组可以简单地认为就是一个整数。
那么这个整数是几位的呢？

其的二进制每一位表示一个事件，值为 1 表示事件发生了，值为 0 表示事件没发生。
一个或多个任务、ISR 都可以去写这些位；一个或多个任务、ISR 都可以去读这些位。
可以等待某一位、某些位中的任意一个，也可以等待多位。

2、使用场景：用于任务间、任务和中断间的同步（非数据传输）

事件组的核心是关调度器，且事件组不像前面的信号量和互斥量一样去复用队列的那套API。

即可以代替裸机开发中的标志位。
多次向任务设置同一事件(如果任务还未来得及读走)，等效于只设置一次。允许多个任务对同一事件进行读写操作。

事件发生时，会唤醒所有符合条件的任务，简单地说它有"广播"的作用。

3、事件组结构体（事件控制块）内容解析

等待事件的任务，所有在等待此事件的任务均会被挂载在等待事件列表 xTasksWaitingForBits这个链表里面。

4、为什么采用的是关闭调度器而不是关闭中断？

因为队列可以在中断中使用（即可以在中断中读写队列），关闭中断是为了防止其他任务和中断打断队列的读写。
而事件组不会在中断中使用，所以仅仅关闭调度器就可以防止其他任务来打扰事件组的设置等。

5、创建事件——xEventGroupCreate

xEventGroupCreate()用于创建一个事件组，并返回对应的句柄。

/* 创建一个事件组，返回它的句柄。
* 此函数内部会分配事件组结构体
* 返回值: 返回句柄，非 NULL 表示成功
*/
EventGroupHandle_t xEventGroupCreate( void );
/* 创建一个事件组，返回它的句柄。
* 此函数无需动态分配内存，所以需要先有一个 StaticEventGroup_t 结构体，并传入它的指
针
* 返回值: 返回句柄，非 NULL 表示成功
*/
EventGroupHandle_t xEventGroupCreateStatic( StaticEventGroup_t * pxEventGroupBuffer );

6、删除事件——vEventGroupDelete

/*
* xEventGroup: 事件组句柄，你要删除哪个事件组
*/
void vEventGroupDelete( EventGroupHandle_t xEventGroup )

7、设置事件

（1）原理解析

即在设置事件之后会自动唤醒符合条件的所有任务。

（2）xEventGroupSetBits()

调用这个函数的时候，第二个参数二进制表示中1对应的位会被置1。

/* 设置事件组中的位
* xEventGroup: 哪个事件组
* uxBitsToSet: 设置哪些位? 
* 如果 uxBitsToSet 的 bitX, bitY 为 1, 那么事件组中的 bitX, bitY 被设置为 1
* 可以用来设置多个位，比如 0x15 就表示设置 bit4, bit2, bit0
* 返回值: 返回原来的事件值(没什么意义, 因为很可能已经被其他任务修改了)
*/
EventBits_t xEventGroupSetBits( EventGroupHandle_t xEventGroup,const EventBits_t uxBitsToSet );

（3）xEventGroupSetBitsFromISR

/* 设置事件组中的位
* xEventGroup: 哪个事件组
* uxBitsToSet: 设置哪些位? 
* 如果 uxBitsToSet 的 bitX, bitY 为 1, 那么事件组中的 bitX, bitY 被设置为 1
* 可以用来设置多个位，比如 0x15 就表示设置 bit4, bit2, bit0
* pxHigherPriorityTaskWoken: 有没有导致更高优先级的任务进入就绪态? pdTRUE-有, pdFA
LSE-没有
* 返回值: pdPASS-成功, pdFALSE-失败
*/
BaseType_t xEventGroupSetBitsFromISR( EventGroupHandle_t xEventGroup,
										const EventBits_t uxBitsToSet,
										 BaseType_t * pxHigherPriorityTaskWoken );

xEventGroupSetBitsFromISR函数不是直接去设置事件组的，而是给一个FreeRTOS后台任务（daemon task）发送队列数，由这个任务来设置事件组。如下图

8、等待事件

（1）原理解析

关键还是链表，要是阻塞时选择了等待，则会进入休眠状态。

（2）xEventGroupWaitBits

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

9、任务同步—— xEventGroupSync

EventBits_t xEventGroupSync( EventGroupHandle_t xEventGroup,
 							 const EventBits_t uxBitsToSet,
							 const EventBits_t uxBitsToWaitFor,
 							 TickType_t xTicksToWait );

例如：我已经做好某件事了，但我还需要等待其他事件做好，这时候会进入阻塞状态（阻塞时间可以自己设置）

/* 表示我做好了, 还要等别人都做好 */
xEventGroupSync(xEventGroup, COOKING, ALL, portMAX_DELAY);