freeRTOS——事件标志组知识总结及实战
1事件标志组概念
事件标志组：是一组事件标志位的集合， 可以简单的理解事件标志组，就是一个整数。
其特点：
1）它的每一个位表示一个事件（高8位不算）
2）每一位事件的含义，由用户自己决定，如：bit0表示按键是否按下，bit1表示是否接受到消息，值为1：表示事件发生了；值为0：表示事件未发生
3）任意任务或中断都可以读写这些位
4）可以等待某一位成立，或者等待多位同时成立
2 事件标志组变量定义
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 位无符号的数据类型
注意：一个事件组最多可以存储 24 个事件标志！
3 事件标志组与队列、信号量的比较
4 事件标志组API函数
1）创建事件标志位
EventGroupHandle_t xEventGroupCreate ( void )
返回值：NULL 失败
其他 成功返回句柄
2）清零时间标志位
EventBits_t xEventGroupClearBits( EventGroupHandle_t xEventGroup,
const EventBits_t uxBitsToClear )
形参： xEventGroup 事件标志组
uxBitsToClear 待清零的事件标志位
返回值：整数 清零事件标志位之前事件组中事件标志位的值
3）设置事件标志位
EventBits_t xEventGroupSetBits( EventGroupHandle_t xEventGroup,
const EventBits_t uxBitsToSet )
形参： xEventGroup 事件标志组
uxBitsToSet 待设置的事件标志位
返回值：整数 函数返回时，事件标志位值
4）等待事件标志位
EventBits_t xEventGroupWaitBits( EventGroupHandle_t xEventGroup,
const EventBits_t uxBitsToWaitFor,
const BaseType_t xClearOnExit,
const BaseType_t xWaitForAllBits,
TickType_t xTicksToWait )
形参： xEventGroup 事件标志组句柄
uxBitsToWaitFor 等待的事件标志位，可以用逻辑或等待多个事件标志位
xClearOnExit 成功等待到事件标志位后，清除事件组中对应的事件标志位，
pdTRUE ：清除uxBitsToWaitFor指定位；
pdFALSE：不清除
xWaitForAllBits 等待 uxBitsToWaitFor 中的所有事件标志位（逻辑与）
pdTRUE：等待的位，全部为1
pdFALSE：等待的位，某个为1
xTicksToWait 等待的阻塞时间
返回值：等待的事件标志位值 等待事件标志位成功，返回等待到的事件标志位
其他值 等待事件标志位失败，返回事件组中的事件标志位
注意：
可以等一位，也可以等多位
等到之后，可以清楚某些位
5）同步函数
EventBits_t xEventGroupSync( EventGroupHandle_t xEventGroup,
const EventBits_t uxBitsToSet,
const EventBits_t uxBitsToWaitFor,
TickType_t xTicksToWait)
5事件标志组实战
5.1freertos_demo.c
#include "freertos_demo.h"
#include "./BSP/LCD/lcd.h"
#include "./BSP/KEY/key.h"
/*FreeRTOS*********************************************************************************************/
#include "FreeRTOS.h"
#include "task.h"
#include "event_groups.h"
/******************************************************************************************************/
/*FreeRTOS配置*/
/* START_TASK 任务 配置
* 包括: 任务句柄 任务优先级 堆栈大小 创建任务
*/
#define START_TASK_PRIO 1 /* 任务优先级 */
#define START_STK_SIZE 128 /* 任务堆栈大小 */
TaskHandle_t StartTask_Handler; /* 任务句柄 */
void start_task(void *pvParameters); /* 任务函数 */
//1.FreeRTOS配置
//1.1 START_TASK 任务 配置
//包括: 任务句柄 任务优先级 堆栈大小 创建任务
#define START_TASK_PRIO 1 /* 任务优先级 */
#define START_STK_SIZE 128 /* 任务堆栈大小 */
TaskHandle_t StartTask_Handler; /* 任务句柄 */
void start_task(void *pvParameters); /* 任务函数 */
//1.2 TASK1 任务 配置
//包括: 任务句柄 任务优先级 堆栈大小 创建任务
#define TASK1_PRIO 2 /* 任务优先级 */
#define TASK1_STK_SIZE 128 /* 任务堆栈大小 */
TaskHandle_t Task1Task_Handler; /* 任务句柄 */
void task1(void *pvParameters); /* 任务函数 */
//1.3 TASK2 任务 配置
//包括: 任务句柄 任务优先级 堆栈大小 创建任务
#define TASK2_PRIO 4 /* 任务优先级 */
#define TASK2_STK_SIZE 128 /* 任务堆栈大小 */
TaskHandle_t Task2Task_Handler; /* 任务句柄 */
void task2(void *pvParameters); /* 任务函数 */
//1.4 TASK3 任务 配置
//包括: 任务句柄 任务优先级 堆栈大小 创建任务
#define TASK3_PRIO 3 /* 任务优先级 */
#define TASK3_STK_SIZE 128 /* 任务堆栈大小 */
TaskHandle_t Task3Task_Handler; /* 任务句柄 */
void task3(void *pvParameters); /* 任务函数 */
//1.5 定义事件组句柄、将事件组位0、位1设置为1
EventGroupHandle_t eventgroup_handle;
#define EVENTBIT_0 (1 << 0 )
#define EVENTBIT_1 (1 << 1 )
//2 FreeRTOS例程入口函数
// @param 无
//@retval 无
void freertos_demo(void)
{
//创建事件组
eventgroup_handle = xEventGroupCreate ();
if(eventgroup_handle != NULL)
{
printf("事件标志组创建成功！！\r\n");
}
xTaskCreate((TaskFunction_t )start_task, /* 任务函数 */
(const char* )"start_task", /* 任务名称 */
(uint16_t )START_STK_SIZE, /* 任务堆栈大小 */
(void* )NULL, /* 传入给任务函数的参数 */
(UBaseType_t )START_TASK_PRIO, /* 任务优先级 */
(TaskHandle_t* )&StartTask_Handler); /* 任务句柄 */
vTaskStartScheduler();
}
//2 start_task
// @param pvParameters : 传入参数(未用到)
//@retval 无
void start_task(void *pvParameters)
{
taskENTER_CRITICAL(); /* 进入临界区 */
/* 创建任务1 */
xTaskCreate((TaskFunction_t )task1,
(const char* )"task1",
(uint16_t )TASK1_STK_SIZE,
(void* )NULL,
(UBaseType_t )TASK1_PRIO,
(TaskHandle_t* )&Task1Task_Handler);
/* 创建任务2 */
xTaskCreate((TaskFunction_t )task2,
(const char* )"task2",
(uint16_t )TASK2_STK_SIZE,
(void* )NULL,
(UBaseType_t )TASK2_PRIO,
(TaskHandle_t* )&Task2Task_Handler);
vTaskDelete(StartTask_Handler); /* 删除开始任务 */
taskEXIT_CRITICAL(); /* 退出临界区 */
}
//3 task1，释放二值信号量
//@param pvParameters : 传入参数(未用到)
// @retval 无
void task1(void *pvParameters)
{
uint8_t key = 0;
while (1)
{
key = key_scan(0); //扫描事件标志组
if(key == KEY0_PRES)
{
xEventGroupSetBits(eventgroup_handle,EVENTBIT_0); //将事件标志组的bit 0位置置为1
}else if(key == KEY1_PRES)
{
xEventGroupSetBits(eventgroup_handle,EVENTBIT_1); //将事件标志组的bit 1位置置为1
}
vTaskDelay(10);
}
}
//task2
//@param pvParameters : 传入参数(未用到)
//@retval 无
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);
}
}