Temeller · 9 dk okuma

Arduino Watchdog Timer: Kilitlenen Kartı Otomatik Resetleme

Arduino watchdog timer nedir? Uno'da avr/wdt.h, ESP32'de Task WDT, Pico'da machine.WDT ile kilitlenen kartı otomatik resetle; doğru yerleşim ve sık hatalar.

Arduino watchdog (bekçi köpeği zamanlayıcısı), programın kilitlendiğini fark edip kartı kendiliğinden yeniden başlatan donanımsal bir güvenlik zamanlayıcısıdır. Program düzenli aralıklarla "ben hâlâ çalışıyorum" sinyali gönderir; bu sinyal belirlenen süre içinde gelmezse watchdog, kartı reset düğmesine basılmış gibi sıfırlar. Böylece sonsuz döngüye giren, bir sensörü beklerken takılan ya da Wi-Fi kütüphanesinde donup kalan bir proje, sen yanına gidip fişi çekmeden birkaç saniye içinde kendine gelir.

Masanda deneme yaparken kilitlenen kartı elle resetlemek kolaydır; ama bahçedeki sulama sistemi, çatıdaki hava istasyonu ya da haftalarca açık kalan bir akıllı ev cihazı için bu mümkün değildir. Bu yazıda watchdog'un nasıl çalıştığını, Arduino Uno'da avr/wdt.h, ESP32'de Task WDT ve Raspberry Pi Pico'da machine.WDT kullanımını, besleme komutunun doğru yerini ve kartı sonsuz reset döngüsüne sokan klasik hataları örnek kodlarla öğreneceksin.

Arduino Uno kartı ve ATmega328P mikrodenetleyicisi
Arduino Uno'daki ATmega328P, kendi 128 kHz osilatörüyle çalışan dahili bir watchdog zamanlayıcısı barındırır; ek bir parça gerekmez.

Watchdog timer nedir, nasıl çalışır?

Watchdog, mikrodenetleyicinin içinde ana programdan bağımsız sayan küçük bir sayaçtır. Sen onu belirli bir süreyle, örneğin 2 saniyeyle başlatırsın ve sayaç saymaya başlar. Programın her turunda çağırdığın besleme komutu (İngilizcede "feed" ya da "kick the dog") sayacı sıfırlar. Program sağlıklı çalıştığı sürece sayaç hiçbir zaman sona ulaşmaz. Program bir yerde takılırsa besleme gelmez, sayaç süreyi doldurur ve watchdog mikrodenetleyiciye donanım reseti uygular. Reset sonrası kart tıpkı yeni açılmış gibi setup() fonksiyonundan başlar.

Watchdog'un güvenilir olmasının sırrı, ana saatten ayrı bir saat kaynağıyla çalışmasıdır. Arduino Uno'daki ATmega328P'de bu kaynak dahili 128 kHz'lik bir osilatördür; ana programın 16 MHz'lik kristali ya da kod akışı bozulsa bile watchdog saymaya devam eder. Kilitlenmenin tipik sebepleri şunlardır: çıkış koşulu hiç gerçekleşmeyen bir while döngüsü, cevap vermeyen bir I2C sensörünü sonsuza kadar bekleyen bir kütüphane, String birleştirmelerinin zamanla parçaladığı RAM, taşan bir dizi yüzünden bozulan bellek ya da elektriksel gürültünün programı rastgele bir adrese atlatması.

ÖzellikArduino Uno (ATmega328P)ESP32Raspberry Pi Pico (RP2040)
Kütüphane / modülavr/wdt.hesp_task_wdt.hmachine.WDT (MicroPython)
Başlatmawdt_enable(WDTO_2S)esp_task_wdt_init / reconfigure + esp_task_wdt_add(NULL)WDT(timeout=5000)
Beslemewdt_reset()esp_task_wdt_reset()wdt.feed()
En uzun süre8 sAyarlanabilir (Arduino varsayılanı 5 s)8388 ms (yaklaşık 8,3 s)
Durdurmawdt_disable()esp_task_wdt_delete() ile görev çıkarılırDurdurulamaz (yalnız reset ile kapanır)
Saat kaynağıDahili 128 kHz osilatörDonanım zamanlayıcı grubu (MWDT)1 µs'lik dahili tick üreteci

