ESP32双核下Arduino loop与FreeRTOS任务混用时看门狗复位的排查路径

一、问题现象与背景

在ESP32上使用Arduino框架时,loop()函数默认运行在Core 1的loopTask中。开发者常同时创建FreeRTOS任务处理网络、传感器等逻辑。典型复位现象:串口打印Task watchdog got triggered或Interrupt wdt timeout on CPU0/1,随后系统重启。

ESP32有两个看门狗:

  • 任务看门狗(TWDT):监控指定任务是否定期喂狗,默认监控loopTask和IDLE任务。
  • 中断看门狗(IWDT):监控中断是否长时间关闭,默认超时300ms。

混用场景下,常见根因是:高优先级任务长期占用CPU导致低优先级任务(含IDLE)无法喂狗;或在临界区/中断中长时间阻塞。

二、五步排查路径

步骤1:确认复位类型

通过esp_reset_reason()获取复位原因,区分是TWDT、IWDT还是其他。

#include "esp_system.h"

void setup() {
  Serial.begin(115200);
  esp_reset_reason_t reason = esp_reset_reason();
  Serial.printf("Reset reason: %d\n", reason);
  // ESP_RST_TASK_WDT = 5, ESP_RST_INT_WDT = 6
}

若为ESP_RST_TASK_WDT,重点查任务阻塞;若为ESP_RST_INT_WDT,查中断关闭时长。

步骤2:检查任务阻塞点

TWDT默认监控loopTask(优先级1)和IDLE任务(优先级0)。若你创建的任务优先级高于1且不阻塞,loopTask和IDLE永远得不到CPU,看门狗必复位。

错误示例:

void highPrioTask(void *pvParameters) {
  while(1) {
    // 无vTaskDelay,死循环占用CPU
    doSomething();
  }
}

void setup() {
  xTaskCreatePinnedToCore(highPrioTask, "high", 4096, NULL, 3, NULL, 1);
}

修正:在循环内加入vTaskDelay(pdMS_TO_TICKS(10))或使用阻塞式API(如xQueueReceive带超时)。

步骤3:分析优先级与核心绑定

  • 确保至少有一个任务优先级不高于1,或显式为loopTask喂狗。
  • 使用xTaskCreatePinnedToCore明确核心,避免任务在Core0与Core1间迁移导致缓存/中断问题。
  • 若任务必须高优先级长时间运行,调用esp_task_wdt_reset()手动喂狗(需先订阅)。
// 订阅当前任务到TWDT并手动喂狗
esp_task_wdt_add(NULL);
while(1) {
  criticalWork();
  esp_task_wdt_reset();
  vTaskDelay(1); // 仍建议让出CPU
}

步骤4:验证喂狗策略

Arduino默认已为loopTask订阅TWDT。若你修改了loopTask优先级或将其挂起,需重新配置。可通过esp_task_wdt_status()查询订阅状态。

注意:不要在中断中调用esp_task_wdt_reset(),该函数非中断安全。

步骤5:优化堆栈与中断

  • 任务堆栈过小导致溢出,可能破坏看门狗数据结构,表现为随机复位。用uxTaskGetStackHighWaterMark()检查余量,建议至少留1KB。
  • 中断服务程序(ISR)中避免长时间关中断,IWDT超时默认300ms,可用portENTER_CRITICAL替代noInterrupts()并缩短临界区。

三、完整代码示例:安全的双核任务设计

#include <Arduino.h>
#include "esp_task_wdt.h"

TaskHandle_t sensorTaskHandle = NULL;

// 传感器任务:优先级2,绑定Core0,带阻塞延时
void sensorTask(void *pvParameters) {
  esp_task_wdt_add(NULL); // 订阅到TWDT
  for(;;) {
    int val = analogRead(34);
    Serial.printf("Sensor: %d\n", val);
    esp_task_wdt_reset(); // 手动喂狗
    vTaskDelay(pdMS_TO_TICKS(100)); // 必须让出CPU
  }
}

void setup() {
  Serial.begin(115200);
  esp_reset_reason_t r = esp_reset_reason();
  Serial.printf("Reset reason: %d\n", r);

  // 创建任务绑定Core0,优先级2
  xTaskCreatePinnedToCore(sensorTask, "sensor", 4096, NULL, 2, &sensorTaskHandle, 0);
}

void loop() {
  // loopTask运行在Core1,优先级1,默认已订阅TWDT
  // 此处不要长时间阻塞,否则TWDT复位
  delay(10);
}

四、注意事项与避坑清单

  • 不要禁用TWDT:esp_task_wdt_deinit()虽可临时规避,但会掩盖真实问题。
  • 优先级反转:高优先级任务等待低优先级任务持有的互斥量时,使用xSemaphoreCreateMutex()并设置优先级继承。
  • Core0的IDLE任务:WiFi/BT协议栈运行在Core0,若Core0的IDLE被饿死,也会触发TWDT。确保Core0上有阻塞点。
  • 串口打印阻塞:Serial.printf在缓冲区满时可能阻塞,高优先级任务中避免大量打印。
  • 使用vTaskDelayUntil:周期性任务用此API保证固定周期,避免累积延迟导致喂狗不及时。

通过以上五步排查,可系统性地定位ESP32双核下看门狗复位根因。核心原则:任何任务都不能无限占用CPU,必须让出时间片给IDLE和loopTask。