FreeRTOS学习笔记-事件组(FreeRTOS中文官网)

最新推荐文章于 2024-05-02 21:17:26 发布

cityhonor

最新推荐文章于 2024-05-02 21:17:26 发布

阅读量298

点赞数

文章标签：学习

原文链接：https://www.freertos.org/zh-cn-cmn-s/event-groups-API.html

版权

事件组
[API]

提示：在许多情况下，“任务通知”可以提供替代事件组的轻量级方案

事件组和事件标志位 API 函数

xEventGroupCreate()
[事件组API ]

提示：在许多情况下，“任务通知”可以提供替代事件组的轻量级方案

event_groups.h

 EventGroupHandle_t xEventGroupCreate( void );

创建一个新的 RTOS 事件组，并返回可以引用新创建的事件组的句柄。

要使此 RTOS API 函数可用：

configSUPPORT_DYNAMIC_ALLOCATION 必须在 FreeRTOSConfig.h 中设置为 1，或保留未定义状态（此时默认为 1）。
RTOS 源文件 FreeRTOS/source/event_groups.c 必须包含在构建中。

每个事件组都需要非常少量 RAM 来保存事件组的状态。如果使用 xEventGroupCreate() 创建事件组，则会从 RAM 堆FreeRTOS中自动分配所需的。如果使用 xEventGroupCreateStatic() 创建事件组则 RAM 由应用程序编写者提供，这需要用到一个附加参数，但允许在编译时静态分配 RAM 。请参阅静态分配与动态分配页面了解更多信息。

事件组存储在 EventBits_t 类型的变量中。如果 configUSE_16_bit_TICKS 设置为 1，则事件组内实现的位（或标志）数为 8；如果 configUSE_16_bit_TICKS 设置为 0，则为 24。依赖于 configUSE_16_BIT_TICKS 的值取决于 RTOS 任务内部实现中用于线程本地存储的数据类型。

参数：

无

Returns:

如果创建了事件组，则返回事件组的句柄。如果没有足够的 FreeRTOS 堆可用于创建事件组，则返回 NULL。

用法示例：

    /* Declare a variable to hold the created event group. */
    EventGroupHandle_t xCreatedEventGroup;

    /* Attempt to create the event group. */
    xCreatedEventGroup = xEventGroupCreate();

    /* Was the event group created successfully? */
    if( xCreatedEventGroup == NULL )
    {
        /* The event group was not created because there was insufficient
        FreeRTOS heap available. */
    }
    else
    {
        /* The event group was created. */
    }

xEventGroupCreateStatic
[事件组API ]

提示：在许多情况下，“任务通知”可以提供替代事件组的轻量级方案

event_groups.h

 EventGroupHandle_t xEventGroupCreateStatic(
                              StaticEventGroup_t *pxEventGroupBuffer );

创建一个新的 RTOS 事件组，并返回可以引用新创建的事件组的句柄。 configSUPPORT_STATIC_ALLOCATION 必须在 FreeRTOSConfig.h 中设置为 1，并且 RTOS 源文件 FreeRTOS/source/event_groups.c 必须包含在构建中，xEventGroupCreateStatic() 函数才可用。

每个事件组都需要[非常]少量 RAM 来保存事件组的状态。如果使用 xEventGroupCreate() 创建事件组，则会从 RAM 堆FreeRTOS中自动分配所需的。如果使用 xEventGroupCreateStatic() 创建事件组，则 RAM 由应用程序编写者提供，这需要用到一个附加参数，但允许在编译时静态分配 RAM 。请参阅静态分配与动态分配页面了解更多信息。

参数：

pxEventGroupBuffer

必须指向 StaticEventGroup_t 类型的变量，该变量用于存储事件组数据结构体。

Returns:

如果成功创建了事件组，则返回事件组的句柄。如果 pxEventGroupBuffer 为 NULL，则返回 NULL。

用法示例：

    /* Declare a variable to hold the handle of the created event group. */
    EventGroupHandle_t xEventGroupHandle;

    /* Declare a variable to hold the data associated with the created
    event group. */
    StaticEventGroup_t xCreatedEventGroup;

    /* Attempt to create the event group. */
    xEventGroupHandle = xEventGroupCreateStatic( &xCreatedEventGroup );

    /* pxEventGroupBuffer was not null so expect the event group to have
    been created? */
    configASSERT( xEventGroupHandle );

