Əsaslar · 9 dəq oxu

Arduino Watchdog Timer: donan platanı avtomatik resetləmək

Arduino watchdog timer nədir? Uno-da avr/wdt.h, ESP32-də Task WDT, Pico-da machine.WDT ilə donan platanı avtomatik resetlə; düzgün yerləşdirmə və tez-tez edilən xətalar.

Arduino watchdog (gözətçi it taymeri) proqramın donduğunu hiss edib platanı öz-özünə yenidən başladan aparat təhlükəsizlik taymeridir. Proqram müntəzəm aralıqlarla "mən hələ işləyirəm" siqnalı göndərir; bu siqnal təyin olunmuş müddət ərzində gəlməsə, watchdog platanı reset düyməsinə basılmış kimi sıfırlayır. Beləliklə, sonsuz dövrə düşən, sensoru gözləyərkən ilişən və ya Wi-Fi kitabxanasında donub qalan layihə, sən yanına gedib fişi çıxarmadan bir neçə saniyə ərzində özünə gəlir.

Masa üstündə sınaqdan keçirərkən donan platanı əllə resetləmək asandır; amma bağçadakı suvarma sistemi, damdakı hava stansiyası və ya həftələrlə açıq qalan ağıllı ev cihazı üçün bu mümkün deyil. Bu yazıda watchdog-un necə işlədiyini, Arduino Uno-da avr/wdt.h, ESP32-də Task WDT və Raspberry Pi Pico-da machine.WDT istifadəsini, qidalandırma komandasının düzgün yerini və platanı sonsuz reset dövrünə salan klassik xətaları nümunə kodlarla öyrənəcəksən.

Arduino Uno platası və ATmega328P mikrokontrolleri
Arduino Uno-dakı ATmega328P öz 128 kHz osilyatoru ilə işləyən daxili watchdog taymeri daşıyır; əlavə hissə lazım deyil.

Watchdog timer nədir, necə işləyir?

Watchdog mikrokontrollerin içində əsas proqramdan asılı olmadan sayan kiçik bir sayğacdır. Sən onu müəyyən müddətlə, məsələn 2 saniyə ilə işə salırsan və sayğac saymağa başlayır. Proqramın hər turunda çağırdığın qidalandırma komandası (ingilis dilində "feed" və ya "kick the dog") sayğacı sıfırlayır. Proqram sağlam işlədiyi müddətcə sayğac heç vaxt sona çatmır. Proqram haradasa ilişərsə, qidalandırma gəlmir, sayğac müddəti doldurur və watchdog mikrokontrollerə aparat reseti tətbiq edir. Resetdən sonra plata yenicə qoşulmuş kimi setup() funksiyasından başlayır.

Watchdog-un etibarlı olmasının sirri əsas saatdan ayrı saat mənbəyi ilə işləməsidir. Arduino Uno-dakı ATmega328P-də bu mənbə daxili 128 kHz-lik osilyatordur; əsas proqramın 16 MHz-lik kvarsı və ya kodun axını pozulsa belə, watchdog saymağa davam edir. Donmanın tipik səbəbləri bunlardır: çıxış şərti heç vaxt yerinə yetməyən while dövrü, cavab verməyən I2C sensorunu sonsuza qədər gözləyən kitabxana, String birləşdirmələrinin zamanla parçaladığı RAM, daşan massiv səbəbindən pozulan yaddaş və ya elektrik küyünün proqramı təsadüfi ünvana atlatması.

XüsusiyyətArduino Uno (ATmega328P)ESP32Raspberry Pi Pico (RP2040)
Kitabxana / modulavr/wdt.hesp_task_wdt.hmachine.WDT (MicroPython)
İşə salmawdt_enable(WDTO_2S)esp_task_wdt_init / reconfigure + esp_task_wdt_add(NULL)WDT(timeout=5000)
Qidalandırmawdt_reset()esp_task_wdt_reset()wdt.feed()
Ən uzun müddət8 sTənzimlənir (Arduino üçün standart 5 san)8388 ms (təxminən 8,3 san)
Dayandırmawdt_disable()Tapşırıq esp_task_wdt_delete() ilə çıxarılırDayandırmaq olmur (yalnız reset ilə söndürülür)
Saat mənbəyiDaxili 128 kHz osilyatorAparat taymer qrupu (MWDT)1 µs-lik daxili tick generatoru

