Bələdçilər · 17 dəq oxu

ESP32 Brownout Detector Was Triggered və Guru Meditation həlli

ESP32 brownout detector was triggered xətası və daimi reset: qida mənbəyi, naqil, kondensator, rst kodları, Guru Meditation, Task WDT və Exception Decoder.

ESP32 brownout detector was triggered mesajı platanın qida gərginliyinin bir anlığa təhlükəsiz həddin altına düşdüyünü və çipin özünü qorumaq üçün yenidən başladıldığını bildirir. Problem demək olar ki, həmişə kodda yox, qida tərəfindədir: zəif USB portu, nazik və uzun naqil, kifayət qədər güclü olmayan stabilizator və ya ESP32 ilə eyni xəttdən qidalanan servo və LED lentlər. ESP32-nin daim yenidən başlamasının ikinci böyük səbəbi proqram çökmələridir; bu halda Serial Monitor-da Guru Meditation Error, task_wdt və ya Stack canary kimi sətirlər görürsən.

Yaxşı xəbər budur: ESP32 niyə yenidən başladığını özü deyir, sadəcə mesajları oxumağı bilmək lazımdır. Bu bələdçidə əvvəlcə açılış sətirlərindəki rst kodlarını və xəta mesajlarını tanıyacaq, sonra brownout-u qida mənbəyi, naqil və kondensatorla birdəfəlik həll edəcəksən. Daha sonra LoadProhibited və StoreProhibited kimi Guru Meditation xətalarını, stek daşmasını, null pointer-i və watchdog zaman aşımlarını nəzərdən keçirəcək, ESP Exception Decoder ilə çökməni kod sətrinə qədər izləyəcəksən. Sonda açılışı pozan strapping pinlərə (GPIO0, 2, 12 və 15) baxacağıq.

ESP32 DevKit inkişaf platası
ESP32 inkişaf platası: USB-dən gələn 5 V plata üzərindəki stabilizatorla 3,3 V-a endirilir. Brownout problemlərinin çoxu bu 3,3 V xəttində baş verən ani çökmələrdən qaynaqlanır.

ESP32 niyə daim yenidən başlayır? Əvvəlcə mesajı oxu

Diaqnostikaya başlamazdan əvvəl Serial Monitor-u 115200 baud sürətində aç və platadakı EN düyməsinə bas. ESP32-nin içindəki ROM ilkin yükləyicisi hər açılışda əvvəlcə "ets Jun 8 2016 00:22:57" kimi tarix sətri, ardınca rst:0x1 (POWERON_RESET),boot:0x13 (SPI_FAST_FLASH_BOOT) formatında sətir yazır. rst hissəsi platanın niyə yenidən başladığını, boot hissəsi isə hansı rejimdə açıldığını göstərir. Plata dövrəyə giribsə, bu sətirlərin dərhal üstündə əvvəlki işləmənin son sözləri olan xəta mesajını tapırsan. Aşağıdakı cədvəl görəcəyin mesajları və haradan başlamalı olduğunu xülasə edir:

Serial Monitor-da gördüyünMənasıHara baxmalısan?
Brownout detector was triggeredQida gərginliyi hədd səviyyəsinin altına düşdüQida mənbəyi, naqil, kondensator
Guru Meditation Error: Core 1 panic'ed (LoadProhibited)Kod yanlış ünvandan oxumağa çalışdıNull pointer, massiv sərhədi
Guru Meditation Error: Core 1 panic'ed (StoreProhibited)Kod yanlış ünvana yazmağa çalışdıNull pointer, daşan bufer
Stack canary watchpoint triggered (loopTask)Tapşırığın steki (stack) dolduBöyük lokal massivlər, rekursiya
task_wdt: Task watchdog got triggeredTapşırıq 5 saniyədən uzun müddət prosessoru buraxmadıGözləməsiz dövrlər, ilişən tapşırıqlar
Interrupt wdt timeout on CPU0 / CPU1Kəsmə funksiyası və ya bağlı kəsmələr 300 ms-i keçdiUzun ISR, ISR daxilində Serial
boot:0x3 (DOWNLOAD_BOOT...) waiting for downloadPlata proqramlaşdırma rejimində açıldıGPIO0 açılışda LOW
invalid header və ya flash read errFlaş yaddaş oxuna bilmədiGPIO12 açılışda HIGH, yarımçıq qalmış yükləmə

Brownout detector was triggered nədir və niyə baş verir?

Brownout gərginliyin tam kəsilmədən qısa müddətə düşməsi deməkdir. ESP32-nin içində qida xəttini daim izləyən brownout detektoru var və Arduino nüvəsində bu detektorun həddi ən aşağı səviyyəyə, təxminən 2,43 V-a ayarlanıb. Gərginlik bu dəyərin altına düşən kimi çip radionu və flaş yaddaşı qorumaya alır, Serial Monitor-a "Brownout detector was triggered" yazır və özünü yenidən başladır. Səbəb sadədir: gərginlik aşağı olanda flaş yaddaş yanlış oxuna bilər, yadda saxlanmış verilənlər pozula bilər və prosessor təsadüfi əmrlər icra edə bilər. Detektor platanın gözlənilməz davranmasındansa təmiz reset etməsini təmin edir. ESP32-WROOM-32 modulu 3,0–3,6 V arasında işləmək üçün nəzərdə tutulub; yəni gərginlik 2,43 V-a düşəndə xətt çoxdan təhlükəsiz zonanın xaricinə çıxıb.

Brownout mesajından sonrakı açılış sətrində Arduino nüvəsinin versiyasından asılı olaraq rst:0xc (SW_CPU_RESET) və ya rst:0x3 (SW_RESET) görürsən, çünki detektorun kəsməsi mesajı yazdıqdan sonra çipi proqramla yenidən başladır. Bu səni çaşdırmasın: eyni kod səbəbin brownout olduğunu çipin yaddaşına qeyd edir və esp_reset_reason() funksiyası ESP_RST_BROWNOUT qaytarır. Aparatın öz brownout reseti işə düşəndə isə sətirdə rst:0xf (RTCWDT_BROWN_OUT_RESET) yazılır. ESP-IDF 5 əsaslı 3.x nüvələrdə bu sətir məlumat (INFO) jurnalına çevrilib (I BOD: Brownout detector was triggered). Arduino-nun hazır kompilyasiya olunmuş kitabxanaları yalnız xəta səviyyəli jurnalları yazdığı üçün mesaj çox vaxt heç görünmür və plata səssizcə yenidən başlayır; açılışda səbəbsiz rst:0x3 və ya rst:0xc görürsənsə, diaqnostika kodundakı reset səbəbinə bax. Gərginliyin niyə düşdüyünü başa düşmək üçün ESP32-nin nə qədər cərəyan çəkdiyinə baxmaq lazımdır:

İş vəziyyətiTipik cərəyan (ESP32 çipi)
Dərin yuxu (RTC taymeri açıq)Təxminən 10 µA
Yüngül yuxu (light sleep)Təxminən 0,8 mA
Wi-Fi söndürülüb, prosessor 240 MHz30–68 mA
Wi-Fi qəbul (RX)95–100 mA
Wi-Fi göndərmə, 802.11b, 19,5 dBmTəxminən 240 mA
Açılışda radio kalibrləməsi və qoşulma anıMikrosaniyələrlə davam edən zirvələrdə 400 mA-i keçə bilər

