ESP32双核下FreeRTOS任务看门狗TWDT误触发排查:从任务饥饿到优先级反转
1. 问题现象与背景
在ESP32双核(Core 0 和 Core 1)上运行FreeRTOS时,任务看门狗(Task Watchdog Timer, TWDT)用于监控任务是否长时间未运行。常见误触发表现为:系统随机重启,串口打印 Task watchdog got triggered 并列出被监控任务。尤其在高负载或复杂同步场景下,TWDT可能因任务饥饿或优先级反转而误报。
2. TWDT工作原理
- TWDT默认监控空闲任务(IDLE)和用户添加的任务。
- 每个被监控任务需定期调用
esp_task_wdt_reset()喂狗。 - 若任务在超时时间内未运行(未喂狗),TWDT触发panic或打印警告。
- 双核下,每个核心独立运行调度器,TWDT可分别监控两个核心的任务。
3. 任务饥饿与优先级反转
3.1 任务饥饿
高优先级任务持续占用CPU,低优先级任务(包括被监控任务)无法获得运行机会,导致无法喂狗。例如:
- 高优先级任务陷入死循环或长时间忙等。
- 中断频繁触发,任务调度被延迟。
3.2 优先级反转
低优先级任务持有互斥量,高优先级任务等待该互斥量而阻塞,中优先级任务抢占CPU,导致低优先级任务无法释放互斥量,高优先级任务长期阻塞,进而影响依赖它的喂狗任务。
4. 排查步骤与配置
4.1 启用TWDT调试信息
在 menuconfig 中设置:
-
Component config -> ESP System Settings -> Task Watchdog Timer使能。 - 开启
Print debug information以获取触发时的任务状态。
4.2 添加被监控任务
#include "esp_task_wdt.h"
void monitored_task(void *pvParameters) {
esp_task_wdt_add(NULL); // 添加当前任务到TWDT
while (1) {
// 业务逻辑
esp_task_wdt_reset(); // 喂狗
vTaskDelay(pdMS_TO_TICKS(100));
}
}
4.3 使用优先级继承互斥量
创建互斥量时使用 xSemaphoreCreateMutex() 自动启用优先级继承,避免优先级反转。
4.4 监控任务状态
触发TWDT时,利用 esp_task_wdt_print_triggered_tasks() 打印各任务状态(需开启调试)。
5. 完整示例:模拟优先级反转与解决
以下代码模拟优先级反转导致TWDT误触发,并通过优先级继承修复。
#include <stdio.h>
#include "freertos/FreeRTOS.h"
#include "freertos/task.h"
#include "freertos/semphr.h"
#include "esp_task_wdt.h"
SemaphoreHandle_t mutex;
void low_prio_task(void *pv) {
esp_task_wdt_add(NULL);
while (1) {
xSemaphoreTake(mutex, portMAX_DELAY);
// 模拟长时间持有互斥量
vTaskDelay(pdMS_TO_TICKS(500));
xSemaphoreGive(mutex);
esp_task_wdt_reset();
vTaskDelay(pdMS_TO_TICKS(100));
}
}
void mid_prio_task(void *pv) {
while (1) {
// 忙等,占用CPU
for (volatile int i = 0; i < 1000000; i++);
vTaskDelay(pdMS_TO_TICKS(10));
}
}
void high_prio_task(void *pv) {
esp_task_wdt_add(NULL);
while (1) {
xSemaphoreTake(mutex, portMAX_DELAY);
// 临界区
xSemaphoreGive(mutex);
esp_task_wdt_reset();
vTaskDelay(pdMS_TO_TICKS(200));
}
}
void app_main() {
// 创建互斥量(默认启用优先级继承)
mutex = xSemaphoreCreateMutex();
xTaskCreatePinnedToCore(low_prio_task, "low", 2048, NULL, 1, NULL, 0);
xTaskCreatePinnedToCore(mid_prio_task, "mid", 2048, NULL, 2, NULL, 0);
xTaskCreatePinnedToCore(high_prio_task, "high", 2048, NULL, 3, NULL, 0);
// 配置TWDT超时5秒
esp_task_wdt_init(5, true);
}
现象:高优先级任务等待互斥量时被中优先级任务抢占,低优先级任务无法运行释放互斥量,高优先级任务长期阻塞,无法喂狗,TWDT触发。
解决:使用 xSemaphoreCreateMutex() 已启用优先级继承,低优先级任务继承高优先级,避免被中优先级抢占。若仍不足,可调整任务优先级或使用 xSemaphoreCreateRecursiveMutex()。
6. 注意事项
- 避免在中断中调用喂狗函数,TWDT只监控任务。
- 喂狗间隔应小于TWDT超时时间,建议留有余量。
- 双核下注意任务绑定核心,避免跨核竞争导致饥饿。
- 使用
esp_task_wdt_status()检查任务是否已添加。 - 调试时开启
CONFIG_ESP_TASK_WDT_CHECK_IDLE_TASK_CPU0/1以监控空闲任务。 - 优先级反转也可通过设计避免:缩短临界区、使用消息队列替代共享资源。
通过以上方法,可有效定位并解决ESP32双核下TWDT误触发问题,提升系统鲁棒性。
暂无评论,来抢沙发~