Watchdog nəyi həll edir, nəyi etmir?

  • Sonsuz dövrlər: Gözlənilən dəyəri heç gəlməyən while dövrü və ya məntiq xətası səbəbindən ilişən vəziyyət maşını watchdog ilə bir neçə saniyəyə aradan qaldırılır.
  • İlişən kitabxanalar: Wi-Fi, MQTT və ya HTTP əlaqəsində donan şəbəkə kitabxanası və ya cavab verməyən sensor drayveri platanı dondurarsa, reset onu təmiz vəziyyətə qaytarır.
  • Yaddaşın pozulması: RAM-ın parçalanması və ya stekin (stack) daşması nəticəsində proqram qəribə davranıb çökərsə, watchdog platanı yenidən ayağa qaldırır.
  • Elektrik küyü: Rele, mühərrik və ya uzun naqillərdən gələn müdaxilə proqramı təsadüfi nöqtəyə atlatarsa, qidalandırmanın kəsilməsi xilasedici olur.
  • Həll etmədiyi hallar: Qida gərginliyinin aşağı olması (brownout), donan xarici sensor və ya səhv hesablanmış dəyər. Watchdog yalnız mikrokontrolleri resetləyir; I2C xəttini kilidli saxlayan sensor öz qidası kəsilmədən çox vaxt düzəlmir. Proqram səhv, amma müntəzəm işləyirsə, watchdog bunu hiss edə bilməz.
Watchdog xətanın həlli deyil, təhlükəsizlik kəməridir. Platanın gündə bir neçə dəfə resetləndiyini görürsənsə, əsl problemi tap: çox vaxt qida mənbəyinin çatışmazlığı, yaddaş sızması və ya vaxt aşımı olmayan gözləmə dövrü olur. Təsadüfi resetlərin aparat mənşəli səbəbləri üçün Arduino daim resetlənir yazısına nəzər sal.

Arduino Uno-da watchdog: avr/wdt.h

AVR əsaslı platalarda (Uno, Nano, Mega, Pro Mini) watchdog üçün əlavə kitabxana quraşdırmağa ehtiyac yoxdur; kompilyatorla gələn avr/wdt.h başlıq faylı kifayətdir. Üç əsas funksiya var: wdt_enable(müddət) watchdog-u işə salır, wdt_reset() sayğacı sıfırlayır (qidalandırır), wdt_disable() isə söndürür. Müddət aşağıdakı hazır sabitlərdən biri ilə verilir; təxminən 15 ms ilə 8 saniyə arasında on seçim var. 8 saniyədən uzun müddəti birbaşa seçə bilməzsən, amma azca sonra görəcəyin şərti qidalandırma üsulu ilə daha uzun hədlər qura bilərsən.

SabitTəxmini müddətTipik istifadə
WDTO_15MS15 msProqramla ani reset
WDTO_30MS30 msNadir istifadə olunur
WDTO_60MS60 msNadir istifadə olunur
WDTO_120MS120 msÇox qısa idarəetmə dövrləri
WDTO_250MS250 msSürətli reaksiya tələb edən dövrlər
WDTO_500MS500 msDüymə və LED idarəsi
WDTO_1S1 sSadə idarəetmə dövrləri
WDTO_2S2 sSensor oxuma və ekran yeniləmə
WDTO_4S4 sYavaş sensorlar, rabitə
WDTO_8S8 sŞəbəkə əməliyyatları, uzun hesablamalar

