Dasar · 11 mnt baca

Watchdog Timer Arduino: Reset Otomatis Board yang Macet

Apa itu watchdog timer Arduino? Pakai avr/wdt.h di Uno, Task WDT di ESP32, dan machine.WDT di Pico untuk me-reset otomatis board yang macet, lengkap dengan penempatan yang benar.

Watchdog Arduino adalah timer pengaman di hardware yang menyadari ketika programmu hang, lalu menyalakan ulang board dengan sendirinya. Program secara rutin mengirim sinyal “aku masih jalan”. Kalau sinyal itu tidak datang dalam waktu yang ditentukan, watchdog me-reset board seolah-olah tombol reset ditekan. Jadi proyek yang terjebak di perulangan tanpa akhir, menunggu sensor, atau macet di dalam library Wi-Fi bisa pulih dalam beberapa detik, tanpa kamu harus datang dan mencabut kabelnya.

Me-reset board yang macet dengan tangan itu gampang kalau board-nya ada di mejamu, tapi tidak mungkin untuk sistem penyiraman di kebun, stasiun cuaca di atap, atau perangkat rumah pintar yang menyala berminggu-minggu. Di artikel ini kamu akan belajar cara kerja watchdog, cara memakai avr/wdt.h di Arduino Uno, Task WDT di ESP32, dan machine.WDT di Raspberry Pi Pico, tempat yang tepat untuk perintah feed, serta kesalahan klasik yang menjebak board dalam loop reset tanpa akhir, semuanya dengan contoh kode.

Board Arduino Uno dan mikrokontroler ATmega328P
ATmega328P di Arduino Uno punya watchdog timer bawaan yang berjalan dengan osilator 128 kHz-nya sendiri; tidak perlu komponen tambahan.

Apa itu watchdog timer dan bagaimana cara kerjanya?

Watchdog adalah penghitung kecil di dalam mikrokontroler yang menghitung secara terpisah dari program utama. Kamu menjalankannya dengan waktu tertentu, misalnya 2 detik, lalu ia mulai menghitung. Perintah feed yang kamu panggil di setiap putaran program (disebut juga “kicking the dog”) mengembalikan penghitung ke nol. Selama program berjalan sehat, penghitung tidak pernah sampai ke ujung. Kalau program tersangkut di suatu tempat, feed tidak pernah datang, penghitung habis, dan watchdog memberikan reset hardware ke mikrokontroler. Setelah reset, board mulai lagi dari setup() persis seperti baru dinyalakan.

Rahasia keandalan watchdog adalah ia berjalan dari sumber clock yang terpisah dari clock utama. Di ATmega328P pada Arduino Uno, sumber ini adalah osilator internal 128 kHz; walaupun kristal 16 MHz program atau alur kodenya kacau, watchdog tetap menghitung. Penyebab umum program hang antara lain: perulangan while yang kondisi keluarnya tidak pernah terpenuhi, library yang menunggu selamanya sensor I2C yang tidak merespons, RAM yang terfragmentasi lama-lama karena penggabungan String, memori yang rusak karena array meluap, atau derau listrik yang membuat program melompat ke alamat acak.

FiturArduino Uno (ATmega328P)ESP32Raspberry Pi Pico (RP2040)
Library / modulavr/wdt.hesp_task_wdt.hmachine.WDT (MicroPython)
Memulaiwdt_enable(WDTO_2S)esp_task_wdt_init / reconfigure + esp_task_wdt_add(NULL)WDT(timeout=5000)
Feedwdt_reset()esp_task_wdt_reset()wdt.feed()
Timeout terlama8 dtkBisa diatur (default Arduino 5 dtk)8388 ms (sekitar 8,3 dtk)
Menghentikanwdt_disable()Hapus task dengan esp_task_wdt_delete()Tidak bisa dihentikan (hanya reset yang mematikannya)
Sumber clockOsilator internal 128 kHzGrup timer hardware (MWDT)Generator tick internal 1 µs

Apa yang bisa diatasi watchdog, dan apa yang tidak?

  • Perulangan tanpa akhir: Perulangan while yang menunggu nilai yang tidak pernah datang, atau state machine yang tersangkut karena kesalahan logika, diselesaikan watchdog dalam beberapa detik.
  • Library yang hang: Kalau library jaringan macet di koneksi Wi-Fi, MQTT, atau HTTP, atau driver sensor yang tidak merespons membuat board macet, reset mengembalikannya ke kondisi bersih.
  • Memori rusak: Kalau fragmentasi RAM atau stack overflow membuat program berperilaku aneh lalu crash, watchdog menghidupkan board lagi.
  • Derau listrik: Kalau gangguan dari relay, motor, atau kabel panjang membuat program melompat ke titik acak, feed yang terputus itulah yang menyelamatkannya.
  • Yang tidak bisa diatasi: Tegangan catu daya yang rendah (brownout), sensor eksternal yang macet, atau nilai yang salah hitung. Watchdog hanya me-reset mikrokontroler; sensor yang menahan jalur I2C tetap LOW sering tidak pulih sampai dayanya sendiri diputus. Kalau program berjalan salah tapi teratur, watchdog tidak bisa menyadarinya.