vEventGroupDelete()
[事件组 API]

event_groups.h

 void vEventGroupDelete( EventGroupHandle_t xEventGroup );

删除先前的事件组，该事件组通过调用 xEventGroupCreate() 创建。

在被删除的事件组上阻塞的任务将被取消阻塞，并且报告事件组值为 0。

要使 vEventGroupDelete() 函数可用，RTOS 源文件 FreeRTOS/source/event_groups.c 必须包含在构建中。

无法从中断调用此函数。

参数：

xEventGroup

要删除的事件组。

Returns:

无。

xEventGroupWaitBits()
[事件组 API]

event_groups.h

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

读取 RTOS 事件组中的位，选择性地进入“已阻塞”状态（已设置超时值）以等待设置单个位或一组位。

无法从中断调用此函数。

要使 xEventGroupWaitBits() 函数可用，RTOS 源文件 FreeRTOS/source/event_groups.c 必须包含在构建中。

参数：

xEventGroup	正在测试位的事件组。此前必须已通过 xEventGroupCreate() 创建好事件组。
uxBitsToWaitFor	指定事件组中要测试的一个或多个事件位的按位值。例如，要等待第 0 位和/或第 2 位，请将 uxBitsToWaitFor 设置为 0x05。要等待第 0 位和/或第 1 位和/或第 2 位，请设置 uxBitsToWaitFor 为 0x07，以此类推。 uxBitsToWaitFor 不得设置为 0。
xClearOnExit	如果 xClearOnExit 设置为 pdTRUE，那么在作为 uxBitsToWaitFor 参数传递的值中设置的任何位会在 xEventGroupWaitBits() 返回某个值之前在事件组中清除掉，前提是 xEventGroupWaitBits() 因超时以外的原因而返回值。超时值由 xTicksToWait 参数设置。如果 xClearOnExit 设置为 pdFALSE，那么当调用 xEventGroupWaitBits() 返回时，事件组中设置的位不会改变。
xWaitForAllBits	xWaitForAllBits 用于创建逻辑与测试（必须设置所有位）或逻辑或测试（必须设置一个或多个位），如下所示：如果 xWaitForAllBits 设置为 pdTRUE，那么当在作为 uxBitsToWaitFor 参数传递的值中设置的所有位均已在事件组中设置好，或指定的阻塞时间已过期，则 xEventGroupWaitBits() 会返回相应值。如果 xWaitForAllBits 设置为 pdFALSE，那么当在作为 uxBitsToWaitFor 参数传递的值中设置的任何位已在事件组中设置好，或指定的阻塞时间已过期，则 xEventGroupWaitBits() 会返回相应值。
xTicksToWait	等待 uxBitsToWaitFor 指定的一个/所有（取决于 xWaitForAllBits 的值）位完成设置的最大时间（单位：tick）。

Returns:

事件位等待完成设置或阻塞时间过期时的事件组值。如果高优先级任务或中断在调用任务解除“已阻塞”状态和退出 xEventGroupWaitBits() 函数之间更改了事件位的值，则事件组中事件位的当前值将与返回值不同。

测试返回值以确定哪些位已完成设置。如果 xEventGroupWaitBits() 因为超时值过期而返回，则并非在等待的所有位都会进行设置。如果 xEventGroupWaitBits() 因为它所等待的位均已完成设置而返回相应值，则返回值是自动清除（原因是 xClearOnExit 参数设置为 pdTRUE）任何位之前的事件组值。

用法示例：

#define BIT_0	( 1 << 0 )
#define BIT_4	( 1 << 4 )

void aFunction( EventGroupHandle_t xEventGroup )
{
EventBits_t uxBits;
const TickType_t xTicksToWait = 100 / portTICK_PERIOD_MS;

  /* Wait a maximum of 100ms for either bit 0 or bit 4 to be set within
  the event group.  Clear the bits before exiting. */
  uxBits = xEventGroupWaitBits(
            xEventGroup,   /* The event group being tested. */
            BIT_0 | BIT_4, /* The bits within the event group to wait for. */
            pdTRUE,        /* BIT_0 & BIT_4 should be cleared before returning. */
            pdFALSE,       /* Don't wait for both bits, either bit will do. */
            xTicksToWait );/* Wait a maximum of 100ms for either bit to be set. */

  if( ( uxBits & ( BIT_0 | BIT_4 ) ) == ( BIT_0 | BIT_4 ) )
  {
      /* xEventGroupWaitBits() returned because both bits were set. */
  }
  else if( ( uxBits & BIT_0 ) != 0 )
  {
      /* xEventGroupWaitBits() returned because just BIT_0 was set. */
  }
  else if( ( uxBits & BIT_4 ) != 0 )
  {
      /* xEventGroupWaitBits() returned because just BIT_4 was set. */
  }
  else
  {
      /* xEventGroupWaitBits() returned because xTicksToWait ticks passed
      without either BIT_0 or BIT_4 becoming set. */
  }
}

