Belajar

Watchdog timer Arduino, pada Uno dengan tombol yang membuatnya macet

Pemula

Atau lihat semua pelajaran.

  • 526komponen di meja kerja
  • 46board sedang berjalan
  • 1.00xwaktu nyata, di semua board
Arduino Uno: tombol di pin 2, siap membuat sketch macetlive0.000 s 0.00x
Tahan tombolnya
Tempel sketch watchdog, lalu tekan tombolnya agar macet dan lihat ia direstart.

Watchdog adalah timer tersendiri di dalam chip yang merestart board kecuali sketch mengatakan "masih hidup" tepat waktu. Nyalakan dengan wdt_enable(WDTO_2S) dari <avr/wdt.h> dan panggil wdt_reset() di loop(). Selama loop() terus berputar, tidak terjadi apa-apa. Jika sketch macet, di loop tanpa akhir atau menunggu sensor yang tak pernah menjawab, dua detik berlalu tanpa reset dan watchdog merestartnya dari awal.

Rangkaian di atas adalah tombol di pin 2 dan LED pada Uno. Tempel sketch pertama di bawah ke dalamnya lalu tekan Jalankan. Serial monitor mencetak "started". Tekan tombolnya dan sketch mencetak "stuck!" lalu macet di while (true), dan sekitar dua detik kemudian mencetak "started" lagi: watchdog meresetnya.

Di bawah ini sketch itu, apa yang ditampilkan penyebab reset pada Uno, daftar timeout, kenapa start yang lambat tidak membuat loop di sini, dan watchdog sebagai interrupt lambat, masing-masing dijalankan pada Uno beserta hasil cetaknya.

Sketch yang mereset dirinya sendiri

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.

Restart itu adalah reset sungguhan: setiap variabel mulai lagi dari nilai awalnya dan setup() berjalan lagi. Watchdog tidak memperbaiki bug yang membuat sketch macet. Ia membuat perangkat yang berjalan sendiri kembali bekerja, dan sebuah sketch sebaiknya mencatat atau menghitung reset itu agar bug-nya bisa ditemukan.

Tahan tombolnya agar macet
#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);
}

Buka sketch ini di editorKodenya saja: editor menempatkan board dan komponen yang bisa dibacanya dari sketch.

Daftar timeout

Watchdog menghitung osilator 128 kHz miliknya sendiri, bukan kristal 16 MHz, jadi waktunya kasar dan tidak berubah mengikuti clock. Pilihannya WDTO_15MS, WDTO_30MS, WDTO_60MS, WDTO_120MS, WDTO_250MS, WDTO_500MS, WDTO_1S, WDTO_2S, WDTO_4S dan WDTO_8S; 8 detik adalah yang terpanjang. Pilih yang nyaman lebih panjang dari putaran loop() normal yang paling lambat.

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().

Apakah itu watchdog?

Chip menyimpan alasan reset terakhir di MCUSR, dan bit WDRF disetel setelah reset watchdog. Sketch di bawah membacanya hal pertama di setup(), lalu menghapusnya, dan mencetaknya. Ia mencetak "reset cause: 1" saat power-on, flag power-on, dan setelah tombol membuatnya macet, "reset cause: 0".

Pembacaan kedua menunjukkan 0, bukan 8 milik watchdog. Reset watchdog di Uno tidak terlihat: bootloader Optiboot membaca MCUSR dan menghapusnya, lalu mematikan watchdog, sebelum sketch-mu berjalan, jadi setup() menemukan WDRF sudah bersih. Uno di Mokxi melakukan hal yang sama. Untuk mengetahui bahwa watchdog pernah aktif, simpan hitunganmu sendiri, misalnya di EEPROM, dan tambah satu di setup().

Membaca penyebab reset
#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) {
    }
  }
}

Buka sketch ini di editorKodenya saja: editor menempatkan board dan komponen yang bisa dibacanya dari sketch.

Perulangan reset tanpa akhir

Pada chip telanjang, setelah reset watchdog, selama WDRF masih aktif, watchdog tetap menyala dengan waktu terpendeknya, sekitar 16 milidetik. Sketch yang mulai dengan lambat tidak pernah sempat mengatur timeout-nya sendiri, dan board restart setiap beberapa milidetik. Di Uno tidak ada perulangan seperti itu: Optiboot mematikan watchdog sebelum sketch berjalan. Dengan delay(100) di setup() sebelum wdt_enable(WDTO_1S), satu tekanan tombol mereset board sekali dan mencetak "started" dua kali seluruhnya.

Bootloader lama di banyak board Nano tidak mematikan watchdog, dan reset watchdog bisa membuat board seperti itu terus restart sampai dicabut atau diberi bootloader baru. Solusinya adalah tiga baris pertama sketch di atas: baca MCUSR, hapus, wdt_disable(), sebelum hal lain.

Watchdog sebagai interrupt lambat

Atur bit WDIE alih-alih WDE, dan watchdog memanggil ISR(WDT_vect) alih-alih mereset. Sketch di bawah meminta satu detik; handler berjalan di 1024, 2048, 3072 dan 4096 ms, satu detik menurut osilator watchdog sendiri. Mengubah WDTCSR membutuhkan dua penulisan berturut-turut, yang pertama mengatur WDCE dan WDE, seperti yang diminta data sheet. Inilah timer yang membangunkan sketch baterai dari sleep, karena tetap berjalan saat semua yang lain berhenti.

Interrupt watchdog setiap detik
#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());
  }
}

Buka sketch ini di editorKodenya saja: editor menempatkan board dan komponen yang bisa dibacanya dari sketch.

Buka rangkaian ini di editor. Arduino Uno: sebuah tombol di pin 2, siap membuat sketch macet, tersambung seperti yang berjalan di bagian atas halaman ini. Ubah komponen atau nilainya dan jalankan lagi.

Buka rangkaian ini

Pertanyaan

Apa itu watchdog timer di Arduino?

Timer terpisah di dalam chip yang mereset board kecuali sketch memanggil wdt_reset() sebelum waktunya habis. Timer ini menjalankan kembali sketch yang macet tanpa perlu ada yang menekan reset.

Bagaimana cara memakai watchdog timer di Arduino Uno?

Sertakan <avr/wdt.h>, panggil wdt_enable(WDTO_2S) di akhir setup() dan wdt_reset() sekali di setiap putaran loop(). Pilih timeout yang lebih lama dari putaran normal paling lambat dari loop().

Kenapa Arduino saya terus mereset dengan watchdog?

Sesuatu di loop() memakan waktu lebih lama dari timeout, sering kali delay() yang panjang, atau, di board dengan bootloader lama, sketch mulai terlalu lambat setelah reset watchdog, saat chip mempertahankan timeout 16 ms sampai MCUSR dihapus. Hapus MCUSR dan panggil wdt_disable() di awal setup().

Berapa timeout watchdog terpanjang?

Sekitar 8 detik, WDTO_8S. Untuk lebih lama, pakai interrupt watchdog dan hitung beberapa interrupt sebelum memutuskan sketch macet.

Apakah watchdog bekerja di Nano?

Chipnya sama, jadi kodenya sama. Board Nano lama membawa bootloader yang tidak mematikan watchdog setelah aktif, yang bisa membuat board terus mereset sampai bootloader baru dibakar.

Rakit versi nyatanya

Buka editor, ubah sebuah nilai, dan lihat angkanya ikut berubah. Tidak ada yang perlu dipasang, dan tidak perlu akun.