Watchdog neyi çözer, neyi çözmez?

  • Sonsuz döngüler: Beklenen bir değeri hiç gelmeyen while döngüsü ya da mantık hatası yüzünden takılan bir durum makinesi watchdog ile birkaç saniyede atlatılır.
  • Takılan kütüphaneler: Wi-Fi, MQTT ya da HTTP bağlantısında kilitlenen bir ağ kütüphanesi veya cevap vermeyen bir sensör sürücüsü kartı dondurursa reset onu temiz bir duruma döndürür.
  • Bellek bozulması: RAM'in parçalanması ya da yığının (stack) taşması sonucu program tuhaf davranıp çökerse watchdog kartı yeniden ayağa kaldırır.
  • Elektriksel gürültü: Röle, motor ya da uzun kablolardan gelen parazit programı rastgele bir noktaya atlatırsa beslemenin kesilmesi kurtarıcı olur.
  • Çözmediği durumlar: Besleme gerilimi düşüklüğü (brownout), kilitlenen harici bir sensör ya da yanlış hesaplanan bir değer. Watchdog yalnızca mikrodenetleyiciyi resetler; I2C hattını kilitli tutan bir sensör kendi gücü kesilmeden çoğu zaman düzelmez. Program yanlış ama düzenli çalışıyorsa watchdog bunu fark edemez.
Watchdog bir hata çözümü değil, emniyet kemeridir. Kartın her gün birkaç kez resetlendiğini görüyorsan asıl sorunu bul: çoğu zaman yetersiz güç kaynağı, bellek sızıntısı ya da zaman aşımı olmayan bir bekleme döngüsüdür. Rastgele resetlerin donanım kaynaklı sebepleri için Arduino Sürekli Resetleniyor yazısına göz at.

Arduino Uno'da watchdog: avr/wdt.h

AVR tabanlı kartlarda (Uno, Nano, Mega, Pro Mini) watchdog için ek kütüphane kurmana gerek yoktur; derleyiciyle birlikte gelen avr/wdt.h başlık dosyası yeterlidir. Üç temel fonksiyon vardır: wdt_enable(süre) watchdog'u başlatır, wdt_reset() sayacı sıfırlar (besler), wdt_disable() ise kapatır. Süre, aşağıdaki hazır sabitlerden biriyle verilir; yaklaşık 15 ms ile 8 saniye arasında on seçenek bulunur. 8 saniyeden uzun bir süreyi doğrudan seçemezsin, ama birazdan göreceğin koşullu besleme yöntemiyle daha uzun sınırlar kurabilirsin.

SabitYaklaşık süreTipik kullanım
WDTO_15MS15 msYazılımla anında reset
WDTO_30MS30 msNadiren kullanılır
WDTO_60MS60 msNadiren kullanılır
WDTO_120MS120 msÇok kısa kontrol döngüleri
WDTO_250MS250 msHızlı tepki gereken döngüler
WDTO_500MS500 msButon ve LED kontrolü
WDTO_1S1 sBasit kontrol döngüleri
WDTO_2S2 sSensör okuma ve ekran güncelleme
WDTO_4S4 sYavaş sensörler, haberleşme
WDTO_8S8 sAğ işlemleri, uzun hesaplamalar

Adım adım: ilk watchdog denemesi

  1. Arduino Uno'yu USB ile bilgisayara bağla; dahili LED (13. pin) dışında ek devre gerekmez.
  2. Aşağıdaki kodu yükle ve Seri Monitör'ü 9600 baud hızında aç.
  3. Ekranda "Basladi" yazısını ve yarım saniyede bir yanıp sönen LED'i gör.
  4. Seri Monitör'den k harfini gönder; program kasıtlı olarak sonsuz döngüye girer ve LED olduğu yerde donar.
  5. Yaklaşık 2 saniye sonra kart kendiliğinden resetlenir, "Basladi" yazısı yeniden gelir ve LED tekrar yanıp sönmeye başlar.
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}