Watchdog bukan perbaikan bug, melainkan sabuk pengaman. Kalau kamu melihat board ter-reset beberapa kali sehari, cari masalah sebenarnya: paling sering catu daya yang kurang, kebocoran memori, atau perulangan tunggu tanpa timeout. Untuk penyebab hardware dari reset acak, lihat Kenapa Arduino-ku terus reset?.

Watchdog di Arduino Uno: avr/wdt.h

Di board berbasis AVR (Uno, Nano, Mega, Pro Mini), kamu tidak perlu menginstal library tambahan untuk watchdog; header avr/wdt.h yang ikut bersama compiler sudah cukup. Ada tiga fungsi dasar: wdt_enable(timeout) memulai watchdog, wdt_reset() me-reset (memberi feed) penghitung, dan wdt_disable() mematikannya. Timeout diberikan dengan salah satu konstanta siap pakai di bawah ini; ada sepuluh pilihan dari sekitar 15 ms sampai 8 detik. Kamu tidak bisa langsung memilih waktu lebih dari 8 detik, tapi dengan metode feed bersyarat yang akan kamu lihat sebentar lagi, kamu bisa membuat batas yang lebih panjang.

KonstantaPerkiraan waktuPenggunaan umum
WDTO_15MS15 msReset software instan
WDTO_30MS30 msJarang dipakai
WDTO_60MS60 msJarang dipakai
WDTO_120MS120 msPerulangan kontrol yang sangat singkat
WDTO_250MS250 msPerulangan yang butuh respons cepat
WDTO_500MS500 msKontrol tombol dan LED
WDTO_1S1 dtkPerulangan kontrol sederhana
WDTO_2S2 dtkMembaca sensor dan memperbarui layar
WDTO_4S4 dtkSensor lambat, komunikasi
WDTO_8S8 dtkOperasi jaringan, perhitungan panjang

Langkah demi langkah: uji watchdog pertamamu

  1. Hubungkan Arduino Uno ke komputermu dengan USB; selain LED bawaan board (pin 13), tidak perlu rangkaian tambahan.
  2. Upload kode di bawah dan buka Serial Monitor di 9600 baud.
  3. Kamu akan melihat “Basladi” (bahasa Turki untuk “dimulai”) di layar dan LED berkedip setiap setengah detik.
  4. Kirim huruf k dari Serial Monitor; program sengaja masuk ke perulangan tanpa akhir dan LED membeku di posisinya.
  5. Setelah sekitar 2 detik, board me-reset dirinya sendiri, “Basladi” muncul lagi, dan LED mulai berkedip lagi.
C++ (Arduino IDE)
1#include <avr/wdt.h>
2
3const int LED_PIN = 13;            // dahili LED / onboard LED
4unsigned long sonYanip = 0;
5bool ledDurum = false;
6
7void setup() {
8  MCUSR = 0;                       // reset bayraklarını temizle / clear reset flags
9  wdt_disable();                   // kurulum sırasında kapalı tut / keep off during setup
10  pinMode(LED_PIN, OUTPUT);
11  Serial.begin(9600);
12  Serial.println(F("Basladi / Started"));
13  wdt_enable(WDTO_2S);             // 2 saniyelik watchdog / 2 second watchdog
14}
15
16void loop() {
17  wdt_reset();                     // köpeği besle / feed the dog
18
19  if (millis() - sonYanip >= 500) {
20    sonYanip = millis();
21    ledDurum = !ledDurum;
22    digitalWrite(LED_PIN, ledDurum);
23  }
24
25  if (Serial.available() && Serial.read() == 'k') {
26    Serial.println(F("Kilitlendi / Hanging..."));
27    while (true) { }               // besleme yok: 2 s sonra reset / no feed: reset after 2 s
28  }
29}