Cədvəldəki fərq brownout-un mahiyyətidir: kod Wi-Fi-ı açana qədər plata 50 mA ətrafında sakit işləyir, WiFi.begin() sətrində isə cərəyan bir neçə mikrosaniyə ərzində beş-altı dəfə artır. Mənbə, naqil və stabilizator bu ani tələbə çatmasa, gərginlik çökür. Espressif buna görə ESP32 üçün ən azı 500 mA verə bilən qida mənbəyi tövsiyə edir. Əlamət də çox tanışdır: plata açılır, Serial Monitor-a bir neçə sətir yazır, Wi-Fi və ya Bluetooth başladığı anda reset olur və bu sonsuz dövrə çevrilir. Eyni şey servo hərəkət edəndə, rele qoşulanda və ya LED lent ağ rəngə keçəndə də baş verə bilər.

Brownout-un ən çox rast gəlinən səbəbləri

  • Nazik və ya uzun USB naqili: Ucuz naqillərdəki nazik qida məftilləri gediş və qayıdışda cəmi 0,5 Ω-a qədər müqavimət göstərə bilər. Om qanununa görə 400 mA-lik zirvə bu naqildə 0,2 V itirir.
  • Zəif USB portu və ya hub: Klaviatura və monitor üzərindəki portlar, gücsüz hub-lar və bəzi noutbukların ön portları zirvə cərəyanda gərginliyi aşağı salır.
  • Stabilizatorun dropout gərginliyi: Platalarin çoxundakı AMS1117 girişi ilə çıxışı arasında 1,0–1,3 V fərq tələb edir. 5V pinindəki gərginlik təxminən 4,3 V-un altına düşərsə, çıxış 3,3 V-u saxlaya bilmir.
  • Batareyanı birbaşa qoşmaq: 3,7 V-luq Li-ion batareyanı 5V pininə qoşmaq stabilizatorun dropout-u səbəbindən çıxışı 3 V-un altına endirir; iki AA batareya isə yük altında qısa müddətdə ESP32-nin aşağı həddinin altına düşür.
  • Arduino Uno-nun 3.3V pini: Bu pindən yalnız təxminən 50 mA çəkmək tövsiyə olunur; Wi-Fi açıq ESP32 üçün qətiyyən kifayət etmir.
  • Eyni xəttdən qidalanan yüklər: Servo, rele, buzzer, DC mühərrik və WS2812B lent ESP32 ilə eyni 5 V-dan qidalanarsa, hər hərəkət gərginliyi aşağı çəkir.
  • Breadboard və jumper naqillər: Boş kontaktlar və nazik jumper naqillər hər qoşulmada bir az da müqavimət əlavə edir; qida xəttini breadboard üzərindən keçirmək problemi böyüdür.
  • ESP32-CAM: Kamera, Wi-Fi və flaş LED-i eyni anda işləyəndə cərəyan çox yüksəlir; bu plata 5 V və ən azı 2 A ilə qidalanmağı sevir. Ətraflı məlumat üçün ESP32-CAM yazısına baxa bilərsən.
Multimetrdə 3,3 V görmək qidanın sağlam olduğunu göstərmir. Multimetr saniyədə yalnız bir neçə ölçmə aparır və ortalamaya yaxın dəyər göstərir; brownout-a səbəb olan çökmələr isə mikrosaniyələrlə bir neçə millisaniyə arasında davam edir və ekranda heç görünmür. Bu düşmələri yalnız osiloqrafla görə bilərsən. Osiloqrafın yoxdursa, aşağıdakı həlləri ardıcıllıqla tətbiq et və hər addımdan sonra xətanın itib-itmədiyinə bax. Ölçmənin əsaslarını Multimetr necə istifadə olunur? yazısında tapa bilərsən.

Həll 1: Qida mənbəyini və naqili düzəlt

İlk və ən təsirli addım qidanı gücləndirməkdir. Platanı qısa, qalın və yaxşı olduğunu bildiyin data naqili ilə birbaşa kompüterin arxa panelindəki USB portuna və ya ən azı 1 A verən 5 V adapterə qoş. USB 2.0 portları 500 mA, USB 3.0 portları 900 mA verəcək şəkildə nəzərdə tutulub; Espressif-in tövsiyə etdiyi 500 mA USB 2.0 portunun tam həddidir və üstünə naqil itkisi əlavə olunanda problem başlayır. Naqili dəyişmək tək başına xətanı həll edirsə, səbəb böyük ehtimalla naqilin müqaviməti idi. Naqilin nə qədər gərginlik itirdiyini Om qanunu alətində V = I × R düsturu ilə hesablaya bilərsən.

AMS1117 3,3 V gərginlik stabilizatoru
AMS1117-3.3: ESP32 platalarının çoxundakı stabilizator. Girişi ilə çıxışı arasında 1,0–1,3 V fərq tələb edir; 5V pinindəki gərginlik təxminən 4,3 V-un altına düşərsə, çıxışı 3,3 V-u saxlaya bilmir.
Qida quruluşuBrownout riskiQeyd
Qısa, qalın naqil və arxa panel USB portuAşağıİnkişaf zamanı ən asan həll
Uzun, nazik naqil, ön panel portu və ya hubYüksəkNaqil müqaviməti zirvə cərəyanda gərginliyi aşağı salır
Ən azı 1 A verən 5 V adapter, 5V və ya VIN pininəAşağıDaimi layihələr üçün tövsiyə olunur
Hazır 3,3 V mənbə birbaşa 3V3 pininəMənbədən asılıdırƏn azı 500 mA verməli və 3,6 V-u heç vaxt keçməməlidir
3,7 V Li-ion batareya, AMS1117 vasitəsiləYüksəkBatareya 4 V-un altına düşəndə çıxış 3 V-un altına enir
Li-ion batareya və aşağı dropoutlu (LDO) 3,3 V stabilizator və ya buck-boostAşağıBatareya boşalarkən də sabit 3,3 V təmin edir
İki AA batareya birbaşa 3V3 pininəÇox yüksəkYük altında gərginlik sürətlə ESP32-nin aşağı həddinin altına düşür

Batareya ilə işləyən layihələrdə diqqətli olmalısan. 18650 kimi Li-ion element tam dolu olanda 4,2 V, boş olanda təxminən 3,0 V verir. Bu aralıq nə 3V3 pininə birbaşa qoşmağa (4,2 V, 3,6 V həddini aşır), nə də AMS1117-li 5V pininə qoşmağa uyğundur. Düzgün həll ya batareyanı 5 V qaldırıcı (boost) modulla 5V pininə vermək, ya da aşağı dropoutlu və ən azı 500 mA verə bilən LDO (məsələn, ME6211 və ya HT7833) və kondensatorla birbaşa 3V3 xəttini qidalandırmaqdır. Layihənin batareya ilə nə qədər dayanacağını Batareya ömrü alətində hesablaya, şarj dövrəsini isə TP4056 şarj modulu yazısında öyrənə bilərsən.

Həll 2: 3V3 və GND arasına kondensator əlavə et