setup()'ın en başındaki MCUSR = 0 satırı reset bayraklarını temizler; ATmega328P'de watchdog reset bayrağı (WDRF) silinmeden watchdog kapatılamaz, bu yüzden wdt_disable() ondan sonra gelir. Watchdog'u kurulum işlemleri bittikten sonra, setup()'ın sonunda etkinleştiriyoruz; böylece uzun süren bir sensör başlatma işlemi yanlışlıkla reset tetiklemez. loop()'un ilk satırındaki wdt_reset() her turda sayacı sıfırlar. LED'i delay() yerine millis() ile yakıp söndürmemiz de bilinçli bir tercihtir: loop() hiç beklemeden döner ve watchdog'u milisaniyeler içinde tekrar tekrar besler.

Watchdog'u kasıtlı tetiklemek, kodla kartı resetlemenin en temiz yoludur: wdt_enable(WDTO_15MS); while (true) {} yazdığında kart çok kısa sürede gerçek bir donanım reseti alır. Sık görülen "0 adresine atlama" yöntemi ise yalnızca programı baştan başlatır, donanım birimlerini sıfırlamaz. Tablodaki sürelerin tipik değerler olduğunu da unutma; 128 kHz osilatör sıcaklığa ve besleme gerilimine göre kayar, bu yüzden watchdog'u hassas zamanlama için değil, yalnızca emniyet için kullan.

Eski bootloader ve sonsuz reset döngüsü

Watchdog reset attığında ATmega328P watchdog'u kapatmaz; tersine, en kısa süreyle (yaklaşık 16 ms) açık bırakır. Kartın açılışta ilk çalıştırdığı program olan bootloader bu durumu ele almazsa, daha kod yükleme için beklerken watchdog'un süresi dolar ve kart tekrar resetlenir. Sonuç, LED'in hızla yanıp söndüğü, kodun hiç başlamadığı ve yeni kodun da yüklenemediği bir sonsuz reset döngüsüdür. Orijinal Arduino Uno'daki Optiboot bootloader açılışta watchdog'u kapattığı için bu sorunu yaşamaz. Sorun daha çok eski bootloader taşıyan Nano klonlarında ve bazı eski Mega 2560 kartlarında görülür.

Arduino IDE'de kartını ATmega328P (Old Bootloader) seçeneğiyle programlıyorsan watchdog'u denemeden önce dikkatli ol. Kart döngüye girerse, ikinci bir Arduino'yu ISP programlayıcı olarak kullanıp Araçlar menüsündeki Burn Bootloader (Bootloader Yaz) komutuyla karta güncel Optiboot bootloader'ı yazman gerekir. Optiboot'lu kartlarda da setup()'ın başındaki MCUSR = 0 ve wdt_disable() satırlarını korumak iyi bir alışkanlıktır.

Besleme komutunu nereye koymalısın?

  • Tek ve merkezi bir yer seç: wdt_reset()'i loop()'un içinde, bütün işlerin geçtiği tek bir noktaya koy. Kodun her köşesine besleme serpiştirirsen takılan bir alt döngü kendi kendini beslemeye devam eder ve watchdog'un anlamı kalmaz.
  • Kesme içinde besleme yapma: Bir zamanlayıcı kesmesi ana program donmuş olsa bile çalışmayı sürdürür. Beslemeyi oraya koyarsan watchdog hiçbir kilitlenmeyi yakalayamaz. Kesmelerin nasıl çalıştığını Arduino Interrupt yazısında bulabilirsin.
  • Süreyi en uzun işleme göre seç: loop()'un bir turu en kötü durumda ne kadar sürüyorsa watchdog süresi bunun en az iki katı olsun. delay(3000) içeren bir döngüde WDTO_2S kullanırsan kart sürekli resetlenir.
  • Bekleme döngülerine zaman aşımı ekle: while (!Serial.available()) gibi bir döngünün içine besleme koymak yerine, döngüden belirli bir süre sonra çıkılmasını sağla. Böylece hem kart donmaz hem de watchdog gerçek kilitlenmeler için tetikte kalır.
  • Watchdog'u kurulumdan sonra aç: Wi-Fi bağlantısı, SD kart başlatma ya da sensör kalibrasyonu gibi uzun işlemler setup()'ta bittikten sonra watchdog'u etkinleştir.

