嵌入式 Linux 与 RTOS / 系统课时

用消息缓冲传递变长帧

用消息缓冲传递变长帧

Message Buffer 用于在一个写者和一个读者之间传递变长消息,并保留每次发送的边界。接收端一次只取出一条完整消息,因此很适合协议帧、命令包和日志记录;代价是每条消息会占用额外长度字段,容量不足时整条消息不能写入。

学习目标

  • 使用 Message Buffer 发送和接收不同长度的数据帧
  • 计算消息长度开销,并处理发送失败和接收缓冲区过小
  • 判断 Message Buffer 与 Stream Buffer、Queue 的适用边界

消息边界是它的核心价值

Stream Buffer 会把多次发送拼成连续字节流;Message Buffer 则为每条消息记录长度,使接收端能一次得到完整帧。FreeRTOS 为每条消息额外占用 sizeof(size_t) 字节保存长度,因此 128 字节的 Message Buffer 并不等于能同时容纳 128 字节的有效载荷。

Message Buffer 保留变长帧边界

这意味着容量评估要按“消息总占用”计算:每条消息的有效载荷之外,还要加一份长度开销。如果当前剩余空间放不下一整条消息,xMessageBufferSend() 不会只写半条消息;在等待时间耗尽后返回 0。

发送三种不同长度的帧

下面是片段示例:放入已经能启动 FreeRTOS 调度器的工程,并在启动调度器前调用 vStartMessageBufferDemo()。示例把三种不同长度的帧循环发送,接收任务用 16 字节数组保证能容纳示例中的最大帧。

c
#include <stdint.h>
#include "FreeRTOS.h"
#include "task.h"
#include "message_buffer.h"

typedef struct
{
    size_t xLength;
    uint8_t ucData[8];
} DemoFrame;

static MessageBufferHandle_t xMessageBuffer;
static volatile size_t uxLastFrameLength;
static volatile uint32_t ulSendFailures;

static const DemoFrame xFrames[] = {
    { 3, { 0xA1, 0x01, 0x7E } },
    { 6, { 0xB2, 0x10, 0x11, 0x12, 0x13, 0x7E } },
    { 8, { 0xC3, 0x20, 0x21, 0x22, 0x23, 0x24, 0x25, 0x7E } }
};

static void vFrameProducer(void *pvParameters)
{
    size_t xIndex = 0;

    for (;;) {
        const DemoFrame *pxFrame = &xFrames[xIndex];

        /* Message Buffer 要么写入整条消息,要么在超时后返回 0。 */
        size_t xSent = xMessageBufferSend(
            xMessageBuffer,
            pxFrame->ucData,
            pxFrame->xLength,
            pdMS_TO_TICKS(100));

        if (xSent == 0) {
            ulSendFailures++;
        }

        xIndex = (xIndex + 1) % (sizeof(xFrames) / sizeof(xFrames[0]));
        vTaskDelay(pdMS_TO_TICKS(20));
    }
}

static void vFrameConsumer(void *pvParameters)
{
    uint8_t ucFrame[16];

    for (;;) {
        /* 每次只取出一条完整消息,不会把下一条消息拼进来。 */
        size_t xReceived = xMessageBufferReceive(
            xMessageBuffer, ucFrame, sizeof(ucFrame), portMAX_DELAY);

        if (xReceived > 0) {
            uxLastFrameLength = xReceived;
        }
    }
}

void vStartMessageBufferDemo(void)
{
    xMessageBuffer = xMessageBufferCreate(128);
    configASSERT(xMessageBuffer != NULL);

    configASSERT(xTaskCreate(vFrameProducer, "msg-tx", 256, NULL, 2, NULL) == pdPASS);
    configASSERT(xTaskCreate(vFrameConsumer, "msg-rx", 256, NULL, 2, NULL) == pdPASS);
}

预期结果

text
接收端按发送顺序得到完整的 3B、6B、8B 消息,然后循环重复。
一次 xMessageBufferReceive() 不会返回“3B 消息 + 下一条消息的一部分”。
正常调度且 128B 缓冲足够时,ulSendFailures 通常保持为 0。
uxLastFrameLength 只会记录示例消息长度 3、6 或 8。

从 ISR 发送或接收时,应使用 xMessageBufferSendFromISR() 和 xMessageBufferReceiveFromISR()。

两类容量不足要分开处理

发送侧空间不足时,如果在 xTicksToWait 内始终腾不出容纳“整条消息”的空间,xMessageBufferSend() 返回 0。此时要根据业务决定重试、丢弃、覆盖上层缓存,还是提高消费者优先级,不能把 0 当成“已发送部分数据”。

接收侧如果提供的目标数组小于下一条消息,xMessageBufferReceive() 也返回 0,并且该消息仍留在缓冲区中。若随后仍用同样大小的数组接收,就会反复失败。因此接收缓冲区应至少覆盖协议允许的最大帧,或先在协议设计层给最大消息长度设硬上限。

什么时候选 Message Buffer

需要保留变长消息边界时选 Message Buffer;只关心连续字节时选 Stream Buffer;消息元素大小固定、存在多生产者或多消费者,或者希望队列本身承担并发仲裁时,Queue 通常更合适。选择的关键不是 API 名称,而是通信数据有没有边界、是否需要多方并发,以及缓冲区满时业务允许怎样退化。

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

目录与阅读设置

阅读设置

17

记录一个想法

用消息缓冲传递变长帧

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

登录哪都通