Kondensator cərəyan zirvəsi gələndə stabilizator və naqil çatana qədər enerjini özü verən kiçik anbar kimi işləyir. Platanın 3V3 və GND pinləri arasına, platanın mümkün qədər yaxınlığına 100–470 µF-lıq elektrolitik kondensator və yanına 100 nF-lıq keramik kondensator əlavə et. Elektrolitik kondensator millisaniyəlik düşmələri, keramik isə çox qısa və yüksək tezlikli dalğalanmaları qarşılayır. Təsirini təxmini olaraq ΔV = I × Δt / C düsturu ilə görə bilərsən: 470 µF-lıq kondensator 200 mA-lik əlavə cərəyanı 200 µs ərzində tək başına qarşılasa belə, gərginlik yalnız 0,085 V düşür. Keramik kondensatorun üzərindəki 104 yazısı 100 nF deməkdir; digər kodları Kondensator kodu alətində həll edə bilərsən.

Kondensator növləri
Elektrolitik kondensatorlarda uzun ayaq artı (+) uçdur və 3V3-ə gedir; gövdədəki zolaqlı tərəfin ayağı GND-yə qoşulur. 3,3 V xətti üçün 6,3 V və ya 10 V dayanıqlı model kifayətdir.
Elektrolitik kondensatoru tərs taxma: qızır, şişir və partlaya bilər. Kondensatoru 5V xəttinə qoşacaqsansa, ən azı 10 V dayanıqlı model seç. Çox böyük kondensatorlar (1000 µF və yuxarı) ilk açılışda yüksək şarj cərəyanı çəkərək USB portunu bir an zorlaya və 3,3 V xəttinin yüksəlişini yavaşlada bilər; 3V3 xəttində 470 µF əksər layihələr üçün kifayətdir. Kondensatorların iş məntiqini Kondensator nədir? yazısında tapa bilərsən.

Həll 3: Servo, mühərrik və LED lenti ayrıca qidalandır

ESP32-nin özü düzgün qidalansa belə, eyni xəttə qoşulmuş yüklər gərginliyi aşağı çəkə bilər. SG90 kimi kiçik servo belə hərəkətə başlayanda bir neçə yüz mA çəkir; bir WS2812B LED tam ağda təxminən 60 mA sərf edir, yəni 30 LED-lik lent 1,8 A-ə qədər çıxa bilər. Bu yükləri ESP32-nin 5V və ya 3V3 pinindən yox, ayrı 5 V mənbədən qidalandır; məsələn, 12 V adapteri LM2596 endirici modulla 5 V-a endirə bilərsən. Ən vacib qayda iki mənbənin GND uclarını bir-birinə qoşmaqdır; ortaq torpaq olmadan siqnal xətti referanssız qalır və servo ya da lent təsadüfi davranır. Bu mövzunu Arduino özünü resetləyir? və GND və ortaq torpaq yazılarında ətraflı izah etdik.

LM2596 step-down (buck) modulu
LM2596 endirici modul: 12 V-u səmərəli şəkildə 5 V-a endirir; servo, rele və ya LED lent kimi yükləri ESP32-dən ayrı qidalandırmaq üçün idealdır. Çıxışı trimmerlə tənzimlənir, qoşmazdan əvvəl multimetrlə 5 V-a ayarla.
Proqramla da cərəyan zirvələrini yumşalda bilərsən. Wi-Fi-ı servoları hərəkət etdirməzdən və LED lenti yandırmazdan əvvəl başlat; lentin parlaqlığını setBrightness() ilə məhdudlaşdır; servo və releləri eyni anda yox, bir neçə yüz millisaniyə fasilə ilə işlət. Wi-Fi ötürücü gücünü WiFi.setTxPower() ilə azaltmaq da zirvə cərəyanı azaldır; ətraflı məlumat ESP32 Wi-Fi-a qoşulmur yazısındadır.

Brownout detektorunu söndürmək həllidirmi?

İnternetdə ən çox tövsiyə olunan "həll" detektoru tək sətirlə söndürməkdir. Aşağıdakı kod ESP32-nin brownout registrini sıfırlayaraq detektoru deaktiv edir və xəta mesajı itir. Amma gərginlik düşməsi davam edir; sadəcə artıq heç kim sənə xəbər vermir. Bu kodu yalnız diaqnostika üçün istifadə et: detektor söndürülü ikən plata problemsiz işləyirsə, problemin mütləq qida olduğunu təsdiqləmiş olursan. Sonra sətri sil və qidanı düzəlt.

C++ (Arduino IDE)
1#include "soc/soc.h"
2#include "soc/rtc_cntl_reg.h"
3
4void setup() {
5  // YALNIZ TEŞHİS İÇİN: brownout dedektörünü kapat / DIAGNOSIS ONLY: disable the brownout detector
6  WRITE_PERI_REG(RTC_CNTL_BROWN_OUT_REG, 0);
7
8  Serial.begin(115200);
9  Serial.println("Brownout dedektoru kapali / brownout detector disabled");
10}
11
12void loop() {
13}
Detektoru daimi olaraq söndürülü saxlama. WRITE_PERI_REG(RTC_CNTL_BROWN_OUT_REG, 0) yalnız xəbərdarlığı susdurmur; detektorun aparat resetini və aşağı gərginlikdə flaşı və radionu bağlama vəzifəsini də deaktiv edir, çip 3,0 V-luq aşağı həddin xeyli altında qorunmadan işləməyə davam edir. Gərginlik 2,4 V-un altına düşəndə flaşa yazılan verilənlər (Preferences, EEPROM, LittleFS), hətta OTA yeniləməsi zamanı proqramın özü pozula bilər, Wi-Fi izah olunmaz şəkildə qopa bilər və plata bu dəfə Guru Meditation xətaları ilə və ya tamamilə donaraq çökə bilər. Ayar daimi deyil: çip hər açılışda detektoru yenidən aktivləşdirir, buna görə bu sətir setup()-ın ilk sətri olmalıdır və sildikdə qoruma geri qayıdır. Bu registr klassik ESP32, S2, S3 və C3-də var; ESP32-C6 kimi yeni modellərdə yoxdur və kod kompilyasiya olunmur. Əsl həll həmişə qidanı düzəltməkdir.

rst cause kodları: ESP32 niyə yenidən başladığını deyir

Hər açılışda ROM-un yazdığı rst: dəyəri əvvəlki işləmənin necə bitdiyini göstərir. Normal açılışda boot dəyəri 0x13 (SPI_FAST_FLASH_BOOT) olur, yəni plata proqramını flaş yaddaşdan başladır. Aşağıdakı cədvəl ən çox rast gələcəyin kodları xülasə edir. ROM kodları həmişə tək başına kifayət etmir: ESP.restart() və Guru Meditation-dan sonrakı yenidən başlama eyni 0xc kodu ilə görünür, brownout isə nüvə versiyasından asılı olaraq 0xc və ya 0x3 kimi çıxır. Fərqi ayırmaq üçün növbəti bölmədəki esp_reset_reason() kodundan istifadə et.

