【正点原子FreeRTOS学习笔记】————（14）事件标志组-编程知识

【正点原子FreeRTOS学习笔记】————（14）事件标志组

这里写目录标题

一、事件标志组简介（了解）
二、事件标志组相关API函数介绍（熟悉）
三、事件标志组实验（掌握）

一、事件标志组简介（了解）

事件标志位：用一个位，来表示事件是否发生
事件标志组是一组事件标志位的集合，可以简单的理解事件标志组，就是一个整数。
事件标志组的特点：
1、它的每一个位表示一个事件（高8位不算）
2、每一位事件的含义，由用户自己决定，如：bit0表示按键是否按下，bit1表示是否接受到消息 …
这些位的值为1：表示事件发生了；值为0：表示事件未发生
3、任意任务或中断都可以读写这些位
4、可以等待某一位成立，或者等待多位同时成立

一个事件组就包含了一个 EventBits_t 数据类型的变量，变量类型 EventBits_t 的定义如下所示：

typedef TickType_t EventBits_t;
#if ( configUSE_16_BIT_TICKS  = =  1 )typedef   uint16_t   TickType_t;
#else typedef   uint32_t   TickType_t;
#endif
#define  configUSE_16_BIT_TICKS    0 EventBits_t 实际上是一个 16 位或 32 位无符号的数据类型

虽然使用了 32 位无符号的数据类型变量来存储事件标志，但其中的高8位用作存储事件标志组的控制信息，低24位用作存储事件标志，所以说一个事件组最多可以存储 24 个事件标志！
在这里插入图片描述
事件标志组与队列、信号量的区别？

二、事件标志组相关API函数介绍（熟悉）

在这里插入图片描述

动态方式创建事件标志组API函数

EventGroupHandle_t xEventGroupCreate ( void ) ;

在这里插入图片描述
清除事件标志位API函数

EventBits_t xEventGroupClearBits( EventGroupHandle_t xEventGroup, const EventBits_t uxBitsToClear )

在这里插入图片描述
设置事件标志位API函数

EventBits_t xEventGroupSetBits( EventGroupHandle_t xEventGroup, const EventBits_t uxBitsToSet )

在这里插入图片描述
等待事件标志位API函数

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

在这里插入图片描述

同步函数

EventBits_t xEventGroupSync( EventGroupHandle_t xEventGroup,
const EventBits_t uxBitsToSet,
const EventBits_t uxBitsToWaitFor,
TickType_t xTicksToWait)

在这里插入图片描述

三、事件标志组实验（掌握）

1、实验目的：学习 FreeRTOS 的事件标志组API函数的使用。
2、实验设计：将设计三个任务：start_task、task1、task2
三个任务的功能如下：
在这里插入图片描述

EventGroupHandle_t  eventgroup_handle;
#define EVENTBIT_0  (1 << 0)
#define EVENTBIT_1  (1 << 1)......
void start_task( void * pvParameters )
{taskENTER_CRITICAL();               /* 进入临界区 */eventgroup_handle = xEventGroupCreate();if(eventgroup_handle != NULL){printf("事件标志组创建成功！！\r\n");}xTaskCreate((TaskFunction_t         )   task1,(char *                 )   "task1",(configSTACK_DEPTH_TYPE )   TASK1_STACK_SIZE,(void *                 )   NULL,(UBaseType_t            )   TASK1_PRIO,(TaskHandle_t *         )   &task1_handler );xTaskCreate((TaskFunction_t         )   task2,(char *                 )   "task2",(configSTACK_DEPTH_TYPE )   TASK2_STACK_SIZE,(void *                 )   NULL,(UBaseType_t            )   TASK2_PRIO,(TaskHandle_t *         )   &task2_handler );vTaskDelete(NULL);taskEXIT_CRITICAL();                /* 退出临界区 */
}/* 任务一，释放二值信号量 */
void task1( void * pvParameters )
{uint8_t key = 0;while(1) {key = key_scan(0);if(key == KEY0_PRES){xEventGroupSetBits( eventgroup_handle, EVENTBIT_0); /* 将事件标志组的bit0位置1 */}else if(key == KEY1_PRES){xEventGroupSetBits( eventgroup_handle, EVENTBIT_1); /* 将事件标志组的bit1位置1 */}vTaskDelay(10);}
}/* 任务二，获取二值信号量 */
void task2( void * pvParameters )
{EventBits_t event_bit = 0;while(1){event_bit = xEventGroupWaitBits( eventgroup_handle,         /* 事件标志组句柄 */EVENTBIT_0 | EVENTBIT_1,   /* 等待事件标志组的bit0和bit1位 */pdTRUE,                    /* 成功等待到事件标志位后，清除事件标志组中的bit0和bit1位 */pdTRUE,                    /* 等待事件标志组的bit0和bit1位都置1,就成立 */portMAX_DELAY );           /* 死等 */printf("等待到的事件标志位值为：%#x\r\n",event_bit);}
}