Addım-addım: ilk watchdog sınağı

  1. Arduino Uno-nu USB ilə kompüterə qoş; daxili LED (13-cü pin) xaricində əlavə dövrə lazım deyil.
  2. Aşağıdakı kodu yüklə və Serial Monitor-u 9600 baud sürətində aç.
  3. Ekranda "Basladi" yazısını və yarım saniyədən bir yanıb-sönən LED-i gör.
  4. Serial Monitor-dan k hərfini göndər; proqram qəsdən sonsuz dövrə girir və LED olduğu yerdə donur.
  5. Təxminən 2 saniyə sonra plata öz-özünə resetlənir, "Basladi" yazısı yenidən gəlir və LED yenə yanıb-sönməyə başlayır.
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 ən başındakı MCUSR = 0 sətri reset bayraqlarını təmizləyir; ATmega328P-də watchdog reset bayrağı (WDRF) silinmədən watchdog söndürülə bilmir, ona görə wdt_disable() ondan sonra gəlir. Watchdog-u quraşdırma əməliyyatları bitdikdən sonra, setup()-ın sonunda aktivləşdiririk; beləliklə, uzun çəkən sensor işə salınması yanlışlıqla reset tetikləmir. loop()-un ilk sətrindəki wdt_reset() hər turda sayğacı sıfırlayır. LED-i delay() əvəzinə millis() ilə yandırıb söndürməyimiz də şüurlu seçimdir: loop() heç gözləmədən dönür və watchdog-u millisaniyələr ərzində dönə-dönə qidalandırır.

Watchdog-u qəsdən tətikləmək platanı kodla resetləməyin ən təmiz yoludur: wdt_enable(WDTO_15MS); while (true) {} yazanda plata çox qısa müddətdə həqiqi aparat reseti alır. Tez-tez görülən "0 ünvanına atlama" üsulu isə yalnız proqramı baştan başladır, aparat bloklarını sıfırlamır. Cədvəldəki müddətlərin tipik dəyərlər olduğunu da unutma; 128 kHz osilyator temperatura və qida gərginliyinə görə sürüşür, ona görə watchdog-u dəqiq zamanlama üçün yox, yalnız təhlükəsizlik üçün istifadə et.

Köhnə bootloader və sonsuz reset dövrü

Watchdog reset atanda ATmega328P watchdog-u söndürmür; əksinə, ən qısa müddətlə (təxminən 16 ms) açıq saxlayır. Platanın açılışda ilk işlətdiyi proqram olan bootloader bu vəziyyəti nəzərə almasa, kod yükləməni hələ gözləyərkən watchdog-un müddəti bitir və plata yenidən resetlənir. Nəticə LED-in sürətlə yanıb-söndüyü, kodun heç başlamadığı və yeni kodun da yüklənə bilmədiyi sonsuz reset dövrüdür. Orijinal Arduino Uno-dakı Optiboot bootloader açılışda watchdog-u söndürdüyü üçün bu problemlə üzləşmir. Problem daha çox köhnə bootloader daşıyan Nano klonlarında və bəzi köhnə Mega 2560 platalarında görülür.

Arduino IDE-də platanı ATmega328P (Old Bootloader) seçimi ilə proqramlaşdırırsansa, watchdog-u sınamazdan əvvəl ehtiyatlı ol. Plata dövrə girərsə, ikinci Arduino-nu ISP proqramlaşdırıcı kimi istifadə edib Tools menyusundakı Burn Bootloader komandası ilə plataya güncəl Optiboot bootloader-ı yazmalısan. Optiboot-lu platalarda da setup()-ın başındakı MCUSR = 0 və wdt_disable() sətirlərini saxlamaq yaxşı vərdişdir.

Qidalandırma komandasını hara qoymalısan?

  • Tək və mərkəzi yer seç: wdt_reset()-i loop()-un içində, bütün işlərin keçdiyi tək nöqtəyə qoy. Kodun hər küncünə qidalandırma səpələsən, ilişən alt dövr özünü qidalandırmağa davam edər və watchdog-un mənası qalmaz.
  • Kəsmə daxilində qidalandırma etmə: Taymer kəsməsi əsas proqram donmuş olsa belə işləməyə davam edir. Qidalandırmanı ora qoysan, watchdog heç bir donmanı tuta bilməz. Kəsmələrin necə işlədiyini Arduino Interrupt yazısında tapa bilərsən.
  • Müddəti ən uzun əməliyyata görə seç: loop()-un bir turu ən pis halda nə qədər çəkirsə, watchdog müddəti bunun ən azı iki qatı olsun. delay(3000) olan dövrdə WDTO_2S istifadə etsən, plata daim resetlənər.
  • Gözləmə dövrlərinə vaxt aşımı əlavə et: while (!Serial.available()) kimi dövrün içinə qidalandırma qoymaq əvəzinə, dövrdən müəyyən müddətdən sonra çıxılmasını təmin et. Beləliklə, həm plata donmur, həm də watchdog real donmalar üçün hazır qalır.
  • Watchdog-u quraşdırmadan sonra aç: Wi-Fi qoşulması, SD kart işə salınması və ya sensor kalibrləməsi kimi uzun əməliyyatlar setup()-da bitdikdən sonra watchdog-u aktivləşdir.

