908-FreeRTOS202212‐xTaskNotifyWait() 与 xTaskNotifyWaitIndexed（）

FreeRTOS 任务通知机制-xTaskNotifyWait() 和 xTaskNotifyWaitIndexed() FreeRTOS 作为一个功能强大且广泛使用的实时操作系统，它提供了多种机制来实现任务之间的同步和通信。其中，任务通知机制是 FreeRTOS 中的一种重要机制，允许任务之间相互通知和等待。今天，我们将详细介绍 xTaskNotifyWait() 和 xTaskNotifyWaitIndexed() 两个函数，它们是 FreeRTOS 任务通知机制的核心组件。 xTaskNotifyWait() 函数 xTaskNotifyWait() 函数用于实现任务通知机制，允许任务等待其他任务的通知。该函数的原型如下所示： #define xTaskNotifyWait( ulBitsToClearOnEntry, ulBitsToClearOnExit, pulNotificationValue, xTicksToWait ) 该函数的参数列表： * ulBitsToClearOnEntry：指定在等待前需要清零的任务通知值比特位。 * ulBitsToClearOnExit：指定在成功等待后需要清零的任务通知值比特位。 * pulNotificationValue：指定要获取的通知值（队列消息或者事件组）。 * xTicksToWait：指定阻塞状态下等待接收通知的最长时间。 xTaskNotifyWait() 函数的实现机制是通过 xTaskGenericNotifyWait() 函数来实现的，后者是一个通用的任务通知等待函数。 xTaskNotifyWaitIndexed() 函数 xTaskNotifyWaitIndexed() 函数也是用于实现任务通知机制的，允许任务等待其他任务的通知。该函数的原型如下所示： #define xTaskNotifyWaitIndexed( uxIndexToWaitOn, ulBitsToClearOnEntry, ulBitsToClearOnExit, pulNotificationValue, xTicksToWait ) 该函数的参数列表和 xTaskNotifyWait() 函数相同，只是多了一个 uxIndexToWaitOn 参数，该参数指定了任务通知数组的索引值。 xTaskGenericNotifyWait() 函数 xTaskGenericNotifyWait() 函数是 FreeRTOS 任务通知机制的核心组件，它提供了通用的任务通知等待机制。该函数的原型如下所示： BaseType_t xTaskGenericNotifyWait( UBaseType_t uxIndexToWait, uint32_t ulBitsToClearOnEntry, uint32_t ulBitsToClearOnExit, uint32_t *pulNotificationValue, TickType_t xTicksToWait ) 该函数的参数列表和 xTaskNotifyWait() 函数相同。 xTaskGenericNotifyWait() 函数的实现机制是通过数组越界检测和任务状态检测来实现的。当任务调用 xTaskGenericNotifyWait() 函数时，FreeRTOS 首先进行数组越界检测，确保索引值 uxIndexToWait 在合法范围内，然后进入临界区，检查任务状态是否等待接收通知。如果不等待接收通知，则任务需要进入阻塞态，直到超时或接收到通知。 xTaskNotifyWait() 和 xTaskNotifyWaitIndexed() 函数是 FreeRTOS 任务通知机制的核心组件，提供了任务之间的同步和通信机制。它们的实现机制基于 xTaskGenericNotifyWait() 函数，该函数提供了通用的任务通知等待机制。