事件组介绍
一个事件组就是一组的事件位,事件组中的事件位通过位编号来访问。事件位用来表明某个事件是否发生,事件位通常用作事件标志。
事件组用一个整数来表示,其中的高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
);
参数说明:
- 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 - 返回值 :返回的是事件值,如果期待的事件发生了,返回的是"非阻塞条件成立"时的事件值;如果是超时退出,返回的是超时时刻的事件值。