Daha ağıllı yanaşma qidalandırmanı şərtə bağlamaqdır: watchdog-u yalnız sistem həqiqətən sağlamdırsa qidalandırırsan. Aşağıdakı nümunədə A0-a qoşulmuş sensor 5 saniyədən bir oxunur; oxunan dəyər mənalı aralıqdadırsa, son uğurlu ölçmə vaxtı yenilənir. 60 saniyə ərzində heç uğurlu ölçmə olmazsa, qidalandırma dayanır və 4 saniyə sonra plata resetlənir. Bu üsulla AVR-in 8 saniyəlik həddini aşan, dəqiqələr miqyasında nəzarət qurmuş olursan; üstəlik yalnız donmanı yox, qopan sensor naqili kimi səssiz nasazlıqları da tutursan.

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-də watchdog: Task WDT və Interrupt WDT

ESP32-də watchdog standart olaraq artıq işləyir; çoxları bunu ilk dəfə serial ekranda gözlənilməz "Task watchdog got triggered" mesajını görəndə fərq edir. ESP32 FreeRTOS əməliyyat sistemi ilə bir neçə tapşırığı (task) eyni anda icra etdiyi üçün tək sayğac əvəzinə qatlı struktur istifadə edir. Task WDT (TWDT) ona abunə olan tapşırıqların müəyyən müddətdə qidalandırılıb qidalandırılmadığını izləyir; Interrupt WDT (IWDT) isə kəsmələrin və tapşırıq planlaşdırıcısının uzun müddət bloklanmasını tutur. Arduino nüvəsində TWDT adətən 5 saniyəlik müddətlə açıqdır və boş (idle) tapşırıqları izləyir; loop()-u işlədən tapşırıq isə sən əlavə etmədikcə izlənmir. Standart davranış nüvə versiyasına görə dəyişə bilər və bəzi konfiqurasiyada TWDT yalnız xəbərdarlıq çap edir, platanı resetləmir; ona görə müddəti və reset davranışını kodla açıq şəkildə tənzimləmək ən etibarlısıdır.

NövNəyi izləyir?Tipik müddətTətiklənəndə görülən mesaj
Task WDT (TWDT)Abunə tapşırıqların və idle tapşırıqlarının müntəzəm işləməsi5 san (tənzimlənir)task_wdt: Task watchdog got triggered
Interrupt WDT (IWDT)Kəsmələrin və tapşırıq planlaşdırıcısının bloklanmasıTəxminən 300 msGuru Meditation Error ... Interrupt wdt timeout on CPU1
RTC WDTYüklənmə prosesinin ilişməsiYüklənmə zamanı qısa müddətrst: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 nüvə versiyasını ESP_ARDUINO_VERSION_MAJOR ilə yoxlayır: 3.x versiyasında (ESP-IDF 5) ayarlar esp_task_wdt_config_t strukturu ilə verilir və artıq işləyən TWDT esp_task_wdt_reconfigure() ilə yenilənir; 2.x versiyasında isə esp_task_wdt_init() müddəti birbaşa saniyə ilə və panik bayrağını qəbul edir. trigger_panic true olduqda müddət bitəndə ESP32 xəta dökümünü serial portuna yazır və özünü resetləyir. esp_task_wdt_add(NULL) həmin anda işləyən tapşırığı, yəni setup() və loop()-u icra edən tapşırığı izləməyə götürür. Açılışda esp_reset_reason() ilə əvvəlki resetin səbəbini oxuyub qeyd etmək, sahədəki cihazın niyə yenidən başladığını anlamağın ən asan yoludur. Heç bir ayar etmədən yalnız loop()-u izlətmək istəsən, setup()-da Arduino nüvəsinin enableLoopWDT() funksiyasını çağıra bilərsən; bu halda qidalandırma hər loop() turunun əvvəlində avtomatik edilir.

