FreeRTOS源码阅读笔记6--event_groups.c

通常用的事件标志组是一个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函数实现。