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。
暂无评论,来抢沙发~