Baris MCUSR = 0 di awal setup() menghapus flag reset; di ATmega328P watchdog tidak bisa dimatikan sebelum flag reset watchdog (WDRF) dihapus, jadi wdt_disable() diletakkan sesudahnya. Kita mengaktifkan watchdog di akhir setup(), setelah inisialisasi selesai, supaya proses start-up sensor yang lama tidak memicu reset secara tidak sengaja. wdt_reset() di baris pertama loop() me-reset penghitung di setiap putaran. Membuat LED berkedip dengan millis() alih-alih delay() juga disengaja: loop() kembali tanpa menunggu dan memberi feed ke watchdog berulang kali dalam hitungan milidetik.

Memicu watchdog dengan sengaja adalah cara paling bersih untuk me-reset board dari kode: ketika kamu menulis wdt_enable(WDTO_15MS); while (true) {}, board mendapat reset hardware sungguhan hampir seketika. Metode populer “lompat ke alamat 0” hanya memulai ulang program dan tidak me-reset periferal hardware. Ingat juga bahwa waktu di tabel adalah nilai tipikal; osilator 128 kHz bergeser tergantung suhu dan tegangan catu daya, jadi pakai watchdog hanya untuk pengaman, bukan untuk pewaktuan presisi.

Bootloader lama dan loop reset tanpa akhir

Ketika watchdog menyebabkan reset, ATmega328P tidak mematikan watchdog; justru ia membiarkannya aktif dengan timeout terpendek (sekitar 16 ms). Kalau bootloader, program pertama yang dijalankan board ketika start-up, tidak menangani hal ini, watchdog habis waktunya selagi bootloader masih menunggu kode untuk di-upload, dan board ter-reset lagi. Hasilnya adalah loop reset tanpa akhir: LED berkedip cepat, kode tidak pernah mulai, dan kode baru tidak bisa di-upload. Bootloader Optiboot di Arduino Uno original mematikan watchdog ketika start-up, jadi tidak punya masalah ini. Masalah ini kebanyakan muncul di Nano klon dengan bootloader lama dan beberapa board Mega 2560 lawas.

Hati-hati sebelum mencoba watchdog kalau kamu memprogram board-mu dengan opsi ATmega328P (Old Bootloader) di Arduino IDE. Kalau board masuk ke loop, kamu perlu memakai Arduino kedua sebagai programmer ISP dan menulis bootloader Optiboot terbaru ke board dengan perintah Tools › Burn Bootloader. Bahkan di board dengan Optiboot, mempertahankan baris MCUSR = 0 dan wdt_disable() di awal setup() adalah kebiasaan yang baik.

Di mana sebaiknya perintah feed diletakkan?

  • Pilih satu titik pusat: Letakkan wdt_reset() di dalam loop(), di satu titik yang dilewati semua pekerjaan. Kalau kamu menaburkan feed di seluruh kode, sub-perulangan yang tersangkut akan terus memberi feed ke dirinya sendiri dan watchdog jadi tidak berguna.
  • Jangan memberi feed di dalam interrupt: Interrupt timer tetap berjalan walaupun program utama macet. Kalau feed ditaruh di sana, watchdog tidak bisa menangkap hang apa pun. Cara kerja interrupt bisa kamu baca di artikel interrupt Arduino.
  • Pilih timeout berdasarkan operasi terlama: Timeout watchdog sebaiknya minimal dua kali durasi terburuk satu putaran loop(). Kalau kamu memakai WDTO_2S di perulangan yang berisi delay(3000), board akan terus ter-reset.
  • Tambahkan timeout ke perulangan tunggu: Daripada memberi feed di dalam perulangan seperti while (!Serial.available()), buat perulangan itu keluar setelah waktu tertentu. Dengan begitu board tidak macet dan watchdog tetap siaga untuk hang yang sebenarnya.
  • Aktifkan watchdog setelah setup: Aktifkan setelah operasi panjang seperti koneksi Wi-Fi, inisialisasi kartu SD, atau kalibrasi sensor selesai di setup().

Pendekatan yang lebih cerdas adalah membuat feed bersyarat: kamu memberi feed ke watchdog hanya kalau sistem benar-benar sehat. Pada contoh di bawah, sensor yang terhubung ke A0 dibaca setiap 5 detik; kalau nilainya ada di rentang yang masuk akal, waktu pengukuran sukses terakhir diperbarui. Kalau tidak ada pengukuran sukses selama 60 detik, feed berhenti dan board ter-reset 4 detik kemudian. Dengan metode ini kamu membuat pengawasan dalam skala menit yang melampaui batas 8 detik AVR, dan kamu tidak hanya menangkap macet, tapi juga kerusakan diam-diam seperti kabel sensor yang putus.

