小工具知识网

当前位置: 首页 > 行业知识 > FreeRTOS操作系统学习——事件组

行业知识

FreeRTOS操作系统学习——事件组

2026-11-18 16:54:17 来源:互联网转载

事件组介绍

一个事件���就是一组的事件位,事件组中的事件位通过位编号来访问。事件位用来表明某个事件是否发生,事件位通常用作事件标志。

事件组用一个整数来表示,其中的高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 );

参数说明:

  1. xEventGroup:哪个事件组?
  2. uxBitsToSet:要设置哪些事件?我完成了哪些事件?

    比如 0x05(二进制为 0101)会导致事件组的 bit0,bit2 被设置为 1

  3. uxBitsToWaitFor:等待那个位、哪些位?

    比如 0x15(二级制 10101),表示要等待 bit0,bit2,bit4 都为 1

  4. xTicksToWait:如果期待的事件未发生,阻塞多久。

    可以设置为 0:判断后即刻返回;

    可设置为 portMAX_DELAY:一定等到成功才返回;

    可以设置为期望的 Tick Count,一般用 pdMS_TO_TICKS()把ms 转换为 Tick Count

  5. 返回值 :返回的是事件值,如果期待的事件发生了,返回的是"非阻塞条件成立"时的事件值;如果是超时退出,返回的是超时时刻的事件值。

上一篇:编写注册页面的JavaScript代码全解析,一步步打造高效注册流程

下一篇:苹果服务器修护怎么关掉?