xEventGroupSetBits()
[事件组 API]

event_groups.h

 EventBits_t xEventGroupSetBits( EventGroupHandle_t xEventGroup,
                                 const EventBits_t uxBitsToSet );

在 RTOS 事件组中设置位（标志）。无法从中断调用此函数。 xEventGroupSetBitsFromISR() 是可从中断调用的版本。

在事件组中设置位将自动解除所有等待位的任务的阻塞态。

RTOS 源文件 FreeRTOS/source/event_groups.c 必须包含在构建中，xEventGroupSetBits() 函数才可用。

参数：

xEventGroup	要设置位的事件组。该必须已通过通过调用 xEventGroupCreate() 创建。
uxBitsToSet	指定要在事件组中设置的一个或多个位的按位值。例如，将 uxBitsToSet 设置为 0x08，可仅设置位 3。将 uxBitsToSet 设置为 0x09，可设置位 3 和位 0。

Returns:

调用 xEventGroupSetBits() 返回时事件组的值。

返回值可能会清除 uxBitsToSet 参数指定的位，有如下两个原因：

如果设置某个位导致正在等待该位的任务解除阻塞态，则可能该位已被自动清除（请参阅 xEventGroupWaitBits() 的 xClearBitOnExit 参数）。
将执行任何处于阻塞态（或就绪态）且优先级高于调用 xEventGroupSetBits() 的任务，并可能在调用 xEventGroupSetBits() 返回之前更改事件组值。

用法示例：

#define BIT_0	( 1 << 0 )
#define BIT_4	( 1 << 4 )

void aFunction( EventGroupHandle_t xEventGroup )
{
EventBits_t uxBits;

  /* Set bit 0 and bit 4 in xEventGroup. */
  uxBits = xEventGroupSetBits(
                              xEventGroup,    /* The event group being updated. */
                              BIT_0 | BIT_4 );/* The bits being set. */

  if( ( uxBits & ( BIT_0 | BIT_4 ) ) == ( BIT_0 | BIT_4 ) )
  {
      /* Both bit 0 and bit 4 remained set when the function returned. */
  }
  else if( ( uxBits & BIT_0 ) != 0 )
  {
      /* Bit 0 remained set when the function returned, but bit 4 was
      cleared.  It might be that bit 4 was cleared automatically as a
      task that was waiting for bit 4 was removed from the Blocked
      state. */
  }
  else if( ( uxBits & BIT_4 ) != 0 )
  {
      /* Bit 4 remained set when the function returned, but bit 0 was
      cleared.  It might be that bit 0 was cleared automatically as a
      task that was waiting for bit 0 was removed from the Blocked
      state. */
  }
  else
  {
      /* Neither bit 0 nor bit 4 remained set.  It might be that a task
      was waiting for both of the bits to be set, and the bits were cleared
      as the task left the Blocked state. */
  }
}

xEventGroupSetBitsFromISR()
[事件组 API]

event_groups.h

 BaseType_t xEventGroupSetBitsFromISR(
                          EventGroupHandle_t xEventGroup,
                          const EventBits_t uxBitsToSet,
                          BaseType_t *pxHigherPriorityTaskWoken );

在RTOS 事件组中设置位（标志）。可以从中断服务程序 (ISR) 调用的 xEventGroupSetBits() 版本。

在事件组中设置位将自动解除所有等待位的任务的阻塞状态。

在事件组中设置位不是确定性操作，因为可能有未知数量的任务正在等待设置一个或多个位。 FreeRTOS 不允许在中断或临界区中执行不确定的操作。因此， xEventGroupSetBitFromISR() 会向 RTOS 守护进程任务发送一条消息，从而在守护进程任务的上下文中执行设置操作，其中使用的是调度器锁而非临界区。

