FreeRTOS(事件标志组)

一、什么是事件标志组?

事件标志位:表明某个事件是否发生,联想:全局变量 flag,通常按位表示每一个位表示一个 事件(高8位不算)

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

事件标志组本质是一个 16 位或 32 位无符号的数据类型 EventBits_t ,由 configUSE_16_BIT_TICKS 决定。

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

【ESP32+freeRTOS学习笔记-(九)事件组】_骑牛唱剧本的博客-CSDN博客 

二、事件标志组相关 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:超时
  • 返回值: 等待的事件标志位值:等待事件标志位成功,返回等待到的事件标志位 其他值:等待事件标志位 失败,返回事件组中的事件标志位

三、实验

实验需求: 创建一个事件标志组和两个任务( task1 和 task2),task1 检测按键,如果检测到 KEY1 和 KEY2 都按过,则执行 task2 。

代码实现

 

猜你喜欢

转载自blog.csdn.net/m0_70987863/article/details/131901242