ESP32S3定时器中断结合WDT的程序流控制问题求助

问题背景 #

在Arduino环境下使用ESP32S3，通过1秒触发的定时器中断设置标志位，驱动timeControl()更新菜单超时、WiFi切换等计数器；同时启用**1分钟超时的看门狗（WDT）**监控系统，未及时喂狗则复位。开机完成NVS与FS初始化后启动定时器，但测试中频繁出现WDT复位，核心问题在于程序结构不合理导致主循环阻塞。

核心代码现状 #

void timerStartLoop(){
  timerLoop = timerBegin(1000000);
  timerAttachInterrupt(timerLoop, &timerLoopIRQ);
  timerAlarm(timerLoop, TIMER_L_TIMEOUT * TIMER_FACTOR, true, 0);
  if (DEBUG){ Serial.println("[timer] started"); }
  return;
}

void ARDUINO_ISR_ATTR timerLoopIRQ(){
  flagTimerLoop = true;
}

void loop(){
  esp_task_wdt_reset();
  systemControl();
  timeControl();
  // 按键与导航处理逻辑
}

void timeControl(){
  esp_task_wdt_reset();
  if (flagTimerLoop){
    flagTimerLoop = false;
    // WiFi超时切换逻辑
    switch(controlTime){
      // 菜单超时等分支处理
    }
  }
}

问题根源分析 #

1. WDT复位的直接原因是主循环阻塞：看门狗触发本质是主任务（loop）在超时时间内未执行esp_task_wdt_reset()，说明systemControl()、按键导航逻辑或timeControl()分支中存在阻塞式操作（如delay()、无超时的文件/网络IO），导致loop无法及时喂狗。
2. 定时器中断逻辑存在竞态风险：flagTimerLoop未声明为原子类型，中断和主循环同时操作可能导致标志位状态异常，但这不是WDT复位的核心原因。
3. 定时器初始化参数错误：timerBegin()的第一个参数是定时器编号（0-3），而非频率，当前初始化逻辑会导致定时器工作异常。

优化实现方案 #

1. 消除主循环阻塞点 #

• 移除所有阻塞式API：用millis()替代delay()，给文件读取、网络请求等操作添加超时限制，避免长时间占用主循环。
• 耗时任务拆分：将文件IO、WiFi连接等耗时操作迁移到FreeRTOS独立任务中，主循环仅处理按键扫描等实时性要求高的逻辑。

2. 修复定时器与标志位逻辑 #

• 修正定时器初始化参数，使用正确的定时器编号与分频配置：

  #define TIMER_NUM 0
  #define TIMER_DIVIDER 80 // 80分频，对应1MHz计数时钟（ESP32S3主频80MHz）
  #define TIMER_ALARM_TICKS 1000000 // 1秒触发一次（1MHz*1s）
  hw_timer_t *timerLoop = NULL;
  volatile atomic_bool flagTimerLoop = false; // 原子类型避免竞态
  
  void timerStartLoop(){
    timerLoop = timerBegin(TIMER_NUM, TIMER_DIVIDER, true);
    timerAttachInterrupt(timerLoop, &timerLoopIRQ, true);
    timerAlarmWrite(timerLoop, TIMER_ALARM_TICKS, true); // 自动重载
    timerAlarmEnable(timerLoop);
    if (DEBUG) Serial.println("[timer] started");
  }
  
  void ARDUINO_ISR_ATTR timerLoopIRQ(){
    flagTimerLoop = true;
  }
  

• 统一喂狗逻辑：仅在主循环入口执行喂狗，避免分散喂狗导致漏喂：

  void loop(){
    esp_task_wdt_reset(); // 主循环入口统一喂狗
    systemControl();
    timeControl();
    // 按键与导航处理逻辑
  }
  
  void timeControl(){
    if (flagTimerLoop){
      flagTimerLoop = false;
      // WiFi超时切换、菜单超时处理逻辑
    }
  }
  

3. 重构为事件驱动的多任务结构 #

用FreeRTOS任务拆分定时任务与主任务，从根本上避免主循环阻塞：

// 定时任务：专门处理1秒周期的计数器更新
void timerTask(void *pvParameters){
  while(1){
    vTaskDelay(pdMS_TO_TICKS(1000)); // 非阻塞延时1秒
    // 直接执行WiFi切换、菜单超时等逻辑
    // 示例：更新菜单超时计数器
    menuTimeoutCounter++;
    if(menuTimeoutCounter >= 60){
      // 菜单超时逻辑
      menuTimeoutCounter = 0;
    }
    // 喂狗（若该任务被加入WDT监控）
    esp_task_wdt_reset();
  }
}

void setup(){
  // 初始化NVS、FS、串口等
  Serial.begin(115200);
  
  // 配置看门狗：仅监控主任务
  esp_task_wdt_init(60, true);
  esp_task_wdt_add(NULL);
  
  // 启动定时任务
  xTaskCreate(timerTask, "TimerTask", 4096, NULL, 1, NULL);
}

void loop(){
  esp_task_wdt_reset();
  systemControl(); // 仅处理实时性高的系统控制逻辑
  // 按键与导航处理逻辑
}

4. 看门狗配置优化 #

• 仅将主任务（loop）加入WDT监控，避免其他任务因调度延迟触发复位：

  esp_task_wdt_init(60, true); // 1分钟超时，触发后复位
  esp_task_wdt_add(NULL); // 将当前主任务加入监控
  

• 若定时任务需要监控，单独为其添加WDT并在任务内定期喂狗。

内容的提问来源于stack exchange，提问作者Daniel Riofrio