注意： 如上文所述，从中断服务程序中设置位会将设置操作推迟到 RTOS 守护进程任务（也叫定时器服务任务）。 RTOS守护进程任务与其他RTOS任务一样，都是根据优先级进行调度的。因此，如果置位操作必须立即完成（在应用程序创建的任务执行之前），那么RTOS守护进程任务的优先级必须要高于其他使用事件组的任务。 RTOS守护进程任务的优先级由configTIMER_TASK_PRIORITY 在FreeRTOSConfig.h中定义。

INCLUDE_xEventGroupSetBitFromISR, configUSE_TIMERS 和INCLUDE_xTimerPendFunctionCall 必须在FreeRTOSConfig.h中全部设置为1，才能使用xEventGroupSetBitsFromISR() 函数。

RTOS源文件 FreeRTOS/source/event_groups.c 必须包含在构建中，才能使用xEventGroupSetBitsFromISR()函数。

参数：

xEventGroup	要设置位的事件组。该必须已通过通过调用 xEventGroupCreate() 创建。
uxBitsToSet	指定要设置的一个或多个位的按位值。例如，要设置位3，便将uxBitsToSet设置为0x08。将 uxBitsToSet 设置位3和位0，便将uxBitsToSet设置为0x09。
pxHigherPriorityTaskWoken	如上所述，调用此函数将意味着给RTOS守护进程任务发送一条消息。如果守护进程任务的优先级高于当前正在运行的任务（中断中断的任务），那么xEventGroupSetBitsFromISR()会将pxHigherPriorityTaskWoken设置为pdTRUE，指示应在中断退出之前请求上下文切换。因此必须将 pxHigherPriorityTaskWoken 初始化为 pdFALSE。请参阅下面的代码示例。

Returns:

如果消息已发送到RTOS守护进程任务，则返回pdPASS，否则将返回pdFAIL。如果计时器服务队列已满，则将返回pdFAIL 。

用法示例：

#define BIT_0    ( 1 << 0 )
#define BIT_4    ( 1 << 4 )

/* An event group which it is assumed has already been created by a call to
xEventGroupCreate(). */
EventGroupHandle_t xEventGroup;

void anInterruptHandler( void )
{
BaseType_t xHigherPriorityTaskWoken, xResult;

  /* xHigherPriorityTaskWoken must be initialised to pdFALSE. */
  xHigherPriorityTaskWoken = pdFALSE;

  /* Set bit 0 and bit 4 in xEventGroup. */
  xResult = xEventGroupSetBitsFromISR(
                              xEventGroup,   /* The event group being updated. */
                              BIT_0 | BIT_4, /* The bits being set. */
                              &xHigherPriorityTaskWoken );

  /* Was the message posted successfully? */
  if( xResult != pdFAIL )
  {
      /* If xHigherPriorityTaskWoken is now set to pdTRUE then a context
      switch should be requested.  The macro used is port specific and will
      be either portYIELD_FROM_ISR() or portEND_SWITCHING_ISR() - refer to
      the documentation page for the port being used. */
      portYIELD_FROM_ISR( xHigherPriorityTaskWoken );
  }
}

xEventGroupClearBits()
[事件组 API]

event_groups.h

 EventBits_t xEventGroupClearBits(
                                 EventGroupHandle_t xEventGroup,
                                 const EventBits_t uxBitsToClear );

清除 RTOS 事件组中的位（标志）。无法从中断调用此函数。有关可从中断调用的版本，请参阅 xEventGroupClearBitsFromISR() 。

RTOS 源文件 FreeRTOS/source/event_groups.c 必须包含在 xEventGroupClearBits() 函数可用的构建中。

参数：

xEventGroup	要在其中清除位的事件组。此事件组必须已通过调用 xEventGroupCreate() 事先创建。
uxBitsToClear	表示要在事件组中清除一个或多个位的按位值。例如，将 uxBitsToClear 设置为 0x08 以仅清除位 3。将 uxBitsToClear 设置为 0x09 以清除位 3 和位 0。

Returns:

清除指定位之前的事件组的值。

用法示例：

#define BIT_0	( 1 << 0 )
#define BIT_4	( 1 << 4 )

