FreeRTOS系列|事件标志组

/***************EventBits_t在event_groups.h中定义**********/
typedef TickType_t EventBits_t;
/***************TickType_t在portmacro.h中定义**************/
#if( configUSE_16_BIT_TICKS == 1 )
    typedef uint16_t TickType_t;//事件标志组可以存储8个事件位
    #define portMAX_DELAY ( TickType_t ) 0xffff
#else
    typedef uint32_t TickType_t;//事件标志组可以存储24个事件位
    #define portMAX_DELAY ( TickType_t ) 0xffffffffUL
    #define portTICK_TYPE_IS_ATOMIC 1
#endif

2. 递归互斥信号量的API函数

2.1 创建递归互斥信号量

/********************动态创建事件标志组**********************************************/
EventGroupHandle_t xEventGroupCreate(void)
/********************静态创建事件标志组**********************************************/
EventGroupHandle_t xEventGroupCreateStatic(StaticEventGroup_t * pxEventGroupBuffer)
//参数：pxEventGroupBuffer指向一个StaticEventGroup_t类型的变量，用来保存事件标志组结构体
返回值：创建成功返回事件标志组句柄；失败返回NULL

2.2 设置事件位

/****************将指定的事件位清零，用在任务中***************************************/
EventBits_t xEventGroupClearBits(EventGroupHandle_t xEventGroup,//要操作的事件标志组句柄
nst EventBits_t uxBitsToClear)//要清零的事件位
/****************将指定的事件位置1，用在任务中***************************************/
EventBits_t xEventGroupSetBits(EventGroupHandle_t xEventGroup,//要操作的事件标志组句柄
nst EventBits_t uxBitsToSet)//要置1的事件位
返回值：将指定事件位清零之前的事件组值；将指定事件位置1后的事件组值
/****************将指定的事件位清零，用在中断服务函数中********************************/
BaseType_t xEventGroupClearBitsFromISR(EventGroupHandle_t xEventGroup,
onst EventBits_t uxBitsToClear)//要清零的事件位						   
/****************将指定的事件位置1，用在中断服务函数中********************************/
//#define configUSE_TRACE_FACILITY需要配置为1
BaseType_t xEventGroupSetBitsFromISR(EventGroupHandle_t xEventGroup, 
onst EventBits_t uxBitsToSet,//要置1的事件位
aseType_t *pxHigherPriorityTaskWoken)//标记退出后是否切换任务
返回值：清零或置1成功返回pdPASS;清零或置1失败返回pdFALSE

指定事件位清零函数xEventGroupClearBits的源码如下示：

EventBits_t xEventGroupClearBits(EventGroupHandle_t xEventGroup,
	onst EventBits_t uxBitsToClear){
	EventGroup_t *pxEventBits = ( EventGroup_t * ) xEventGroup;
	EventBits_t uxReturn;
	taskENTER_CRITICAL();//进入临界段
	{
		/* 获取当前事件标志位 */
		uxReturn = pxEventBits->uxEventBits;
		/* 清除要设置的事件标志位 */
		pxEventBits->uxEventBits &= ~uxBitsToClear;
	}
	taskEXIT_CRITICAL();//退出临界段
	return uxReturn;//返回事件标志组值
}

指定事件位置1函数xEventGroupSetBits的源码如下示：