rst koduAdıNə deməkdir?
0x1POWERON_RESETQida ilk dəfə verildi və ya EN düyməsinə basıldı
0x3SW_RESETProqram bütün rəqəmsal sistemi resetlədi; yeni nüvə versiyalarında brownout-dan sonra da görünür
0x5DEEPSLEEP_RESETPlata dərin yuxudan oyandı (normaldır)
0x7 / 0x8TG0WDT_SYS_RESET / TG1WDT_SYS_RESETTaymer qrupu watchdog-u sistemi aparatla resetlədi; kəsmələr çox uzun müddət bağlı qaldı və ya panik işləyicisi belə işləyə bilmədi
0x9RTCWDT_SYS_RESETRTC watchdog-u rəqəmsal nüvəni resetlədi
0xcSW_CPU_RESETProqramla yenidən başlatma: ESP.restart(), Guru Meditation-dan sonra və ya Arduino-da brownout-dan sonra
0xfRTCWDT_BROWN_OUT_RESETAparat brownout reseti: qida gərginliyi qeyri-sabitdir
0x10RTCWDT_RTC_RESETRTC watchdog-u RTC daxil olmaqla bütün çipi resetlədi; çox vaxt açılış zamanı ilişən platalarda görünür

Diaqnostika kodu: reset səbəbini, yaddaşı və steki yazdır

Aşağıdakı kodu ayrıca skeç kimi yüklə və ya içindəki sətirləri problemli layihənin setup() və loop() funksiyalarına əlavə et. Plata hər açılanda reset səbəbini oxunaqlı yazı ilə, neçənci dəfə açıldığını və yaddaş vəziyyətini Serial Monitor-a yazır. RTC_DATA_ATTR ilə işarələnmiş sayğac RTC yaddaşında saxlandığı üçün proqram resetlərində və dərin yuxuda qorunur, yalnız qida tamamilə kəsiləndə sıfırlanır. Beləliklə, sayğac hər bir neçə saniyədən bir artırsa, platanın reset dövründə olduğunu dərhal başa düşürsən.

C++ (Arduino IDE)
1#include <esp_system.h>
2
3RTC_DATA_ATTR uint32_t bootCount = 0;   // yazılım resetinde korunur / survives software resets
4
5// Reset nedenini okunabilir yazıya çevir / turn the reset reason into readable text
6const char* reasonText(esp_reset_reason_t r) {
7  switch (r) {
8    case ESP_RST_POWERON:   return "POWERON: guc acilisi ya da EN / power-on or EN button";
9    case ESP_RST_SW:        return "SW: ESP.restart()";
10    case ESP_RST_PANIC:     return "PANIC: Guru Meditation";
11    case ESP_RST_INT_WDT:   return "INT_WDT: kesme watchdog'u / interrupt watchdog";
12    case ESP_RST_TASK_WDT:  return "TASK_WDT: gorev watchdog'u / task watchdog";
13    case ESP_RST_WDT:       return "WDT: diger watchdog / other watchdog";
14    case ESP_RST_DEEPSLEEP: return "DEEPSLEEP: derin uykudan uyanma / deep sleep wake-up";
15    case ESP_RST_BROWNOUT:  return "BROWNOUT: gerilim dusmesi / supply voltage dropped";
16    default:                return "UNKNOWN: bilinmiyor / unknown";
17  }
18}
19
20void setup() {
21  Serial.begin(115200);
22  delay(1000);                          // Seri Monitör'ün açılmasını bekle / wait for the Serial Monitor
23  bootCount++;
24  Serial.printf("Acilis sayisi / boot count: %u\n", (unsigned)bootCount);
25  Serial.printf("Reset nedeni / reset reason: %s\n", reasonText(esp_reset_reason()));
26}
27
28void loop() {
29  // Bellek durumu / memory status
30  Serial.printf("Bos heap / free heap: %u B, en dusuk / minimum: %u B, en buyuk blok / largest block: %u B\n",
31                (unsigned)ESP.getFreeHeap(), (unsigned)ESP.getMinFreeHeap(), (unsigned)ESP.getMaxAllocHeap());
32  // loopTask yığınında hiç kullanılmamış en küçük alan / smallest unused space on the loopTask stack
33  Serial.printf("loopTask bos yigin / free stack: %u B\n", (unsigned)uxTaskGetStackHighWaterMark(NULL));
34  delay(5000);
35}

Kodun dövrdə yazdığı dəyərlər səssiz problemləri də üzə çıxarır. Boş heap (free heap) dəyəri hər turda bir az azalırsa, proqramında yaddaş sızması var və plata gec-tez çökəcək. Ən böyük blok dəyəri boş heap-dən çox kiçikdirsə, yaddaş parçalanıb; bu, adətən dövr daxilində daim böyüyüb kiçilən String obyektlərindən qaynaqlanır. loopTask-ın boş steki bir neçə yüz baytın altına düşürsə, stek daşması qapıdadır. Reset səbəbi BROWNOUT çıxırsa, qida bölməsinə; PANIC, TASK_WDT və ya INT_WDT çıxırsa, aşağıdakı proqram bölmələrinə diqqət yetir.

Guru Meditation Error nədir? Çökmə çıxışını sətir-sətir oxu

Guru Meditation Error ESP32-nin prosessoru düzəldə bilmədiyi xəta ilə qarşılaşanda panik işləyicisinin çap etdiyi çökmə hesabatıdır; adı köhnə Amiga kompüterlərinin xəta ekranından gəlir. Hesabat ilk baxışda qorxunc görünür, amma yalnız bir neçə sətri vacibdir. Core 1 ifadəsi xətanın hansı nüvədə olduğunu deyir: Arduino-da setup() və loop() 1-ci nüvədə, Wi-Fi steki isə 0-cı nüvədə işləyir. Mötərizə içindəki ad istisnanın növüdür. Hesabat bitdikdən sonra plata "Rebooting..." yazır və yenidən başlayır; açılış sətrində rst:0xc görürsən.

SətirMənası
Guru Meditation Error: Core 1 panic'ed (LoadProhibited). Exception was unhandled.1-ci nüvədəki kod yanlış ünvandan oxumağa çalışdı və xəta tutulmadı
PC : 0x400d1a2cÇökmənin baş verdiyi əmrin ünvanı; 0x400d ilə başlayırsa, sənin kodun və ya kitabxana flaşdan işləyirdi
EXCCAUSE: 0x0000001cİstisna kodu; 0x1c yəni 28 LoadProhibited deməkdir
EXCVADDR: 0x00000000Müraciət edilməyə çalışılan ünvan; 0 və ya çox kiçik rəqəm null pointer-i göstərir
Backtrace: 0x400d1a29:0x3ffb2270 0x400d0f6e:0x3ffb2290 ...Çağırış zənciri; hər cüt PC:SP formatındadır və decoder ilə kod sətrinə çevrilir
ELF file SHA256: ...Çöken proqramın barmaq izi; decoder üçün eyni kompilyasiyadan istifadə etməlisən
Rebooting...Panik işləyicisi çipi proqramla yenidən başladır

LoadProhibited, StoreProhibited və digər istisna növləri

İstisnaEXCCAUSENə baş verdi?Tez-tez rast gəlinən səbəb
LoadProhibited28 (0x1c)Yanlış ünvandan oxumaNull və ya başlanmamış göstərici, silinmiş obyekt
StoreProhibited29 (0x1d)Yanlış ünvana yazmaNull göstəriciyə yazma, massiv sərhədini aşan bufer
InstrFetchProhibited20 (0x14)Yanlış ünvandan əmr oxumaTəyin olunmamış funksiya göstəricisi və ya geri çağırış (callback)
IllegalInstruction0 (0x0)Yanlış əmrPozulmuş stek, dəyər qaytarmalı funksiyada unudulmuş return
LoadStoreAlignment9 (0x9)Hizalanmamış yaddaş müraciətiBayt massivini uint32_t* kimi tipə məcbur çevirmək
IntegerDivideByZero6 (0x6)Tam ədədin sıfıra bölünməsiSıfır ola bilən sayğacla bölmə
Unhandled debug exception-Sazlama (debug) istisnasıStack canary watchpoint triggered: stek daşması
Interrupt wdt timeout on CPU0/CPU1-Kəsmə watchdog-u dolduUzun ISR, ISR daxilində Serial və ya delay
Cache disabled but cached memory region accessed-Flaş məşğul ikən flaşdakı koda müraciətIRAM_ATTR olmayan kəsmə funksiyası

