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

通常用的事件标志组是一个32位的变量uxEventBits,可设置的位有24位,一共就是24 种事件。

事件组的结构体类型:

FreeRTOS源码阅读笔记6--event_groups.c_第1张图片

6.1创建事件组xEventGroupCreate()

6.1.1函数原型

  • 返回值:事件组句柄,指向事件组。
6.1.2函数框架
  • ①为事件组结构体分配空间

  • ②初始化事件组结构体的成员变量,包括等待事件列表的初始化。

6.2删除事件组vEventGroupDelete()

6.2.1函数原型

  • xEventGroup:事件组的句柄。
6.2.2函数框架

FreeRTOS源码阅读笔记6--event_groups.c_第2张图片

6.3置位事件组xEventGroupSetBits()

6.3.1函数原型

  • xEventGroup:事件组句柄;
  • uxBitsToSet:指定事件中的事件标志位,32位的数据。如设置为0x07,表示事件组中的位0、位1和位2都设置为1。
  • 返回值:调用 xEventGroupSetBits() 时事件组中的值。
6.3.2函数框架

FreeRTOS源码阅读笔记6--event_groups.c_第3张图片

6.4置位事件组xEventGroupSetBitsFromISR()

6.4.1函数原型

  • xEventGroup:事件组句柄;
  • uxBitsToSet:指定事件中要设置的事件标志位;
  • pxHigherPriorityTaskWoken:可根据*pxHigherPriorityTaskWoken判断退出中断后,是否要进行任务切换。
  • 返回值:消息成功发送给守护任务之后则返回 pdTRUE,否则返回 pdFAIL。如果定时器服务队列满了将返回 pdFAIL。
6.4.2函数框架

xEventGroupSetBits源码中可以看出,while循环中等待事件的任务数量是不确定的,FreeRTOS中不能在中断中执行不确定的操作。所以xEventGroupSetBitsFromISR其实是在守护任务(软件定时器服务任务,优先级比自定义的任务优先级大)通过回调函数的方式,调用xEventGroupSetBits函数来实现的,本质上xEventGroupSetBitsFromISR执行的上下文环境是任务。

FreeRTOS源码阅读笔记6--event_groups.c_第4张图片

6.5等待事件组xEventGroupWaitBits()

6.5.1函数原型

FreeRTOS源码阅读笔记6--event_groups.c_第5张图片

  • xEventGroup:事件组句柄;
  • uxBitsToWaitFor:等待事件组的哪些位;
  • xClearOnExit:函数退出时是否清除由形参 uxBitsToWaitFor 指定的事件标志位;
  • xWaitForAllBits:pdTRUE“逻辑与”,pdFALSE“逻辑或”;
  • xTicksToWait:超时时间。
  • 返回值:事件组的值。
6.5.2函数框架

FreeRTOS源码阅读笔记6--event_groups.c_第6张图片

6.6清除事件组标志位xEventGroupClearBits()

6.6.1函数原型

  • xEventGroup:事件组句柄;
  • uxBitsToClear:需要清零的位;
  • 返回值:清除之前的事件组的值。
6.6.2函数框架
  • ①事件组的值赋值给返回值

  • ②清零相应位

6.7清除事件组标志位xEventGroupClearBitsFromISR()

6.7.1函数原型

  • xEventGroup:事件组句柄;
  • uxBitsToClear:需要清零的位;
6.7.2函数框架

通过回调函数的方式,在守护任务中调用xEventGroupClearBits函数实现。

你可能感兴趣的:(笔记)