系列文章目录

文章目录

系列文章目录
事件标志组
事件标志组API函数
实验测试

事件标志组

事件标志位：用一个位来表示事件是否可以发生。

事件标志组是一组事件标志位的集合

特点：
1.每一个位表示一个事件（高8位不是）
2.每一位事件的含义由用户自己决定，1表示事件发生了，0表示事件未发生
3.任意任务或中断都可以读写这些位
4.可以等待某一位成立或等待多位同时成立

一个事件组包含了一个EventBits_t数据类型的变量，是一个16位或32位的无符号数据类型

typedef TickType_t EventBits_t;
#if ( configUSE_16_BIT_TICKS  = =  1 )
	typedef   uint16_t   TickType_t;
#else	
	typedef   uint32_t   TickType_t;
#endif

在这里插入图片描述

但是高8位用作存储事件标志组的控制信息，低24位用作存储事件标志，最多存储24个事件标志。

队列和信号量在事件发生的时候，只能有一个任务被唤醒，而且队列的数据在读取后就消失了，信号量在获取后就减少了；
事件标志组不同，事件发生的时候，会唤醒所有符合条件的任务，且可以选择保留事件或者清除事件。

事件标志组API函数

函数	描述
xEventGroupCreate()	使用动态方式创建事件标志组
xEventGroupCreateStatic()	使用静态方式创建事件标志组
xEventGroupClearBits()	清零事件标志位
xEventGroupClearBitsFromISR()	在中断中清零事件标志位
xEventGroupSetBits()	设置事件标志位
xEventGroupSetBitsFromISR()	在中断中设置事件标志位
xEventGroupWaitBits()	等待事件标志位
xEventGroupSync()	设置事件标志位，并等待事件标志位

1.动态创建API函数

EventGroupHandle_t    xEventGroupCreate ( void ) ;

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

2.清除事件标志位API函数

EventBits_t  xEventGroupClearBits( EventGroupHandle_t xEventGroup,const EventBits_t uxBitsToClear )

形参：
xEventGroup：待操作的事件标志组句柄
uxBitsToSet ：待清零的事件标志位

返回值：
整数：清零事件标志位之前事件组中事件标志位的值

3.设置事件标志位API函数

EventBits_t   xEventGroupSetBits(  EventGroupHandle_t xEventGroup,const EventBits_t uxBitsToSet )

形参：
xEventGroup ：待操作的事件标志组句柄
uxBitsToSet ：待设置的事件标志位

返回值：
整数：函数返回时，事件组中的事件标志位值

4.等待事件标志位API函数

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 清除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)

形参：
xEventGroup ：等待事件标志所在事件组
uxBitsToSet ：达到同步点后，要设置的事件标志
uxBitsToWaitFor：等待的事件标志
xTicksToWait：等待的阻塞时间

返回值：
等待的事件标志位值：等待事件标志位成功，返回等待到的事件标志位
其他值：等待事件标志位失败，返回事件组中的事件标志位

实验测试

任务1：创建任务2和任务3，并且创建事件标志组
任务2；将事件标志组相应事件位置1，模拟事件发生
任务3：同时等待事件标志组中的多个事件位发生，发生全部置1进行处理

在这里插入图片描述

EventGroupHandle_t  eventgroup_handle;
#define EVENTBIT_0  (1 << 0)
#define EVENTBIT_1  (1 << 1)
/**
 * @brief       FreeRTOS例程入口函数
 * @param       无
 * @retval      无
 */
void freertos_demo(void)
{    
    xTaskCreate((TaskFunction_t         )   start_task,
                (char *                 )   "start_task",
                (configSTACK_DEPTH_TYPE )   START_TASK_STACK_SIZE,
                (void *                 )   NULL,
                (UBaseType_t            )   START_TASK_PRIO,
                (TaskHandle_t *         )   &start_task_handler );
    vTaskStartScheduler();
}


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