ESP32-S2编程：如何将数据加入队列并在串口监视器输出

核心实现步骤（新手参考） #

1. 统一数据封装 #

用结构体+联合体兼容多任务产生的不同类型数据，避免类型混乱：

// 定义通用队列数据结构
typedef struct {
    int type; // 数据类型标记：1=传感器数值，2=系统状态码，3=文本消息
    union {
        float sensor;
        int status;
        char text[32];
    } content;
} QueueItem;

2. 初始化队列 #

必须在任务创建前完成队列初始化，指定队列长度和单数据项大小：

QueueHandle_t data_queue;

void setup() {
    Serial.begin(115200);
    // 创建队列：最多存10个数据项，每个项大小为QueueItem的字节数
    data_queue = xQueueCreate(10, sizeof(QueueItem));
    if (data_queue == NULL) {
        Serial.println("队列创建失败，内存不足");
        while(1);
    }

    // 创建多任务
    xTaskCreate(sensorTask, "SensorTask", 2048, NULL, 1, NULL);
    xTaskCreate(statusTask, "StatusTask", 2048, NULL, 1, NULL);
    xTaskCreate(printTask, "PrintTask", 2048, NULL, 2, NULL);
}

3. 任务发送数据到队列 #

每个任务生成数据后，通过xQueueSend()发送，可设置阻塞超时：

void sensorTask(void *param) {
    QueueItem item;
    item.type = 1;
    while(1) {
        item.content.sensor = analogRead(A0) * (3.3 / 4095.0); // 模拟传感器读数
        // 阻塞100ms等待队列空间
        if (xQueueSend(data_queue, &item, pdMS_TO_TICKS(100)) != pdPASS) {
            Serial.println("传感器数据发送失败：队列已满");
        }
        vTaskDelay(pdMS_TO_TICKS(500));
    }
}

void statusTask(void *param) {
    QueueItem item;
    item.type = 2;
    int count = 0;
    while(1) {
        item.content.status = count++;
        xQueueSend(data_queue, &item, pdMS_TO_TICKS(100));
        vTaskDelay(pdMS_TO_TICKS(1000));
    }
}

4. 专用任务读取队列并输出串口 #

只在一个任务中操作串口，避免多任务竞争导致输出异常：

void printTask(void *param) {
    QueueItem item;
    while(1) {
        // 永久阻塞等待队列数据
        if (xQueueReceive(data_queue, &item, portMAX_DELAY) == pdPASS) {
            switch(item.type) {
                case 1:
                    Serial.printf("[传感器数据] %.2f V\n", item.content.sensor);
                    break;
                case 2:
                    Serial.printf("[系统状态] 运行计数：%d\n", item.content.status);
                    break;
                case 3:
                    Serial.printf("[文本消息] %s\n", item.content.text);
                    break;
                default:
                    Serial.println("[未知数据] 类型错误");
            }
        }
    }
}

void loop() {
    // 空闲任务，无需操作
    vTaskDelete(NULL);
}

常见错误及修正 #

• 队列未初始化/初始化参数错误
  修正：检查xQueueCreate()返回值是否为NULL，确保单数据项大小与实际数据类型的字节数一致（比如用sizeof(QueueItem)而不是固定数值）。
• 多任务发送不同类型裸数据
  修正：必须用统一结构体封装数据，直接发送不同类型数据会导致内存解析错误，用type字段标记数据类型后再解析输出。
• 多任务直接操作串口
  修正：串口是共享资源，多任务同时调用Serial.print()会导致输出乱码，仅在专用打印任务中操作串口。
• 忽略发送/接收返回值
  修正：通过xQueueSend()/xQueueReceive()的返回值判断是否成功，便于调试队列满、空等异常情况。

请提供你的当前代码，我可以帮你定位具体问题并给出针对性修正。

内容的提问来源于stack exchange，提问作者explorer