Watchdog Timer - ESP32

Um sistema de Watchdog é responsável por reiniciar o circuito caso ocorra travamentos.
Vamos ver como configurá-lo no ESP32.

Na postagem Watchdog Timer - Reset Automático do Circuito foi detalhado melhor como funciona um watchdog e, utilizamos um Arduino.

Nesse exemplo veremos como utilizar no ESP32.

A biblioteca do watchdog para o ESP32 é a <esp_task_wdt.h>.

As principais chamadas para seu funcionamento são:

esp_task_wdt_init(struct de configuração);
Essa função inicializa o watchdog passando a variável do tipo struct com as configurações. O timeout_ms, que deve ser informado em milissegundos e é do tipo inteiro. O idle_core_mask com o valor do núcleo e o trigger_panic para acionar a reinicialização.

esp_task_wtd_add(tarefa);
Essa função adiciona uma tarefa ao watchdog. Para a tarefa atual devemos passar o parâmetro NULL.

esp_task_wdt_reset();
Essa é a função responsável por resetar o cronômetro do watchdog, não permitindo que o timeout seja atingido.

O exemplo abaixo foi configurado um watchdog com timeout de 4 segundos.

Através do monitor serial é possível acompanhar o funcionamento.

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44

/*--------------------------------------------------------- Programa : WATCHDOG TIMER - ESP32 Autor : Fellipe Couto [ http://www.efeitonerd.com.br ] Data : 10/07/2024 ---------------------------------------------------------*/ #include <esp_task_wdt.h> //Biblioteca do watchdog #define BUTTON 0 //Porta de conexão do botão (ESP32 Dev Module o botão boot é o pino 0) void setup() { //Configura a porta com pull-up interno pinMode(BUTTON, INPUT_PULLUP); //Inicia a comunicação serial e exibe a mensagem Serial.begin(115200); delay(500); Serial.println("\nWATCHDOG TIMER - ESP32"); Serial.println("Mantenha o botao pressionado por mais de 4 segundos para o reiniciar o circuito.\n"); //Habilita o watchdog configurando o timeout para 4 segundos esp_task_wdt_config_t wdt_config = { .timeout_ms = 4000, .idle_core_mask = 1, .trigger_panic = true }; esp_task_wdt_init(&wdt_config); esp_task_wdt_add(NULL); } void loop() { //Variável para contagem de tempo int count = 0; //Fica preso no loop enquanto o botão estiver pressionado while (digitalRead(BUTTON) == LOW) { Serial.print("Botao pressionado... "); Serial.println(count); count++; delay(1000); } //Reseta o temporizador do watchdog esp_task_wdt_reset(); }

Essa configuração é para a versão 3.x da biblioteca do ESP32 disponibilizada para IDE Arduino.

Abaixo está a configuração para a versão 2.x.

esp_task_wdt_init(tempo em segundos, verdadeiro/falso para reinicialização);
Essa função inicializa o watchdog passando dois parâmetros. O primeiro é o timeout, que deve ser informado em segundos e é do tipo inteiro. O segundo é do tipo booleano e informa se ao atingir o timeout deve ser reinicializado o circuito.

esp_task_wtd_add(tarefa);
Essa função adiciona uma tarefa ao watchdog. Para a tarefa atual devemos passar o parâmetro NULL.

esp_task_wdt_reset();
Essa é a função responsável por resetar o cronômetro do watchdog, não permitindo que o timeout seja atingido.

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40

/*--------------------------------------------------------- Programa : WATCHDOG TIMER - ESP32 Autor : Fellipe Couto [ http://www.efeitonerd.com.br ] Data : 24/08/2019 ---------------------------------------------------------*/ // PARA A BIBLIOTECA ESP32 ATÉ A VERSÃO 2.x #include <esp_task_wdt.h> //Biblioteca do watchdog #define BUTTON 0 //Porta de conexão do botão (ESP32 Dev Module o botão boot é o pino 0) void setup() { //Configura a porta com pull-up interno pinMode(BUTTON, INPUT_PULLUP); //Inicia a comunicação serial e exibe a mensagem Serial.begin(115200); Serial.println("WATCHDOG TIMER - ESP32"); Serial.println("Mantenha o botao pressionado por mais de 4 segundos para o reiniciar o circuito.\n"); //Habilita o watchdog configurando o timeout para 4 segundos esp_task_wdt_init(4, true); esp_task_wdt_add(NULL); } void loop() { //Variável para contagem de tempo int count = 1; //Fica preso no loop enquanto o botão estiver pressionado while (digitalRead(BUTTON) == LOW) { Serial.print("Botao pressionado... "); Serial.println(count); count++; delay(1000); } //Reseta o temporizador do watchdog esp_task_wdt_reset(); }

 

Referências:

https://docs.espressif.com/projects/esp-idf/en/v5.1.3/esp32/api-reference/system/wdts.html

https://docs.espressif.com/projects/arduino-esp32/en/latest/migration_guides/2.x_to_3.0.html

 

Postagem atualizada em 10/07/2024.