EventBits_t xEventGroupSetBits(EventGroupHandle_t xEventGroup,
	nst EventBits_t uxBitsToSet){
	ListItem_t *pxListItem, *pxNext;
	ListItem_t const *pxListEnd;
	List_t *pxList;
	EventBits_t uxBitsToClear = 0, uxBitsWaitedFor, uxControlBits;
	EventGroup_t *pxEventBits = ( EventGroup_t * ) xEventGroup;
	BaseType_t xMatchFound = pdFALSE;
	/* 获取事件列表头 */
	pxList = &( pxEventBits->xTasksWaitingForBits );
	/* 获取列表尾节点 */
	pxListEnd = listGET_END_MARKER( pxList ); 
	vTaskSuspendAll();//挂起调度器
	{	
		pxListItem = listGET_HEAD_ENTRY( pxList );//获取头节点
		pxEventBits->uxEventBits |= uxBitsToSet;//设置事件标志位
		/* 循环遍历整个列表项，直到列表头节点等于尾节点（指针） */
		while(pxListItem != pxListEnd){			
			pxNext = listGET_NEXT(pxListItem);//获取下个列表项
			/* 获取当前列表项的值 */
			uxBitsWaitedFor = listGET_LIST_ITEM_VALUE(pxListItem);		
			xMatchFound = pdFALSE;//标记是否找到需要处理的节点
			/* 拆分 */
			uxControlBits = uxBitsWaitedFor & eventEVENT_BITS_CONTROL_BYTES;
			uxBitsWaitedFor &= ~eventEVENT_BITS_CONTROL_BYTES;
			if((uxControlBits & eventWAIT_FOR_ALL_BITS) == (EventBits_t)0){
				/* 或逻辑，等待位已经置位 */
				if((uxBitsWaitedFor & pxEventBits->uxEventBits) != (EventBits_t)0){			
					xMatchFound = pdTRUE;//找到了已经触发的节点
				}
				else{
					mtCOVERAGE_TEST_MARKER();
				}
			}
			/* 表示所有等待的位都已经触发 */
			else if((uxBitsWaitedFor&pxEventBits->uxEventBits) == uxBitsWaitedFor){		
				xMatchFound = pdTRUE;//找到触发的节点
			}
			else{
				/* Need all bits to be set, but not all the bits were set. */
			}

			if( xMatchFound != pdFALSE ){
				/* 判断是否需要清除 */
				if((uxControlBits & eventCLEAR_EVENTS_ON_EXIT_BIT)!=(EventBits_t)0){
					uxBitsToClear |= uxBitsWaitedFor;//做个标记
				}
				else{
					mtCOVERAGE_TEST_MARKER();
				}
				/* 把任务从事件列表中移除	*/
				(void)xTaskRemoveFromUnorderedEventList(pxListItem,pxEventBits->uxEventBits|eventUNBLOCKED_DUE_TO_BIT_SET);
			}
			pxListItem = pxNext;//当前列表项指向下个，继续遍历
		}
		pxEventBits->uxEventBits &= ~uxBitsToClear;//清除设置后的标志位
	}	
	(void) xTaskResumeAll();//开启调度器
	return pxEventBits->uxEventBits;
}

2.3 获取事件标志组值

/***获取当前事件标志组的值，用在任务中****/
EventBits_t xEventGroupGetBits(EventGroupHandle_t xEventGroup)//要操作的事件标志组句柄
/**获取当前事件标志组的值，用在中断服务函数中****/
EventBits_t xEventGroupGetBitsFromISR(EventGroupHandle_t xEventGroup)
返回值：当前事件标志组的值

用在任务中获取当前事件标志组的值函数是一个宏定义，如下示：

#define xEventGroupGetBits(xEventGroup)    xEventGroupClearBits(xEventGroup, 0)

用在中断服务函数获取当前事件标志组的值函数源码如下示：

EventBits_t xEventGroupGetBitsFromISR(EventGroupHandle_t xEventGroup){
	UBaseType_t uxSavedInterruptStatus;
	EventGroup_t *pxEventBits = ( EventGroup_t * ) xEventGroup;
	EventBits_t uxReturn;	
	/* 禁止中断,带返回值 */
	uxSavedInterruptStatus = portSET_INTERRUPT_MASK_FROM_ISR();
	{		
		uxReturn = pxEventBits->uxEventBits;//获取事件标志位
	}
	/* 恢复中断，在进入禁止之前的状态 */
	portCLEAR_INTERRUPT_MASK_FROM_ISR( uxSavedInterruptStatus );
	return uxReturn;
}

2.4 等待指定的事件位

/***等待指定的事件位***/
EventBits_t xEventGroupWaitBits(EventGroupHandle_t xEventGroup, //要等待的事件标志组
cnst EventBits_t uxBitsToWaitFor, //要等待的事件位
cnst BaseType_t xClearOnExit, //退出是否要清除位
cnst BaseType_t xWaitForAllBits, //与逻辑还是或逻辑
TckType_t xTicksToWait) //阻塞等待时间
参  数：xClearOnExit若为pdTURE，则表示设置的位在函数退出时会被清零；
aitForAllBits若为pdTURE，则表示所有要设置的位都置1或阻塞时间到，函数才会返回
为pdFALSE,则表示只要要设置的某一位置1或阻塞时间到，函数就会返回
返回值：返回所等待的事件位置1后的事件标志组的值，或返回阻塞时间到

