【FreeRTOS篇】事件标志组

最新推荐文章于 2024-02-29 21:16:05 发布

程序猿gao

最新推荐文章于 2024-02-29 21:16:05 发布

阅读量96

点赞数

分类专栏： FreeRTOS 文章标签： FreeRTOS

本文链接：https://blog.csdn.net/m0_66492811/article/details/132397760

版权

FreeRTOS 专栏收录该内容

12 篇文章 2 订阅

订阅专栏

一、什么是事件标志组？

事件标志位：表明某个事件是否发生，联想：全局变量 flag。通常按位表示，每一个位表示一个事件（高8位不算）。

事件标志组是一组事件标志位的集合，可以简单的理解事件标志组，就是一个整数。

二、事件标志组相关 API 函数

1. 创建事件标志组

EventGroupHandle_t xEventGroupCreate( void );

参数：
无
返回值：
成功，返回对应事件标志组的句柄；失败，返回 NULL 。

2. 设置事件标志位

EventBits_t xEventGroupSetBits( EventGroupHandle_t xEventGroup,
                                const EventBits_t uxBitsToSet );

参数：
xEventGroup：对应事件组句柄。 uxBitsToSet：指定要在事件组中设置的一个或多个位的按位
值。
返回值：
设置之后事件组中的事件标志位值。

3. 清除事件标志位

EventBits_t xEventGroupClearBits(EventGroupHandle_t xEventGroup,
const EventBits_t uxBitsToClear );

参数：
xEventGroup：对应事件组句柄。 uxBitsToClear：指定要在事件组中清除的一个或多个位的按位
值。
返回值：
清零之前事件组中事件标志位的值。

4. 等待事件标志位

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

参数：
xEventGroup：对应的事件标志组句柄
uxBitsToWaitFor：指定事件组中要等待的一个或多个事件位的按位值
xClearOnExit：pdTRUE——清除对应事件位，pdFALSE——不清除 
xWaitForAllBits：pdTRUE——所有等待事件位全为1（逻辑与），pdFALSE——等待的事件位有一个为1（逻辑或）
xTicksToWait：超时
返回值：
等待的事件标志位值：等待事件标志位成功，返回等待到的事件标志位 其他值：等待事件标志位
失败，返回事件组中的事件标志位

三、实操

•实验需求：创建一个事件标志组和两个任务（ task1 和 task2），task1 检测按键，如果检测到 KEY1 和 KEY2都按过，则执行 task2 。

•编程实现

EventGroupHandle_t eventgroup_Handle;
eventgroup_Handle = xEventGroupCreate();

void StartTask1(void const * argument)
{
  /* USER CODE BEGIN StartTask1 */
  /* Infinite loop */
  for(;;)
  {
		//等待KEY1按下
		if(HAL_GPIO_ReadPin(GPIOA,GPIO_PIN_0) == RESET)
		{
			osDelay(20);
			if(HAL_GPIO_ReadPin(GPIOA,GPIO_PIN_0) == RESET)
			{
				xEventGroupSetBits(eventgroup_Handle,0x01);
			}	
			while(HAL_GPIO_ReadPin(GPIOA,GPIO_PIN_0) == RESET);
		}
		//等待KEY2按下
		if(HAL_GPIO_ReadPin(GPIOA,GPIO_PIN_1) == RESET)
		{
			osDelay(20);
			if(HAL_GPIO_ReadPin(GPIOA,GPIO_PIN_1) == RESET)
			{
				xEventGroupSetBits(eventgroup_Handle,0x02);
			}	
			while(HAL_GPIO_ReadPin(GPIOA,GPIO_PIN_1) == RESET);
		}
    osDelay(1);
  }
  /* USER CODE END StartTask1 */
}

void StartTask2(void const * argument)
{
  /* USER CODE BEGIN StartTask2 */
	EventBits_t event_bit = 0;
  /* Infinite loop */
  for(;;)
  {
		event_bit = xEventGroupWaitBits(eventgroup_Handle,0x01 | 0x02,pdTRUE,pdFALSE,portMAX_DELAY);
		printf("返回值：%#x,请假成功，可以去大保健了！\r\n",event_bit);
    osDelay(1);
  }
  /* USER CODE END StartTask2 */
}