FreeRTOS事件标志组

news2025/1/12 17:50:17

一、事件标志组的概念

1、事件标志位

2、事件标志组

二、事件标志组相关API

1、创建事件标志组

2、设置事件标志位

3、清除事件标志位

4、等待事件标志位

三、事件标志组实操

1、实验需求

2、CubeMX配置

3、代码实现

一、事件标志组的概念

1、事件标志位

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

2、事件标志组

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

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

二、事件标志组相关API

函数	描述
xEventGroupCreate()	使用动态方式创建事件标志组
xEventGroupCreateStatic()	使用静态方式创建事件标志组
xEventGroupClearBits()	清零事件标志位
xEventGroupClearBitsFromISR()	在中断中清零事件标志位
xEventGroupSetBits()	设置事件标志位
xEventGroupSetBitsFromISR()	在中断中设置事件标志位
xEventGroupWaitBits()	等待事件标志位

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表示卡死等待

返回值：

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

三、事件标志组实操

1、实验需求

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

2、CubeMX配置

这里已经将FreeRTOS移植到STM32F103C8T6，具体操作流程看前面的文章。

查看原理图配置按键引脚

创建两个优先级相同的任务

3、代码实现

uart.c 重定向printf

#include "stdio.h"
int fputc(int ch,FILE *f)
{
	unsigned char temp[1] = {ch};
	HAL_UART_Transmit(&huart1,temp,1,0xffff);
	return ch;
}

需要打开魔术棒勾上红框内选项实现串口打印

打开freertos.c并添加代码

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

void StartTask1(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);//设置事件标志位为第1位
			}
			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);//设置事件标志位为第2位
			}
			while (HAL_GPIO_ReadPin(GPIOA, GPIO_PIN_1) == GPIO_PIN_RESET);
		}
    osDelay(10);
  }
}
 
void StartTask2(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);
  }
}

可见只有当按键1和按键2后才能执行task2，task2中的事件标志位值是设置的事件标志位都置为1后返回的值，当第1位和第2位同时为1，十六进制显示后就是0x03。

注意：上述代码中等待事件标志位函数中的第4个参数设置为pdTURE（按位与），即当设置的事件标志位都置1后（按键1和按键2都按下），才能执行task2，那么如果把第4个参数设置为pdFALSE（按位或），会出现什么现象，如下：
event_bit = xEventGroupWaitBits(eventgroup_handle,0x01|0x02,pdTRUE,pdFALSE,portMAX_DELAY);
可见当其中任何一个事件标志位置为1（任意一个按键按下），都会进入执行task2。