Daha akıllı bir yaklaşım, beslemeyi bir koşula bağlamaktır: watchdog'u yalnızca sistem gerçekten sağlıklıysa beslersin. Aşağıdaki örnekte A0'a bağlı bir sensör 5 saniyede bir okunur; okunan değer anlamlı aralıktaysa son başarılı ölçüm zamanı güncellenir. 60 saniye boyunca hiç başarılı ölçüm olmazsa besleme durur ve 4 saniye sonra kart resetlenir. Bu yöntemle AVR'nin 8 saniyelik sınırını aşan, dakikalar mertebesinde bir denetim kurmuş olursun; üstelik yalnızca donmayı değil, kopan bir sensör kablosu gibi sessiz arızaları da yakalarsın.

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}

ESP32'de watchdog: Task WDT ve Interrupt WDT

ESP32'de watchdog zaten varsayılan olarak çalışır; çoğu kişi bunu ilk kez seri ekranda beklenmedik bir "Task watchdog got triggered" mesajı görünce fark eder. ESP32, FreeRTOS işletim sistemiyle birden fazla görevi (task) aynı anda yürüttüğü için tek bir sayaç yerine katmanlı bir yapı kullanır. Task WDT (TWDT) kendisine abone olan görevlerin belirli sürede beslenip beslenmediğini izler; Interrupt WDT (IWDT) ise kesmelerin ve görev zamanlayıcısının uzun süre bloklanmasını yakalar. Arduino çekirdeğinde TWDT genellikle 5 saniyelik süreyle açıktır ve boşta (idle) görevlerini izler; loop()'u çalıştıran görev ise sen eklemedikçe izlenmez. Varsayılan davranış çekirdek sürümüne göre değişebilir ve kimi ayarda TWDT yalnızca uyarı basar, kartı resetlemez; bu yüzden süreyi ve reset davranışını kodla açıkça ayarlamak en güvenlisidir.

TürNe izler?Tipik süreTetiklenince görülen mesaj
Task WDT (TWDT)Abone görevlerin ve idle görevlerinin düzenli çalışması5 s (ayarlanabilir)task_wdt: Task watchdog got triggered
Interrupt WDT (IWDT)Kesmelerin ve görev zamanlayıcısının bloklanmasıYaklaşık 300 msGuru Meditation Error ... Interrupt wdt timeout on CPU1
RTC WDTÖnyükleme sürecinin takılmasıÖnyükleme sırasında kısa sürerst: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}

Kod, çekirdek sürümünü ESP_ARDUINO_VERSION_MAJOR ile kontrol eder: 3.x sürümünde (ESP-IDF 5) ayarlar esp_task_wdt_config_t yapısıyla verilir ve zaten çalışan TWDT esp_task_wdt_reconfigure() ile güncellenir; 2.x sürümünde ise esp_task_wdt_init() doğrudan saniye cinsinden süre ve panik bayrağı alır. trigger_panic true olduğunda süre dolunca ESP32 hata dökümünü seri ekrana yazar ve kendini resetler. esp_task_wdt_add(NULL) o anda çalışan görevi, yani setup() ve loop()'u yürüten görevi izlemeye alır. Açılışta esp_reset_reason() ile önceki resetin sebebini okuyup kaydetmek, sahadaki bir cihazın neden yeniden başladığını anlamanın en kolay yoludur. Hiç ayar yapmadan yalnızca loop()'u izletmek istersen setup()'ta Arduino çekirdeğinin enableLoopWDT() fonksiyonunu çağırabilirsin; bu durumda besleme her loop() turunun başında otomatik yapılır.

