嵌入式 Linux 与 RTOS / 系统课时
用流缓冲传输连续字节
用流缓冲传输连续字节
Stream Buffer 适合把串口、采样或协议解析前的连续字节从一个任务交给另一个任务。它不保存“每次发送”的边界,而是把数据并入同一条字节流;触发级别只控制接收任务何时被唤醒,不保证每次恰好收到固定字节数。
学习目标
- 使用 Stream Buffer 建立单写者、单读者的连续字节通道
- 正确理解容量、触发级别和
xStreamBufferReceive()返回长度之间的关系 - 根据突发流量和接收任务处理速度判断缓冲区是否会被写满
连续字节为什么不用队列逐项传
Queue 以固定大小的“项”为单位复制数据,适合命令、事件或结构体;Stream Buffer 以字节为单位存储,发送端一次可以写任意长度,接收端也可以按自己的缓冲大小取走当前可用字节。多次发送的内容会首尾相接,因此它更接近串口 RX、TCP 字节流或连续采样数据。

触发级别是“唤醒阈值”,不是“读取长度”。例如触发级别设为 16 字节,接收任务阻塞期间先到 10 字节不会被唤醒;随后又到 10 字节时通常会被唤醒,但这次读取可能得到当前可用的 20 字节,而不是强制只返回 16 字节。
创建并收发字节流
下面是片段示例:把它放进已经完成 FreeRTOS 堆、时钟和调度器初始化的工程,并在启动调度器前调用 vStartStreamBufferDemo()。示例不依赖板级外设,接收任务只累计收到的字节数,便于观察通信语义。
#include <stdint.h>
#include "FreeRTOS.h"
#include "task.h"
#include "stream_buffer.h"
static StreamBufferHandle_t xByteStream;
static volatile size_t uxReceivedTotal;
static void vProducerTask(void *pvParameters)
{
static const uint8_t ucChunk[10] =
{ 'A', 'B', 'C', 'D', 'E', 'F', 'G', 'H', 'I', 'J' };
for (;;) {
size_t xOffset = 0;
/* 处理超时导致的部分写入,直到当前 10B 数据全部进入流缓冲。 */
while (xOffset < sizeof(ucChunk)) {
xOffset += xStreamBufferSend(
xByteStream,
ucChunk + xOffset,
sizeof(ucChunk) - xOffset,
pdMS_TO_TICKS(100));
}
vTaskDelay(pdMS_TO_TICKS(50));
}
}
static void vConsumerTask(void *pvParameters)
{
uint8_t ucReceive[32];
for (;;) {
/* trigger=16 只决定何时解除阻塞,实际返回长度取决于当时可用字节。 */
size_t xCount = xStreamBufferReceive(
xByteStream, ucReceive, sizeof(ucReceive), portMAX_DELAY);
uxReceivedTotal += xCount;
}
}
void vStartStreamBufferDemo(void)
{
xByteStream = xStreamBufferCreate(64, 16);
configASSERT(xByteStream != NULL);
configASSERT(xTaskCreate(vProducerTask, "tx", 256, NULL, 2, NULL) == pdPASS);
configASSERT(xTaskCreate(vConsumerTask, "rx", 256, NULL, 2, NULL) == pdPASS);
}预期结果
生产任务每 50 ms 写入 10B。
接收任务等待期间,累计到 10B 时仍阻塞;累计达到至少 16B 后被唤醒。
每次 xStreamBufferReceive() 最多返回接收数组可容纳的 32B,具体数量不保证等于触发级别。
uxReceivedTotal 会随着接收任务持续取走字节而增加。如果从 ISR 写入,应改用 xStreamBufferSendFromISR();不要在 ISR 中调用普通任务版 API。
容量和触发级别怎么定
容量解决的是“生产突发能不能被吸收”,触发级别解决的是“接收任务多频繁被唤醒”。容量过小,生产者在接收任务来不及处理时会阻塞或出现部分写入;触发级别过低,任务切换频繁;触发级别过高,则增加首批数据的等待延迟。
可以从最坏情况估算:先找接收任务最长可能得不到 CPU 的时间,再估计这段时间生产者最多会写入多少字节,并给缓冲容量留出余量。触发级别通常按“值得唤醒一次去处理的最小批量”设置,而不是照搬缓冲容量。
判断是否真的适合 Stream Buffer
连续字节、无需保留发送边界、希望降低逐字节排队开销时,Stream Buffer 很合适。若接收端必须知道“这一帧到哪里结束”,不要额外猜边界;应改用 Message Buffer,或让上层协议自己携带并解析长度字段。