EventBits_t xEventGroupWaitBits( EventGroupHandle_t xEventGroup, 
    const EventBits_t uxBitsToWaitFor, 
    const BaseType_t xClearOnExit, 
    const BaseType_t xWaitForAllBits, 
    TickType_t xTicksToWait){
	EventGroup_t *pxEventBits = ( EventGroup_t * ) xEventGroup;
	EventBits_t uxReturn, uxControlBits = 0;
	BaseType_t xWaitConditionMet, xAlreadyYielded;
	BaseType_t xTimeoutOccurred = pdFALSE;	
	vTaskSuspendAll();//挂起调度器
	{
		/* 获取当前的事件标志位 */
		const EventBits_t uxCurrentEventBits = pxEventBits->uxEventBits;
		/* 检查是否触发 */
		xWaitConditionMet = prvTestWaitCondition(uxCurrentEventBits, uxBitsToWaitFor, xWaitForAllBits);
		if( xWaitConditionMet != pdFALSE ){			
			/* 已经触发 */
			uxReturn = uxCurrentEventBits;
			xTicksToWait = ( TickType_t ) 0;
			/* 清楚已经触发的标志 */
			if( xClearOnExit != pdFALSE ){
				pxEventBits->uxEventBits &= ~uxBitsToWaitFor;
			}
			else{
				mtCOVERAGE_TEST_MARKER();
			}
		}
		else if(xTicksToWait == (TickType_t) 0){
			/* 不需要超时，直接返回标志位. */
			uxReturn = uxCurrentEventBits;
		}
		else{
			/* 事件没有触发，并且需要超时*/
			if( xClearOnExit != pdFALSE ){
				uxControlBits |= eventCLEAR_EVENTS_ON_EXIT_BIT;
			}
			else{
				mtCOVERAGE_TEST_MARKER();
			}

			if( xWaitForAllBits != pdFALSE ){
				//uxControlBits = 0x05000000UL;
				uxControlBits |= eventWAIT_FOR_ALL_BITS;
			}
			else{
				mtCOVERAGE_TEST_MARKER();
			}

			/* 把任务添加到事件列表中	*/
			vTaskPlaceOnUnorderedEventList(&( pxEventBits->xTasksWaitingForBits), ( uxBitsToWaitFor | uxControlBits ), xTicksToWait );
			uxReturn = 0;
			traceEVENT_GROUP_WAIT_BITS_BLOCK( xEventGroup, uxBitsToWaitFor );
		}
	}
	xAlreadyYielded = xTaskResumeAll();//恢复调度器	
	if(xTicksToWait != (TickType_t ) 0){//再次判断是否需要超时
		if( xAlreadyYielded == pdFALSE ){
			portYIELD_WITHIN_API();//进行上下文切换 ->pendSV
		}
		else{
			mtCOVERAGE_TEST_MARKER();
		}
		/* 任务已经恢复，则复位列表项中的值  复位为任务有优先级 */
		uxReturn = uxTaskResetEventItemValue();
		/* 是不是通过事件置位解除的任务 */
		if((uxReturn & eventUNBLOCKED_DUE_TO_BIT_SET) == (EventBits_t)0){		
			taskENTER_CRITICAL();//进入临界段
			{
				
				uxReturn = pxEventBits->uxEventBits;// 获取当前事件位
				/* 再此判断是否已经置位 */
				if( prvTestWaitCondition( uxReturn, uxBitsToWaitFor, xWaitForAllBits ) != pdFALSE ){
					/* 如果需要清除，清除触发后的标志位 */
					if( xClearOnExit != pdFALSE ){
						pxEventBits->uxEventBits &= ~uxBitsToWaitFor;
					}
					else{
						mtCOVERAGE_TEST_MARKER();
					}
				}
				else{
					mtCOVERAGE_TEST_MARKER();
				}
			}
			taskEXIT_CRITICAL();
			xTimeoutOccurred = pdFALSE;
		}
		else{
			/* The task unblocked because the bits were set. */
		}
		/* 返回当前事件标志位 */
		uxReturn &= ~eventEVENT_BITS_CONTROL_BYTES;
	}
	traceEVENT_GROUP_WAIT_BITS_END( xEventGroup, uxBitsToWaitFor, xTimeoutOccurred );
	return uxReturn;
}

3. 事件标志组应用实例

本实例介绍 FreeRTOS 事件标志组的创建、将相应的事件位置1、等待相应事件位置1等函数的操作与使用

使用STM32CubeMX将FreeRTOS移植到工程中，创建三个任务、一个事件标志组、开启一个按键中断

EventSetBit_Task：读取按键值，根据不同的键值将相应的事件位置1
EventGroup_Task：等待事件标志组的多个事件位都置1后执行相应处理
EventQuery_Task：查询事件组的值，即各个事件位的值

