【学习FreeRTOS】第16章——FreeRTOS事件标志组

1.事件标志组简介

事件标志位：用一个位，来表示事件是否发生
事件标志组是一组事件标志位的集合， 可以简单的理解事件标志组，就是一个整数。

事件标志组的特点：

• 它的每一个位表示一个事件（高8位不算）
• 每一位事件的含义，由用户自己决定，如：bit0表示按键是否按下，bit1表示是否接受到消息
  这些位的值为1：表示事件发生了；值为0：表示事件未发生
• 任意任务或中断都可以读写这些位
• 可以等待某一位成立，或者等待多位同时成立
  

一个事件组就包含了一个 EventBits_t 数据类型的变量，变量类型 EventBits_t 的定义如下所示。EventBits_t 实际上是一个 16 位或 32 位无符号的数据类型 （一般设为32位）

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 

事件标志组与队列、信号量的区别

事件标志组和信号量存在区别，它们之间有一个可以沟通的桥梁——队列集，通过队列集可以模拟事件标志位

2.事件标志组相关API函数介绍

• xEventGroupCreate()：使用动态方式创建事件标志组
• xEventGroupCreateStstic()：使用静态方式创建事件标志组
• xEventGroupClearBits()：清零事件标志位
• xEventGroupClearBitsFromISR()：在中断中清零事件标志位
• xEventGroupSetBits()：设置事件标志位
• xEventGroupSetBitsFromISR()：在中断中设置事件标志位
• xEventGroupWaitBits()：等待事件标志位
• xEventGroupSync()：设置事件标志位，并等待事件标志位
• vEventGroupDelete()：删除事件标志组
• xEventGroupGetBits()：获取事件组中各事件标志位的值
• xEventGroupGetBitsFromISR()：在中断中获取事件组中各事件标志位的值

2.1.使用动态方式创建事件标志组xEventGroupCreate()

EventGroupHandle_t    xEventGroupCreate (void) ; 

• 返回值：NULL，事件标志组创建失败；其他值，事件标志组创建成功，返回其句柄

2.2.清零事件标志位xEventGroupClearBits()

EventBits_t xEventGroupClearBits( 	EventGroupHandle_t 	xEventGroup,const EventBits_t 	uxBitsToClear) 

• 形参xEventGroup：待操作的事件标志组句柄
• 形参uxBitsToSet：待清零的事件标志位
• 返回值：整数，清零事件标志位之前事件组中事件标志位的值

2.3.设置事件标志位xEventGroupSetBits()

EventBits_t  xEventGroupSetBits(  	EventGroupHandle_t 	xEventGroup,const EventBits_t 	uxBitsToSet)

• 形参xEventGroup：待操作的事件标志组句柄
• 形参uxBitsToSet：待设置的事件标志位
• 返回值：整数，函数返回时事件组中事件标志位的值

2.4.等待事件标志位xEventGroupWaitBits()

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

• 形参xEvenrGroup：等待的事件标志组句柄
• 形参uxBitsToWaitFor：等待的事件标志位，（可以用逻辑或等待多个事件标志位）
• 形参xClearOnExit：成功等待到事件标志位后，清除事件组中对应的事件标志位，pdTRUE清除;pdFALSE:不清除
• 形参xWaitForAllBits：等待uxBitsToWaitFor 中的所有事件标志位（逻辑与）pdTRUE，等待的位全部为1；pdFALSE，等待的位某个为1
• 形参xTicksToWait：等待的阻塞时间
• 返回值
  等待的事件标志位值：等待事件标志位成功，返回等待到的事件标志位
  其他值：等待事件标志位失败，返回事件组中的事件标志位
• 特点：可以等待某一位、也可以等待多位，等到期望的事件后，还可以清除某些位

注意，本函数只能完成设置标志位的某一位或者全部，并不能设置某几位。比如8各中的1个或8个，不能设置2-7个

2.5.设置事件标志位，并等待事件标志位xEventGroupSync()

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

• 形参xEvenrGroup：等待的事件标志组句柄
• uxBitsToSet：达到同步点后，要设置的事件标志
• uxBitsToWaitFor：等待的事件标志
• xTicksToWait：等待的阻塞时间
• 返回值
  等待的事件标志位值：等待事件标志位成功，返回等待到的事件标志位
  其他值：等待事件标志位失败，返回事件组中的事件标志位
• 特点：同步——用于Task1完成后置1，等待Task2完成之后才算完成事件

3.事件标志组实验

• 实验目的：学习 FreeRTOS 的事件标志组API函数的使用。
• 实验设计：将设计三个任务：start_task、task1、task2
  start_task-用来创建task1和task2任务，并创建事件标志组
  task1-读取按键按下键值，根据不同键值将事件标志组相应事件位置一，模拟事件发生
  task2-同时等待事件标志组中的多个事件位，当这些事件位都置 1 的话就执行相应的处理