void aFunction( EventGroupHandle_t xEventGroup )
{
EventBits_t uxBits;

  /* Clear bit 0 and bit 4 in xEventGroup. */
  uxBits = xEventGroupClearBits(
                                xEventGroup,  /* The event group being updated. */
                                BIT_0 | BIT_4 );/* The bits being cleared. */

  if( ( uxBits & ( BIT_0 | BIT_4 ) ) == ( BIT_0 | BIT_4 ) )
  {
      /* Both bit 0 and bit 4 were set before xEventGroupClearBits()
      was called.  Both will now be clear (not set). */
  }
  else if( ( uxBits & BIT_0 ) != 0 )
  {
      /* Bit 0 was set before xEventGroupClearBits() was called.  It will
      now be clear. */
  }
  else if( ( uxBits & BIT_4 ) != 0 )
  {
      /* Bit 4 was set before xEventGroupClearBits() was called.  It will
      now be clear. */
  }
  else
  {
      /* Neither bit 0 nor bit 4 were set in the first place. */
  }
}

xEventGroupClearBitsFromISR()
[事件组 API]

event_groups.h

 BaseType_t xEventGroupClearBitsFromISR(
                                EventGroupHandle_t xEventGroup,
                                const EventBits_t uxBitsToClear );

可以从中断调用的 xEventGroupClearBits() 版本。清除操作被延迟为 RTOS 守护进程任务，也称为定时器服务任务。守护进程任务的优先级由 configTIMER_TASK_PRIORITY FreeRTOSConfig.h 中的设置来设定。

要使 xEventGroupClearBitsFromISR() 函数可用，RTOS 源文件 FreeRTOS/source/event_groups.c 必须包含在构建中。

参数：

xEventGroup	要在其中清除位的事件组。此事件组必须已通过调用 xEventGroupCreate() 事先创建。
uxBitsToClear	表示要在事件组中清除一个或多个位的按位值。例如，将 uxBitsToClear 设置为 0x08 以仅清除位 3。将 uxBitsToClear 设置为 0x09 以清除位 3 和位 0。

Returns:

如果操作已成功延迟为 RTOS 守护进程任务，则返回 pdPASS。否则返回 pdFALSE。只有当定时器命令队列已满时，才会返回 pdFALSE。

用法示例：

#define BIT_0	( 1 << 0 )
#define BIT_4	( 1 << 4 )

/* This code assumes the event group referenced by the
xEventGroup variable has already been created using a call to
xEventGroupCreate(). */
void anInterruptHandler( void )
{
BaseType_t xSuccess;

  /* Clear bit 0 and bit 4 in xEventGroup. */
  xSuccess = xEventGroupClearBitsFromISR(
                                xEventGroup, /* The event group being updated. */
                                BIT_0 | BIT_4 );/* The bits being cleared. */

  if( xSuccess == pdPASS )
  {
      /* The command was sent to the daemon task. */
  }
  else
  {
      /* The clear bits command was not sent to the daemon task. */
  }
}

xEventGroupGetBits()
[事件组 API]

event_groups.h

 EventBits_t xEventGroupGetBits( EventGroupHandle_t xEventGroup );

返回RTOS 事件组中事件位（事件标志）的当前值。不能从中断使用此函数。可以在中断中使用的版本请参阅xEventGroupGetBitsFromISR() 。

RTOS源文件 FreeRTOS/source/event_groups.c 必须包含在构建中，才能使用xEventGroupGetBits()函数。

参数：

xEventGroup

正在查询的事件组。该必须已通过 xEventGroupCreate()创建的。

Returns:

调用xEventGroupGetBits()时，事件组中的事件组中事件位的值。

xEventGroupGetBitsFromISR()
[事件组 API]

event_groups.h

 EventBits_t xEventGroupGetBitsFromISR(
                               EventGroupHandle_t xEventGroup );

可从中断调用的 xEventGroupGetBits() 的版本。

RTOS 源文件 FreeRTOS/source/event_groups.c 必须包含在构建中，xEventGroupGetBitsFrom() 函数才可使用。

参数：

xEventGroup

正在查询的事件组。该必须已通过通过调用 xEventGroupCreate() 创建。

Returns:

调用 XEventGroupGetBitsFromISR() 时，事件组中事件位的值。

xEventGroupSync()
[事件组 API]

event_groups.h

 EventBits_t xEventGroupSync( EventGroupHandle_t xEventGroup,
                              const EventBits_t uxBitsToSet,
                              const EventBits_t uxBitsToWaitFor,
                              TickType_t xTicksToWait );

以原子方式设置RTOS 事件组中的位（标志），然后等待在同一事件组中设置位的组合。此功能通常用于同步多个任务（通常称为任务集合），其中每个任务必须等待其他任务到达同步点才能继续。

