FreeRTOS 事件标志组 详解

目录

什么是事件标志组？

事件标志位

事件标志组

事件标志组相关 API 函数

1. 创建事件标志组

2. 设置事件标志位

3. 清除事件标志位

4. 等待事件标志位

事件标志组实操

什么是事件标志组？

事件标志位

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

事件标志组

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

事件标志组本质是一个 16 位或 32 位无符号的数据类型 EventBits_t ，由 configUSE_16_BIT_TICKS 决定。

虽然使用了 32 位无符号的数据类型变量来存储事件标志， 但其中的高8位用作存储事件标志组的 控制信息，低 24 位用作存储事件标志 ，所以说一个事件组最多可以存储 24 个事件标志！

事件标志组相关 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：

• 超时时间，0 表示不超时，
• portMAX_DELAY表示卡死等待

返回值：

等待的事件标志位值：等待事件标志位成功，返回等待到的事件标志位

其他值：等待事件标志位失败，返回事件组中的事件标志位

事件标志组实操

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

1.打开CubeMX，将FreeRTOS移植到STM32F103C8T6，具体看我之前写过的文章

将FreeRTOS移植到STM32F103C8T6

2.增加两个任务，配置两个输入引脚给按键Key1和Key2，导出代码

3.在代码中创建一个事件标志组

EventGroupHandle_t eventgroup_handle; // 事件标志组句柄

eventgroup_handle = xEventGroupCreate(); // 创建一个事件标志组

4.task1 检测按键，如果检测到 KEY1 和 KEY2 都按过，则执行 task2

freertos.c

void StartTaskKey1(void const * argument)
{
  for(;;)
  {
		if(HAL_GPIO_ReadPin(GPIOA, GPIO_PIN_0) == GPIO_PIN_RESET)
		{
			osDelay(20);
			if (HAL_GPIO_ReadPin(GPIOA, GPIO_PIN_0) == GPIO_PIN_RESET)
			{
				xEventGroupSetBits(eventgroup_handle, 0x01);
			}
			while (HAL_GPIO_ReadPin(GPIOA, GPIO_PIN_0) == GPIO_PIN_RESET);
		}
		if(HAL_GPIO_ReadPin(GPIOA, GPIO_PIN_1) == GPIO_PIN_RESET)
		{
			osDelay(20);
			if (HAL_GPIO_ReadPin(GPIOA, GPIO_PIN_1) == GPIO_PIN_RESET)
			{
				xEventGroupSetBits(eventgroup_handle, 0x02);
			}
			while (HAL_GPIO_ReadPin(GPIOA, GPIO_PIN_1) == GPIO_PIN_RESET);
		}
    osDelay(10);
  }
}

void StartTaskKey2(void const * argument)
{
  for(;;)
  {
    event_bit = xEventGroupWaitBits(eventgroup_handle,0x01|0x02,pdTRUE,pdTRUE,portMAX_DELAY);
    printf("返回值：%#x，按键都按下，任务2可以执行了\r\n",event_bit); // %#x是带格式输出, 效果为在输出前加0x. 
    osDelay(1);
  }
}

5.打开串口助手看运行结果