之前介紹了使用信號(hào)量來完成同步，但是使用信號(hào)量來同步的話，任務(wù)只能與單個(gè)的事件或任務(wù)進(jìn)行同步。有時(shí)候某個(gè)任務(wù)可能會(huì)需要與多個(gè)事件或任務(wù)進(jìn)行同步，此時(shí)信號(hào)量就無能為力了。FreeRTOS 提供了一個(gè)可選的解決方法，那就是事件標(biāo)志組。

事件標(biāo)志位可以理解為一個(gè)Bit位，多個(gè)事件位就組成了事件標(biāo)志組，F(xiàn)reeRTOS可選8個(gè)事件標(biāo)志位或者24個(gè)事件標(biāo)志位，具體是由configUSE_16_BIT_TICKS來確定，它為1的時(shí)候是8個(gè)標(biāo)準(zhǔn)位，為0時(shí)是24個(gè)標(biāo)志位！

創(chuàng)建標(biāo)志組

EventGroupHandle_t xEventGroupCreate( void );

返回值：

創(chuàng)建失敗返回NULL，創(chuàng)建成功返回句柄

置位API函數(shù)

EventBits_t xEventGroupSetBits( EventGroupHandle_t xEventGroup,
                                 const EventBits_t uxBitsToSet );

參數(shù)：

xEventGroup:需要操作的事件標(biāo)志組的句柄

uxBitsToSet:寫入數(shù)值，例如0x09就表示置位第0位和第三位

讀取事件組的位

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

參數(shù)：

xEventGroup：事件標(biāo)志組的句柄

uxBitsToWaitFor：需要等待的標(biāo)志位

xClearOnExit：是否需要清除標(biāo)志位

xWaitForAllBits：是否等待所有設(shè)定標(biāo)志位

xTicksToWait：最大等待時(shí)間

注意：更多API函數(shù)，請參考官方相關(guān)

附上簡單使用應(yīng)用

#include "stm32f10x.h"
#include 
#include "FreeRTOS.h"
#include "task.h"
#include "event_groups.h"


#define START_TASK_PRIO 1      //任務(wù)優(yōu)先級(jí)
#define START_STK_SIZE 128      //任務(wù)堆棧大小
TaskHandle_t StartTask_Handler;   //任務(wù)句柄
void start_task(void *pvParameters);//任務(wù)函數(shù)


#define LED0_TASK_PRIO 2       //任務(wù)優(yōu)先級(jí)
#define LED0_STK_SIZE 50       //任務(wù)堆棧大小
TaskHandle_t LED0Task_Handler;     //任務(wù)句柄
void led0_task(void *p_arg);     //任務(wù)函數(shù)


EventGroupHandle_t Event_Handle = NULL;//事件標(biāo)志組的句柄


void LED_Init(void)
{
  GPIO_InitTypeDef GPIO_InitStructure;        //定義結(jié)構(gòu)體變量

  RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOC,ENABLE);  //開啟時(shí)鐘

  GPIO_InitStructure.GPIO_Pin=GPIO_Pin_0;            //選擇你要設(shè)置的IO口
  GPIO_InitStructure.GPIO_Mode=GPIO_Mode_Out_PP;      //設(shè)置推挽輸出模式
  GPIO_InitStructure.GPIO_Speed=GPIO_Speed_50MHz;     //設(shè)置傳輸速率
  GPIO_Init(GPIOC,&GPIO_InitStructure);                //初始化GPIO

  GPIO_SetBits(GPIOC,GPIO_Pin_0);             //將LED端口拉高，熄滅LED
}


int main( void ) 
{
  NVIC_PriorityGroupConfig(NVIC_PriorityGroup_4);//設(shè)置系統(tǒng)中斷優(yōu)先級(jí)分組 4
  LED_Init(); //初始化 LED
  //創(chuàng)建任務(wù)標(biāo)志組
  Event_Handle = xEventGroupCreate();
  //置位標(biāo)志位
  xEventGroupSetBits( ( EventGroupHandle_t) Event_Handle,
            ( EventBits_t )       0x08       );

  //創(chuàng)建開始任務(wù)
  xTaskCreate(
    (TaskFunction_t )start_task,     //任務(wù)函數(shù)
    (const char* )"start_task",     //任務(wù)名稱
    (uint16_t )START_STK_SIZE,       //任務(wù)堆棧大小
    (void* )NULL,             //傳遞給任務(wù)函數(shù)的參數(shù)
    (UBaseType_t )START_TASK_PRIO,     //任務(wù)優(yōu)先級(jí)
    (TaskHandle_t* )&StartTask_Handler  //任務(wù)句柄 
  );
  vTaskStartScheduler();  //開啟調(diào)度
}
//開始任務(wù)函數(shù)
void start_task(void *pvParameters)
{
  taskENTER_CRITICAL();   //進(jìn)入臨界區(qū)
  //創(chuàng)建 LED0 任務(wù)
  xTaskCreate(
    (TaskFunction_t )led0_task, 
    (const char* )"led0_task", 
    (uint16_t )LED0_STK_SIZE, 
    (void* )NULL,
    (UBaseType_t )LED0_TASK_PRIO,
    (TaskHandle_t* )&LED0Task_Handler
  );
  vTaskDelete(StartTask_Handler); //刪除開始任務(wù)
  taskEXIT_CRITICAL();   //退出臨界區(qū)
}


//LED0 任務(wù)函數(shù)
void led0_task(void *pvParameters)
{
  while(1)
  {
    xEventGroupWaitBits( ( EventGroupHandle_t ) Event_Handle,  //句柄
               ( EventBits_t        ) 0x08,      //需要等待的位
               ( BaseType_t         ) pdTRUE ,    //需要清零
               ( BaseType_t         ) pdTRUE,      //等待所有設(shè)定標(biāo)志位
               ( TickType_t         ) portMAX_DELAY );//死等待

    if(GPIO_ReadInputDataBit( GPIOC, GPIO_Pin_0))
    {
      GPIO_ResetBits( GPIOC, GPIO_Pin_0);
    }
    else
    {
      GPIO_SetBits( GPIOC, GPIO_Pin_0);
    }
    //置位標(biāo)志位
    xEventGroupSetBits( ( EventGroupHandle_t) Event_Handle,
              ( EventBits_t )       0x08         );

    vTaskDelay(400);
  }
}

注意：如果LED0任務(wù)中的置位函數(shù)，那么LED0函數(shù)只會(huì)運(yùn)行一次，因?yàn)闃?biāo)志位已經(jīng)清除了，需要再次置位標(biāo)志位才會(huì)繼續(xù)運(yùn)行！

--END--