不能从中断使用此函数。

如果设置了 uxBitsToWait 参数指定的位，或者在该时间内设置了这些位，则该函数将在其阻塞时间到期之前返回。在这种情况下，uxBitsToWait 指定的所有位将在函数返回之前自动清除。

RTOS源文件 FreeRTOS/source/event_groups.c 必须包含在构建中，确保 xEventGroupSync（）函数可用。

参数：

xEventGroup	设置和测试位的事件组。必须必须已通过通过调用 xEventGroupCreate() 创建。
uxBitsToSet	在确定（且可能等待）uxBitsToWait参数指定的所有位设置完成之前，要设置事件组中的一个或多个位。例如，将uxBitsToSet设置为0x04 即可设置事件组中的位2。
uxBitsToWaitFor	指定事件组中要测试的一个或多个事件位的按位值。例如，如果要等待位0和位2被设置，则将uxBitsToWaitFor设置为0x05。如果要等待位0、位1和位2被设置，则将uxBitsToWaitFor设置为0x07 等等。
xTicksToWait	等待uxBitsToWaitFor参数值指定的所有位设置完成的最长时间（以“ticks”表示）。

Returns:

等待置位时或阻塞到期时事件组的值。测试返回值以便了解设置了哪些位。

如果xEventGroupSync()由于超时而返回，则不会设置所有等待位。

如果 xEventGroupSync()因其所等待的所有位都被设置而返回，那么返回值是自动清除任何位之前的事件组值。

用法示例：

/* Bits used by the three tasks. */
#define TASK_0_BIT        ( 1 << 0 )
#define TASK_1_BIT        ( 1 << 1 )
#define TASK_2_BIT        ( 1 << 2 )

#define ALL_SYNC_BITS ( TASK_0_BIT | TASK_1_BIT | TASK_2_BIT )

/* Use an event group to synchronise three tasks.  It is assumed this event
group has already been created elsewhere. */
EventGroupHandle_t xEventBits;

void vTask0( void *pvParameters )
{
EventBits_t uxReturn;
TickType_t xTicksToWait = 100 / portTICK_PERIOD_MS;

    for( ;; )
    {
        /* Perform task functionality here. */
        . . .

        /* Set bit 0 in the event group to note this task has reached the
        sync point.  The other two tasks will set the other two bits defined
        by ALL_SYNC_BITS.  All three tasks have reached the synchronisation
        point when all the ALL_SYNC_BITS are set.  Wait a maximum of 100ms
        for this to happen. */
        uxReturn = xEventGroupSync( xEventBits,
                                    TASK_0_BIT,
                                    ALL_SYNC_BITS,
                                    xTicksToWait );

        if( ( uxReturn & ALL_SYNC_BITS ) == ALL_SYNC_BITS )
        {
            /* All three tasks reached the synchronisation point before the call
            to xEventGroupSync() timed out. */
        }
    }
}

void vTask1( void *pvParameters )
{
    for( ;; )
    {
        /* Perform task functionality here. */
        . . .

        /* Set bit 1 in the event group to note this task has reached the
        synchronisation point.  The other two tasks will set the other two
        bits defined by ALL_SYNC_BITS.  All three tasks have reached the
        synchronisation point when all the ALL_SYNC_BITS are set.  Wait
        indefinitely for this to happen. */
        xEventGroupSync( xEventBits, TASK_1_BIT, ALL_SYNC_BITS, portMAX_DELAY );

        /* xEventGroupSync() was called with an indefinite block time, so
        this task will only reach here if the syncrhonisation was made by all
        three tasks, so there is no need to test the return value. */
    }
}

void vTask2( void *pvParameters )
{
    for( ;; )
    {
        /* Perform task functionality here. */
        . . .

        /* Set bit 2 in the event group to note this task has reached the
        synchronisation point.  The other two tasks will set the other two
        bits defined by ALL_SYNC_BITS.  All three tasks have reached the
        synchronisation point when all the ALL_SYNC_BITS are set.  Wait
        indefinitely for this to happen. */
        xEventGroupSync( xEventBits, TASK_2_BIT, ALL_SYNC_BITS, portMAX_DELAY );

        /* xEventGroupSync() was called with an indefinite block time, so
        this task will only reach here if the syncrhonisation was made by all
        three tasks, so there is no need to test the return value. */
    }
}