嵌入式 Linux 与 RTOS / 系统课时
用消息缓冲传递变长帧
用消息缓冲传递变长帧
Message Buffer 用于在一个写者和一个读者之间传递变长消息,并保留每次发送的边界。接收端一次只取出一条完整消息,因此很适合协议帧、命令包和日志记录;代价是每条消息会占用额外长度字段,容量不足时整条消息不能写入。
学习目标
- 使用 Message Buffer 发送和接收不同长度的数据帧
- 计算消息长度开销,并处理发送失败和接收缓冲区过小
- 判断 Message Buffer 与 Stream Buffer、Queue 的适用边界
消息边界是它的核心价值
Stream Buffer 会把多次发送拼成连续字节流;Message Buffer 则为每条消息记录长度,使接收端能一次得到完整帧。FreeRTOS 为每条消息额外占用 sizeof(size_t) 字节保存长度,因此 128 字节的 Message Buffer 并不等于能同时容纳 128 字节的有效载荷。

这意味着容量评估要按“消息总占用”计算:每条消息的有效载荷之外,还要加一份长度开销。如果当前剩余空间放不下一整条消息,xMessageBufferSend() 不会只写半条消息;在等待时间耗尽后返回 0。
发送三种不同长度的帧
下面是片段示例:放入已经能启动 FreeRTOS 调度器的工程,并在启动调度器前调用 vStartMessageBufferDemo()。示例把三种不同长度的帧循环发送,接收任务用 16 字节数组保证能容纳示例中的最大帧。
#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);
}预期结果
接收端按发送顺序得到完整的 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 名称,而是通信数据有没有边界、是否需要多方并发,以及缓冲区满时业务允许怎样退化。