C++ (Arduino IDE)
1#include <avr/wdt.h>
2
3const unsigned long OLCUM_ARALIK = 5000UL;     // 5 s'de bir ölç / measure every 5 s
4const unsigned long MAKS_SESSIZLIK = 60000UL;  // 60 s başarısızlık sınırı / 60 s failure limit
5unsigned long sonOlcum = 0;
6unsigned long sonBasari = 0;
7
8bool olcumYap() {
9  int deger = analogRead(A0);                  // örnek sensör / sample sensor
10  Serial.println(deger);
11  return deger > 10 && deger < 1013;           // uç değer = kopuk kablo / extreme value = broken wire
12}
13
14void setup() {
15  MCUSR = 0;                                   // reset bayraklarını temizle / clear reset flags
16  wdt_disable();
17  Serial.begin(9600);
18  sonBasari = millis();
19  wdt_enable(WDTO_4S);                         // 4 saniyelik watchdog / 4 second watchdog
20}
21
22void loop() {
23  unsigned long simdi = millis();
24
25  if (simdi - sonOlcum >= OLCUM_ARALIK) {
26    sonOlcum = simdi;
27    if (olcumYap()) {
28      sonBasari = simdi;                       // sağlıklı ölçüm / healthy reading
29    }
30  }
31
32  if (simdi - sonBasari < MAKS_SESSIZLIK) {
33    wdt_reset();                               // yalnız sistem sağlıklıysa besle / feed only if healthy
34  }
35}

Watchdog di ESP32: Task WDT dan Interrupt WDT

Di ESP32 sudah ada watchdog yang berjalan secara default; kebanyakan orang baru menyadarinya ketika pesan tak terduga “Task watchdog got triggered” muncul di Serial Monitor. Karena ESP32 menjalankan beberapa task sekaligus di bawah sistem operasi FreeRTOS, ia memakai struktur berlapis, bukan satu penghitung. Task WDT (TWDT) memeriksa apakah task yang terdaftar padanya diberi feed dalam waktu tertentu; Interrupt WDT (IWDT) menangkap interrupt dan penjadwal task yang terblokir lama. Di core Arduino, TWDT biasanya aktif dengan timeout 5 detik dan mengawasi idle task; task yang menjalankan loop() tidak diawasi kecuali kamu menambahkannya. Perilaku default bisa berbeda tergantung versi core, dan di beberapa konfigurasi TWDT hanya mencetak peringatan tanpa me-reset board, jadi mengatur timeout dan perilaku reset secara eksplisit di kode adalah pilihan paling aman.

JenisYang diawasiWaktu tipikalPesan yang muncul ketika terpicu
Task WDT (TWDT)Berjalannya task terdaftar dan idle task secara teratur5 dtk (bisa diatur)“task_wdt: Task watchdog got triggered”
Interrupt WDT (IWDT)Interrupt dan penjadwal task yang terblokirSekitar 300 ms“Guru Meditation Error ... Interrupt wdt timeout on CPU1”
RTC WDTProses boot yang tersangkutWaktu singkat selama bootrst:0x10 (RTCWDT_RTC_RESET)
C++ (Arduino IDE)
1#include <esp_task_wdt.h>
2#include <esp_system.h>
3
4#define WDT_SURE_S 10                         // watchdog süresi (s) / watchdog timeout (s)
5
6void wdtKur() {
7#if ESP_ARDUINO_VERSION_MAJOR >= 3
8  esp_task_wdt_config_t cfg = {
9    .timeout_ms = WDT_SURE_S * 1000,
10    .idle_core_mask = 0,                       // idle görevlerini izleme / do not watch idle tasks
11    .trigger_panic = true                      // süre dolunca resetle / reset on timeout
12  };
13  if (esp_task_wdt_reconfigure(&cfg) == ESP_ERR_INVALID_STATE) {
14    esp_task_wdt_init(&cfg);                   // TWDT kapalıysa başlat / start TWDT if not running
15  }
16#else
17  esp_task_wdt_init(WDT_SURE_S, true);         // 2.x: süre (s), panik / 2.x: timeout (s), panic
18#endif
19  esp_task_wdt_add(NULL);                      // bu görevi (loop) izle / watch this task (loop)
20}
21
22void setup() {
23  Serial.begin(115200);
24  esp_reset_reason_t neden = esp_reset_reason();
25  Serial.print("Reset nedeni / Reset reason: ");
26  Serial.println((int)neden);
27  if (neden == ESP_RST_TASK_WDT || neden == ESP_RST_INT_WDT || neden == ESP_RST_WDT) {
28    Serial.println("Watchdog reseti / Watchdog reset");
29  }
30  wdtKur();
31  Serial.println("Hazir / Ready");
32}
33
34void loop() {
35  esp_task_wdt_reset();                        // besle / feed
36
37  // sensör, Wi-Fi ve ekran işleri burada / sensor, Wi-Fi and display work here
38
39  if (Serial.available() && Serial.read() == 'k') {
40    Serial.println("Kilitlendi / Hanging...");
41    while (true) { delay(10); }                // besleme yok: 10 s sonra reset / no feed: reset after 10 s
42  }
43  delay(10);
44}