ESP32'de en sık görülen watchdog hatası, kendi oluşturduğun bir FreeRTOS görevinin içinde hiç beklemeyen bir döngü yazmaktır. Örneğin çekirdek 0'a sabitlenmiş bir görevde while (true) { sensoruOku(); } yazarsan aynı çekirdekteki boşta görevi hiç çalışamaz, Wi-Fi yığını aksar ve birkaç saniye sonra "Task watchdog got triggered ... IDLE (CPU 0)" mesajı belirir. Her döngüye en az vTaskDelay(1) ya da delay(1) ekle. Görevlerle ilgili ayrıntılar ESP32 FreeRTOS ve çift çekirdek yazısında, "Guru Meditation" mesajlarının anlamı ise ESP32 Brownout ve Guru Meditation yazısında.

Raspberry Pi Pico'da watchdog (MicroPython)

RP2040'ın donanım watchdog'u MicroPython'da machine.WDT sınıfıyla kullanılır. Süre milisaniye cinsinden verilir ve RP2040'ta en fazla 8388 ms olabilir. Önemli bir fark var: Pico'da watchdog bir kez başlatıldıktan sonra kodla durdurulamaz, ancak reset ile kapanır. Bu yüzden geliştirme sırasında küçük bir kurtarma yolu bırakmak hayat kurtarır. Aşağıdaki kodda GP15 pini açılışta GND'ye bağlıysa watchdog hiç başlatılmaz ve program REPL'e düşer. machine.reset_cause() ile de kartın watchdog yüzünden mi yoksa normal açılışla mı başladığını öğrenebilirsin. Pico'yu MicroPython yerine Arduino IDE ile (arduino-pico çekirdeği) programlıyorsan aynı iş rp2040.wdt_begin(5000) ve rp2040.wdt_reset() fonksiyonlarıyla yapılır.

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)
Thonny'de watchdog'lu bir programı Durdur düğmesiyle kestiğinde watchdog saymaya devam eder ve birkaç saniye içinde Pico resetlenip bağlantı kopar. Kodu önce main.py dışında bir dosya adıyla dene; her şey yolunda olunca main.py olarak kaydet. Kart döngüye girerse GP15'i GND'ye bağlayıp resetlemen yeterli. MicroPython'a yeni başlıyorsan MicroPython temelleri yazısı iyi bir başlangıçtır.