ESP32-də ən çox rast gəlinən watchdog xətası, özünün yaratdığın FreeRTOS tapşırığının içində heç gözləməyən dövr yazmaqdır. Məsələn, nüvə 0-a sabitlənmiş tapşırıqda while (true) { readSensor(); } yazsan, həmin nüvədəki boş tapşırıq heç işləyə bilmir, Wi-Fi steki ilişir və bir neçə saniyədən sonra "Task watchdog got triggered ... IDLE (CPU 0)" mesajı görünür. Hər dövrə ən azı vTaskDelay(1) və ya delay(1) əlavə et. Tapşırıqlarla bağlı ətraflı məlumat ESP32 FreeRTOS və ikinüvəli işləmə yazısındadır, "Guru Meditation" mesajlarının mənası isə ESP32 Brownout və Guru Meditation yazısındadır.

Raspberry Pi Pico-da watchdog (MicroPython)

RP2040-ın aparat watchdog-u MicroPython-da machine.WDT sinfi ilə istifadə olunur. Müddət millisaniyə ilə verilir və RP2040-da ən çoxu 8388 ms ola bilər. Mühüm fərq var: Pico-da watchdog bir dəfə işə salındıqdan sonra kodla dayandırıla bilmir, yalnız reset ilə söndürülür. Ona görə inkişaf zamanı kiçik bir qurtarma yolu qoymaq həyat xilas edir. Aşağıdakı kodda GP15 pini açılışda GND-yə qoşulubsa, watchdog heç işə salınmır və proqram REPL-ə düşür. machine.reset_cause() ilə platanın watchdog səbəbindən, yoxsa normal açılışla başladığını da öyrənə bilərsən. Pico-nu MicroPython əvəzinə Arduino IDE ilə (arduino-pico nüvəsi) proqramlaşdırırsansa, eyni iş rp2040.wdt_begin(5000) və rp2040.wdt_reset() funksiyaları ilə görü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-də watchdog-lu proqramı Stop düyməsi ilə kəsəndə watchdog saymağa davam edir və bir neçə saniyə ərzində Pico resetlənib əlaqə qopur. Kodu əvvəlcə main.py xaricində bir fayl adı ilə sına; hər şey qaydasında olanda main.py kimi yadda saxla. Plata dövrə girərsə, GP15-i GND-yə qoşub resetləmək kifayətdir. MicroPython-a təzə başlayırsansa, MicroPython əsasları yazısı yaxşı başlanğıcdır.

Uzun müddət işləyən IoT layihələrində watchdog strategiyası

  • Açılışları qeyd et: Hər açılışda sayğacı Uno-da EEPROM-a, ESP32-də Preferences (NVS) yaddaşına yaz; ESP32-də esp_reset_reason() ilə səbəbini də saxla. Həftədə bir reset məqbuldur, saatda bir reset isə düzəldilməli xətadır. Uno-da Optiboot reset bayraqlarını sildiyi üçün səbəbi MCUSR-dan oxumaq çox vaxt mümkün olmur; açılış sayğacı yenə də cihazın nə tezliklə yenidən başladığını göstərir.
  • Şəbəkə əməliyyatlarına vaxt aşımı qoy: Wi-Fi əlaqəsini sonsuza qədər gözləmə; məsələn, 15 saniyə ərzində qoşula bilməzsə, dövrdən çıx və bir müddət sonra yenidən cəhd et. HTTPClient-də setTimeout(), AVR-də Wire.setWireTimeout() kimi ayarlar ilişən əməliyyatın watchdog müddətini aşmasının qarşısını alır. Qoşulma problemləri üçün ESP32 Wi-Fi qoşulmur yazısına bax.
  • OTA yeniləməsini nəzərə al: Simsiz yükləmə saniyələr çəkir və bu zaman loop() gözləmədə qala bilər. ArduinoOTA-nın onProgress geri çağırışında esp_task_wdt_reset() çağıraraq yeniləmənin yarıda kəsilməsinin qarşısını ala bilərsən; bu, qaydanı pozan nadir, amma haqlı istisnadır.
  • Yuxu rejimlərini düşün: Uno-da watchdog kəsmə rejimində oyanma taymeri kimi istifadə olunub 8 saniyəlik aralıqlarla yatmaq olar. ESP32-də deep sleep zamanı prosessor söndürülür və oyananda kod baştan başlayır. Təfərrüatlar üçün ESP32 Deep Sleep yazısına nəzər sal.
  • Xarici sensorların qidasını idarə et: Watchdog sensoru resetləmir. Tez-tez ilişən I2C sensorunun qidasını tranzistor və ya MOSFET üzərindən verib açılışda bir neçə yüz millisaniyə kəsib açsan, mikrokontrollerlə birlikdə sensor da təmiz başlayır. I2C xəttinin necə kilidləndiyini I2C nədir yazısında oxuya bilərsən.
  • Kritik sistemlərdə xarici watchdog: Daxili watchdog yalnız mikrokontrollerin öz xətalarını tutur. Bütün dövrəyə nəzarət lazımdırsa, GPIO-dan müntəzəm impuls gözləyən xarici watchdog mikrosxemi və ya ikinci kiçik mikrokontroller istifadə olunur.