Kode ini memeriksa versi core dengan ESP_ARDUINO_VERSION_MAJOR: di versi 3.x (ESP-IDF 5) pengaturan diberikan lewat struktur esp_task_wdt_config_t dan TWDT yang sudah berjalan diperbarui dengan esp_task_wdt_reconfigure(); di versi 2.x, esp_task_wdt_init() langsung menerima timeout dalam detik dan flag panic. Kalau trigger_panic bernilai true, ESP32 mencetak dump error ke port serial dan me-reset dirinya begitu waktunya habis. esp_task_wdt_add(NULL) mulai mengawasi task yang sedang berjalan, yaitu task yang menjalankan setup() dan loop(). Membaca dan mencatat penyebab reset sebelumnya dengan esp_reset_reason() ketika start-up adalah cara termudah untuk memahami kenapa perangkat di lapangan menyala ulang. Kalau kamu hanya ingin mengawasi loop() tanpa konfigurasi apa pun, kamu bisa memanggil fungsi enableLoopWDT() dari core Arduino di setup(); dalam hal ini feed dilakukan otomatis di awal setiap putaran loop().

Kesalahan watchdog paling umum di ESP32 adalah menulis perulangan yang tidak pernah menunggu di dalam task FreeRTOS buatanmu sendiri. Misalnya, kalau kamu menulis while (true) { readSensor(); } di task yang dipasang di core 0, idle task di core itu tidak pernah bisa berjalan, stack Wi-Fi macet, dan setelah beberapa detik muncul pesan “Task watchdog got triggered ... IDLE (CPU 0)”. Tambahkan minimal vTaskDelay(1) atau delay(1) ke setiap perulangan. Untuk detail soal task lihat FreeRTOS dan dua inti ESP32, dan untuk arti pesan “Guru Meditation” lihat error brownout dan Guru Meditation ESP32.

Watchdog di Raspberry Pi Pico (MicroPython)

Watchdog hardware RP2040 dipakai di MicroPython dengan class machine.WDT. Timeout diberikan dalam milidetik dan maksimal 8388 ms di RP2040. Ada satu perbedaan penting: di Pico, begitu watchdog sudah mulai, ia tidak bisa dihentikan dari kode; hanya reset yang mematikannya. Karena itu menyisakan jalur pemulihan kecil selama pengembangan sangat menolong. Di kode di bawah, kalau pin GP15 terhubung ke GND ketika start-up, watchdog tidak pernah dijalankan dan program jatuh ke REPL. Dengan machine.reset_cause() kamu juga bisa tahu apakah board mulai karena watchdog atau karena dinyalakan normal. Kalau kamu memprogram Pico dengan Arduino IDE (core arduino-pico) alih-alih MicroPython, pekerjaan yang sama dilakukan dengan fungsi rp2040.wdt_begin(5000) dan rp2040.wdt_reset().

MicroPython
1import machine
2from machine import Pin, WDT
3import time
4
5led = Pin(25, Pin.OUT)                     # dahili LED (Pico W'da "LED") / onboard LED ("LED" on Pico W)
6kurtarma = Pin(15, Pin.IN, Pin.PULL_UP)   # GND'ye bağlıysa WDT başlamaz / tied to GND = WDT skipped
7
8if machine.reset_cause() == machine.WDT_RESET:
9    print("Watchdog reseti / Watchdog reset")
10
11if kurtarma.value() == 0:
12    print("Kurtarma modu / Recovery mode")
13    raise SystemExit
14
15wdt = WDT(timeout=5000)                    # 5 s, RP2040'ta en fazla 8388 ms / max 8388 ms on RP2040
16son = time.ticks_ms()
17
18while True:
19    wdt.feed()                             # besle / feed
20    if time.ticks_diff(time.ticks_ms(), son) >= 500:
21        son = time.ticks_ms()
22        led.toggle()
23    time.sleep_ms(10)
Ketika kamu menghentikan program yang memakai watchdog dengan tombol Stop di Thonny, watchdog tetap menghitung dan dalam beberapa detik Pico ter-reset dan koneksinya putus. Coba kode dulu dengan nama file selain main.py; begitu semuanya jalan, simpan sebagai main.py. Kalau board terjebak di loop, cukup hubungkan GP15 ke GND lalu reset. Kalau kamu baru mengenal MicroPython, artikel dasar-dasar MicroPython adalah awal yang bagus.

