O watchdog timer do Arduino, em um Uno com um botão que o trava
Iniciante
- 526componentes na bancada
- 46placas rodando agora
- 1.00xtempo real, em todas as placas
O watchdog é um timer próprio dentro do chip que reinicia a placa, a menos que o sketch diga "ainda estou vivo" a tempo. Ative-o com wdt_enable(WDTO_2S) de <avr/wdt.h> e chame wdt_reset() em loop(). Enquanto loop() continuar girando, nada acontece. Se o sketch travar, em um loop sem fim ou esperando um sensor que nunca responde, passam-se dois segundos sem reset e o watchdog o reinicia do começo.
O circuito acima é um botão no pino 2 e um LED em um Uno. Cole o primeiro sketch abaixo nele e aperte Rodar. O monitor serial imprime "started". Aperte o botão e o sketch imprime "stuck!" e trava em um while (true), e cerca de dois segundos depois imprime "started" de novo: o watchdog o resetou.
Abaixo estão esse sketch, o que a causa do reset mostra em um Uno, os timeouts, por que uma inicialização lenta não entra em loop aqui, e o watchdog como uma interrupção lenta, cada um rodado em um Uno com o que imprimiu.
Um sketch que se reseta
Here is the sketch. setup() turns the watchdog on last, after everything slow is done. loop() pats it first thing every time around. The button stands in for a real hang, a sensor read that waits forever, say: it prints "stuck!" and goes into a loop with no way out, and no more pats. It printed "started", "stuck!" and then "started" again.
A reinicialização é um reset de verdade: toda variável começa de novo do seu primeiro valor e setup() roda de novo. O watchdog não corrige o bug que travou o sketch. Ele devolve ao trabalho um dispositivo que roda sozinho, e um sketch deveria registrar ou contar os resets para que o bug possa ser encontrado.
#include <avr/wdt.h>
void setup() {
Serial.begin(9600);
pinMode(2, INPUT_PULLUP);
Serial.println("started");
wdt_enable(WDTO_2S);
}
void loop() {
wdt_reset();
if (digitalRead(2) == LOW) {
Serial.println("stuck!");
while (true) {
}
}
delay(100);
}Abrir este sketch no editorSó o código: o editor posiciona a placa e os componentes que ele consegue ler do sketch.
Os timeouts
O watchdog conta seu próprio oscilador de 128 kHz, não o cristal de 16 MHz, então seus tempos são aproximados e não mudam com o clock. As opções são WDTO_15MS, WDTO_30MS, WDTO_60MS, WDTO_120MS, WDTO_250MS, WDTO_500MS, WDTO_1S, WDTO_2S, WDTO_4S e WDTO_8S; 8 segundos é o máximo. Escolha um confortavelmente maior que a passagem normal mais lenta por loop().
A long delay counts as a hang. With a 2 second watchdog, delay(3000) in loop() reset the board before the wait was over: in 7 seconds it printed "started" four times and "done waiting" never. Break long waits into short ones with a wdt_reset() in between, or better, time them with millis().
Foi o watchdog?
O chip guarda o motivo do último reset em MCUSR, e o bit WDRF fica ativo depois de um reset do watchdog. O sketch abaixo o lê logo no começo de setup(), depois o limpa, e o imprime. Imprimiu "reset cause: 1" na energização, a flag de power-on, e depois que o botão o travou, "reset cause: 0".
A segunda inicialização mostra 0, e não o 8 do watchdog. Um reset de watchdog em um Uno não aparece: o bootloader Optiboot lê o MCUSR e o limpa, e desliga o watchdog, antes do seu sketch começar, então setup() encontra o WDRF já limpo. O Uno do Mokxi faz o mesmo. Para saber que o watchdog disparou, mantenha sua própria contagem, na EEPROM por exemplo, e some um em setup().
#include <avr/wdt.h>
void setup() {
byte cause = MCUSR;
MCUSR = 0;
wdt_disable();
Serial.begin(9600);
pinMode(2, INPUT_PULLUP);
Serial.print("reset cause: ");
Serial.println(cause, HEX);
wdt_enable(WDTO_1S);
}
void loop() {
wdt_reset();
if (digitalRead(2) == LOW) {
while (true) {
}
}
}Abrir este sketch no editorSó o código: o editor posiciona a placa e os componentes que ele consegue ler do sketch.
O loop infinito de resets
Em um chip puro, depois de um reset de watchdog, enquanto o WDRF está ativo, o watchdog continua ligado no seu tempo mais curto, cerca de 16 milissegundos. Um sketch que começa devagar nunca tem a chance de definir seu próprio timeout, e a placa reinicia a cada poucos milissegundos. Em um Uno não existe esse loop: o Optiboot desliga o watchdog antes de o sketch começar. Com delay(100) em setup() antes de wdt_enable(WDTO_1S), um apertar do botão reiniciou a placa uma vez e ela imprimiu "started" duas vezes no total.
O bootloader mais antigo de muitas placas Nano não desliga o watchdog, e um reset de watchdog pode deixar essa placa presa reiniciando até ser desligada da alimentação ou receber um novo bootloader. A correção são as três primeiras linhas do sketch acima: ler o MCUSR, limpá-lo e wdt_disable(), antes de qualquer outra coisa.
O watchdog como uma interrupção lenta
Configure o bit WDIE em vez do WDE e o watchdog chama ISR(WDT_vect) em vez de resetar. O sketch abaixo pede um segundo; o handler rodou em 1024, 2048, 3072 e 4096 ms, um segundo pelo oscilador próprio do watchdog. Mudar o WDTCSR exige duas escritas seguidas, a primeira definindo WDCE e WDE, como o data sheet pede. Este é o timer que acorda um sketch de bateria do sleep, porque continua rodando quando todo o resto está parado.
#include <avr/wdt.h>
volatile int barks = 0;
ISR(WDT_vect) {
barks++;
}
void setup() {
Serial.begin(9600);
noInterrupts();
wdt_reset();
WDTCSR = (1 << WDCE) | (1 << WDE);
WDTCSR = (1 << WDIE) | (1 << WDP2) | (1 << WDP1);
interrupts();
}
void loop() {
static int shown = 0;
if (barks != shown) {
shown = barks;
Serial.print("bark ");
Serial.print(shown);
Serial.print(" at ");
Serial.println(millis());
}
}Abrir este sketch no editorSó o código: o editor posiciona a placa e os componentes que ele consegue ler do sketch.
Abra este circuito no editor. Arduino Uno: um botão no pino 2, pronto para receber um sketch, ligado como ele roda no topo desta página. Mude um componente ou um valor e rode de novo.
Abrir o circuitoPerguntas
O que é o watchdog timer em um Arduino?
Um timer separado no chip que reseta a placa se o sketch não chamar wdt_reset() antes do tempo acabar. Ele faz um sketch travado voltar a rodar sem ninguém apertar reset.
Como uso o watchdog timer em um Arduino Uno?
Inclua <avr/wdt.h>, chame wdt_enable(WDTO_2S) no fim de setup() e wdt_reset() uma vez a cada volta de loop(). Escolha um timeout maior do que a passagem normal mais lenta de loop().
Por que meu Arduino fica resetando com o watchdog?
Algo em loop() demora mais do que o timeout, geralmente um delay() longo, ou, em uma placa com bootloader mais antigo, o sketch começa devagar demais depois de um reset de watchdog, quando o chip mantém um timeout de 16 ms até o MCUSR ser limpo. Limpe o MCUSR e chame wdt_disable() logo no início de setup().
Qual é o maior timeout do watchdog?
Cerca de 8 segundos, WDTO_8S. Para mais que isso, use a interrupção do watchdog e conte várias delas antes de concluir que o sketch travou.
O watchdog funciona em um Nano?
O chip é o mesmo, então o código é o mesmo. Placas Nano mais antigas têm um bootloader que não desliga o watchdog depois que ele dispara, o que pode deixar a placa resetando até um novo bootloader ser gravado.
Continuar
De onde vêm as informações desta página
Monte isto de verdade
Abra o editor, mude um valor e veja o número mudar junto. Nada para instalar, e não precisa de conta.