Tez-tez edilən xətalar və həlləri

ƏlamətEhtimal olunan səbəbHəll
Plata bir neçə saniyədən bir resetlənirWatchdog müddəti loop()-un ən uzun turundan qısadır (məs., delay(3000) ilə WDTO_2S)Müddəti uzat, delay() əvəzinə millis() istifadə et
LED sürətlə yanıb-sönür, kod yüklənmirKöhnə bootloader watchdog resetindən sonra watchdog-u söndürmürISP ilə Optiboot yaz, platanı güncəl bootloader seçimi ilə proqramlaşdır
Plata donur, amma heç resetlənmirQidalandırma taymer kəsməsində və ya ilişən alt dövrün içindədirwdt_reset()-i loop()-dakı tək nöqtəyə köçür
ESP32-də "Task watchdog got triggered" təkrarlanır, reset yoxdurTWDT panik rejimində deyiltrigger_panic dəyərini true et (2.x-də ikinci parametr)
ESP32-də "IDLE (CPU 0)" xəbərdarlığıNüvə 0-dakı tapşırıq heç gözləmədən dönürDövrə vTaskDelay(1) əlavə et
esp_task_wdt_reset() "task not found" xətası verirTapşırıq TWDT-yə əlavə edilməyibƏvvəlcə esp_task_wdt_add(NULL) çağır
Pico Thonny-də dayandırılanda əlaqə qopurmachine.WDT bir dəfə başlayandan sonra dayandırıla bilmirQurtarma pinindən istifadə et, sınaq zamanı kodu main.py xaricində adla işlət
Reset anında rele və ya mühərrik bir anlıq istəmədən işləyirReset zamanı pinlər girişə qayıdır, sürücü girişi boşda qalırÇıxışlara pull-down rezistor əlavə et, setup()-ın əvvəlində təhlükəsiz vəziyyətə gətir

Watchdog timer bir neçə sətir kodla layihəni masa üstündəki sınaqdan günlərlə öz başına işləyə bilən cihaza çevirir. Əvvəlcə donmaların əsl səbəblərini aradan qaldır, sonra watchdog-u son təhlükəsizlik qatı kimi əlavə et və qidalandırmanı tək, mənalı nöqtəyə qoy. BlueGrays tətbiqində ESP32 Wi-Fi qoşulması, veb server, OTA yeniləmə, hava məlumatı və ağıllı suvarma kimi uzun müddət açıq qalan layihələri dövrə sxemləri və kodları ilə addım-addım araşdırıb watchdog-u bu layihələrə özün əlavə edə bilərsən.

Tez-tez verilən suallar

Arduino watchdog timer nəyə lazımdır?