Strategi watchdog untuk proyek IoT yang berjalan lama

  • Catat setiap start-up: Di setiap start-up, tulis penghitung ke EEPROM di Uno atau ke Preferences (NVS) di ESP32; di ESP32 simpan juga penyebabnya dengan esp_reset_reason(). Satu reset seminggu masih bisa diterima, satu reset setiap jam adalah bug yang perlu diperbaiki. Karena Optiboot menghapus flag reset di Uno, membaca penyebabnya dari MCUSR sering tidak mungkin; penghitung start-up tetap menunjukkan seberapa sering perangkat menyala ulang.
  • Beri timeout pada operasi jaringan: Jangan menunggu koneksi Wi-Fi selamanya; misalnya, kalau tidak bisa terhubung dalam 15 detik, keluar dari perulangan dan coba lagi setelah beberapa waktu. Pengaturan seperti setTimeout() di HTTPClient dan Wire.setWireTimeout() di AVR mencegah operasi yang tersangkut melewati waktu watchdog. Untuk masalah koneksi lihat ESP32 tidak mau terhubung ke Wi-Fi.
  • Perhitungkan pembaruan OTA: Upload nirkabel memakan waktu beberapa detik dan loop() bisa tertahan selama itu. Dengan memanggil esp_task_wdt_reset() di callback onProgress milik ArduinoOTA, kamu bisa mencegah pembaruan terputus di tengah jalan; ini pengecualian aturan yang jarang tapi beralasan.
  • Pikirkan mode sleep: Di Uno, watchdog bisa dipakai dalam mode interrupt sebagai timer pembangun dan kamu bisa sleep dengan interval 8 detik. Di ESP32 prosesor mati selama deep sleep dan kode mulai dari awal ketika bangun. Lihat deep sleep ESP32 untuk detailnya.
  • Kelola daya sensor eksternal: Watchdog tidak me-reset sensor. Kalau kamu memberi daya sensor I2C yang sering macet lewat transistor atau MOSFET, lalu memutus dan menyambungkan dayanya selama beberapa ratus milidetik ketika start-up, sensor ikut mulai bersih bersama mikrokontroler. Cara jalur I2C bisa terkunci bisa kamu baca di artikel Apa Itu I2C?.
  • Watchdog eksternal untuk sistem kritis: Watchdog internal hanya menangkap kerusakan mikrokontroler itu sendiri. Kalau kamu perlu mengawasi seluruh rangkaian, pakai chip watchdog eksternal yang menunggu pulsa rutin dari GPIO, atau mikrokontroler kecil kedua.

Kesalahan umum dan solusinya

GejalaKemungkinan penyebabSolusi
Board ter-reset setiap beberapa detikTimeout watchdog lebih pendek dari putaran loop() terlama (mis. WDTO_2S dengan delay(3000))Perpanjang timeout, pakai millis() alih-alih delay()
LED berkedip cepat, kode tidak bisa di-uploadBootloader lama tidak mematikan watchdog setelah reset watchdogTulis Optiboot lewat ISP, program board dengan opsi bootloader terbaru
Board macet tapi tidak pernah ter-resetFeed ada di dalam interrupt timer atau sub-perulangan yang tersangkutPindahkan wdt_reset() ke satu titik di loop()
ESP32 mengulang “Task watchdog got triggered”, tanpa resetTWDT tidak dalam mode panicAtur trigger_panic ke true (parameter kedua di 2.x)
Peringatan “IDLE (CPU 0)” di ESP32Task di core 0 berputar tanpa pernah menungguTambahkan vTaskDelay(1) ke perulangan
esp_task_wdt_reset() memberi error “task not found”Task belum ditambahkan ke TWDTPanggil esp_task_wdt_add(NULL) dulu
Koneksi Pico putus ketika dihentikan di Thonnymachine.WDT tidak bisa dihentikan begitu sudah mulaiPakai pin pemulihan, jalankan kode dengan nama selain main.py ketika menguji
Relay atau motor menyala sekejap tanpa sengaja ketika resetPin kembali menjadi input selama reset dan input driver mengambangTambahkan resistor pull-down ke output, atur kondisi aman di awal setup()

