嵌入式 Linux 与 RTOS / 系统课时

用流缓冲传输连续字节

用流缓冲传输连续字节

Stream Buffer 适合把串口、采样或协议解析前的连续字节从一个任务交给另一个任务。它不保存“每次发送”的边界,而是把数据并入同一条字节流;触发级别只控制接收任务何时被唤醒,不保证每次恰好收到固定字节数。

学习目标

  • 使用 Stream Buffer 建立单写者、单读者的连续字节通道
  • 正确理解容量、触发级别和 xStreamBufferReceive() 返回长度之间的关系
  • 根据突发流量和接收任务处理速度判断缓冲区是否会被写满

连续字节为什么不用队列逐项传

Queue 以固定大小的“项”为单位复制数据,适合命令、事件或结构体;Stream Buffer 以字节为单位存储,发送端一次可以写任意长度,接收端也可以按自己的缓冲大小取走当前可用字节。多次发送的内容会首尾相接,因此它更接近串口 RX、TCP 字节流或连续采样数据。

Stream Buffer 单写者单读者与触发级别

触发级别是“唤醒阈值”,不是“读取长度”。例如触发级别设为 16 字节,接收任务阻塞期间先到 10 字节不会被唤醒;随后又到 10 字节时通常会被唤醒,但这次读取可能得到当前可用的 20 字节,而不是强制只返回 16 字节。

创建并收发字节流

下面是片段示例:把它放进已经完成 FreeRTOS 堆、时钟和调度器初始化的工程,并在启动调度器前调用 vStartStreamBufferDemo()。示例不依赖板级外设,接收任务只累计收到的字节数,便于观察通信语义。

c
#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);
}

预期结果

text
生产任务每 50 ms 写入 10B。
接收任务等待期间,累计到 10B 时仍阻塞;累计达到至少 16B 后被唤醒。
每次 xStreamBufferReceive() 最多返回接收数组可容纳的 32B,具体数量不保证等于触发级别。
uxReceivedTotal 会随着接收任务持续取走字节而增加。

如果从 ISR 写入,应改用 xStreamBufferSendFromISR();不要在 ISR 中调用普通任务版 API。

容量和触发级别怎么定

容量解决的是“生产突发能不能被吸收”,触发级别解决的是“接收任务多频繁被唤醒”。容量过小,生产者在接收任务来不及处理时会阻塞或出现部分写入;触发级别过低,任务切换频繁;触发级别过高,则增加首批数据的等待延迟。

可以从最坏情况估算:先找接收任务最长可能得不到 CPU 的时间,再估计这段时间生产者最多会写入多少字节,并给缓冲容量留出余量。触发级别通常按“值得唤醒一次去处理的最小批量”设置,而不是照搬缓冲容量。

判断是否真的适合 Stream Buffer

连续字节、无需保留发送边界、希望降低逐字节排队开销时,Stream Buffer 很合适。若接收端必须知道“这一帧到哪里结束”,不要额外猜边界;应改用 Message Buffer,或让上层协议自己携带并解析长度字段。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

用流缓冲传输连续字节

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通