【一文吃透】FreeRTOS之事件标志组

1、事件位(事件标志)

事件位用来表明某个事件是否发生，事件位通常用作事件标志，比如下面的几个例子：

● 当收到一条消息并且把这条消息处理掉以后就可以将某个位(标志)置 1，当队列中没有消息需要处理的时候就可以将这个位(标志)置 0。

● 当把队列中的消息通过网络发送输出以后就可以将某个位(标志)置 1，当没有数据需要从网络发送出去的话就将这个位(标志)置 0。

● 现在需要向网络中发送一个心跳信息，将某个位(标志)置 1。现在不需要向网络中发送心跳信息，这个位(标志)置 0。

2、事件组

一个事件组就是一组的事件位，事件组中的事件位通过位编号来访问，同样，以上面列出的三个例子为例：

● 事件标志组的 bit0 表示队列中的消息是否处理掉。

● 事件标志组的 bit1 表示是否有消息需要从网络中发送出去。

● 事件标志组的 bit2 表示现在是否需要向网络发送心跳信息。

3、事件标志组和事件位的数据类型

事件标志组的数据类型为 EventGroupHandle_t，当 configUSE_16_BIT_TICKS 为 1 的时候事件标志组可以存储 8 个事件位，当 configUSE_16_BIT_TICKS 为 0 的时候事件标志组存储24个事件位。

事件标志组中的所有事件位都存储在一个无符号的 EventBits_t 类型的变量中，EventBits_t 类型的变量可以存储 24 个事件位，高 8 位有其他用。事件位 0 存放在这个变量的 bit0 上，变量的 bit1 就是事件位 1，以此类推。

对于 STM32 来说一个事件标志组最多可以存储 24 个事件位，如下图 所示：

4.事件标志组的特点

● 它的每一个位表示一个事件（高8位不算）

● 每一位事件的含义，由用户自己决定，如：bit0表示按键是否按下，bit1表示是否接受到消息 … …若这些位的值为1：表示事件发生了；值为0：表示事件未发生

● 任意任务或中断都可以读写这些位

● 可以等待某一位成立，或者等待多位同时成立

二、事件标志组使用方法

1.创建事件标志组

FreeRTOS 提供了两个用于创建事件标志组的函数，这里主要介绍一下比较常用的动态创建方法

函数 xEventGroupCreate() 用于创建一个事件标志组，所需要的内存通过动态内存管理方法分配。由于内部处理的原因，事件标志组可用的 bit 数取决于 configUSE_16_BIT_TICKS ， 当configUSE_16_BIT_TICKS1 为 1 的 时 候 事 件 标 志 组 有 8 个 可 用 的 位 (bit0~bit7) ， 当 configUSE_16_BIT_TICKS 为 0 的时候事件标志组有 24 个可用的位(bit0~bit23)。

2.设置事件位

①函数 xEventGroupClearBits()

将事件标志组中的指定事件位清零，此函数只能用在任务中，不能用在中断服务函数中！

中断服务函数有其他的 API 函数。函数原型如下：

EventBits_t xEventGroupClearBits( EventGroupHandle_t xEventGroup, 
                                  const EventBits_t uxBitsToClear );

参数：

xEventGroup： 要操作的事件标志组的句柄。

uxBitsToClear： 要清零的事件位，比如要清除 bit3 的话就设置为 0X08。可以同时清除多个

bit，如设置为 0X09 的话就是同时清除 bit3 和 bit0。

返回值：

pdPASS： 事件位清零成功。

pdFALSE: 事件位清零失败。

②函数 xEventGroupClearBitsFromISR()

EventBits_t xEventGroupSetBits( EventGroupHandle_t xEventGroup, 
                                const EventBits_t uxBitsToSet );

此函数为函数 xEventGroupClearBits()的中断级版本，也是将指定的事件位(标志)清零。

参数：

xEventGroup： 要操作的事件标志组的句柄。

uxBitsToClear： 指定要置 1 的事件位，比如要将 bit3 值 1 的话就设置为 0X08。可以同时将多个 bit 置 1，如设置为 0X09 的话就是同时将 bit3 和 bit0 置 1。

EventBits_t xEventGroupSetBits( EventGroupHandle_t xEventGroup, 
                                const EventBits_t uxBitsToSet );

④函数 xEventGroupSetBitsFromISR()

BaseType_t xEventGroupSetBitsFromISR( EventGroupHandle_t xEventGroup, 
                                      const EventBits_t uxBitsToSet, 
                                      BaseType_t * pxHigherPriorityTaskWoken );

EventBits_t xEventGroupGetBits( EventGroupHandle_t xEventGroup )

EventBits_t xEventGroupGetBitsFromISR( EventGroupHandle_t xEventGroup )

EventBits_t xEventGroupWaitBits( EventGroupHandle_t xEventGroup,
                                 const EventBits_t uxBitsToWaitFor,
                                 const BaseType_t xClearOnExit,
                                 const BaseType_t xWaitForAllBits,
                                 const TickType_t xTicksToWait );

-------------------------------------------------------------------------------------------------------摘自正点原子FreeRTOS相关课程课件，方便大家学习