Uzun süre çalışan IoT projelerinde watchdog stratejisi

  • Açılışları kaydet: Her açılışta bir sayacı Uno'da EEPROM'a, ESP32'de Preferences (NVS) belleğine yaz; ESP32'de esp_reset_reason() ile sebebini de sakla. Haftada bir reset kabul edilebilir, saatte bir reset ise düzeltilmesi gereken bir hatadır. Uno'da Optiboot reset bayraklarını sildiği için sebebi MCUSR'den okumak çoğu zaman mümkün olmaz; açılış sayacı yine de cihazın ne sıklıkla yeniden başladığını gösterir.
  • Ağ işlemlerine zaman aşımı koy: Wi-Fi bağlantısını sonsuza kadar bekleme; örneğin 15 saniye içinde bağlanamazsa döngüden çık ve bir süre sonra yeniden dene. HTTPClient'ta setTimeout(), AVR'de Wire.setWireTimeout() gibi ayarlar takılan bir işlemin watchdog süresini aşmasını önler. Bağlantı sorunları için ESP32 Wi-Fi Bağlanmıyor yazısına bak.
  • OTA güncellemesini hesaba kat: Kablosuz yükleme saniyeler sürer ve bu sırada loop() beklemede kalabilir. ArduinoOTA'nın onProgress geri çağrısında esp_task_wdt_reset() çağırarak güncellemenin yarıda kesilmesini önleyebilirsin; bu, kuralı bozan nadir ama haklı bir istisnadır.
  • Uyku modlarını düşün: Uno'da watchdog kesme modunda uyandırma zamanlayıcısı olarak kullanılıp 8 saniyelik aralıklarla uyunabilir. ESP32'de deep sleep sırasında işlemci kapalıdır ve uyanınca kod baştan başlar. Ayrıntılar için ESP32 Deep Sleep yazısına göz at.
  • Harici sensörlerin gücünü yönet: Watchdog sensörü resetlemez. Sık takılan bir I2C sensörünün beslemesini bir transistör ya da MOSFET üzerinden verip açılışta birkaç yüz milisaniye kesip açarsan, mikrodenetleyiciyle birlikte sensör de temiz başlar. I2C hattının nasıl kilitlendiğini I2C Nedir yazısında okuyabilirsin.
  • Kritik sistemlerde harici watchdog: Dahili watchdog yalnızca mikrodenetleyicinin kendi hatalarını yakalar. Bütün devreyi denetlemek gerekiyorsa bir GPIO'dan düzenli darbe bekleyen harici bir watchdog entegresi ya da ikinci küçük bir mikrodenetleyici kullanılır.

Sık hatalar ve çözümleri

BelirtiMuhtemel sebepÇözüm
Kart birkaç saniyede bir resetleniyorWatchdog süresi loop()'un en uzun turundan kısa (ör. delay(3000) ile WDTO_2S)Süreyi uzat, delay() yerine millis() kullan
LED hızla yanıp sönüyor, kod yüklenmiyorEski bootloader watchdog resetinden sonra watchdog'u kapatmıyorISP ile Optiboot yaz, kartı güncel bootloader seçeneğiyle programla
Kart kilitleniyor ama hiç resetlenmiyorBesleme bir zamanlayıcı kesmesinde ya da takılan alt döngünün içindewdt_reset()'i loop()'taki tek bir noktaya taşı
ESP32'de "Task watchdog got triggered" tekrar ediyor, reset yokTWDT panik modunda değiltrigger_panic değerini true yap (2.x'te ikinci parametre)
ESP32'de "IDLE (CPU 0)" uyarısıÇekirdek 0'daki bir görev hiç beklemeden dönüyorDöngüye vTaskDelay(1) ekle
esp_task_wdt_reset() "task not found" hatası veriyorGörev TWDT'ye eklenmemişÖnce esp_task_wdt_add(NULL) çağır
Pico, Thonny'de durdurulunca bağlantı kopuyormachine.WDT bir kez başlayınca durdurulamazKurtarma pini kullan, testte kodu main.py dışında çalıştır
Reset anında röle ya da motor bir an istemeden çalışıyorReset sırasında pinler girişe döner, sürücü girişi boşta kalırÇıkışlara pull-down direnç ekle, setup()'ın başında güvenli duruma al

Watchdog timer, birkaç satır kodla projeni masadaki bir denemeden günlerce kendi başına çalışabilen bir cihaza dönüştürür. Önce kilitlenmelerin asıl sebeplerini gider, sonra watchdog'u son emniyet katmanı olarak ekle ve beslemeyi tek, anlamlı bir noktaya koy. BlueGrays uygulamasında ESP32 Wi-Fi bağlantısı, web sunucusu, OTA güncelleme, hava durumu ve akıllı sulama gibi uzun süre açık kalan projeleri devre şemaları ve kodlarıyla adım adım inceleyip watchdog'u bu projelere kendin ekleyebilirsin.

Sıkça sorulan sorular

Arduino watchdog timer ne işe yarar?

