freeRTOS——事件标志组知识总结及实战

发布时间:2024年01月04日

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);
    }
}



文章来源:https://blog.csdn.net/m0_73502349/article/details/135387136
本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。