FreeRTOS事件标志组

目录

一、事件标志组的概念

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。