当前位置：首页 > news >正文

11.FreeRTOS_事件组

news 来源：原创 2024/9/20 5:47:12

事件组概述

事件组的作用：

可以等待某一个事件发生
可以等待若干个事件发生
可以等待若干个事件中的某一个事件发生

同步点是事件组的另一个使用方式，它可以让多个任务进行阻塞等待，当全部事件完成后，再一起解除任务的阻塞。常常用于合作关系的情况。

相关函数

创建事件组

函数声明如下：

EventGroupHandle_t xEventGroupCreate( void )

返回值：事件组的句柄

设置事件组

函数声明如下：

EventBits_t xEventGroupSetBits( EventGroupHandle_t xEventGroup,const EventBits_t uxBitsToSet )

xEventGroup：事件组的句柄，设置哪一个事件组

uxBitsToSet ：设置哪一个事件，以bit传入，设置bit3就传入 (1<<3)，设置多个可用 ‘ | ’实现

等待事件组

函数声明如下：

EventBits_t xEventGroupWaitBits( EventGroupHandle_t xEventGroup,const EventBits_t uxBitsToWaitFor,const BaseType_t xClearOnExit,const BaseType_t xWaitForAllBits,TickType_t xTicksToWait )

xEventGroup：事件组的句柄，设置哪一个事件组

uxBitsToWaitFor：要等待的事件，以bit传入

xClearOnExit：当函数返回之前，是否清除这个事件。传入pdFALSE、pdTRUE

xWaitForAllBits：是否等待全部

传入pdFALSE代表有一个事件发生即可解除阻塞
传入pdTRUE代表必须全部事件发生才可解除阻塞

xTicksToWait ：超时时间

同步点

函数声明如下：

EventBits_t xEventGroupSync( EventGroupHandle_t xEventGroup,const EventBits_t uxBitsToSet,const EventBits_t uxBitsToWaitFor,TickType_t xTicksToWait )

xEventGroup：事件组的句柄，设置哪一个事件组

uxBitsToSet：设置自己做完了哪一个事件，以bit传入

uxBitsToWaitFor：要等待哪些事件完成，以bit传入，只有当全部等待的事件完成后才可退出阻塞

xTicksToWait ：超时

uxBitsToWaitFor设置的事件都完成后，多个任务会同时从这个函数退出来，不再阻塞。退出函数之后，会自动清除uxBitsToWaitFor设置的事件的位

验证实验

现在有3个任务，任务1在做一件很长时间的事情，任务2也在做一个很长时间的事情，任务3在等待这两个任务中其中一个完成后，打印task finish字符串。

具体代码实现如下：

EventGroupHandle_t xEventHandle_Test;/* 事件组句柄 */
void TaskAFunction(void *param){int i=0;int j=0;while(1){/* 做一个很长时间的任务 */for(i=0;i<10000;i++){j++;}/* 设置事件0 */xEventGroupSetBits(xEventHandle_Test,1<<0);}
}void TaskBFunction(void *param){int i=0;int j=0;while(1){/* 做一个很长时间的任务 */for(i=0;i<20000;i++){j++;}/* 设置事件1 */xEventGroupSetBits(xEventHandle_Test,1<<1);}
}
void TaskCFunction(void *param){while(1){/* 等待事件组，pdFALSE代表等待的事件有一个发生即可解除阻塞 */xEventGroupWaitBits(xEventHandle_Test,(1<<0)|(1<<1),pdTRUE,pdFALSE,portMAX_DELAY);printf("task finish\r\n");}
}int main( void )
{TaskHandle_t xHandleTask1;TaskHandle_t xHandleTask2;TaskHandle_t xHandleTask3;prvSetupHardware();SerialPortInit();printf("UART TEST\r\n");/* 创建事件组 */xEventHandle_Test = xEventGroupCreate();xTaskCreate(TaskAFunction,"TaskA",100,(void*)NULL,1,&xHandleTask1);xTaskCreate(TaskBFunction,"TaskB",100,(void*)NULL,1,&xHandleTask2);xTaskCreate(TaskCFunction,"TaskC",100,(void*)NULL,1,&xHandleTask3);vTaskStartScheduler();return 0;
}