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 的话就执行相应的处理