Bu xətaların ən geniş yayılanı null pointer istifadəsidir. NULL ünvanı 0-dır və ESP32-də 0 ünvanının ətrafında oxuna bilən yaddaş yoxdur; buna görə boş göstəricinin göstərdiyi yerdən oxumaq LoadProhibited, ora yazmaq StoreProhibited xətası verir. EXCVADDR dəyəri bu halda tam ipucudur: 0x00000000 göstəricinin özünü, 0x00000004 və ya 0x00000010 kimi kiçik dəyərlər isə boş göstəricinin içindəki sahəni (NULL + sahənin mövqeyi) göstərir. Arduino layihələrində ən çox səbəb funksiyanın "tapa bilmədim" mənasında NULL qaytarması və bu dəyərin yoxlanmadan istifadə olunmasıdır. Aşağıdakı nümunədə strstr() axtarılan mətni tapmasa NULL qaytarır; yoxlama aparılmasa plata EXCVADDR 0x00000005 ilə çökür.

C++ (Arduino IDE)
1const char* response = "temp=23.5;hum=40";   // sunucudan gelen yanıt / reply from a server
2
3void setup() {
4  Serial.begin(115200);
5  delay(500);
6
7  // YANLIŞ: "pres=" yoksa strstr NULL döner ve kart çöker (EXCVADDR 0x00000005)
8  // WRONG: if "pres=" is missing strstr returns NULL and the board crashes (EXCVADDR 0x00000005)
9  // float pressure = atof(strstr(response, "pres=") + 5);
10
11  // DOĞRU: işaretçiyi kullanmadan önce NULL kontrolü yap / RIGHT: check for NULL before using the pointer
12  const char* found = strstr(response, "pres=");
13  if (found != nullptr) {
14    float pressure = atof(found + 5);
15    Serial.println(pressure);
16  } else {
17    Serial.println("pres alani bulunamadi / pres field not found");
18  }
19}
20
21void loop() {
22}
Null pointer-ə qarşı bir neçə vərdiş qazan: göstəriciləri təyin edəndə nullptr ilə başlat, kitabxanaların begin() funksiyalarının qaytardığı dəyəri yoxla, obyekti delete etdikdən sonra göstəricini nullptr et və massivlərə yazanda indeksin massiv ölçüsündən kiçik olduğundan əmin ol. Arduino IDE-də File > Preferences menyusundakı kompilyator xəbərdarlıqları ayarını All etsən, unudulmuş return və bənzər xətaları kompilyasiya zamanı görərsən.

Stek daşması: Stack canary watchpoint triggered xətası

ESP32-də hər tapşırığın (task) sabit ölçülü steki (stack) var; lokal dəyişənlər, funksiya çağırışları və qayıdış ünvanları bu stekdə saxlanılır. Arduino-da setup() və loop() funksiyalarını işlədən loopTask tapşırığının steki 8192 baytdır. loop() daxilində 10.000 baytlıq lokal massiv təyin etmək, özünü çağıran (rekursiv) funksiya və ya çoxlu lokal dəyişən istifadə edən kitabxana funksiyası bu həddi aşır. Stekin sonunda qoruyucu (canary) bölgə var; stek ora çatanda plata Guru Meditation Error: Core 1 panic'ed (Unhandled debug exception) və dərhal altında Debug exception reason: Stack canary watchpoint triggered (loopTask) yazır. Mötərizədəki ad steki daşan tapşırığın adıdır. Eyni problem bəzən ***ERROR*** A stack overflow in task loopTask has been detected. mesajı ilə də görünür. Həll yolları bunlardır:

  • Böyük massivləri stekdən çıxar: Massivi qlobal təyin et və ya əvvəlinə static əlavə et; beləliklə, stekdə yox, daimi RAM-da durur.
  • loopTask steki böyüt: Skeçin ən üstünə SET_LOOP_TASK_STACK_SIZE(16 * 1024); yazaraq loop() steki 16 KB-a çıxara bilərsən.
  • Öz tapşırıqlarına kifayət qədər yer ver: ESP32-də xTaskCreate və xTaskCreatePinnedToCore funksiyalarına verilən stek ölçüsü FreeRTOS-un digər platformalarında olduğu kimi söz (word) yox, bayt ilədir. 1024 bayt Serial.printf istifadə edən tapşırıq üçün belə azdır; 4096 ilə başla.
  • Ölç: uxTaskGetStackHighWaterMark(NULL) tapşırığın o ana qədər heç istifadə etmədiyi ən kiçik stek miqdarını bayt ilə verir; bu dəyər bir neçə yüz baytın altına düşürsə, steki böyüt.
  • Rekursiyadan qaç: Özünü çağıran funksiyaları dövrə çevir və ya dərinliyini məhdudlaşdır.

Task watchdog: "task_wdt: Task watchdog got triggered" xətası

Watchdog (gözətçi it) ilişən proqramı fərq edib platanı xilas edən taymerdir. ESP32-nin tapşırıq watchdog-u (Task WDT) ona qeydiyyatdan keçmiş tapşırıqların müəyyən fasilələrlə "yaşayıram" siqnalı verməsini gözləyir. Arduino nüvəsində susmaya görə 0-cı nüvənin boş (IDLE) tapşırığını izləyir və müddəti 5 saniyədir. 0-cı nüvədə işləyən tapşırıq 5 saniyə boyunca prosessoru heç buraxmasa, IDLE tapşırığı işləyə bilmir və Serial Monitor-da E (10257) task_wdt: Task watchdog got triggered. ilə başlayan mesaj görünür. Dərhal ardınca watchdog-u vaxtında sıfırlamayan tapşırıqların siyahısı (çox vaxt - IDLE (CPU 0)) və Tasks currently running: başlığı altında həmin an işləyən tapşırıqlar gəlir. Arduino nüvəsində bu halda task_wdt: Aborting. sətri ilə panik başlayır və plata yenidən başlayır.

Ən çox rast gəlinən səbəblər bunlardır: xTaskCreatePinnedToCore ilə 0-cı nüvəyə yerləşdirilmiş və içində heç vTaskDelay() olmayan dövr, sensordan zaman aşımı olmadan cavab gözləyən while dövrü və ya AsyncWebServer kimi kitabxanaların callback funksiyalarında delay() və ya uzun əməliyyatlar. Sonuncu halda siyahıda IDLE əvəzinə async_tcp tapşırığını görürsən. Həll uzun işləri kiçik hissələrə bölmək və dövrlərə vTaskDelay(1) kimi qısa gözləmələr əlavə etməkdir. loop() funksiyasının özü susmaya görə izlənmir; istəsən setup() daxilində enableLoopWDT() çağırıb loop() 5 saniyədən uzun ilişəndə platanın yenidən başlamasını təmin edə bilərsən. Watchdog-u disableCore0WDT() ilə söndürmək xətanı gizlədir, amma ilişən kodu düzəltmir. Tapşırıqlar və nüvələr haqqında daha çoxu üçün ESP32 FreeRTOS və ikinüvəli işləmə yazısına baxa bilərsən. Aşağıdakı kod həm düzgün tapşırıq strukturunu, həm də stek daşmasına qarşı görüləcək tədbirləri göstərir:

