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误触发问题,提升系统鲁棒性。