事件组

原文链接

事件组是一个整数，其中的高8位留给内核，只能用其他位来表示时间
每一位代表一个事件，且每个时间的含义由程序员决定
1为发生，0为未发生
一个/多个任务或ISR都能读写这些位
可以等待某一位，也可以等待多个位

事件组有广播作用，会唤醒所有复合条件的任务；而队列和信号量只会唤醒一个任务。
事件组唤醒任务后，可以让事件不动，也可以清除事件。

事件组函数

创建

成功返回句柄，失败返回NULL

EventGroupHandle_t xEventGroupCreate( void );// 动态创建
EventGroupHandle_t xEventGroupCreateStatic( StaticEventGroup_t * pxEventGroupBuffer );
//静态创建

示例：

g_xEventCar = xEventGroupCreate();

删除

void vEventGroupDelete( EventGroupHandle_t xEventGroup )

设置事件

xEventGroup: 哪个事件组
uxBitsToSet: 设置哪些位?

• 如果uxBitsToSet的bitX, bitY为1, 那么事件组中的bitX, bitY被设置为1
• 可以用来设置多个位，比如 0x15 就表示设置bit4, bit2, bit0

返回值EventBits_t: 返回原来的事件值(没什么意义, 因为很可能已经被其他任务修改了)
pxHigherPriorityTaskWoken: 有没有导致更高优先级的任务进入就绪态? pdTRUE-有, pdFALSE-没有
返回值BaseType_t: pdPASS-成功, pdFALSE-失败

/*在任务中使用*/
EventBits_t xEventGroupSetBits( EventGroupHandle_t xEventGroup,const EventBits_t uxBitsToSet );
/*在ISR中使用*/
BaseType_t xEventGroupSetBitsFromISR( EventGroupHandle_t xEventGroup,const EventBits_t uxBitsToSet,BaseType_t * pxHigherPriorityTaskWoken );

示例：

xEventGroupSetBits(g_xEventCar, (1<<0));

(1<<0)是二进制掩码，表示将1左移0位（00000001），指等待第0位

等待事件

xEventGroup	等待哪个事件组？
uxBitsToWaitFor	等待哪些位？哪些位要被测试？
xClearOnExit	函数提出前是否要清除事件？ pdTRUE: 清除uxBitsToWaitFor指定的位 pdFALSE: 不清除
xWaitForAllBits	怎么测试？是"AND"还是"OR"？ pdTRUE: 等待的位，全部为1; pdFALSE: 等待的位，某一个为1即可
xTicksToWait	如果期待的事件未发生，阻塞多久。 可以设置为0：判断后即刻返回； 可设置为portMAX_DELAY：一定等到成功才返回； 可以设置为期望的Tick Count，一般用*pdMS_TO_TICKS()*把ms转换为Tick Count
返回值	返回的是事件值， 如果期待的事件发生了，返回的是"非阻塞条件成立"时的事件值； 如果是超时退出，返回的是超时时刻的事件值。

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

示例：

xEventGroupWaitBits(g_xEventCar, (1<<0)|(1<<1), pdTRUE, pdFALSE, portMAX_DELAY);

(1<<0)|(1<<1)表示关心第0和第1位，且他们有一个为1时触发。

同步点

如果有ABC多个任务需要全部做完才能进行下一步，可以使用xEventGroupSync()

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

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

示例：

xEventGroupSync(g_xEventCar, (1<<0),(1<<1)|(1<<2), portMAX_DELAY); 

会设置第0位，等待第1，2位