本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
# 任务间协调
本部分包含了有关 FreeRTOS 基元的信息。
**Topics**
+ [队列](#inter-task-queues)
+ [信号灯和互斥对象](#inter-task-semaphones)
+ [“直接到任务”通知](#direct-task-notifications)
+ [流缓冲区](#rtos-stream-buffer)
+ [消息缓冲区](#rtos-message-buffer)
## 队列
队列是任务间通信的主要方式。可用于在任务之间以及中断与任务之间发送消息。大多数情况下，队列用作线程安全先进先出 (FIFO) 缓冲区，新数据将发送到队列的后面。（数据也可以发送到队列的前面。） 消息通过队列以复制方式发送，这意味着是将数据（可能是指向更大缓冲区的指针）本身复制到队列中，而不只是存储对数据的引用。
队列 API 允许指定阻止时间。如果任务尝试读取空队列，则该任务将置为“被阻止”状态，直到队列中有可用数据，或者阻止时间结束。处于“被阻止”状态的任务不会占用任何 CPU 时间，以便其他任务运行。同样，如果任务尝试写入已满队列，则该任务将置为“被阻止”状态，直到队列中有可用空间，或者阻止时间结束。如果对同一队列阻止了多个任务，则具有最高优先级的任务将首先取消阻止。
在许多常见的设计场景中，其他 FreeRTOS 基元（如“直接到任务”通知以及流和消息缓冲区）可作为队列的轻型替代方案。
## 信号灯和互斥对象
FreeRTOS 内核提供了二元信号灯、计数信号灯和互斥对象，以用于相互排斥和同步的情况。
二元信号灯只能有两个值。如果要在任务之间或任务与中断之间实施同步，二元信号灯是不错的选择。计数信号灯可以有两个以上的值。该信号灯允许多个任务共享资源或执行更复杂的同步操作。
互斥对象是包括优先级继承机制的二元信号灯。这意味着，如果高优先级任务在尝试获取当前由较低优先级任务所持有的互斥对象时遭到阻止，则持有令牌的任务的优先级将临时提升至被阻止任务的优先级。此机制旨在确保较高优先级任务尽可能在最短时间内处于“被阻止”状态，从而最大程度地减少优先级反转的发生。
## “直接到任务”通知
通过任务通知，任务可以与其他任务进行交互，并与中断服务例程 (ISR) 同步，且无需单独的通信对象（如信号灯）。每个 RTOS 任务都有一个 32 位通知值，用于存储通知的内容（如果有）。RTOS 任务通知即直接发送给任务的事件，可以取消阻止接收的任务，以及有选择地更新所接收任务的通知值。
RTOS 任务通知可用作二元信号灯、计数信号灯和队列（在某些情况下）的更快速的轻型替代方案。相比于可用于执行同等功能的其他 FreeRTOS 基元，任务通知在速度和 RAM 开销两方面均具有优势。但是，任务通知只能用在事件接收方只能是一个任务的情况下。
## 流缓冲区
通过流缓冲区，可以将字节流从中断服务例程传递到任务，或者从一个任务传递到另一个。字节流可以是任意长度，且并不一定具有开头或结尾。可以一次写入任意数量的字节，也可以一次读取任意数量的字节。可通过将 `stream_buffer.c` 源文件包含在项目中来启用流缓冲区功能。
流缓冲区假定只有一个任务或中断写入缓冲区（即写入器），并且只从缓冲区读取一个任务或中断（即读取器）。写入器和读取器是不同的任务或中断服务例程才安全，具有多个写入器或读取器是不安全的。
流缓冲区实施采用的是“直接到任务”通知。因此，流缓冲区 API 将调用的任务置于“被阻止”状态，调用该 API 可以改变该调用任务的通知状态和通知值。
### 发送数据
`xStreamBufferSend()` 用于将数据发送到任务的流缓冲区。`xStreamBufferSendFromISR()` 用于将数据发送到中断服务例程 (ISR) 的流缓冲区。
`xStreamBufferSend()` 允许指定阻止时间。如果在调用 `xStreamBufferSend()` 时，将非零阻止时间写入流缓冲区且缓冲区已满，则任务将置为“被阻止”状态，直到有可用空间或者阻止时间结束。
`sbSEND_COMPLETED()` 和 `sbSEND_COMPLETED_FROM_ISR()` 是将数据写入流缓冲区时调用的宏（由 FreeRTOS API 在内部调用）。它采用更新的流缓冲区的句柄。这两个宏会查看流缓冲区中是否有被阻止的任务等待数据，如果有，会从“被阻止”状态中删除该任务。
您可以在 `sbSEND_COMPLETED()` 中提供自己的 [`FreeRTOSConfig.h`](freertos-config.md) 实施，以更改此默认行为。如果利用流缓冲区在多核处理器的核心之间传递数据，该功能很有用。在此情况下，可以执行 `sbSEND_COMPLETED()` 在另一个 CPU 核心中生成中断，然后该中断的服务例程可以使用 `xStreamBufferSendCompletedFromISR()` API 进行检查，如有必要则取消阻止等待数据的任务。
### 接收数据
`xStreamBufferReceive()` 用于从任务的流缓冲区读取数据。`xStreamBufferReceiveFromISR()` 用于从中断服务例程 (ISR) 的流缓冲区读取数据。
`xStreamBufferReceive()` 允许指定阻止时间。如果在调用 `xStreamBufferReceive()` 时，从流缓冲区读取非零阻止时间但缓冲区为空，则任务将置为“被阻止”状态，直到流缓冲区中有可用的指定数据量，或者阻止时间结束。
在取消阻止任务之前流缓冲区中必须具备的数据量，称为流缓冲区的触发级别。如果被阻止的任务触发级别为 10，则当至少 10 字节写入缓冲区或者任务的阻止时间结束时，将取消阻止该任务。如果读取任务尚未达到触发级别但其阻止时间已经到期，则该任务将接收写入缓冲区的任何数据。任务的触发级别必须设置为介于 1 与流缓冲区大小之间的值。流缓冲区的触发级别在调用 `xStreamBufferCreate()` 时设置。可以通过调用 `xStreamBufferSetTriggerLevel()` 进行更改。
`sbRECEIVE_COMPLETED()` 和 `sbRECEIVE_COMPLETED_FROM_ISR()` 是从流缓冲区读取数据时调用的宏（由 FreeRTOS API 内部调用）。宏会查看流缓冲区中是否有被阻止的任务等待缓冲区中有可用空间，如果有，它们会从“被阻止”状态中删除该任务。您可以在 `sbRECEIVE_COMPLETED()` 中提供其他实施来更改 [`FreeRTOSConfig.h`](freertos-config.md) 的默认行为。
## 消息缓冲区
通过消息缓冲区，可以将可变长度的离散消息从中断服务例程传递到任务，或者从一个任务传递到另一个。例如，可以将长度为 10、20 和 123 字节的消息写入消息缓冲区，或者从同一消息缓冲区中读取这些消息。10 字节的消息只能以 10 字节消息而不是单独字节的形式读取。消息缓冲区构建在流缓冲区实施之上。您可以通过将 `stream_buffer.c` 源文件包含在项目中来启用消息缓冲区功能。
消息缓冲区假定只有一个任务或中断写入缓冲区（即写入器），并且只从缓冲区读取一个任务或中断（即读取器）。写入器和读取器是不同的任务或中断服务例程才安全，具有多个写入器或读取器是不安全的。
消息缓冲区实施采用的是“直接到任务”通知。因此，流缓冲区 API 将调用的任务置于“被阻止”状态，调用该 API 可以改变该调用任务的通知状态和通知值。
要启用消息缓冲区来处理可变大小的消息，应先将每条消息的长度写入消息缓冲区，然后再写入消息本身。长度存储在类型为 `size_t` 的变量中，在 32 字节架构上通常为 4 字节。因此，将一条 10 字节消息写入消息缓冲区时，实际占用的缓冲区空间为 14 字节。同样，将一条 100 字节消息写入消息缓冲区时，实际使用的缓冲区空间为 104 字节。
### 发送数据
`xMessageBufferSend()` 用于将数据从任务发送到消息缓冲区。`xMessageBufferSendFromISR()` 用于将数据从中断服务例程 (ISR) 发送到消息缓冲区。
`xMessageBufferSend()` 允许指定阻止时间。如果在调用 `xMessageBufferSend()` 时，将非零阻止时间写入消息缓冲区且缓冲区已满，则任务将置为“被阻止”状态，直到消息缓冲区中有可用空间，或者阻止时间结束。
`sbSEND_COMPLETED()` 和 `sbSEND_COMPLETED_FROM_ISR()` 是将数据写入流缓冲区时调用的宏（由 FreeRTOS API 在内部调用）。宏采用单个参数，即更新的流缓冲区的句柄。这两个宏会查看流缓冲区中是否有被阻止的任务等待数据，如果有，会从“被阻止”状态中删除该任务。
您可以在 `sbSEND_COMPLETED()` 中提供自己的 [`FreeRTOSConfig.h`](freertos-config.md) 实施，以更改此默认行为。如果利用流缓冲区在多核处理器的核心之间传递数据，该功能很有用。在此情况下，可以执行 `sbSEND_COMPLETED()` 在另一个 CPU 核心中生成中断，然后该中断的服务例程可以使用 `xStreamBufferSendCompletedFromISR()` API 进行检查，如有必要则取消阻止等待数据的任务。
### 接收数据
`xMessageBufferReceive()` 用于将数据从消息缓冲区读取到任务中。`xMessageBufferReceiveFromISR()` 用于将数据从消息缓冲区读取到中断服务例程 (ISR) 中。`xMessageBufferReceive()` 允许指定阻止时间。如果在调用 `xMessageBufferReceive()` 时，从消息缓冲区读取非零阻止时间但缓冲区为空，则任务将置为“被阻止”状态，直到有可用数据或者阻止时间结束。
`sbRECEIVE_COMPLETED()` 和 `sbRECEIVE_COMPLETED_FROM_ISR()` 是从流缓冲区读取数据时调用的宏（由 FreeRTOS API 内部调用）。宏会查看流缓冲区中是否有被阻止的任务等待缓冲区中有可用空间，如果有，它们会从“被阻止”状态中删除该任务。您可以在 `sbRECEIVE_COMPLETED()` 中提供其他实施来更改 [`FreeRTOSConfig.h`](freertos-config.md) 的默认行为。