通常用的事件标志组是一个32位的变量uxEventBits,可设置的位有24位,一共就是24 种事件。
事件组的结构体类型:
6.1创建事件组xEventGroupCreate()
6.1.1函数原型
- 返回值:事件组句柄,指向事件组。
6.1.2函数框架
- ①为事件组结构体分配空间
- ②初始化事件组结构体的成员变量,包括等待事件列表的初始化。
6.2删除事件组vEventGroupDelete()
6.2.1函数原型
- xEventGroup:事件组的句柄。
6.2.2函数框架
6.3置位事件组xEventGroupSetBits()
6.3.1函数原型
- xEventGroup:事件组句柄;
- uxBitsToSet:指定事件中的事件标志位,32位的数据。如设置为0x07,表示事件组中的位0、位1和位2都设置为1。
- 返回值:调用 xEventGroupSetBits() 时事件组中的值。
6.3.2函数框架
6.4置位事件组xEventGroupSetBitsFromISR()
6.4.1函数原型
- xEventGroup:事件组句柄;
- uxBitsToSet:指定事件中要设置的事件标志位;
- pxHigherPriorityTaskWoken:可根据*pxHigherPriorityTaskWoken判断退出中断后,是否要进行任务切换。
- 返回值:消息成功发送给守护任务之后则返回 pdTRUE,否则返回 pdFAIL。如果定时器服务队列满了将返回 pdFAIL。
6.4.2函数框架
从xEventGroupSetBits源码中可以看出,while循环中等待事件的任务数量是不确定的,FreeRTOS中不能在中断中执行不确定的操作。所以xEventGroupSetBitsFromISR其实是在守护任务(软件定时器服务任务,优先级比自定义的任务优先级大)通过回调函数的方式,调用xEventGroupSetBits函数来实现的,本质上xEventGroupSetBitsFromISR执行的上下文环境是任务。
6.5等待事件组xEventGroupWaitBits()
6.5.1函数原型
- xEventGroup:事件组句柄;
- uxBitsToWaitFor:等待事件组的哪些位;
- xClearOnExit:函数退出时是否清除由形参 uxBitsToWaitFor 指定的事件标志位;
- xWaitForAllBits:pdTRUE“逻辑与”,pdFALSE“逻辑或”;
- xTicksToWait:超时时间。
- 返回值:事件组的值。
6.5.2函数框架
6.6清除事件组标志位xEventGroupClearBits()
6.6.1函数原型
- xEventGroup:事件组句柄;
- uxBitsToClear:需要清零的位;
- 返回值:清除之前的事件组的值。
6.6.2函数框架
- ①事件组的值赋值给返回值
- ②清零相应位
6.7清除事件组标志位xEventGroupClearBitsFromISR()
6.7.1函数原型
- xEventGroup:事件组句柄;
- uxBitsToClear:需要清零的位;
6.7.2函数框架
通过回调函数的方式,在守护任务中调用xEventGroupClearBits函数实现。