FreeRTOS_事件组_学习笔记
事件组
原文链接
事件组是一个整数，其中的高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位