C++ (Arduino IDE)
1SET_LOOP_TASK_STACK_SIZE(16 * 1024);   // loop() yığını 8 KB yerine 16 KB / loop() stack 16 KB instead of 8 KB
2
3volatile uint32_t sampleCount = 0;
4
5// 0. çekirdekte çalışan görev / task running on core 0
6void sensorTask(void* parameter) {
7  for (;;) {
8    sampleCount = sampleCount + 1;       // sensörünü burada oku / read your sensor here
9    vTaskDelay(pdMS_TO_TICKS(10));       // IDLE görevine sıra ver, task_wdt tetiklenmez / let IDLE run, no task_wdt
10  }
11}
12
13void setup() {
14  Serial.begin(115200);
15  // Yığın boyutu bayt cinsindendir: 4096 bayt / stack size is in bytes: 4096 bytes
16  xTaskCreatePinnedToCore(sensorTask, "sensorTask", 4096, NULL, 1, NULL, 0);
17}
18
19void loop() {
20  static uint8_t buffer[10000];          // static: yığında değil kalıcı RAM'de / static: in RAM, not on the stack
21  memset(buffer, 0, sizeof(buffer));
22
23  Serial.printf("Ornek / samples: %u, loopTask bos yigin / free stack: %u B\n",
24                (unsigned)sampleCount, (unsigned)uxTaskGetStackHighWaterMark(NULL));
25  delay(1000);
26}

Interrupt wdt timeout və IRAM_ATTR: kəsmələrdə çökmə

Kəsmə watchdog-u (Interrupt WDT) daha səbirsizdir: kəsmə funksiyası (ISR) və ya kəsmələrin bağlı saxlandığı kod hissəsi 300 ms-i aşarsa, plata Guru Meditation Error: Core 1 panic'ed (Interrupt wdt timeout on CPU1) xətası ilə çökür. ISR daxilində Serial.print, delay(), I2C və ya Wi-Fi əməliyyatları aparmaq ən çox rast gəlinən səbəbdir. Başqa bir tələ də flaş yaddaşdır: Preferences, EEPROM və ya LittleFS flaşa yazanda flaş keşi bir anlığa bağlanır. Bu zaman gələn kəsmənin funksiyası flaşdadırsa, plata Cache disabled but cached memory region accessed xətası verir. Həll ISR-ləri IRAM_ATTR ilə işarələyib RAM-a yerləşdirmək və içlərində yalnız bayraq qaldırmaqdır; əsl işi loop() görür. ISR ilə loop() arasında paylaşılan dəyişənlər volatile olmalıdır.

C++ (Arduino IDE)
1const int BUTTON_PIN = 27;              // buton GPIO 27 ile GND arasında / button between GPIO 27 and GND
2volatile bool buttonPressed = false;    // ISR ile loop arasında paylaşılan bayrak / flag shared by the ISR and loop
3uint32_t pressCount = 0;
4
5void IRAM_ATTR onButton() {             // IRAM_ATTR: fonksiyon flaşta değil RAM'de durur / the function lives in RAM, not flash
6  buttonPressed = true;                 // yalnızca bayrak kaldır, Serial yok / only set a flag, no Serial
7}
8
9void setup() {
10  Serial.begin(115200);
11  pinMode(BUTTON_PIN, INPUT_PULLUP);
12  attachInterrupt(digitalPinToInterrupt(BUTTON_PIN), onButton, FALLING);
13}
14
15void loop() {
16  if (buttonPressed) {
17    buttonPressed = false;
18    pressCount++;
19    Serial.printf("Butona basildi / button pressed: %u\n", (unsigned)pressCount);   // yavaş iş burada / slow work here
20  }
21}

ESP Exception Decoder ilə Backtrace-i kod sətrinə çevirmək

Backtrace sətrindəki ünvanlar tək başına heç nə demir; onları mənbə koddakı fayl, funksiya və sətir nömrəsinə çevirən alətə ESP Exception Decoder deyilir. Köhnə Arduino IDE 1.8-də bu alət Tools menyusuna əlavə olunan plagin idi. Arduino IDE 2-də isə icmanın hazırladığı eyni adlı uzantıdan istifadə edirsən:

  1. GitHub-dakı dankeboy36/esp-exception-decoder layihəsinin Releases bölməsindən .vsix uzantılı faylı endir. Arduino IDE 2 üçün 1.x versiyalarını seç; yeni 2.x versiyaları VS Code üçün hazırlanıb.
  2. Arduino IDE-ni bağla və faylı Windows-da %UserProfile%\.arduinoIDE\plugins, macOS və Linux-da ~/.arduinoIDE/plugins qovluğuna kopyala; qovluq yoxdursa, yarat.
  3. IDE-ni aç, çöküş yaşayan skeçi aç, Verify ilə kompilyasiya et və plataya yüklə.
  4. Serial Monitor-u aç və çökmənin yenidən baş verməsini gözlə.
  5. Ctrl+Shift+P (macOS-da Cmd+Shift+P) ilə komanda panelini aç və ESP Exception Decoder: Show Decoder Terminal komandasını işlət.
  6. Serial Monitor-dakı Guru Meditation blokunu Backtrace sətri ilə birlikdə kopyalayıb açılan terminala yapışdır; alət hər ünvanı fayl adı, funksiya və sətir nömrəsi ilə göstərir.

Uzantını qura bilmirsənsə, eyni işi əllə də edə bilərsən. Sketch > Export Compiled Binary menyusu skeç qovluğunun içindəki build qovluğuna .elf uzantılı fayl qoyur. ESP32 alət zəncirindəki xtensa-esp32-elf-addr2line -pfiaC -e sketch.ino.elf 0x400d1a29 0x400d0f6e komandası bu ünvanları funksiya adlarına və sətir nömrələrinə çevirir. PlatformIO istifadə edirsənsə, platformio.ini faylına monitor_filters = esp32_exception_decoder sətrini əlavə etmək kifayətdir; çökmə çıxışı serial monitorda öz-özünə həll olunur.

Decoder yalnız çöken proqramla eynilə eyni kompilyasiyanın .elf faylı ilə düzgün nəticə verir. Kodda tək sətir dəyişib yenidən kompilyasiya etsən, ünvanlar sürüşür və çıxış yanlış sətirləri göstərir. Backtrace sətrinin sonunda CORRUPTED yazılıbsa, stek pozulub; bu da adətən stek daşmasının və ya sərhədini aşan buferin əlamətidir.

Strapping pinlər: GPIO0, GPIO2, GPIO12 və GPIO15 açılışı necə pozur?

