Keil RTX5 消息队列:传指针还是直接拷贝数据?
数据小陈
结论
在给定约束下,把数据直接复制进消息队列对象并不违反通用最佳实践,反而更稳妥。传指针并不是绝对的最佳实践,只有在所有权清晰、生命周期可控,并且确实需要避免拷贝或消息很大时,才更合适。
原因
- 队列按值保存固定大小的消息时,
osMessageQueuePut会把消息内容复制到队列存储。Put成功后,发送方可以复用原缓冲区,接收方Get到的是独立副本。这样正好满足“消息在传输到外部设备前不得被修改”的约束。 - 内存已经预留,速度又不敏感,拷贝成本可以接受。用这点拷贝换来简单性和隔离性,是划算的。
- 指针方案的风险不在指针本身,而在所有权:悬空指针、缓冲区被复用、栈变量地址逃逸、释放时序错误、接收方处理前发送方又改数据,这些情况都需要额外协议兜底。
sender_thread的内存和线程安全,关键是把“谁拥有消息、什么时候可以修改、什么时候可以释放”说清楚,而不是一上来就选传指针。
实现步骤
- 定义固定大小的消息结构体,队列元素就是该结构体本身。
- 用
osMessageQueueNew指定队列深度和元素大小,并预留静态队列存储。 - 发送方调用
osMessageQueuePut,传入结构体地址。按照 CMSIS-RTOS2/Keil RTX5 的队列语义,队列元素会按值复制。 - 发送成功后,发送方不再依赖这条消息的内容;
sender_thread用osMessageQueueGet取到副本,再转发给外部设备。 - 如果消息很大,改用固定大小的内存池并转移所有权,不要直接传裸指针。
代码示例
#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 调用限制。
备注:内容仅供参考。
