什么是事件标志组?
事件标志位
表明某个事件是否发生,联想:全局变量 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,具体看我之前写过的文章
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.打开串口助手看运行结果