FreeRTOS操作系统学习——事件组

事件组介绍

一个事件组就是一组的事件位，事件组中的事件位通过位编号来访问。事件位用来表明某个事件是否发生，事件位通常用作事件标志。

事件组用一个整数来表示，其中的高8位留给内核使用，只能用其他的位来表示事件。那么这个整数是多少位的？

事件组使用

创建

使用事件组之前，要先创建，得到一个句柄；使用事件组时，要使用句柄来表明使用哪个事件组。
有两种创建方法：动态分配内存、静态分配内存。

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

删除

对于动态创建的事件组，不再需要它们时，可以删除它们以回收内存。

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

设置事件

可以设置事件组的某个位、某些位，使用的函数有2个。有一个或多个任务在等待事件，如果这些事件符合这些任务的期望，那么任务还会被唤醒。

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

等待事件

使用 xEventGroupWaitBits 来等待事件，可以等待某一位、某些位中的任意一个，也可以等待多位；等到期望的事件后，还可以清除某些位。

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

多任务同步

有一个事情需要多个任务协同，比如：任务A炒菜，任务B买酒，任务C：摆台。A、 B、C做好自己的事后，还要等别人做完；大家一起做完，才可开饭。
使用 xEventGroupSync()函数可以同步多个任务：

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

参数说明：

1. xEventGroup：哪个事件组？
2. uxBitsToSet：要设置哪些事件？我完成了哪些事件？
   比如 0x05(二进制为 0101)会导致事件组的 bit0,bit2 被设置为 1
3. uxBitsToWaitFor：等待那个位、哪些位？
   比如 0x15(二级制 10101)，表示要等待 bit0,bit2,bit4 都为 1
4. xTicksToWait：如果期待的事件未发生，阻塞多久。
   可以设置为 0：判断后即刻返回；
   可设置为 portMAX_DELAY：一定等到成功才返回；
   可以设置为期望的 Tick Count，一般用 pdMS_TO_TICKS()把ms 转换为 Tick Count
5. 返回值 ：返回的是事件值，如果期待的事件发生了，返回的是"非阻塞条件成立"时的事件值；如果是超时退出，返回的是超时时刻的事件值。