Hanya dengan beberapa baris kode, watchdog timer mengubah proyekmu dari eksperimen di meja menjadi perangkat yang bisa berjalan sendiri berhari-hari. Hilangkan dulu penyebab sebenarnya dari macet, lalu tambahkan watchdog sebagai lapisan pengaman terakhir dan letakkan feed di satu titik yang bermakna. Di aplikasi BlueGrays kamu bisa mengikuti langkah demi langkah proyek yang berjalan lama seperti koneksi Wi-Fi ESP32, web server, pembaruan OTA, cuaca, dan penyiraman pintar, lengkap dengan skema rangkaian dan kode, lalu menambahkan watchdog sendiri ke proyek-proyek itu.

Pertanyaan umum

Watchdog timer Arduino dipakai untuk apa?

Watchdog adalah timer bawaan yang otomatis me-reset board kalau program tidak mengirim sinyal “aku masih jalan” dalam waktu yang ditentukan. Ia menghidupkan lagi dalam hitungan detik proyek yang masuk ke perulangan tanpa akhir, tersangkut menunggu sensor, atau macet di library jaringan. Watchdog sangat penting terutama untuk perangkat penyiraman, alarm, dan IoT yang berjalan lama tanpa diawasi.

Bagaimana cara me-reset Arduino dari kode?

Di board AVR, cara paling bersih adalah mengaktifkan watchdog dengan timeout terpendek lalu menunggu: ketika kamu menulis wdt_enable(WDTO_15MS); while (true) {}, board mendapat reset hardware sungguhan hampir seketika. Di ESP32, ESP.restart() melakukan hal yang sama, dan di Raspberry Pi Pico dengan MicroPython, machine.reset(). Di Nano klon dengan bootloader lama, metode ini bisa memicu loop reset tanpa akhir.

Berapa timeout watchdog terlama?

Di Arduino Uno dan board AVR lain, waktu terlama adalah 8 detik (WDTO_8S). Di Raspberry Pi Pico batasnya 8388 ms, sedangkan di Task WDT ESP32 waktunya bisa diatur bebas. Kalau kamu butuh pengawasan lebih lama, kamu bisa membuat batas dalam skala menit dengan metode feed bersyarat, yang memberi feed ke watchdog hanya selama sistem sehat.

Bagaimana cara memperbaiki error “Task watchdog got triggered” di ESP32?

Pesan ini menunjukkan bahwa task yang diawasi tidak diberi feed dalam waktu yang ditentukan; penyebabnya biasanya perulangan while yang berputar tanpa menunggu, atau task FreeRTOS yang membuat idle task tidak kebagian jatah. Tambahkan vTaskDelay(1) atau delay(1) ke perulanganmu, pecah operasi panjang menjadi beberapa bagian, dan kalau kamu menambahkan task-mu sendiri ke TWDT, panggil esp_task_wdt_reset() secara rutin. Task yang disebut di pesan, misalnya IDLE (CPU 0), memberi tahu di core mana masalahnya.

Aku menambahkan watchdog dan Arduino-ku terus reset. Kenapa?

Penyebab paling umum adalah timeout watchdog yang lebih pendek dari putaran loop() terlama; misalnya memilih WDTO_2S padahal perulangannya berisi delay(3000). Buat timeout minimal dua kali waktu putaran terburuk dan pakai millis() alih-alih panggilan delay() yang panjang. Kalau LED berkedip cepat dan kode tidak bisa di-upload, masalahnya ada di bootloader lama; kamu perlu menulis Optiboot ke board dengan ISP.

Apakah variabel tetap tersimpan setelah reset watchdog?

Tidak, reset watchdog menyalakan ulang board dan setup() berjalan dari awal; variabel global kembali ke nilai awalnya. Informasi yang harus bertahan setelah reset, seperti penghitung, pengaturan, atau kondisi terakhir, sebaiknya ditulis ke EEPROM di Uno, ke Preferences (NVS) di ESP32, dan ke file di flash pada Pico.

Lihat semua proyek
LED Berkedip dengan ESP32
ES-1Pemula

LED Berkedip dengan ESP32

Mengajarkan penggunaan output GPIO dasar dengan ESP32. Kita membuat efek berkedip dengan menyalakan dan mematikan LED dari pin digital. Versi ESP32 dari proyek blink klasik di Arduino UNO; perintah blink dasar di lingkungan Arduino sama, tetapi susunan pin ESP32 dan level GPIO 3,3 V-nya berbeda dengan Arduino UNO.

4.7(37)
108
Kedip LED Bawaan Raspberry Pi Pico (Pico dan Pico W)
PI-1Pemula

Kedip LED Bawaan Raspberry Pi Pico (Pico dan Pico W)

