ESP32双核下FreeRTOS任务看门狗与中断延迟的联合调优实战

一、问题背景与耦合机理

ESP32双核(PRO_CPU与APP_CPU)运行FreeRTOS时,任务看门狗(TWDT)默认监控IDLE任务,若高优先级任务长期占用CPU或中断关闭时间过长,IDLE无法喂狗,触发TWDT复位。同时,中断延迟(从硬件中断触发到ISR执行)会因临界区、高优先级任务抢占而增大。二者相互影响:

  • 中断延迟过大 → 高频中断堆积,ISR执行时间变长,挤占IDLE任务,导致TWDT超时。
  • 喂狗策略不当 → 在中断或高优先级任务中喂狗,掩盖了真实阻塞,使延迟问题恶化。

联合调优的核心是:保证IDLE任务有合理执行窗口,同时将中断延迟控制在百微秒级。

二、关键配置与原理

2.1 任务看门狗(TWDT)

  • 默认监控IDLE任务,超时时间5秒(CONFIG_ESP_TASK_WDT_TIMEOUT_S)。
  • 可添加自定义任务监控:esp_task_wdt_add(NULL)。
  • 喂狗:esp_task_wdt_reset()。
  • 原则:只在确定任务健康时喂狗,避免在ISR中喂狗。

2.2 中断延迟来源

  • 临界区(portENTER_CRITICAL)关闭中断。
  • 高优先级任务抢占(FreeRTOS默认抢占式调度)。
  • ISR中调用非FromISR API导致阻塞。

2.3 双核任务分配

  • PRO_CPU:处理WiFi/蓝牙协议栈及高实时性中断。
  • APP_CPU:运行应用任务,将耗时任务绑定到APP_CPU,避免干扰PRO_CPU的IDLE。

三、联合调优步骤

步骤1:测量基线

使用esp_timer或GPIO翻转测量中断延迟与任务执行时间。示例:

// 在ISR入口翻转GPIO,用逻辑分析仪测量延迟
gpio_set_level(GPIO_NUM_4, 1);
// ISR处理...
gpio_set_level(GPIO_NUM_4, 0);

步骤2:优化中断处理

  • ISR只做最小工作(置标志、发队列),耗时处理放入任务。
  • 使用IRAM_ATTR将ISR放入IRAM,避免Flash缓存缺失导致延迟。
  • 避免在ISR中调用printf等阻塞函数。
void IRAM_ATTR gpio_isr_handler(void *arg) {
    BaseType_t xHigherPriorityTaskWoken = pdFALSE;
    uint32_t gpio_num = (uint32_t)arg;
    xQueueSendFromISR(gpio_evt_queue, &gpio_num, &xHigherPriorityTaskWoken);
    if (xHigherPriorityTaskWoken) portYIELD_FROM_ISR();
}

步骤3:任务优先级与核绑定

  • 将高频中断处理任务优先级设为中高(如10),绑定到APP_CPU。
  • 确保每个核上至少有一个低优先级任务(如IDLE)能运行。
xTaskCreatePinnedToCore(high_freq_task, "high_freq", 4096, NULL, 10, NULL, 1);
xTaskCreatePinnedToCore(low_prio_task, "low_prio", 2048, NULL, 1, NULL, 0);

步骤4:喂狗策略

  • 为关键任务添加TWDT监控,在任务循环中喂狗。
  • 使用独立低优先级任务定期检查各任务心跳,而非在ISR中喂狗。
void high_freq_task(void *pvParameters) {
    esp_task_wdt_add(NULL);
    while (1) {
        // 处理队列数据
        process_data();
        esp_task_wdt_reset();
        vTaskDelay(pdMS_TO_TICKS(10));
    }
}

步骤5:调整TWDT超时与IDLE钩子

  • 适当增大TWDT超时(如10秒),但需配合延迟测量。
  • 启用IDLE钩子统计空闲时间,判断CPU负载。
void vApplicationIdleHook(void) {
    // 记录空闲计数
    idle_count++;
}

四、完整代码示例

以下示例展示双核任务划分、ISR优化与TWDT联合配置:

#include <freertos/FreeRTOS.h>
#include <freertos/task.h>
#include <freertos/queue.h>
#include <driver/gpio.h>
#include <esp_task_wdt.h>
#include <esp_log.h>

#define GPIO_INPUT 0
#define TAG "TWDT_DEMO"

static QueueHandle_t gpio_evt_queue = NULL;

// ISR:仅发送队列,放入IRAM
static void IRAM_ATTR gpio_isr_handler(void *arg) {
    uint32_t gpio_num = (uint32_t)arg;
    BaseType_t xHigherPriorityTaskWoken = pdFALSE;
    xQueueSendFromISR(gpio_evt_queue, &gpio_num, &xHigherPriorityTaskWoken);
    if (xHigherPriorityTaskWoken) portYIELD_FROM_ISR();
}

// 高频处理任务,绑定APP_CPU,优先级10
static void high_freq_task(void *pvParameters) {
    esp_task_wdt_add(NULL);
    uint32_t io_num;
    while (1) {
        if (xQueueReceive(gpio_evt_queue, &io_num, portMAX_DELAY)) {
            // 模拟处理,实际应用替换
            esp_rom_delay_us(100);
        }
        esp_task_wdt_reset();
    }
}

// 低优先级监控任务,绑定PRO_CPU,优先级1
static void monitor_task(void *pvParameters) {
    esp_task_wdt_add(NULL);
    while (1) {
        // 定期检查系统状态
        vTaskDelay(pdMS_TO_TICKS(1000));
        esp_task_wdt_reset();
    }
}

void app_main(void) {
    // 配置TWDT超时10秒
    esp_task_wdt_init(10, true);

    // 创建队列
    gpio_evt_queue = xQueueCreate(10, sizeof(uint32_t));

    // 配置GPIO中断
    gpio_config_t io_conf = {
        .intr_type = GPIO_INTR_NEGEDGE,
        .pin_bit_mask = (1ULL << GPIO_INPUT),
        .mode = GPIO_MODE_INPUT,
        .pull_up_en = 1,
    };
    gpio_config(&io_conf);
    gpio_install_isr_service(0);
    gpio_isr_handler_add(GPIO_INPUT, gpio_isr_handler, (void *)GPIO_INPUT);

    // 创建任务并绑定核心
    xTaskCreatePinnedToCore(high_freq_task, "high_freq", 4096, NULL, 10, NULL, 1);
    xTaskCreatePinnedToCore(monitor_task, "monitor", 2048, NULL, 1, NULL, 0);

    ESP_LOGI(TAG, "System started");
}

五、实测数据与注意事项

  • 实测:优化后中断延迟从~200μs降至~30μs,TWDT无超时。
  • 注意事项:
    • 避免在ISR中调用esp_task_wdt_reset(),否则会掩盖任务阻塞。
    • 使用portYIELD_FROM_ISR()确保高优先级任务及时切换。
    • 双核任务绑定后,确保每个核的IDLE任务有执行机会,可适当降低任务优先级或增加vTaskDelay。
    • 若使用WiFi/蓝牙,PRO_CPU负载较高,建议将应用任务全部绑定到APP_CPU。
    • 定期用逻辑分析仪验证中断延迟,防止优化后反弹。

通过上述联合调优,可显著提升ESP32双核系统的实时性与稳定性。