Arduino FreeRTOS：xTaskCreate传递结构体参数后数据异常问题

问题根源 #

你在setup函数中定义的sRED、sYELLOW、sGREEN是局部变量，存储在栈内存中。当setup执行完毕后，栈空间会被系统回收并可能被后续操作覆盖。而xTaskCreate传递的是这些局部变量的地址，任务运行时访问这个地址会读到随机的垃圾数据（也就是你看到的0、1283这类异常值）。

解决方案 #

方案1：使用全局结构体变量 #

将结构体定义为全局变量，这样内存不会随setup结束而被回收，任务能持续访问到正确的数据：

#include <Arduino_FreeRTOS.h>

#define RED_PIN 6
#define YELLOW_PIN 7
#define GREEN_PIN 8

typedef struct LED_struct{
  int sPIN;
  int sDELAY;
} sLEDS;

// 全局结构体变量，内存长期有效
sLEDS sRED = {RED_PIN, 500};
sLEDS sYELLOW = {YELLOW_PIN, 200};
sLEDS sGREEN = {GREEN_PIN, 1000};

bool debug_flag = true;

void setup() {
  Serial.begin(9600);

  Serial.println("SETUP: ");
  Serial.println(sRED.sPIN);
  Serial.println(sRED.sDELAY);
  Serial.println(sYELLOW.sPIN);
  Serial.println(sYELLOW.sDELAY);
  Serial.println(sGREEN.sPIN);
  Serial.println(sGREEN.sDELAY);

  // 任务名称区分开，方便调试
  xTaskCreate(toggle_LED, "Toggle RED LED", 128, &sRED, 1, NULL);
  xTaskCreate(toggle_LED, "Toggle YELLOW LED", 128, &sYELLOW, 1, NULL);
  xTaskCreate(toggle_LED, "Toggle GREEN LED", 128, &sGREEN, 1, NULL);
}

void toggle_LED(struct LED_struct *xStruct){
  // 仅初始化当前任务负责的引脚，无需重复初始化所有引脚
  pinMode(xStruct->sPIN, OUTPUT);

  while(1){
    if (debug_flag == true) {
      Serial.println("DEBUG: ");
      Serial.print("PIN: ");
      Serial.println(xStruct->sPIN);
      Serial.print("DELAY: ");
      Serial.println(xStruct->sDELAY);
    }

    digitalWrite(xStruct->sPIN, HIGH);
    // 用FreeRTOS的vTaskDelay替代Arduino delay，避免阻塞整个系统
    vTaskDelay(pdMS_TO_TICKS(250));
    digitalWrite(xStruct->sPIN, LOW);
    vTaskDelay(pdMS_TO_TICKS(xStruct->sDELAY));
  }
}

void loop() {
}

方案2：动态分配内存（适合结构体数量不确定的场景） #

使用FreeRTOS提供的pvPortMalloc分配堆内存，复制结构体数据，确保内存不会被回收：

#include <Arduino_FreeRTOS.h>

#define RED_PIN 6
#define YELLOW_PIN 7
#define GREEN_PIN 8

typedef struct LED_struct{
  int sPIN;
  int sDELAY;
} sLEDS;

bool debug_flag = true;

void setup() {
  Serial.begin(9600);

  // 动态分配内存并初始化结构体
  sLEDS *sRED = (sLEDS*)pvPortMalloc(sizeof(sLEDS));
  sRED->sPIN = RED_PIN;
  sRED->sDELAY = 500;

  sLEDS *sYELLOW = (sLEDS*)pvPortMalloc(sizeof(sLEDS));
  sYELLOW->sPIN = YELLOW_PIN;
  sYELLOW->sDELAY = 200;

  sLEDS *sGREEN = (sLEDS*)pvPortMalloc(sizeof(sLEDS));
  sGREEN->sPIN = GREEN_PIN;
  sGREEN->sDELAY = 1000;

  Serial.println("SETUP: ");
  Serial.println(sRED->sPIN);
  Serial.println(sRED->sDELAY);
  Serial.println(sYELLOW->sPIN);
  Serial.println(sYELLOW->sDELAY);
  Serial.println(sGREEN->sPIN);
  Serial.println(sGREEN->sDELAY);

  xTaskCreate(toggle_LED, "Toggle RED LED", 128, sRED, 1, NULL);
  xTaskCreate(toggle_LED, "Toggle YELLOW LED", 128, sYELLOW, 1, NULL);
  xTaskCreate(toggle_LED, "Toggle GREEN LED", 128, sGREEN, 1, NULL);
}

void toggle_LED(struct LED_struct *xStruct){
  pinMode(xStruct->sPIN, OUTPUT);

  while(1){
    if (debug_flag == true) {
      Serial.println("DEBUG: ");
      Serial.print("PIN: ");
      Serial.println(xStruct->sPIN);
      Serial.print("DELAY: ");
      Serial.println(xStruct->sDELAY);
    }

    digitalWrite(xStruct->sPIN, HIGH);
    vTaskDelay(pdMS_TO_TICKS(250));
    digitalWrite(xStruct->sPIN, LOW);
    vTaskDelay(pdMS_TO_TICKS(xStruct->sDELAY));
  }
  // 若任务会主动退出，需在此处释放内存：vPortFree(xStruct);
}

void loop() {
}

额外优化建议 #

• 任务名称尽量唯一，便于FreeRTOS调试工具识别
• 避免在任务循环中重复执行pinMode这类初始化操作，仅需执行一次
• 优先使用vTaskDelay替代Arduino原生delay，前者会让出CPU给其他任务，更符合多任务系统设计逻辑

内容的提问来源于stack exchange，提问作者Alexander Jönsson