ESP32 açılanda bəzi pinlərin səviyyəsinə baxaraq necə başlayacağına qərar verir. Bu pinlərə strapping pinlər deyilir və yalnız reset anındakı səviyyələri vacibdir; açılış bitdikdən sonra normal GPIO kimi istifadə oluna bilərlər. Problem bu pinlərə qoşduğun sensorun, düymənin və ya modulun açılış anında pini yanlış səviyyəyə çəkməsidir. Bu halda plata proqramı heç başlatmır, proqramlaşdırma rejiminə girir və ya flaş yaddaşı oxuya bilmir; kənardan baxanda bu da "ESP32 açılmır" və ya "daim resetlənir" kimi görünür. Platanın tam pin xəritəsini Pinout alətində görə bilərsən.

PinDaxili rezistorAçılışdakı roluYanlış səviyyədə nə olur?
GPIO0Pull-upLOW isə proqramlaşdırma (download) rejimi, HIGH isə normal açılışboot:0x3 (DOWNLOAD_BOOT) və waiting for download; proqram işləmir
GPIO2Pull-downProqramlaşdırma rejiminə girmək üçün LOW və ya boş olmalıdır; normal açılışda əhəmiyyəti yoxdurHIGH-a çəkən dövrə kodun yüklənməsinə mane olur
GPIO12 (MTDI)Pull-downFlaşın qida gərginliyini seçir: LOW 3,3 V, HIGH 1,8 VHIGH isə 3,3 V-luq flaş düzgün qidalanmır; plata açılmır və ya reset dövrünə girir
GPIO15 (MTDO)Pull-upLOW isə ROM-un açılış mesajlarını susdururSerial Monitor-da açılış sətirləri görünmür, diaqnostika çətinləşir
GPIO5Pull-upSDIO zamanlamasını müəyyən edirİnkişaf platalarında nadir hallarda problem yaradır
GPIO12-yə qoşulmuş və açılışda pini HIGH-a çəkən pull-up rezistoru, rele və ya sensor modulu ESP32-nin ümumiyyətlə açılmamasının ən gizli səbəbidir. Bu pindən istifadə etməlisənsə, modulun açılış anında pini LOW saxladığından əmin ol. Alternativ olaraq esptool ilə gələn espefuse.py set_flash_voltage 3.3V komandası flaş gərginliyini eFuse-a daimi yazır və GPIO12-nin açılışdakı təsirini aradan qaldırır; lakin bu əməliyyat geri qaytarıla bilməz və yalnız 3,3 V flaşlı modullarda (ESP32-WROOM-32 kimi) edilməlidir.

Yeni nəsil platalarda strapping pinlər fərqlidir: ESP32-S3-də GPIO0, GPIO3, GPIO45 və GPIO46, ESP32-C3-də isə GPIO2, GPIO8 və GPIO9 açılışa təsir edir. ESP32-S3 klassik ESP32 ilə eyni Xtensa istisna adlarından istifadə edir. RISC-V nüvəli ESP32-C3-də isə LoadProhibited əvəzinə Load access fault, StoreProhibited əvəzinə Store access fault görürsən və EXCVADDR-ın vəzifəsini MTVAL registri öz üzərinə götürür. Brownout mesajı isə bütün modellərdə eynidir.

MicroPython-da ESP32 və Raspberry Pi Pico

ESP32-ni MicroPython ilə proqramlaşdırırsansa, brownout tam eyni şəkildə baş verir, çünki problem proqramda yox, aparatdadır. Python kodundakı xətalar isə Guru Meditation əvəzinə oxunaqlı Traceback kimi görünür və plata nadir hallarda çökür. Reset səbəbini machine.reset_cause() ilə oxuya bilərsən, amma diqqət: MicroPython-un ESP32 versiyası brownout-u ayrıca dəyər kimi qaytarmır, qidanın açılması ilə birlikdə PWRON_RESET kimi bildirir. Plata sən toxunmadığın halda daim PWRON_RESET ilə açılırsa, yenə qidadan şübhələn. Aşağıdakı kod ESP32 üçündür; Raspberry Pi Pico-da machine modulu daha az reset növü tanıyır. Pico-da VSYS girişindəki buck-boost stabilizator 1,8–5,5 V arasındakı gərginliklərlə işləyə bildiyi üçün brownout problemləri daha nadirdir; platanı tanımaq üçün Raspberry Pi Pico nədir? yazısına baxa bilərsən.

MicroPython
1import machine, gc, time
2
3# Reset nedenleri (ESP32 için) / reset causes (for ESP32)
4causes = {
5    machine.PWRON_RESET: "PWRON: guc acilisi ya da brownout / power-on or brownout",
6    machine.HARD_RESET: "HARD: cokme ya da machine.reset() / crash or machine.reset()",
7    machine.WDT_RESET: "WDT: watchdog",
8    machine.DEEPSLEEP_RESET: "DEEPSLEEP: derin uykudan uyanma / deep sleep wake-up",
9    machine.SOFT_RESET: "SOFT: Ctrl+D ile yazilim reseti / soft reset with Ctrl+D",
10}
11print("Reset nedeni / reset cause:", causes.get(machine.reset_cause(), "bilinmiyor / unknown"))
12
13while True:
14    gc.collect()                                     # çöp toplayıcıyı çalıştır / run the garbage collector
15    print("Bos RAM / free RAM:", gc.mem_free(), "bayt / bytes")
16    time.sleep(5)

Tez-tez rast gəlinən xətalar və həlləri

ƏlamətMümkün səbəbHəll
Wi-Fi başlayanda Brownout detector was triggeredNaqil, port və ya stabilizator zirvə cərəyana çatmırQısa qalın naqil, 1 A adapter, 3V3-GND arasına 470 µF + 100 nF
Servo dönəndə və ya rele qoşulanda resetYük ESP32 ilə eyni xəttdən qidalanırYükü ayrı 5 V mənbədən qidalandır, GND-ləri birləşdir
Batareya bir az boşalanda resetlər başlayırAMS1117-nin dropout gərginliyiLDO və ya buck-boost çevirici istifadə et
Guru Meditation, EXCVADDR 0x00000000Null pointerGöstəricini istifadə etməzdən əvvəl yoxla
Stack canary watchpoint triggered (loopTask)loop() steki dolduBöyük massivləri static et və ya SET_LOOP_TASK_STACK_SIZE istifadə et
task_wdt: - IDLE (CPU 0)0-cı nüvədə gözləməsiz dövrDövrə vTaskDelay əlavə et
Interrupt wdt timeout on CPU1ISR çox uzundurISR-də yalnız bayraq qaldır, IRAM_ATTR istifadə et
Plata səssizdir, boot:0x3 və waiting for downloadGPIO0 açılışda LOWGPIO0-a qoşulmuş dövrəni çıxar, EN-ə bas
Plata ümumiyyətlə açılmır, flaş oxuma xətasıGPIO12 açılışda HIGHGPIO12-dəki pull-up-ı və ya modulu başqa pinə köçür
Kod yükləyəndə Failed to connect to ESP32GPIO2 HIGH-dır və ya plata proqramlaşdırma rejiminə girə bilmirGPIO2-ni boşalt, yükləmə başlayanda BOOT düyməsini basılı saxla
Diaqnostikada ardıcıllığı pozma: əvvəlcə naqili və qida mənbəyini dəyiş, sonra kondensatoru əlavə et, daha sonra servoları və LED-ləri ayrıca qidalandır. Brownout mesajı itdikdən sonra hələ də reset olursa, diaqnostika kodundakı reset səbəbinə bax və proqram bölmələrinə keç. Tools > Core Debug Level ayarını Verbose etsən, ESP32 nüvəsi Wi-Fi və sistem hadisələri ilə bağlı çox daha ətraflı mesajlar yazır. Kod yükləmə problemləri üçün Arduino-ya kod yüklənmir yazısına da nəzər sala bilərsən.