Proyek pembuka seri Raspberry Pi Pico! Kita mengedipkan LED hijau bawaan untuk memastikan board bekerja; percobaan "Hello World" klasik. TANPA komponen eksternal, hanya Pico dan kabel USB. Kodenya ditulis dalam MicroPython (bahasa resmi dari Raspberry Pi Foundation). Pelajari kelas machine.Pin, mode Pin.OUT, metode led.on()/off(), dan time.sleep() di Thonny IDE, dan ikuti setiap perubahan di output Serial (REPL). Juga pas untuk menguji firmware MicroPython.

5.0(1)
10
Koneksi Wi-Fi STA ESP32 (dengan Layar LCD)
ES-25Mahir

Koneksi Wi-Fi STA ESP32 (dengan Layar LCD)

Di proyek ini, kita menyambungkan ESP32 ke jaringan Wi-Fi rumah dalam mode Station (STA) dengan cara yang aman dan tahan gangguan. Kita menyimpan SSID dan kata sandi di file secrets.h terpisah agar tidak bocor ke Git, menyiapkan mekanisme sambung ulang otomatis, dan menampilkan tingkat sinyal RSSI dan alamat IP di layar LCD I2C. LED bawaan bekerja sebagai indikator status. Ini adalah pengelola koneksi kelas produksi.

4.4(21)
38
Web Server Asinkron ESP32 (dengan Tampilan IP di LCD)
ES-27Mahir

Web Server Asinkron ESP32 (dengan Tampilan IP di LCD)

Di proyek ini, kita mengubah ESP32 menjadi web server asinkron yang bisa kamu kendalikan dari ponsel atau komputer di jaringan Wi-Fi yang sama. Berkat library ESPAsyncWebServer, server bisa memproses beberapa permintaan bersamaan (berbeda dengan WebServer.h klasik, yang memblokir pada satu permintaan). Kamu bisa membuka alamat IP ESP32 di browser dan mengklik tombol ON/OFF (rute /on dan /off) untuk menyalakan dan mematikan LED yang tersambung ke GPIO 5.

4.8(16)
26
Pembaruan OTA ESP32: Instal Firmware Tanpa Kabel (dengan Layar LCD)
ES-30Mahir
Premium

Pembaruan OTA ESP32: Instal Firmware Tanpa Kabel (dengan Layar LCD)

Di proyek ini, kamu belajar cara meng-upload firmware baru ke ESP32 lewat Wi-Fi tanpa kabel USB. Dengan library ArduinoOTA, ESP32 terlihat di jaringan dan otomatis tercantum sebagai bluegrays-ota di tab "Network port" Arduino IDE. Upload pertama dilakukan lewat USB, dan semua pembaruan berikutnya tanpa kabel; fitur penting untuk perangkat di lapangan. Layar LCD I2C menampilkan status Wi-Fi, alamat IP, nama host, persentase upload OTA, dan pesan error.

4.6(14)
22
HTTPClient + API Cuaca ESP32 (dengan Layar LCD)
ES-31Mahir
Premium

HTTPClient + API Cuaca ESP32 (dengan Layar LCD)

Di proyek ini, kita memakai ESP32 untuk melakukan panggilan REST API ke API cuaca (wttr.in) lewat internet dengan HTTPClient.h. Kita mengurai respons JSON yang diterima dengan ArduinoJson v7 dan menampilkan kota, suhu, kelembapan, cuaca, dan informasi angin di layar LCD I2C dalam bahasa Turki dan Inggris. wttr.in gratis dan tidak butuh kunci API; kamu cukup memasukkan nama kota apa pun untuk mengambil kondisi cuaca terkini kota itu. Data diperbarui otomatis setiap 30 menit.

4.7(13)
20
Sistem Alarm Gerakan ESP32 (PIR + Buzzer + LED + Telegram)
ES-41Mahir
Premium

Sistem Alarm Gerakan ESP32 (PIR + Buzzer + LED + Telegram)

Sistem alarm keamanan pintar yang menyalakan buzzer dan LED ketika sensor PIR mendeteksi gerakan, sekaligus mengirim notifikasi instan ke pemilik lewat Telegram. Cooldown 30 detik membatasi seberapa sering alarm berulang; mekanisme ini tidak memvalidasi deteksi PIR atau menghilangkan pemicu palsu. Cocok untuk rumah, garasi, gudang, atau ruang kerja. Dengan ESP32-CAM bisa ditambahkan notifikasi berfoto; dengan ESP32 DevKit V1 klasik, notifikasinya berupa teks.

9