FreeRTOS队列的使用技巧：传递指针

特性	传递完整数据（拷贝）	传递指针
操作本质	队列将数据完整复制进出内部存储区。	队列仅复制你提供的指针变量（一个地址值）本身。
内存开销	队列内部占用 = 项大小 x 队列长度。较大数据会消耗可观内存。	队列内部占用很小（仅一个指针的大小 x 队列长度）。数据本身在外部。
时间开销	数据入队和出队时均有拷贝开销，数据越大越慢。	效率极高，只有指针拷贝，与数据体大小无关。
安全性	高。数据完全独立，发送方和接收方操作各自副本，互不干扰。	低。双方操作的是同一块内存，需要严格同步，否则会引发数据竞争、野指针等问题。
复杂性	低，由队列自动管理。	高，开发者需自行管理内存分配与释放时机。

1.2 安全传递指针的关键步骤与模式

要实现安全传递，关键在于建立一套 “生产者-消费者”内存管理协议。

1.2.1 模式一：动态分配（最常见，也最需谨慎）

发送方分配内存，接收方使用后释放。必须确保“谁申请，谁释放”的原则在逻辑链上得到延续。

// 1. 发送方任务：分配内存并发送指针
typedef struct {
    int sensor_id;
    float value;
} Data_t;

void vSenderTask(void *pvParameters) {
    Data_t *pxData = pvPortMalloc(sizeof(Data_t)); // 动态申请
    if(pxData != NULL) {
        pxData->sensor_id = 1;
        pxData->value = read_sensor();
        // 将指针（&pxData）的地址传入队列，即传递 Data_t*
        if(xQueueSend(xQueue, &pxData, portMAX_DELAY) != pdPASS) {
            vPortFree(pxData); // 发送失败，立即释放，避免内存泄漏
        }
    }
    // 注意：发送成功后，发送方绝不能再使用或释放pxData！
}

// 2. 接收方任务：接收指针，使用后释放
void vReceiverTask(void *pvParameters) {
    Data_t *pxReceivedData;
    while(1) {
        if(xQueueReceive(xQueue, &pxReceivedData, portMAX_DELAY)) {
            process_data(pxReceivedData);
            vPortFree(pxReceivedData); // 关键：使用完毕后释放内存
            pxReceivedData = NULL; // 防止误用
        }
    }
}

1.2.2 模式二：静态内存池（确定性高，无碎片）

预分配一个全局数组或缓冲区池，用队列管理其“空闲索引”或“使用权”。

// 1. 定义静态内存池
#define POOL_SIZE 10
Data_t xDataPool[POOL_SIZE];
QueueHandle_t xFreePoolQueue; // 管理空闲池索引

// 2. 初始化：将所有空闲索引（0~9）放入队列
void init_memory_pool() {
    xFreePoolQueue = xQueueCreate(POOL_SIZE, sizeof(int));
    for(int i = 0; i < POOL_SIZE; i++) {
        xQueueSend(xFreePoolQueue, &i, 0);
    }
}

// 3. 发送方：获取空闲块，填充数据，发送数据指针
void vSenderTask(void *pvParameters) {
    int freeIndex;
    if(xQueueReceive(xFreePoolQueue, &freeIndex, portMAX_DELAY)) { // 等待空闲块
        Data_t *pxData = &xDataPool[freeIndex];
        pxData->value = read_sensor();
        // 发送的是指向静态池中某个元素的指针
        xQueueSend(xDataQueue, &pxData, portMAX_DELAY);
    }
}

// 4. 接收方：处理数据后，将块索引归还给空闲队列
void vReceiverTask(void *pvParameters) {
    Data_t *pxReceivedData;
    int usedIndex;
    while(1) {
        if(xQueueReceive(xDataQueue, &pxReceivedData, portMAX_DELAY)) {
            process_data(pxReceivedData);
            // 计算索引并归还
            usedIndex = pxReceivedData - xDataPool; // 指针减运算得到索引
            xQueueSend(xFreePoolQueue, &usedIndex, 0);
        }
    }
}

1.2.3 模式三：环形缓冲区（专用，高效）

在单生产者-单消费者场景下，一个全局的环形缓冲区配合队列传递“写入位置”或“读取通知”是最优解。

1.3 核心对比表

特性	队列 (Queue)	信号量 (Semaphore)	事件组 (Event Group)
核心本质	数据管道	资源计数器或同步信号	多事件标志位集合
传递内容	任意数据的拷贝（结构体、指针等）	无数据，仅有一个计数值	无数据，仅有一个位图（每位一个事件标志）
通信关系	典型多对多（一个队列可由多个任务读写）	典型一对多（一个信号量被多个任务获取/释放）	多对多（任意任务可设置/等待任意位）
阻塞机制	发送（队满）和接收（队空）均可独立阻塞	获取（计数为0）时可阻塞；释放不阻塞	等待（指定位模式）时可阻塞；设置不阻塞
主要用途	传输数据流、传递结构化消息	资源管理、任务同步、临界区保护	多事件等待、复杂状态同步

2 应用总结

2.1 致命陷阱与最佳实践

1） 绝对禁止传递局部变量指针

函数栈上的变量在退出后即失效，传递其指针会导致接收方读取到垃圾数据或引发崩溃。

// 错误示例！指针指向即将失效的栈内存。
Data_t data;
Data_t *ptr = &data;
xQueueSend(xQueue, &ptr, 0); // 致命错误！

2） 中断服务程序（ISR）中的使用

在ISR中发送指针时，必须使用 xQueueSendFromISR，并确保分配的内存是ISR安全的（如静态或动态分配的，但动态分配需确保线程安全）。

3) 所有权必须清晰且单向

指针从发送方传递到队列，再被接收方取出后，发送方即丧失所有权，绝不应再访问或释放该内存。接收方成为唯一所有者，负责最终释放。

4) 考虑使用互斥量保护共享内存本身

如果数据在传递后仍需被多方（如发送方日志任务）只读访问，则需用互斥量保护，但设计会变得复杂。通常应避免。

5) 为指针队列启用深度复制检查

创建队列时，项大小应为 sizeof(void*)。发送和接收的都是指针变量的地址。

2.2 总结和建议

场景	推荐方式	理由
数据小、结构简单	直接传递结构体	安全，省心，性能足够。
数据大、传递频繁、性能关键	传递指针 + 严格内存管理	效率极高，但需精心设计。
确定性要求高、避免碎片	指针 + 静态内存池/环形缓冲区	行为可预测，适合硬实时系统。
新手或复杂度高的项目	优先使用直接拷贝	安全性远高于性能收益。