事件标志组

Q: 什么是事件标志组？

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

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

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

事件标志组相关 API 函数

创建事件标志组

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

设置事件标志位

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

清除事件标志位

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

等待事件标志位

xEventGroup：对应的事件标志组句柄
uxBitsToWaitFor：指定事件组中要等待的一个或多个事件位的按位值
xClearOnExit：pdTRUE -> 清除对应事件位，pdFALSE -> 不清除
xWaitForAllBits： pdTRUE -> 所有等待事件位全为1（逻辑与），pdFALSE -> 等待的事件位有一个为1（逻辑或）（假如要等第3位和第10位，如果这里设置了pdFALSE，那么第3位和第10位有一位变为1就可以结束等待）
xTicksToWait：超时等待时间
返回值： 等待的事件标志位值：等待事件标志位成功，返回等待到的事件标志位 其他值：等待事件标志位失败，返回事件组中的事件标志位

实操演示

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

在 C:\mjm_CubeMX_proj 路径下，复制一份Cube的母版并重命名为：mjm_freeRTOS_event：

打开相应的Cube文件：

1. 配置按钮的GPIO：

2. 找到左侧的Middleware --> FREERTOS：

2.1 然后在下方找到"Task and Queues"，然后创建两个任务：

2.2 然后在下方找到"Events"，发现无法创建Events:

原因是，现在使用的是FreeRTOS的V1版本，V1版本不包含事件的功能，所以这部分直接到keil自己代码实现。

3. 生成代码打开Keil:

freertos.c:

#include "stdio.h"

EventGroupHandle_t eventgroup_handle; //创建事件句柄

void MX_FREERTOS_Init(void) {
	
	eventgroup_handle = xEventGroupCreate(); //创建事件标志组并返回句柄
}

void StartTask_1(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){ //按键消抖
				printf("KEY1 has been pressed\r\n");
				xEventGroupSetBits(eventgroup_handle, 0x01); //设置事件标志位，具体设置为 bit0置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){ //按键消抖
				printf("KEY2 has been pressed\r\n");
				xEventGroupSetBits(eventgroup_handle, 0x02); //设置事件标志位，具体设置为 bit1置1
			}
			while (HAL_GPIO_ReadPin(GPIOA, GPIO_PIN_1) == GPIO_PIN_RESET); //等待按键松开，防止出现按钮一直按着，就一直删除创建任务			
		}
    osDelay(10);
  }
}


void StartTask_2(void const * argument)
{
	EventBits_t event_bit = 0;

  for(;;)
  {
		event_bit = xEventGroupWaitBits(eventgroup_handle, 0x01 | 0x02, pdTRUE, pdTRUE, portMAX_DELAY); //等待事件标志位，只有当第0位和第1位标志位同时置1才会结束等待,将标志位清0并返回，如果等不到就一直死等
		printf("return value: %#x\r\n",event_bit); //返回值的类型是“EvenBits_t”,是一个16进制的数，即“%x”,如果在x前面再加一个“#”,则会在16进制数前自动显示“0x”，所以这里写成“%#x”
     
		osDelay(1);
  }
}