PAYATHON 2026

Keil RTX5 消息队列:传指针还是直接拷贝数据?

数据小陈

结论

在给定约束下,把数据直接复制进消息队列对象并不违反通用最佳实践,反而更稳妥。传指针并不是绝对的最佳实践,只有在所有权清晰、生命周期可控,并且确实需要避免拷贝或消息很大时,才更合适。

原因

  • 队列按值保存固定大小的消息时,osMessageQueuePut 会把消息内容复制到队列存储。Put 成功后,发送方可以复用原缓冲区,接收方 Get 到的是独立副本。这样正好满足“消息在传输到外部设备前不得被修改”的约束。
  • 内存已经预留,速度又不敏感,拷贝成本可以接受。用这点拷贝换来简单性和隔离性,是划算的。
  • 指针方案的风险不在指针本身,而在所有权:悬空指针、缓冲区被复用、栈变量地址逃逸、释放时序错误、接收方处理前发送方又改数据,这些情况都需要额外协议兜底。
  • sender_thread 的内存和线程安全,关键是把“谁拥有消息、什么时候可以修改、什么时候可以释放”说清楚,而不是一上来就选传指针。

实现步骤

  1. 定义固定大小的消息结构体,队列元素就是该结构体本身。
  2. 用 osMessageQueueNew 指定队列深度和元素大小,并预留静态队列存储。
  3. 发送方调用 osMessageQueuePut,传入结构体地址。按照 CMSIS-RTOS2/Keil RTX5 的队列语义,队列元素会按值复制。
  4. 发送成功后,发送方不再依赖这条消息的内容;sender_thread 用 osMessageQueueGet 取到副本,再转发给外部设备。
  5. 如果消息很大,改用固定大小的内存池并转移所有权,不要直接传裸指针。

代码示例

#define SENDER_QUEUE_DEPTH 8U

typedef struct {
    uint8_t cmd;
    uint16_t len;
    uint8_t payload[64];
} app_msg_t;

static app_msg_t sender_queue_mem[SENDER_QUEUE_DEPTH];
static osMessageQueueId_t sender_queue;

static const osMessageQueueAttr_t sender_queue_attr = {
    .mq_mem = sender_queue_mem,
    .mq_size = sizeof(sender_queue_mem)
};

bool sender_queue_init(void)
{
    sender_queue = osMessageQueueNew(SENDER_QUEUE_DEPTH,
                                     sizeof(app_msg_t),
                                     &sender_queue_attr);
    return sender_queue != NULL;
}

bool send_to_sender(const app_msg_t *msg, uint32_t timeout)
{
    if (msg == NULL) {
        return false;
    }

    return osMessageQueuePut(sender_queue, msg, 0U, timeout) == osOK;
}

void sender_thread(void *argument)
{
    app_msg_t msg;

    (void)argument;

    for (;;) {
        if (osMessageQueueGet(sender_queue, &msg, NULL, osWaitForever) == osOK) {
            transfer_to_external_device(&msg);
        }
    }
}

上面的代码有一个前提:队列元素是 app_msg_t,osMessageQueuePut 复制的是 sizeof(app_msg_t) 字节。transfer_to_external_device 需要用户按外部设备协议实现。

如果必须传指针

如果消息体很大、有零拷贝要求,或者受硬件 DMA 约束,必须传指针,至少要做好下面几件事:

  • 指针只能指向静态缓冲区、固定内存池,或生命周期明确的堆块,不能指向发送线程栈上的临时变量。
  • 接收方确认处理完成之前,发送方不得修改或释放该缓冲区。
  • 接收方 Get 到指针后,先复制到自己的私有缓冲区,再归还池块或发出确认。
  • 用引用计数、确认队列或池块所有权状态管理生命周期。
  • 队列满、超时和错误路径要处理清楚,避免消息丢失或重复释放。

注意事项

  • “队列会复制元素”这一结论,以所用 Keil RTX5/CMSIS-RTOS2 版本以及队列元素为值类型为前提。如果队列元素本身就是指针,RTX5 复制的是指针值,不是指针指向的数据。
  • 队列深度和元素大小要匹配。结构体尽量保持固定大小,避免在队列里传变长数据。
  • 发送到外部设备前消息不可变,这一点用值拷贝最容易保证。
  • 在中断里使用队列 API 时,要用对应版本,并遵守 RTOS 的 ISR 调用限制。

备注:内容仅供参考。