【FreeRtos教程七】STM32 CubeMx——EventGroup（事件组）

目录

1 事件组

2 示例程序

2.1 例程功能

2.2 步骤

2.4 实验结果

2.5 函数讲解

2.6 程序源码

---

1 事件组

1.什么是事件组

一个事件标志组有多个事件位，每个事件位表示了一个事件的标志。 比如我们用事件标志组的bit0表示事件A、bit1表示事件B、bit2表示事件C，那么这个事件标志组至少可以表示3个事件是否发生。 之前我们讲过信号量，它用作信号同步时，只能表示一个资源的有无；而事件标志组，它可以同时表示多个资源的有无。

上述的例子，相当于这个事件标志组实现了等效于3个二值信号量的功能，任务可以在一个事件标志组上同时等待A、B、C三个事件。 任务在等待事件标志组的事件时，可以选等待该组中的一个或某几个事件位。比如上述例子中，虽然事件标志组表示了A、B、C三个事件，但是用户可以设置为只等待A和B。 此外，事件标志组与信号量不同的另一点，是它可以选择在等待到某个事件位时是否对该事件位清零。而使用信号量时，获取到一个信号量时，信号量的计数会自动减1。

2 示例程序

2.1 例程功能

创建两个按键任务，按键按下将事件组的某一位置1；创建一个打印任务，等待两个事件组两个事件都发生后打印字符串

2.2 步骤

配置两个按键IO口

配置两个按键任务和一个打印任务

创建事件标志，创建事件组和事件组句柄

/* Private define ------------------------------------------------------------*/
/* USER CODE BEGIN PD */
//创建事件标志
#define Event_1 (1<<1)
#define Event_2 (1<<2)
/* USER CODE END PD */

//..............

/* Private variables ---------------------------------------------------------*/
/* USER CODE BEGIN Variables */
EventGroupHandle_t myEventGroupHandle_1;//事件组句柄
/* USER CODE END Variables */    

//..............

void MX_FREERTOS_Init(void) {
  /* USER CODE BEGIN Init */
  myEventGroupHandle_1=xEventGroupCreate();//创建事件组
  /* USER CODE END Init */
  
  //..............
  
}

按键KEY0按下，将事件组第一位置1

/* USER CODE END Header_StartTask_KEY0 */
void StartTask_KEY0(void const * argument)
{
  /* USER CODE BEGIN StartTask_KEY0 */
  /* Infinite loop */
  for(;;)
  {
    if(HAL_GPIO_ReadPin(KEY0_GPIO_Port,KEY0_Pin)==0)
    {
        osDelay(10);
        if(HAL_GPIO_ReadPin(KEY0_GPIO_Port,KEY0_Pin)==0)
        {
            //用户要执行的事
            osThreadSuspendAll();
            printf("KEY0按下 \n");
            osThreadResumeAll();
            xEventGroupSetBits(myEventGroupHandle_1,Event_1);
        }
        while(HAL_GPIO_ReadPin(KEY0_GPIO_Port,KEY0_Pin)==0)
        {
            osDelay(10);
        }
    }
      osDelay(1);
  }
  /* USER CODE END StartTask_KEY0 */
}

按键KEY1按下，将事件组第二位置1

/* USER CODE END Header_StartTask_KEY1 */
void StartTask_KEY1(void const * argument)
{
  /* USER CODE BEGIN StartTask_KEY1 */
  /* Infinite loop */
  for(;;)
  {
    if(HAL_GPIO_ReadPin(KEY1_GPIO_Port,KEY1_Pin)==0)
    {
        osDelay(10);
        if(HAL_GPIO_ReadPin(KEY1_GPIO_Port,KEY1_Pin)==0)
        {
            //用户要执行的事
            osThreadSuspendAll();
            printf("KEY1按下 \n");
            osThreadResumeAll();
            xEventGroupSetBits(myEventGroupHandle_1,Event_2);
        }
        while(HAL_GPIO_ReadPin(KEY1_GPIO_Port,KEY1_Pin)==0)
        {
            osDelay(10);
        }
    }
      osDelay(1);
  }
  /* USER CODE END StartTask_KEY1 */
}

等待到事件组第1位和第二位都置1后，执行打印语句

/* USER CODE END Header_StartTask01 */
void StartTask01(void const * argument)
{
  /* USER CODE BEGIN StartTask01 */
    EventBits_t myEventBits_1;
  /* Infinite loop */
  for(;;)
  {
      myEventBits_1=xEventGroupWaitBits(myEventGroupHandle_1,Event_1|Event_2,pdTRUE,pdTRUE,portMAX_DELAY);
      if(myEventBits_1&Event_1)
      {
          osThreadSuspendAll();
          printf("事件1发生 \n");
          osThreadResumeAll();
      }
      if(myEventBits_1&Event_2)
      {
          osThreadSuspendAll();
          printf("事件2发生 \n");
          osThreadResumeAll();
      }
      osDelay(1);
  }
  /* USER CODE END StartTask01 */
}

2.4 实验结果

按键KEY0和按键KEY1都按下后，打印“事件1发生”、“事件2发生”

2.5 函数讲解

1 EventGroupHandle_t xEventGroupCreate( void )

• 函数功能：创建一事件组
• 返回值：返回事件组的句柄

2 EventBits_t xEventGroupSetBits( EventGroupHandle_t xEventGroup, const EventBits_t uxBitsToSet )

• 函数功能：设置事件组的位
• 传入参数：1.xEventGroup（要设置的事件组的句柄） 2.uxBitsToSet（要设置那几位）
• 返回值：返回原来的事件值

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

• 函数功能：等待事件，可以等待某一位，也可以等待多位
• 传入参数：1.xEventGroup（要等待的事件组的句柄） 2.uxBitsToWaitFor（要等待那些位）3.xClearOnExit(函数退出前是否清除事件，pdTURE:清除uxBitsToWaitFor指定的位；pdFALSE:不清除) 4.xWaitForAllBits（pdTURE:uxBitsToWaitFor指定的位全部为1，pdFALSE:uxBitsToWaitFor某一位为1即可）

2.6 程序源码

github链接：HaoJosephWen/FreeRtos_personal (github.com)