Watchdog, program belirlenen süre içinde "hâlâ çalışıyorum" sinyali göndermezse kartı otomatik olarak resetleyen dahili bir zamanlayıcıdır. Sonsuz döngüye giren, bir sensörü beklerken takılan ya da ağ kütüphanesinde donan projeleri birkaç saniye içinde kendine getirir. Özellikle uzun süre gözetimsiz çalışan sulama, alarm ve IoT cihazlarında vazgeçilmezdir.

Arduino'yu kodla nasıl resetlerim?

AVR kartlarda en temiz yol watchdog'u en kısa süreyle açıp beklemektir: wdt_enable(WDTO_15MS); while (true) {} yazdığında kart çok kısa sürede gerçek bir donanım reseti alır. ESP32'de ESP.restart(), Raspberry Pi Pico'da MicroPython ile machine.reset() aynı işi görür. Eski bootloader'lı Nano klonlarında bu yöntem sonsuz reset döngüsüne yol açabilir.

Watchdog süresi en fazla ne kadar olabilir?

Arduino Uno ve diğer AVR kartlarda en uzun süre 8 saniyedir (WDTO_8S). Raspberry Pi Pico'da sınır 8388 ms, ESP32'nin Task WDT'sinde ise süre serbestçe ayarlanabilir. Daha uzun bir denetim gerekiyorsa watchdog'u yalnızca sistem sağlıklıyken besleyen koşullu besleme yöntemiyle dakikalar mertebesinde sınırlar kurabilirsin.

ESP32 "Task watchdog got triggered" hatası nasıl düzeltilir?

Bu mesaj, izlenen bir görevin belirlenen sürede beslenmediğini gösterir; sebep çoğunlukla hiç beklemeden dönen bir while döngüsü ya da boşta görevini aç bırakan bir FreeRTOS görevidir. Döngülerine vTaskDelay(1) ya da delay(1) ekle, uzun işlemleri parçalara böl ve kendi görevini TWDT'ye eklediysen düzenli olarak esp_task_wdt_reset() çağır. Mesajda adı geçen görev, örneğin IDLE (CPU 0), sorunun hangi çekirdekte olduğunu söyler.

Watchdog ekledim, Arduino sürekli resetleniyor. Neden?

En sık sebep, watchdog süresinin loop()'un en uzun turundan kısa olmasıdır; örneğin döngüde delay(3000) varken WDTO_2S seçmek. Süreyi en kötü durumdaki tur süresinin en az iki katı yap ve uzun delay() yerine millis() kullan. LED hızla yanıp sönüyor ve kod yüklenemiyorsa sorun eski bootloader'dır; karta ISP ile Optiboot yazman gerekir.

Watchdog reseti sonrası değişkenler korunur mu?

Hayır, watchdog reseti kartı yeniden başlatır ve setup() baştan çalışır; global değişkenler ilk değerlerine döner. Reset sonrasında saklanması gereken sayaç, ayar ya da son durum gibi bilgileri Uno'da EEPROM'a, ESP32'de Preferences (NVS) belleğine, Pico'da flash üzerindeki bir dosyaya yazmalısın.

Tüm projeleri gör
ESP32 ile LED Yakma
ES-1Başlangıç

ESP32 ile LED Yakma

ESP32 ile temel GPIO çıkışı kullanımını öğretir. Bir LED'i dijital pinden açıp kapatarak yanıp sönme efekti elde ederiz. Arduino UNO'daki klasik blink projesinin ESP32 versiyonu; Arduino ortamındaki temel blink komutları aynıdır, ancak ESP32'nin pin yerleşimi ve 3,3 V GPIO seviyeleri Arduino UNO'dan farklıdır.

4.7(37)
108
Raspberry Pi Pico Dahili LED Yakma (Pico ve Pico W)
PI-1Başlangıç

Raspberry Pi Pico Dahili LED Yakma (Pico ve Pico W)

