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.打开串口助手看运行结果