Watchdog proqram təyin olunmuş müddət ərzində "mən hələ işləyirəm" siqnalı göndərməsə, platanı avtomatik resetləyən daxili taymerdir. Sonsuz dövrə girən, sensoru gözləyərkən ilişən və ya şəbəkə kitabxanasında donan layihələri bir neçə saniyə ərzində özünə gətirir. Xüsusilə uzun müddət nəzarətsiz işləyən suvarma, siqnalizasiya və IoT cihazlarında əvəzsizdir.

Arduino-nu kodla necə resetləyim?

AVR platalarda ən təmiz yol watchdog-u ən qısa müddətlə açıb gözləməkdir: wdt_enable(WDTO_15MS); while (true) {} yazanda plata çox qısa müddətdə həqiqi aparat reseti alır. ESP32-də ESP.restart(), Raspberry Pi Pico-da MicroPython ilə machine.reset() eyni işi görür. Köhnə bootloader-lı Nano klonlarında bu üsul sonsuz reset dövrünə səbəb ola bilər.

Watchdog müddəti ən çoxu nə qədər ola bilər?

Arduino Uno və digər AVR platalarda ən uzun müddət 8 saniyədir (WDTO_8S). Raspberry Pi Pico-da hədd 8388 ms-dir, ESP32-nin Task WDT-sində isə müddəti sərbəst tənzimləmək olar. Daha uzun nəzarət lazımdırsa, watchdog-u yalnız sistem sağlam olanda qidalandıran şərti qidalandırma üsulu ilə dəqiqələr miqyasında hədlər qura bilərsən.

ESP32 "Task watchdog got triggered" xətası necə düzəldilir?

Bu mesaj izlənən tapşırığın təyin olunmuş müddətdə qidalandırılmadığını göstərir; səbəb çox vaxt heç gözləmədən dönən while dövrü və ya boş tapşırığı ac qoyan FreeRTOS tapşırığıdır. Dövrlərinə vTaskDelay(1) və ya delay(1) əlavə et, uzun əməliyyatları hissələrə böl və öz tapşırığını TWDT-yə əlavə etmisənsə, müntəzəm olaraq esp_task_wdt_reset() çağır. Mesajda adı keçən tapşırıq, məsələn IDLE (CPU 0), problemin hansı nüvədə olduğunu deyir.

Watchdog əlavə etdim, Arduino daim resetlənir. Niyə?

Ən çox görülən səbəb watchdog müddətinin loop()-un ən uzun turundan qısa olmasıdır; məsələn, dövrdə delay(3000) olarkən WDTO_2S seçmək. Müddəti ən pis haldakı tur müddətinin ən azı iki qatı et və uzun delay() əvəzinə millis() istifadə et. LED sürətlə yanıb-sönürsə və kod yüklənmirsə, problem köhnə bootloader-dır; plataya ISP ilə Optiboot yazmalısan.

Watchdog resetindən sonra dəyişənlər qorunurmu?

Xeyr, watchdog reseti platanı yenidən başladır və setup() baştan işləyir; qlobal dəyişənlər ilkin dəyərlərinə qayıdır. Resetdən sonra saxlanmalı olan sayğac, ayar və ya son vəziyyət kimi məlumatları Uno-da EEPROM-a, ESP32-də Preferences (NVS) yaddaşına, Pico-da flash üzərindəki fayla yazmalısan.

Bütün layihələrə bax
ESP32 ilə LED yandırma
ES-1Başlanğıc

ESP32 ilə LED yandırma

ESP32 ilə əsas GPIO çıxışından istifadəni öyrədir. LED-i rəqəmsal pindən yandırıb söndürərək yanıb-sönmə effekti əldə edirik. Arduino UNO-dakı klassik blink layihəsinin ESP32 versiyasıdır; Arduino mühitindəki əsas blink əmrləri eynidir, lakin ESP32-nin pin yerləşməsi və 3,3 V GPIO səviyyələri Arduino UNO-dan fərqlidir.

4.7(37)
108
Raspberry Pi Pico daxili LED-in yanıb-sönməsi (Pico və Pico W)
PI-1Başlanğıc

Raspberry Pi Pico daxili LED-in yanıb-sönməsi (Pico və Pico W)