Raspberry Pi Pico serisinin açılış projesi! Pico'nun üzerindeki yeşil dahili LED'i yakıp söndürerek kartın çalıştığını doğruluyoruz; klasik "Hello World" tarzı ilk deney. Harici bileşene gerek yok, Pico ve USB kablosu yeterli. Kod MicroPython ile yazıldı (Raspberry Pi Vakfı'nın resmî olarak desteklediği dil).

5.0(1)
10
ESP32 Wi-Fi STA Bağlantısı (LCD Ekranlı)
ES-25İleri

ESP32 Wi-Fi STA Bağlantısı (LCD Ekranlı)

Bu projede ESP32'yi Station (STA) modunda evdeki Wi-Fi ağına güvenli ve hata toleranslı şekilde bağlıyoruz. SSID/şifreyi secrets.h dosyasına ayırarak Git'e sızmasını önlüyor, otomatik yeniden bağlanma mekanizması kuruyor, RSSI sinyal seviyesini ve IP adresini I2C LCD ekranda gösteriyoruz. Dahili LED durum göstergesi olarak çalışır. Üretim seviyesi bir bağlantı yöneticisidir.

4.4(21)
38
ESP32 Async Web Server (LCD'de IP Göstergeli)
ES-27İleri

ESP32 Async Web Server (LCD'de IP Göstergeli)

Bu projede ESP32'yi aynı Wi-Fi ağındaki telefonunuzdan veya bilgisayarınızdan kontrol edebileceğiniz asenkron bir web sunucusuna dönüştürüyoruz. ESPAsyncWebServer kütüphanesi sayesinde sunucu birden fazla isteği aynı anda işleyebiliyor (klasik WebServer.h gibi tek istekte bloklamıyor). Tarayıcıdan ESP32'nin IP adresine bağlanıp ON/OFF butonlarına basarak (/on ve /off adresleri) GPIO 5'e bağlı LED'i açıp kapatabileceksiniz.

4.8(16)
26
ESP32 OTA Update — Kablosuz Firmware Yükleme (LCD Ekranlı)
ES-30İleri
Premium

ESP32 OTA Update — Kablosuz Firmware Yükleme (LCD Ekranlı)

Bu projede ESP32'ye USB kablosu olmadan, Wi-Fi üzerinden yeni firmware yüklemeyi öğreneceksin. ArduinoOTA kütüphanesi ile ESP32 ağda görünür hale gelir ve Arduino IDE'nin "Network port" sekmesinde bluegrays-ota olarak otomatik listelenir. İlk yükleme USB ile yapılır, sonrasında tüm güncellemeler kablosuz olur; sahadaki cihazlar için çok önemli bir özellik.

4.6(14)
22
ESP32 HTTPClient + Hava Durumu API (LCD Ekranlı)
ES-31İleri
Premium

ESP32 HTTPClient + Hava Durumu API (LCD Ekranlı)

Bu projede ESP32 ile internet üzerinden hava durumu API'sine (wttr.in) HTTPClient.h kullanarak REST API çağrısı yapıyoruz. ArduinoJson v7 ile gelen JSON cevabını çözümleyip şehir, sıcaklık, nem, hava durumu ve rüzgâr bilgilerini I2C LCD ekranda gösteriyoruz. wttr.in API anahtarı istemez; istediğin şehrin adını yazman yeterli.

4.7(13)
20
ESP32 Hareket Alarm Sistemi (PIR + Buzzer + LED + Telegram)
ES-41İleri
Premium

ESP32 Hareket Alarm Sistemi (PIR + Buzzer + LED + Telegram)

PIR sensörü hareket algıladığında buzzer'ı ve LED'i çalıştıran, aynı anda Telegram üzerinden sahibine anlık bildirim gönderen akıllı bir güvenlik alarm sistemi. Tekrarlayan alarmların sıklığını sınırlamak için 30 saniyelik bekleme süresi (cooldown) vardır; bu süre PIR sensörünün yanlış algılamalarını ortadan kaldırmaz. Ev, garaj, depo veya çalışma odası gibi alanlarda kullanılabilir.

9