11.FreeRTOS_事件组

事件组概述

事件组的作用：

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

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

相关函数

创建事件组

函数声明如下：

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;
}