3.1 STM32CubeMX设置

RCC设置外接HSE，时钟设置为72M
PA0设置为GPIO外部中断、下拉模式、并开启中断；PE2/PE3/PE4设置为GPIO输入模式、上拉模式
USART1选择为异步通讯方式，波特率设置为115200Bits/s，传输数据长度为8Bit，无奇偶校验，1位停止位；
激活FreeRTOS，添加任务，设置任务名称、优先级、堆栈大小、函数名称等参数

使能xEventGroupSetBitsFromISR()函数

使用FreeRTOS操作系统，需要将HAL库的Timebase Source从SysTick改为其他定时器，选好定时器后，系统会自动配置TIM

输入工程名，选择路径（不要有中文），选择MDK-ARM V5；勾选Generated periphera initialization as a pair of ‘.c/.h' files per IP ；点击GENERATE CODE，生成工程代码

3.2 MDK-ARM软件编程

创建按键驱动文件key.c和key.h，参考按键输入例程
在freertos.c文件中，添加一个事件标志组（STM32CubeMX中不提供添加方法），定义事件位；并在freertos初始化函数MX_FREERTOS_Init()中创建事件标志组

EventGroupHandle_t EventGroupHandler;	//事件标志组句柄
#define EVENTBIT_0	(1<<0)	//事件位
#define EVENTBIT_1	(1<<1)
#define EVENTBIT_2	(1<<2)

/*****MX_FREERTOS_Init()中创建事件标志组*****/
EventGroupHandler = xEventGroupCreate();
if(EventGroupHandler == NULL)
  printf("EventGroup Create Failed!\r\n");

添加EventSetBitTask、EventGroupTask和EventQueryTask任务函数代码

/***EventSetBitTask***/
void EventSetBitTask(void const * argument){
  uint8_t key;
  for(;;){	
	if(EventGroupHandler != NULL){
	  key = KEY_Scan(0);
	  switch(key){
		case KEY_LEFT_PRES :
		  xEventGroupSetBits(EventGroupHandler,EVENTBIT_1);
		  printf("EVENTBIT_1 Set Successed!\r\n");
		  break;
		case KEY_RIGHT_PRES :
		  xEventGroupSetBits(EventGroupHandler,EVENTBIT_2);
		  printf("EVENTBIT_2 Set Successed!\r\n");
		  break;
	  }
	}
    osDelay(10);
  }
}
/***EventGroup_Task***/
void EventGroup_Task(void const * argument){
  EventBits_t EventValue;
  for(;;){
    if(EventGroupHandler != NULL){
      EventValue = xEventGroupWaitBits(EventGroupHandler,
      EVENTBIT_0|EVENTBIT_1|EVENTBIT_2,要设置的位
      pdTRUE,//退出时清除位
      pdTRUE,//要设置的位都置1或阻塞时间到，函数才会返回
      portMAX_DELAY);	阻塞时间
      printf("WaitBits successed!Value of EventGroup is %d\r\n",EventValue);	
    }
    else{
	  osDelay(10);
	}
  }
}
/***EventQuery_Task***/
void EventQuery_Task(void const * argument){
  EventBits_t NewValue, LastValue;
  for(;;){
    if(EventGroupHandler != NULL){
      NewValue = xEventGroupGetBits(EventGroupHandler);
      if(NewValue != LastValue){
		LastValue = NewValue;
		printf("The Query Value of EventGroup is %d\r\n",LastValue);
	  }
    }
    osDelay(50);
  }
}

添加按键PA0的中断处理函数，在中断中设置事件位

void HAL_GPIO_EXTI_Callback(uint16_t GPIO_Pin){
  BaseType_t ret;
  HAL_Delay(10);
  if(GPIO_Pin == GPIO_PIN_0){
	ret = xEventGroupSetBitsFromISR(EventGroupHandler,EVENTBIT_0,NULL);
	if(ret != pdFAIL)
	  printf("EVENTBIT_0 Set from ISR successed!\r\n");
	}
}

3.3 下载验证

编译无误下载到开发板后，打开串口调试助手，依次按KEY_UP、KEY_LEFT和KEY_RIGHT按键，串口输出如下调试信息：

按下KEY_UP，在中断中将EVENTBIT_0位置1
按下KEY_LEFT和KEY_RIGHT，EVENTBIT_1和EVENTBIT_2位置1
三个位都置1后，xEventGroupWaitBits将各位清除

268 次浏览	8次

< 首页