Platan sabit işləyir: sırada nə var?

  • Batareyaya qənaət edən cihaz: ESP32 deep sleep ilə platanı ölçmələr arasında yuxuya ver və mikroamper səviyyəsində cərəyan çək.
  • Simsiz yeniləmə: ESP32 OTA ilə kodu USB naqilsiz yüklə.
  • Real vaxt paneli: ESP32 WebSocket ilə sensor məlumatını brauzerdə canlı izlə.
  • Bildiriş göndər: ESP32 Telegram bot ilə plata hər dəfə yenidən başlayanda reset səbəbini telefonuna mesaj kimi al.
  • İşıq şousu: WS2812B NeoPixel lentini ayrı qida ilə təhlükəsiz idarə et.

ESP32-nin yenidən başlama problemlərinin çoxu ya qida problemidir, ya da bir neçə sətirlik kod xətası; mesajı düzgün oxuyanda hər ikisi tez həll olunur. Platanın əsaslarını təzələmək üçün ESP32 nədir? yazısına nəzər sala bilərsən. BlueGrays tətbiqində ESP32 ilə LED, servo, NeoPixel lent, Wi-Fi qoşulması, veb server, OTA yeniləmə və dərin yuxu layihələrini addım-addım dövrə sxemi və kodları ilə tapa, burada öyrəndiyin qida və diaqnostika üsullarını real layihələrdə sına bilərsən.

Tez-tez verilən suallar

ESP32 brownout detector was triggered xətası necə düzəlir?

Bu xəta ESP32-nin qida gərginliyinin bir anlığa təxminən 2,43 V-un altına düşdüyünü göstərir. Əvvəlcə qısa və qalın USB naqili ilə ən azı 1 A verən 5 V mənbədən istifadə et, sonra 3V3 ilə GND arasına 100–470 µF elektrolitik və 100 nF keramik kondensator əlavə et. Servo, rele və LED lent kimi yükləri ayrı mənbədən qidalandırıb GND-ləri birləşdir.

ESP32 niyə daim yenidən başlayır?

Ən çox rast gəlinən səbəblər qidanın çatışmazlığı (brownout), proqram çökmələri (Guru Meditation), watchdog zaman aşımları və açılışda yanlış səviyyədə qalan strapping pinlərdir. Serial Monitor-u 115200 baud sürətində açıb EN düyməsinə bas; resetdən əvvəlki son mesaj və açılışdakı rst kodu səbəbi göstərir. esp_reset_reason() funksiyası da səbəbi kodun içindən oxumağa imkan verir.

Guru Meditation Error LoadProhibited nə deməkdir?

ESP32-dəki kodun yanlış yaddaş ünvanından oxumağa çalışdığı mənasına gəlir. EXCVADDR dəyəri 0 və ya çox kiçik rəqəmdirsə, demək olar ki, həmişə null pointer istifadə olunub. Backtrace sətrini ESP Exception Decoder-ə yapışdıraraq xətanın hansı fayl və sətirdə olduğunu tapa bilərsən.

ESP32 brownout detektorunu söndürmək olarmı?

Bəli, WRITE_PERI_REG(RTC_CNTL_BROWN_OUT_REG, 0) sətri ilə söndürmək olar, amma bu yalnız xəbərdarlığı susdurur. Gərginlik düşməsi davam etdiyi üçün flaşdakı verilənlər pozula bilər və plata başqa xətalarla çökə bilər. Bu üsuldan yalnız problemin qidadan qaynaqlandığını təsdiqləmək üçün qısa müddətə istifadə et.

ESP32 Task watchdog got triggered xətası necə həll olunur?

Bu mesaj izlənən tapşırığın 5 saniyə boyunca prosessoru buraxmadığını göstərir; Arduino-da siyahıda adətən 0-cı nüvənin IDLE tapşırığı olur. Öz yaratdığın tapşırıqlardakı dövrlərə vTaskDelay() əlavə et, sensoru gözləyəndə zaman aşımından istifadə et və veb server callback-lərində delay() və ya uzun əməliyyatlar aparma. Watchdog-u söndürmək xətanı gizlədir, səbəbi düzəltmir.

ESP32 üçün neçə amperlik adapter lazımdır?

Espressif ESP32 üçün ən azı 500 mA verə bilən qida mənbəyi tövsiyə edir; praktikada 5 V və 1 A-lik adapter təhlükəsiz ehtiyat saxlayır. ESP32-CAM istifadə edirsənsə və ya servo, LED lent kimi yüklər əlavə etmisənsə, 2 A və yuxarı mənbə seç və bu yükləri mümkünsə ayrı xəttdən qidalandır.

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
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 servo mühərrik (potensiometrlə idarə)
ES-16Orta
Premium

ESP32 servo mühərrik (potensiometrlə idarə)

Bu layihədə potensiometrlə SG90 servo mühərrikini idarə edirik. Potensiometrdən oxunan analoq dəyəri 0-180 dərəcə aralığına map-ləyərək servo bucağını tənzimləyirik. ESP32Servo kitabxanası ESP32-nin çıxış verə bilən uyğun GPIO-larında servo siqnalı yaradır; bu layihədə GPIO 18 istifadə olunur. Bu, robot qollar, kamera gimbal-ları və avtomatik qapı mexanizmləri üçün əsas idarəetmə üsuludur.

4.3(29)
42
ESP32 WS2812B NeoPixel lent idarəsi
ES-24Orta
Premium

ESP32 WS2812B NeoPixel lent idarəsi

WS2812B (NeoPixel) ünvanlana bilən LED-lər tək data pini üzərindən zəncirvari idarə oluna bilən ağıllı RGB LED-lərdir. Bu layihədə 8 LED-lik WS2812B lentini Adafruit_NeoPixel kitabxanası ilə idarə edib axıcı göy qurşağı animasiyası yaradacağıq. ESP32-nin 3,3V məntiq səviyyəsi əksər WS2812B partiyalarında problemsiz işləsə də, qeyri-sabitlik olsa, 470Ω ardıcıl rezistor və 1000µF kondensator həllini göstərəcəyik. Animasiya HSV rəng məkanında ton (hue) dəyərini sürüşdürməklə əldə edilir.

4.9(19)
30
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 Deep Sleep — batareya qənaəti (OLED + RTC RAM sayğac)
ES-33Qabaqcıl
Premium

ESP32 Deep Sleep — batareya qənaəti (OLED + RTC RAM sayğac)

ESP32-nin Deep Sleep rejimi CPU-nu və əksər periferiyaları söndürərək cərəyan istehlakını təxminən 10µA səviyyəsinə endirir; batareya ilə işləyən IoT cihazları üçün çox vacibdir. Bu layihədə üç oyanma mənbəyi istifadə edirik: taymer (15 san), xarici pin (EXT0, GPIO 33-dəki düymə) və toxunma pini (T0/GPIO 4). RTC_DATA_ATTR ilə işarələnən sayğaclar deep sleep boyunca qorunur.

4.3(10)
16
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 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