Raspberry Pi Pico seriyasının açılış layihəsi! Pico-nun üzərindəki yaşıl daxili LED-i yandırıb söndürərək platanın işlədiyini təsdiqləyirik; klassik "Hello World" tipli ilk təcrübə. Xarici komponent lazım deyil, Pico və USB kabeli kifayətdir. Kod MicroPython ilə yazılıb (Raspberry Pi Fondunun rəsmi dəstəklədiyi dil).

5.0(1)
10
ESP32 Wi-Fi STA qoşulması (LCD ekranlı)
ES-25Qabaqcıl

ESP32 Wi-Fi STA qoşulması (LCD ekranlı)

Bu layihədə ESP32-ni Station (STA) rejimində evdəki Wi-Fi şəbəkəsinə təhlükəsiz və xətaya davamlı şəkildə qoşuruq. SSID/şifrəni secrets.h faylına ayıraraq Git-ə sızmasının qarşısını alır, avtomatik yenidən qoşulma mexanizmi qurur, RSSI siqnal səviyyəsini və IP ünvanını I2C LCD ekranda göstəririk. Daxili LED vəziyyət göstəricisi kimi işləyir. İstehsal səviyyəli qoşulma meneceridir.

4.4(21)
38
ESP32 Async veb server (LCD-də IP göstəricili)
ES-27Qabaqcıl

ESP32 Async veb server (LCD-də IP göstəricili)

Bu layihədə ESP32-ni eyni Wi-Fi şəbəkəsindəki telefonundan və ya kompüterindən idarə edə biləcəyin asinxron veb serverə çeviririk. ESPAsyncWebServer kitabxanası sayəsində server bir neçə sorğunu eyni anda emal edə bilir (klassik WebServer.h kimi tək sorğuda bloklamır). Brauzerdən ESP32-nin IP ünvanına qoşulub ON/OFF düymələrinə basaraq (/on və /off ünvanları) GPIO 5-ə qoşulu LED-i yandırıb söndürə biləcəksən.

4.8(16)
26
ESP32 OTA Update — simsiz firmware yükləmə (LCD ekranlı)
ES-30Qabaqcıl
Premium

ESP32 OTA Update — simsiz firmware yükləmə (LCD ekranlı)

Bu layihədə ESP32-yə USB naqili olmadan, Wi-Fi üzərindən yeni firmware yükləməyi öyrənəcəksən. ArduinoOTA kitabxanası ilə ESP32 şəbəkədə görünür və Arduino IDE-nin "Network port" bölməsində bluegrays-ota kimi avtomatik siyahıya düşür. İlk yükləmə USB ilə edilir, sonrakı bütün yeniləmələr simsiz olur; sahədəki cihazlar üçün çox vacib xüsusiyyətdir.

4.6(14)
22
ESP32 HTTPClient + hava proqnozu API (LCD ekranlı)
ES-31Qabaqcıl
Premium

ESP32 HTTPClient + hava proqnozu API (LCD ekranlı)

Bu layihədə ESP32 ilə internet üzərindən hava proqnozu API-sinə (wttr.in) HTTPClient.h istifadə edərək REST API sorğusu göndəririk. ArduinoJson v7 ilə gələn JSON cavabını emal edib şəhər, temperatur, rütubət, hava vəziyyəti və külək məlumatlarını I2C LCD ekranda göstəririk. wttr.in API açarı tələb etmir; istədiyin şəhərin adını yazmaq kifayətdir.

4.7(13)
20
ESP32 hərəkət siqnalizasiya sistemi (PIR + buzzer + LED + Telegram)
ES-41Qabaqcıl
Premium

ESP32 hərəkət siqnalizasiya sistemi (PIR + buzzer + LED + Telegram)

PIR sensoru hərəkət aşkarlayanda buzzer-i və LED-i işə salan, eyni zamanda Telegram vasitəsilə sahibinə ani bildiriş göndərən ağıllı təhlükəsizlik siqnalizasiyası. Təkrarlanan həyəcanların tezliyini məhdudlaşdırmaq üçün 30 saniyəlik gözləmə müddəti (cooldown) var; bu müddət PIR sensorunun yanlış aşkarlamalarını aradan qaldırmır. Ev, qaraj, anbar və ya iş otağı kimi yerlərdə istifadə oluna bilər.

9