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

ESP32 hava proqnozu: API ilə məlumat çəkmə, JSON və OLED ekran

ESP32 hava proqnozu bələdçisi: HTTPClient ilə Open-Meteo və OpenWeatherMap sorğusu, ArduinoJson ilə təhlil, OLED/LCD ekran, HTTPS və 401, 404, -1 xətaları.

ESP32 hava proqnozu layihələri platanı Wi-Fi-a qoşub internetdəki hava proqnozu xidmətindən sual soruşmağa və gələn cavabı ekranda göstərməyə əsaslanır. Tək bir sensor taxmadan yaşadığın şəhərin temperaturunu, rütubətini, küləyini və sabahkı proqnozu öyrənə bilərsən, çünki ölçməni meteorologiya stansiyalarından və hava modellərindən qidalanan bir API (tətbiq proqramlaşdırma interfeysi) sənin əvəzinə edib. ESP32 bu xidmətə veb brauzer kimi HTTP GET sorğusu göndərir, cavab olaraq JSON formatında sadə mətn alır və ArduinoJson kitabxanası ilə bu mətnin içindən rəqəmləri çıxarır.

Bu bələdçidə əvvəlcə açar istəməyən Open-Meteo ilə ilk sorğunu göndərəcək, sonra şəhər adı ilə işləyən OpenWeatherMap-a keçəcəksən. JSON-u təhlil etməyi, WMO hava kodlarını yazıya çevirməyi, nəticəni 0,96 düymlük OLED və 16x2 I2C LCD ekranda göstərməyi, HTTPS və sertifikat ayarını, sorğu limitlərini və 401, 404, -1 kimi xəta kodlarının nə demək olduğunu tək-tək görəcəksən. Sonda eyni üsulla valyuta məzənnəsi çəkən nümunə və Raspberry Pi Pico W üçün MicroPython kodu da var.

ESP32 inkişaf platası
ESP32: daxili Wi-Fi sayəsində əlavə modul olmadan internetdən hava məlumatı çəkə bilər.

ESP32 internetdən məlumatı necə çəkir? API, HTTP və JSON

Brauzerinə ünvan yazanda brauzer həmin serverə HTTP sorğusu göndərir və server veb səhifə qaytarır. API də eyni cür işləyir; yeganə fərq cavabın insanlar üçün bəzədilmiş səhifə yox, proqramların asanlıqla oxuya biləcəyi nizamlı mətn olmasıdır. ESP32 tərəfində bu işi nüvə ilə gələn HTTPClient kitabxanası görür: ünvanı verirsən, o da GET sorğusunu göndərir və serverin status kodunu, cavabın gövdəsini sənə təhvil verir. Cavab çox vaxt JSON olur; fiqurlu mötərizələr içində "açar": dəyər cütlərindən ibarətdir və iç-içə obyektlər ya da massivlər ehtiva edə bilər.

TerminMənasıHava proqnozu nümunəsi
APIProqramların məlumat mübadiləsi apardığı qapıOpen-Meteo proqnoz xidməti
Son nöqtə (endpoint)API-nin müəyyən bir işi görən ünvanı/v1/forecast
Sorğu parametriÜnvanda ? işarəsindən sonra gələn ayarlarlatitude=41.01¤t=temperature_2m
GET sorğusuServerdən məlumat istəməkhttp.GET()
Status koduSorğunun nəticəsini bildirən rəqəm200 uğurlu, 404 tapılmadı
JSONAçar və dəyərlərdən ibarət mətn formatı{"temperature_2m":17.3}
API açarıSəni tanıdan gizli identifikatorOpenWeatherMap appid dəyəri

Hansı xidmət: Open-Meteo, yoxsa OpenWeatherMap?

Pulsuz səviyyəsi olan çoxlu hava proqnozu xidməti var, amma başlanğıc üçün ikisi önə çıxır. Open-Meteo qeydiyyat və açar istəmir; məkanı enlik və uzunluqla verirsən, yalnız istədiyin sahələri seçirsən və buna görə cavab qısa və ESP32 üçün yüngül olur. OpenWeatherMap isə pulsuz hesab və API açarı istəyir; əvəzində şəhər adı ilə sorğu, hazır izah mətni (məsələn, "light rain") və ikon kodu verir. İkisinin də pulsuz versiyası şəxsi və təhsil layihələri üçündür; kommersiya məhsulu düzəldəcəksənsə, istifadə şərtlərini ayrıca oxu.

XüsusiyyətOpen-MeteoOpenWeatherMap (pulsuz)
Qeydiyyat və açarLazım deyilHesab və API açarı lazımdır
MəkanEnlik və uzunluqŞəhər adı, enlik-uzunluq və ya şəhər ID-si
Pulsuz limitGündə 10.000, saatda 5.000, dəqiqədə 600 sorğuDəqiqədə 60, ayda 1.000.000 sorğu
Məlumatın yenilənməsiAnlıq məlumat 15 dəqiqədən birTəxminən 10 dəqiqədən bir
Hava vəziyyəti məlumatıWMO rəqəm kodu (0, 3, 61...)İzah mətni və ikon kodu
Vahidlər°C və km/saat (parametrlə dəyişir)units=metric ilə °C və m/s
Cavabın ölçüsüSeçdiyin sahələr qədər, təxminən 400 baytTəxminən 500 bayt
Yalnız temperatur və hava vəziyyəti göstərəcəksənsə, Open-Meteo ilə başla: açar gözləmədən ilk dəqiqədə nəticə alırsan. Məkanının enliyini və uzunluğunu xəritə tətbiqində şəhərinin üzərinə sağ klik edərək (telefonda basılı saxlayaraq) öyrənə bilərsən. İstanbul üçün 41.01, 28.98, Ankara üçün 39.93, 32.86, İzmir üçün 38.42, 27.14 kifayət qədər yaxındır.

Nələr lazımdır və quraşdırma

  1. Arduino IDE-yə ESP32 plata paketini quraşdır (Tools > Board > Boards Manager-də esp32 by Espressif). Quraşdırmanın təfərrüatları ESP32 nədir yazısındadır.
  2. Library Manager-də ArduinoJson (Benoit Blanchon) axtar və 7.x versiyasını quraşdır. HTTPClient, WiFi və WiFiClientSecure kitabxanaları ESP32 paketi ilə birlikdə gəlir, ayrıca quraşdırılmır.
  3. Ekranlı versiya üçün Adafruit SSD1306 və Adafruit GFX kitabxanalarını, LCD istifadə edəcəksənsə LiquidCrystal I2C kitabxanasını quraşdır.
  4. Kodlardakı AgAdi və Sifre123 yerinə öz Wi-Fi adını və şifrəni yaz, plata kimi ESP32 Dev Module seç və Serial Monitor-u 115200 baud-a ayarla.
ESP32 yalnız 2,4 GHz Wi-Fi şəbəkələrinə qoşulur. Kod Wi-Fi sətrində dayanmadan nöqtə çap edirsə, problem API-də yox, əlaqədədir; şəbəkə adını, şifrəni və modemin 2,4 GHz yayımını yoxla. Ətraflı həll siyahısı ESP32 Wi-Fi-a qoşulmur yazısındadır.

Addım-addım ilk sorğu: HTTPClient ilə GET

İlk kodun yalnız bir işi var: Wi-Fi-a qoşulmaq, Open-Meteo-dan İstanbulun anlıq hava vəziyyətini istəmək və gələn cavabı olduğu kimi Serial Monitor-a yazmaq. Ünvandakı current= parametri hansı sahələri istədiyini bildirir; vergüllə ayıraraq temperaturu, rütubəti, hava kodunu və külək sürətini seçdik. timezone=auto isə saatları məkanın yerli vaxtına çevirir.

C++ (Arduino IDE)
1#include <WiFi.h>
2#include <HTTPClient.h>
3
4const char* WIFI_SSID = "AgAdi";        // Wi-Fi adı / Wi-Fi name
5const char* WIFI_PASS = "Sifre123";     // Wi-Fi şifresi / Wi-Fi password
6
7// İstanbul'un anlık hava durumu (anahtar gerekmez) / current weather for Istanbul (no key needed)
8const char* URL = "http://api.open-meteo.com/v1/forecast?latitude=41.01&longitude=28.98"
9                  "&current=temperature_2m,relative_humidity_2m,weather_code,wind_speed_10m"
10                  "&timezone=auto";
11
12void setup() {
13  Serial.begin(115200);
14  WiFi.mode(WIFI_STA);
15  WiFi.begin(WIFI_SSID, WIFI_PASS);
16  Serial.print("Wi-Fi");
17  while (WiFi.status() != WL_CONNECTED) {   // bağlanana kadar bekle / wait until connected
18    delay(500);
19    Serial.print(".");
20  }
21  Serial.println(" OK");
22
23  HTTPClient http;
24  http.begin(URL);                          // isteği hazırla / prepare the request
25  int code = http.GET();                    // GET isteğini gönder / send the GET request
26  Serial.printf("HTTP kodu / code: %d\n", code);
27
28  if (code > 0) {                           // sunucu yanıt verdi / the server answered
29    Serial.println(http.getString());       // yanıtın gövdesi (JSON) / response body (JSON)
30  } else {                                  // eksi kod: bağlantı sorunu / negative: connection problem
31    Serial.println(http.errorToString(code));
32  }
33  http.end();                               // bağlantıyı kapat, belleği boşalt / close and free memory
34}
35
36void loop() {
37}

Kodu yükləyəndə Serial Monitor-da əvvəlcə "HTTP kodu / code: 200", ardınca tək sətirlik JSON görməlisən. Cavabın bizə lazım olan hissəsi buna bənzəyir: "current":{"time":"2026-11-17T14:15","interval":900,"temperature_2m":17.3,"relative_humidity_2m":63,"weather_code":3,"wind_speed_10m":12.4}. Buradakı interval dəyəri olan 900 məlumatın 900 saniyədən, yəni 15 dəqiqədən bir yeniləndiyini bildirir; bu məlumat sonradan sorğu tezliyini müəyyən edəndə işinə yarayacaq.

FunksiyaNə edir?
http.begin(url)Ünvanı həll edir, əlaqəni hazırlayır
http.GET()Sorğunu göndərir; HTTP status kodunu və ya mənfi xəta kodunu qaytarır
http.getString()Cavabın gövdəsini String kimi oxuyur
http.getStream()Gövdəni saxlamadan axın kimi verir (böyük cavablar üçün)
http.errorToString(code)Mənfi xəta kodunu oxunaqlı mətnə çevirir
http.setTimeout(ms)Cavab üçün gözləmə müddəti (susmaya görə 5000 ms)
http.end()Əlaqəni bağlayır və yaddaşı azad edir

ArduinoJson ilə JSON təhlili

Xam JSON-u ekranda göstərmək heç nəyə yaramır; onun içindən 17.3 rəqəmini çıxarıb float dəyişənə qoymalısan. ArduinoJson bu mətni yaddaşda ağac strukturuna çevirir, sən də açarların adları ilə budaqlara enirsən: doc["current"]["temperature_2m"] əvvəlcə current obyektinə, sonra onun içindəki temperatura gedir. Dəyəri hansı tipli dəyişənə mənimsətsən, kitabxana onu həmin tipə çevirir. Olmayan açar istəsən, proqram çökmür; rəqəm üçün 0, mətn üçün boş göstərici (null) qayıdır.

C++ (Arduino IDE)
1#include <WiFi.h>
2#include <HTTPClient.h>
3#include <ArduinoJson.h>
4
5const char* WIFI_SSID = "AgAdi";
6const char* WIFI_PASS = "Sifre123";
7const char* URL = "http://api.open-meteo.com/v1/forecast?latitude=41.01&longitude=28.98"
8                  "&current=temperature_2m,relative_humidity_2m,weather_code,wind_speed_10m"
9                  "&timezone=auto";
10
11bool fetchWeather() {
12  HTTPClient http;
13  http.begin(URL);
14  int code = http.GET();
15  if (code != HTTP_CODE_OK) {               // 200 değilse vazgeç / give up if not 200
16    Serial.printf("Hata / error: %d %s\n", code, http.errorToString(code).c_str());
17    http.end();
18    return false;
19  }
20
21  JsonDocument doc;                         // ArduinoJson 7: boyut otomatik / size is automatic
22  DeserializationError err = deserializeJson(doc, http.getString());
23  http.end();
24  if (err) {                                // JSON bozuk ya da eksik / JSON broken or truncated
25    Serial.print("JSON hatasi / error: ");
26    Serial.println(err.c_str());
27    return false;
28  }
29
30  JsonObject now = doc["current"];          // "current" nesnesi / the "current" object
31  float temp     = now["temperature_2m"];   // °C
32  int humidity   = now["relative_humidity_2m"];
33  int wmo        = now["weather_code"];     // WMO hava kodu / WMO weather code
34  float wind     = now["wind_speed_10m"];   // km/sa / km/h
35  const char* t  = now["time"];             // ölçüm zamanı / observation time
36
37  Serial.printf("%s  %.1f C  %%%d nem/hum  kod/code %d  ruzgar/wind %.1f km/h\n",
38                t, temp, humidity, wmo, wind);
39  return true;
40}
41
42void setup() {
43  Serial.begin(115200);
44  WiFi.begin(WIFI_SSID, WIFI_PASS);
45  while (WiFi.status() != WL_CONNECTED) delay(500);
46  fetchWeather();
47}
48
49void loop() {
50}

Bu kod ArduinoJson 7 üçündür. Köhnə nümunələrdə görəcəyin StaticJsonDocument və DynamicJsonDocument doc(1024) sətirləri 6.x versiyasına aiddir; 7.x-də onların yerinə yalnız JsonDocument doc; yazılır və yaddaş ehtiyaca görə öz-özünə ayrılır. Köhnə kodu kompilyasiya edəndə "StaticJsonDocument is deprecated" xəbərdarlığı alırsansa, səbəb budur: kod çox vaxt yenə işləyir, amma yeni yazılışa keçmək daha səliqəlidir. Oxuma tərəfi, yəni doc["key"] yazılışı hər iki versiyada eynidir.

deserializeJson() xəta qaytararsa, err.c_str() sənə səbəbini deyir: IncompleteInput cavabın yarıda kəsildiyini, InvalidInput gələn mətnin JSON olmadığını (çox vaxt HTML xəta səhifəsi), NoMemory isə yaddaşın çatmadığını göstərir. Problemi həll etmənin ən sürətli yolu cavabı əvvəlcə Serial.println() ilə ekrana çap edib gözlə baxmaqdır.

WMO hava kodları: rəqəmi yazıya çevirmək

Open-Meteo hava vəziyyətini "buludlu" kimi sözlə yox, Dünya Meteorologiya Təşkilatının (WMO) müəyyən etdiyi rəqəmlə verir. Beləliklə cavab dildən asılı olmur və ekranda hansı dildən istifadə edəcəyinə sən qərar verirsən. Ən çox görəcəyin kodlar bunlardır:

WMO koduMənası
0Açıq hava
1, 2, 3Əsasən açıq, parçalı buludlu, tutqun
45, 48Duman, qırov qoyan duman
51, 53, 55Zəif, orta, güclü çiskin
56, 57Donan çiskin
61, 63, 65Zəif, orta, güclü yağış
66, 67Donan yağış
71, 73, 75Zəif, orta, güclü qar
77Qar dənəcikləri
80, 81, 82Zəif, orta, şiddətli leysan
85, 86Zəif və güclü qar leysanı
95İldırımlı fırtına
96, 99Dolulu ildırımlı fırtına

Aşağıdakı OLED kodundakı wmoText() funksiyası bu cədvəli qısa etiketlərə çevirir. Öz ikonlarını çəkmək istəsən, eyni aralıqlardan istifadə edib günəş, bulud və ya yağış damlası bitmap-lərini seçə bilərsən; məsələn, 61 ilə 67 arası və 80 ilə 82 arası üçün eyni yağış ikonu kifayətdir.

OpenWeatherMap ilə şəhər adına görə hava proqnozu

OpenWeatherMap-da pulsuz hesab açandan sonra hesabının API keys bölməsində 32 simvolluq açar görürsən. Yeni açarın aktivləşməsi bir neçə dəqiqədən bir neçə saata qədər çəkə bilər; bu müddətdə hər sorğu 401 qaytarır və koduna xəta olduğunu düşünə bilərsən. Sorğuda q=Ankara,TR şəhər adını və ölkə kodunu, units=metric selsi və m/s vahidlərini, lang isə izahın dilini müəyyən edir.

C++ (Arduino IDE)
1#include <WiFi.h>
2#include <HTTPClient.h>
3#include <ArduinoJson.h>
4
5const char* WIFI_SSID = "AgAdi";
6const char* WIFI_PASS = "Sifre123";
7const char* API_KEY   = "BURAYA_API_ANAHTARIN";   // OpenWeatherMap hesabındaki anahtar / key from your account
8const char* CITY      = "Ankara,TR";              // şehir,ülke kodu / city,country code
9
10void fetchCity() {
11  String url = String("http://api.openweathermap.org/data/2.5/weather?q=") + CITY +
12               "&appid=" + API_KEY + "&units=metric&lang=en";   // metric = °C ve m/s / °C and m/s
13  HTTPClient http;
14  http.begin(url);
15  int code = http.GET();
16  String body = (code > 0) ? http.getString() : "";
17  http.end();
18
19  if (code == 401) { Serial.println("401: anahtar gecersiz ya da henuz aktif degil / invalid or inactive key"); return; }
20  if (code == 404) { Serial.println("404: sehir bulunamadi / city not found"); return; }
21  if (code == 429) { Serial.println("429: istek siniri asildi / rate limit exceeded"); return; }
22  if (code != 200) { Serial.printf("Hata / error %d: %s\n", code, HTTPClient::errorToString(code).c_str()); return; }
23
24  JsonDocument doc;
25  if (deserializeJson(doc, body)) { Serial.println("JSON hatasi / error"); return; }
26
27  const char* name = doc["name"];                        // şehir adı / city name
28  float temp       = doc["main"]["temp"];                // sıcaklık / temperature
29  float feels      = doc["main"]["feels_like"];          // hissedilen / feels like
30  int humidity     = doc["main"]["humidity"];            // nem % / humidity %
31  int pressure     = doc["main"]["pressure"];            // hPa
32  const char* desc = doc["weather"][0]["description"];   // dizi: [0] ilk eleman / array: [0] first item
33  float wind       = doc["wind"]["speed"];               // m/s
34
35  Serial.printf("%s: %.1f C (hissedilen/feels %.1f), %%%d, %d hPa, %s, %.1f m/s\n",
36                name, temp, feels, humidity, pressure, desc, wind);
37}
38
39void setup() {
40  Serial.begin(115200);
41  WiFi.begin(WIFI_SSID, WIFI_PASS);
42  while (WiFi.status() != WL_CONNECTED) delay(500);
43  fetchCity();
44}
45
46void loop() {
47}

Bu cavabda iki təfərrüat diqqət tələb edir. Birincisi, weather sahəsi obyekt yox, massivdir; izaha görə də doc["weather"][0]["description"] ilə, yəni massivin ilk elementi üzərindən çatılır. İkincisi, külək sürəti units=metric ilə m/s kimi gəlir; km/saat-a çevirmək üçün 3,6-ya vur. lang=tr yazsan, izahlar türkcə gələcək ("hafif yağmur" kimi), amma Adafruit GFX-in və HD44780 LCD-nin susmaya görə şriftləri ğ, ş, ı kimi hərfləri göstərə bilmir. Ekranda pozulmuş simvollar görməmək üçün lang=en istifadə edib öz etiketlərini yazmaq daha etibarlıdır.

HTTPS və sertifikat: setInsecure, yoxsa setCACert?

Hava proqnozu xidmətlərinin çoxu artıq HTTPS istifadə edir və bəziləri sadə HTTP-ni ümumiyyətlə qəbul etmir. HTTPS-də ESP32 ilə server arasındakı trafik şifrələnir; ESP32-nin qarşısındakının həqiqətən həmin server olduğuna əmin olması üçün isə sertifikat zəncirini bir kök sertifikatla yoxlaması lazımdır. Bunun üçün sadə WiFiClient əvəzinə WiFiClientSecure istifadə olunur və iki seçim var.

setInsecure() əlaqəni şifrələyir, amma sertifikatı yoxlamır. Hamıya açıq hava proqnozu kimi gizli olmayan məlumat üçün praktik və geniş yayılmış seçimdir, amma arada duran biri saxta məlumat göndərə bilər. setCACert() isə verdiyin kök sertifikatla zənciri yoxlayır. Open-Meteo-nun sertifikatı Let's Encrypt-ə, yəni ISRG Root X1 kökünə əsaslanır və bu kök 2035-ə qədər etibarlıdır. Serverin öz sertifikatı bir neçə aydan bir yenilənir, ona görə də koda heç vaxt onu yox, həmişə zəncirin ən üstündəki kökü qoy.

C++ (Arduino IDE)
1#include <WiFi.h>
2#include <WiFiClientSecure.h>
3#include <HTTPClient.h>
4
5const char* WIFI_SSID = "AgAdi";
6const char* WIFI_PASS = "Sifre123";
7
8// ISRG Root X1: Let's Encrypt kök sertifikası, 2035'e kadar geçerli
9// ISRG Root X1: Let's Encrypt root certificate, valid until 2035
10const char* ROOT_CA = R"EOF(
11-----BEGIN CERTIFICATE-----
12MIIFazCCA1OgAwIBAgIRAIIQz7DSQONZRGPgu2OCiwAwDQYJKoZIhvcNAQELBQAw
13TzELMAkGA1UEBhMCVVMxKTAnBgNVBAoTIEludGVybmV0IFNlY3VyaXR5IFJlc2Vh
14cmNoIEdyb3VwMRUwEwYDVQQDEwxJU1JHIFJvb3QgWDEwHhcNMTUwNjA0MTEwNDM4
15WhcNMzUwNjA0MTEwNDM4WjBPMQswCQYDVQQGEwJVUzEpMCcGA1UEChMgSW50ZXJu
16ZXQgU2VjdXJpdHkgUmVzZWFyY2ggR3JvdXAxFTATBgNVBAMTDElTUkcgUm9vdCBY
17MTCCAiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIBAK3oJHP0FDfzm54rVygc
18h77ct984kIxuPOZXoHj3dcKi/vVqbvYATyjb3miGbESTtrFj/RQSa78f0uoxmyF+
190TM8ukj13Xnfs7j/EvEhmkvBioZxaUpmZmyPfjxwv60pIgbz5MDmgK7iS4+3mX6U
20A5/TR5d8mUgjU+g4rk8Kb4Mu0UlXjIB0ttov0DiNewNwIRt18jA8+o+u3dpjq+sW
21T8KOEUt+zwvo/7V3LvSye0rgTBIlDHCNAymg4VMk7BPZ7hm/ELNKjD+Jo2FR3qyH
22B5T0Y3HsLuJvW5iB4YlcNHlsdu87kGJ55tukmi8mxdAQ4Q7e2RCOFvu396j3x+UC
23B5iPNgiV5+I3lg02dZ77DnKxHZu8A/lJBdiB3QW0KtZB6awBdpUKD9jf1b0SHzUv
24KBds0pjBqAlkd25HN7rOrFleaJ1/ctaJxQZBKT5ZPt0m9STJEadao0xAH0ahmbWn
25OlFuhjuefXKnEgV4We0+UXgVCwOPjdAvBbI+e0ocS3MFEvzG6uBQE3xDk3SzynTn
26jh8BCNAw1FtxNrQHusEwMFxIt4I7mKZ9YIqioymCzLq9gwQbooMDQaHWBfEbwrbw
27qHyGO0aoSCqI3Haadr8faqU9GY/rOPNk3sgrDQoo//fb4hVC1CLQJ13hef4Y53CI
28rU7m2Ys6xt0nUW7/vGT1M0NPAgMBAAGjQjBAMA4GA1UdDwEB/wQEAwIBBjAPBgNV
29HRMBAf8EBTADAQH/MB0GA1UdDgQWBBR5tFnme7bl5AFzgAiIyBpY9umbbjANBgkq
30hkiG9w0BAQsFAAOCAgEAVR9YqbyyqFDQDLHYGmkgJykIrGF1XIpu+ILlaS/V9lZL
31ubhzEFnTIZd+50xx+7LSYK05qAvqFyFWhfFQDlnrzuBZ6brJFe+GnY+EgPbk6ZGQ
323BebYhtF8GaV0nxvwuo77x/Py9auJ/GpsMiu/X1+mvoiBOv/2X/qkSsisRcOj/KK
33NFtY2PwByVS5uCbMiogziUwthDyC3+6WVwW6LLv3xLfHTjuCvjHIInNzktHCgKQ5
34ORAzI4JMPJ+GslWYHb4phowim57iaztXOoJwTdwJx4nLCgdNbOhdjsnvzqvHu7Ur
35TkXWStAmzOVyyghqpZXjFaH3pO3JLF+l+/+sKAIuvtd7u+Nxe5AW0wdeRlN8NwdC
36jNPElpzVmbUq4JUagEiuTDkHzsxHpFKVK7q4+63SM1N95R1NbdWhscdCb+ZAJzVc
37oyi3B43njTOQ5yOf+1CceWxG1bQVs5ZufpsMljq4Ui0/1lvh+wjChP4kqKOJ2qxq
384RgqsahDYVvTH9w7jXbyLeiNdd8XM2w9U/t7y0Ff/9yi0GE44Za4rF2LN9d11TPA
39mRGunUHBcnWEvgJBQl9nJEiU0Zsnvgc/ubhPgXRR4Xq37Z0j4r7g1SgEEzwxA57d
40emyPxgcYxn/eR44/KJ4EBs+lVDR3veyJm+kXQ99b21/+jh5Xos1AnX5iItreGCc=
41-----END CERTIFICATE-----
42)EOF";
43
44void setup() {
45  Serial.begin(115200);
46  WiFi.begin(WIFI_SSID, WIFI_PASS);
47  while (WiFi.status() != WL_CONNECTED) delay(500);
48
49  WiFiClientSecure client;
50  client.setCACert(ROOT_CA);       // sunucuyu doğrula / verify the server
51  // client.setInsecure();         // yalnız deneme için: şifreler ama doğrulamaz / testing only: encrypts, no verification
52
53  HTTPClient http;
54  http.begin(client, "https://api.open-meteo.com/v1/forecast?latitude=39.93&longitude=32.86&current=temperature_2m");
55  int code = http.GET();
56  Serial.printf("HTTPS kodu / code: %d\n", code);
57  if (code > 0) Serial.println(http.getString());
58  else Serial.println(HTTPClient::errorToString(code));
59  http.end();
60}
61
62void loop() {
63}
Kök sertifikatı başqa xidmət üçün istifadə etməzdən əvvəl həmin saytın hansı köklə bağlı olduğunu yoxla: OpenWeatherMap Sectigo və USERTrust, Frankfurter isə Google Trust Services zəncirindən istifadə edir. Yanlış kök versən, GET() -1 qaytarır və Serial Monitor-da bu rəqəmdən başqa ipucu görmürsən. API açarın kimi gizli məlumat göndərirsənsə, setInsecure() əvəzinə mütləq setCACert() istifadə et.

Şəhərin hava proqnozunu OLED ekranda göstərmək

0,96 düymlük I2C OLED ekran
0,96 düymlük SSD1306 OLED: ESP32-yə yalnız dörd naqillə qoşulur və hava məlumatını iri rəqəmlərlə göstərir.

Gəl, indi Serial Monitor-u kənara qoyub real masaüstü hava stansiyası quraq. 0,96 düymlük SSD1306 OLED ESP32-nin I2C pinlərinə qoşulur. Ekranın istifadəsi və kitabxana təfərrüatları üçün OLED ekran SSD1306 yazısına baxa bilərsən.

OLED piniESP32
GNDGND
VCC3V3
SCLGPIO 22
SDAGPIO 21
C++ (Arduino IDE)
1#include <WiFi.h>
2#include <WiFiClientSecure.h>
3#include <HTTPClient.h>
4#include <ArduinoJson.h>
5#include <Wire.h>
6#include <Adafruit_GFX.h>
7#include <Adafruit_SSD1306.h>
8
9const char* WIFI_SSID = "AgAdi";
10const char* WIFI_PASS = "Sifre123";
11const char* CITY_NAME = "Izmir";                   // ekranda görünecek ad / name shown on screen
12const char* URL = "https://api.open-meteo.com/v1/forecast?latitude=38.42&longitude=27.14"
13                  "&current=temperature_2m,relative_humidity_2m,weather_code,wind_speed_10m"
14                  "&timezone=auto";
15const unsigned long PERIOD = 10UL * 60UL * 1000UL; // 10 dakikada bir / every 10 minutes
16
17Adafruit_SSD1306 display(128, 64, &Wire, -1);
18unsigned long lastFetch = 0;
19bool firstRun = true;
20
21// WMO kodunu kısa metne çevir / turn a WMO code into a short label
22const char* wmoText(int c) {
23  if (c == 0) return "Acik";                       // açık / clear
24  if (c <= 2) return "Az bulutlu";                 // az bulutlu / partly cloudy
25  if (c == 3) return "Kapali";                     // kapalı / overcast
26  if (c == 45 || c == 48) return "Sis";            // sis / fog
27  if (c >= 51 && c <= 57) return "Ciseleme";       // çiseleme / drizzle
28  if (c >= 61 && c <= 67) return "Yagmur";         // yağmur / rain
29  if (c >= 71 && c <= 77) return "Kar";            // kar / snow
30  if (c >= 80 && c <= 82) return "Saganak";        // sağanak / showers
31  if (c == 85 || c == 86) return "Kar saganagi";   // kar sağanağı / snow showers
32  if (c >= 95) return "Firtina";                   // gök gürültülü fırtına / thunderstorm
33  return "?";
34}
35
36void showMessage(const char* line1, const char* line2) {
37  display.clearDisplay();
38  display.setTextSize(1);
39  display.setCursor(0, 0);
40  display.println(line1);
41  display.println(line2);
42  display.display();
43}
44
45void fetchAndShow() {
46  if (WiFi.status() != WL_CONNECTED) {             // Wi-Fi koptuysa yeniden bağlan / reconnect if Wi-Fi dropped
47    showMessage("Wi-Fi yok", "yeniden baglaniyor");
48    WiFi.reconnect();
49    return;
50  }
51
52  WiFiClientSecure client;
53  client.setInsecure();                            // şifreli, sertifika doğrulamasız / encrypted, no cert check
54  HTTPClient http;
55  http.setTimeout(8000);                           // yavaş ağlar için 8 sn / 8 s for slow networks
56  http.begin(client, URL);
57  int code = http.GET();
58  if (code != HTTP_CODE_OK) {
59    char buf[24];
60    snprintf(buf, sizeof(buf), "HTTP hata %d", code);
61    showMessage(buf, "10 dk sonra tekrar");
62    http.end();
63    return;
64  }
65
66  JsonDocument doc;
67  DeserializationError err = deserializeJson(doc, http.getString());
68  http.end();
69  if (err) { showMessage("JSON hatasi", err.c_str()); return; }
70
71  float temp   = doc["current"]["temperature_2m"];
72  int humidity = doc["current"]["relative_humidity_2m"];
73  int wmo      = doc["current"]["weather_code"];
74  float wind   = doc["current"]["wind_speed_10m"];
75  const char* t = doc["current"]["time"];          // "2026-11-17T14:15"
76
77  display.clearDisplay();
78  display.setTextSize(1);
79  display.setCursor(0, 0);
80  display.print(CITY_NAME);
81  display.setCursor(98, 0);
82  if (t && strlen(t) >= 16) display.print(t + 11); // "T"den sonrası: "14:15" / the part after "T"
83  display.drawLine(0, 10, 127, 10, SSD1306_WHITE);
84
85  display.setTextSize(3);                          // büyük sıcaklık / big temperature
86  display.setCursor(0, 16);
87  display.print(temp, 1);
88  display.setTextSize(1);
89  display.print((char)247);                        // derece işareti / degree sign
90  display.print("C");
91
92  display.setCursor(0, 44);
93  display.print(wmoText(wmo));
94  display.setCursor(0, 55);
95  display.printf("Nem %%%d  Ruzgar %.0f", humidity, wind);
96  display.display();
97}
98
99void setup() {
100  Serial.begin(115200);
101  Wire.begin(21, 22);                              // SDA, SCL
102  if (!display.begin(SSD1306_SWITCHCAPVCC, 0x3C)) {
103    Serial.println("OLED bulunamadi / not found");
104    for (;;);
105  }
106  display.setTextColor(SSD1306_WHITE);
107  display.cp437(true);                             // (char)247 derece olsun / so 247 is the degree sign
108  showMessage("Wi-Fi'ye", "baglaniyor...");
109  WiFi.mode(WIFI_STA);
110  WiFi.begin(WIFI_SSID, WIFI_PASS);
111  while (WiFi.status() != WL_CONNECTED) delay(500);
112}
113
114void loop() {
115  if (firstRun || millis() - lastFetch >= PERIOD) { // delay yerine millis / millis instead of delay
116    firstRun = false;
117    lastFetch = millis();
118    fetchAndShow();
119  }
120}

Kod açılışda Wi-Fi-a qoşulur, ilk məlumatı dərhal çəkir və sonra hər 10 dəqiqədən bir yeniləyir. Gözləmə üçün delay() əvəzinə millis() istifadə etdik; beləliklə loop() boş dövr edərkən araya düymə oxuma və ya animasiya əlavə edə bilərsən. Əlaqə qopsa, kod ekrana xəbərdarlıq yazır və yenidən qoşulmağa çalışır; sorğu uğursuz olsa, xəta kodunu göstərir. Sağ üstdəki saat cavabdakı "2026-11-17T14:15" mətninin T hərfindən sonrakı hissəsidir; beləliklə ayrıca saat ayarı etmədən son ölçmənin saatını görürsən. Saniyəsi-saniyəsinə işləyən saat istəyirsənsə, ESP32 NTP saat yazısındakı üsulu bu koda əlavə edə bilərsən.

16x2 I2C LCD ekranda göstərmək

Əlində OLED əvəzinə 16x2 simvol LCD varsa, eyni məlumatı iki sətrə sığdıra bilərsən. LCD modulunu ESP32-nin 5 V verən VIN pinindən qidalandırmaq kontrastı yaxşılaşdırır; SDA-nı GPIO 21-ə, SCL-i GPIO 22-yə qoş. Modul I2C xətlərini 5 V-a çəkdiyi üçün ən təhlükəsiz yol arada səviyyə çeviricisi istifadə etməkdir. OLED kodundakı çəkmə sətirlərinin yerinə aşağıdakı kimi bir funksiya qoymaq kifayətdir; təfərrüatlar I2C LCD ekran yazısındadır.

C++ (Arduino IDE)
1#include <LiquidCrystal_I2C.h>
2
3LiquidCrystal_I2C lcd(0x27, 16, 2);                // adres 0x27 ya da 0x3F / address 0x27 or 0x3F
4
5// OLED kodundaki ekran kısmının yerine / replaces the OLED drawing part
6void showOnLcd(float temp, int humidity, const char* label) {
7  lcd.clear();
8  lcd.setCursor(0, 0);
9  lcd.print("Izmir ");
10  lcd.print(temp, 1);
11  lcd.print((char)223);                            // LCD'de derece işareti / degree sign on HD44780
12  lcd.print("C");
13  lcd.setCursor(0, 1);
14  lcd.print(label);                                // ör. "Yagmur" / e.g. "Yagmur"
15  lcd.print(" %");
16  lcd.print(humidity);
17}
18
19void setup() {
20  lcd.init();                                      // ESP32'de Wire.begin(21, 22) varsayılan / default pins
21  lcd.backlight();
22  showOnLcd(18.4, 62, "Az bulutlu");
23}
24
25void loop() {
26}

Sorğu tezliyi və pulsuz limitlər

Ən çox edilən səhv loop()-un içinə delay(1000) qoyub hər saniyə sorğu göndərməkdir. Bu həm lazımsızdır, həm də səni limitlərə ilişdirir: Open-Meteo-nun anlıq məlumatı onsuz da 15 dəqiqədən bir yenilənir, hər saniyə soruşsan, eyni cavabı 900 dəfə alırsan. Saniyədə bir sorğu gündə 86.400 edir və Open-Meteo-nun 10.000-lik gündəlik limitini üç saatdan qısa müddətdə doldurur. Hesab sadədir: gündəlik sorğu sayı 1440-ın dəqiqə ilə intervala bölünməsinə bərabərdir.

IntervalGündəlik sorğuQiymətləndirmə
1 san86.400Limit aşılır, IP ünvanın müvəqqəti bloklana bilər
1 dəq1.440Limit daxilindədir, amma məlumat dəyişmədiyi üçün boşunadır
10 dəq144Masaüstü hava stansiyası üçün idealdır
15 dəq96Open-Meteo-nun yenilənmə sürəti ilə eynidir
1 saat24Batareya ilə işləyən cihazlar və gündəlik proqnoz üçün kifayətdir
Batareya ilə işləyən hava stansiyasında ən çox cərəyanı Wi-Fi çəkir. Məlumatı çəkəndən sonra ESP32-ni 15 dəqiqəlik dərin yuxuya salsan, orta cərəyan çılpaq modulda 1 mA-dən aşağı, tipik inkişaf platasında bir neçə milliampere enir və tək bir 18650 batareya həftələrlə kifayət edir. Təfərrüatlar ESP32 deep sleep yazısındadır.

Xəta kodları: 401, 404, 429 və -1

http.GET() iki cür rəqəm qaytarır. Müsbət rəqəmlər serverdən gələn HTTP status kodlarıdır: əlaqə qurulub, server səni eşidib, amma sorğunda nəyisə bəyənməyib. Mənfi rəqəmlər isə ESP32-nin öz xəta kodlarıdır və sorğunun serverə heç çatmadığını ya da cavabın yarıda qaldığını göstərir.

KodMənasıNə etməli?
200UğurluGövdəni oxu və təhlil et
400Səhv sorğuÜnvandakı parametr adlarını və vergülləri yoxla
401İcazəsiz: API açarı yoxdur, yanlışdır və ya hələ aktiv deyilAçarı yenidən kopyala; yeni açardırsa, bir müddət gözlə
404Tapılmadı: şəhər adı və ya ünvan yanlışdırŞəhər adını ingilis hərfləri ilə yaz (Istanbul,TR), ünvanı yoxla
429Çox sayda sorğuSorğu intervalını uzat
500-503Server tərəfində problemBir neçə dəqiqədən sonra yenidən cəhd et
-1Əlaqə qurulmadı: internet yoxdur, domen adı həll olunmadı, ünvan yanlışdır və ya HTTPS əl sıxması uğursuz olduWi-Fi-ı, ünvanı və sertifikatı yoxla
-5Əlaqə yarıda qopduWi-Fi siqnalını gücləndir, sorğunu yenidən cəhd et
-11Oxuma vaxtı bitdihttp.setTimeout() ilə gözləmə müddətini uzat

OpenWeatherMap xəta halında da JSON qaytarır: yanlış açarda {"cod":401, "message":"Invalid API key..."}, naməlum şəhərdə isə {"cod":"404","message":"city not found"} gəlir. Birincidə cod rəqəm, ikincidə dırnaq içində mətndir. Kodunu cod sahəsinə görə yox, http.GET()-in qaytardığı rəqəmə görə qursan, bu uyğunsuzluqdan təsirlənmirsən.

Böyük cavablar: filtr, getStream və useHTTP10

Saatlıq və ya 7 günlük proqnoz istəyəndə cavab bir neçə kilobaytdan onlarla kilobayta çata bilər. getString() bütün cavabı əvvəlcə String-ə, sonra ArduinoJson ağacına qoyduğu üçün yaddaş iki dəfə sərf olunur. Bunun əvəzinə http.getStream() ilə cavabı gələrkən təhlil edə, filtr ilə də yalnız istədiyin sahələri saxlaya bilərsən. Bir tələ var: server cavabı hissə-hissə (chunked) göndərsə, axının içinə hissə ölçüləri qarışır və JSON pozulur. Open-Meteo cavabları hissə-hissə göndərir; http.useHTTP10(true) sorğunu HTTP/1.0 ilə edir və serveri sadə cavab göndərməyə məcbur edir.

C++ (Arduino IDE)
1#include <WiFi.h>
2#include <WiFiClientSecure.h>
3#include <HTTPClient.h>
4#include <ArduinoJson.h>
5
6const char* WIFI_SSID = "AgAdi";
7const char* WIFI_PASS = "Sifre123";
8const char* URL = "https://api.open-meteo.com/v1/forecast?latitude=41.01&longitude=28.98"
9                  "&daily=temperature_2m_max,temperature_2m_min,weather_code"
10                  "&forecast_days=3&timezone=auto";
11
12void setup() {
13  Serial.begin(115200);
14  WiFi.begin(WIFI_SSID, WIFI_PASS);
15  while (WiFi.status() != WL_CONNECTED) delay(500);
16
17  WiFiClientSecure client;
18  client.setInsecure();
19  HTTPClient http;
20  http.useHTTP10(true);                      // parçalı (chunked) yanıtı kapat / disable chunked replies
21  http.begin(client, URL);
22  if (http.GET() != HTTP_CODE_OK) { http.end(); return; }
23
24  JsonDocument filter;                       // yalnız gereken alanları tut / keep only what we need
25  filter["daily"]["time"] = true;
26  filter["daily"]["temperature_2m_max"] = true;
27  filter["daily"]["temperature_2m_min"] = true;
28  filter["daily"]["weather_code"] = true;
29
30  JsonDocument doc;
31  DeserializationError err = deserializeJson(doc, http.getStream(),   // String yerine akış / stream instead of String
32                                             DeserializationOption::Filter(filter));
33  http.end();
34  if (err) { Serial.println(err.c_str()); return; }
35
36  JsonArray days = doc["daily"]["time"];
37  for (size_t i = 0; i < days.size(); i++) {  // 3 gün / 3 days
38    const char* day = days[i];
39    float tmax = doc["daily"]["temperature_2m_max"][i];
40    float tmin = doc["daily"]["temperature_2m_min"][i];
41    int wmo    = doc["daily"]["weather_code"][i];
42    Serial.printf("%s  en dusuk/min %.0f  en yuksek/max %.0f  kod/code %d\n", day, tmin, tmax, wmo);
43  }
44}
45
46void loop() {
47}

Eyni üsulla hourly=temperature_2m istəyib 24 saatlıq temperatur qrafiki çəkə və ya daily=precipitation_probability_max ilə sabah yağış ehtimalı yüksəkdirsə, LED yandıra bilərsən. Open-Meteo-da forecast_days ən çox 16 ola bilər; ESP32 üçün 3 ilə 7 gün arası rahat aralıqdır.

Eyni üsulla başqa API-lər: valyuta məzənnəsi nümunəsi

Burada öyrəndiyin şey yalnız hava proqnozuna xas deyil: ünvan, GET, JSON və təhlil addımları bütün REST API-lərdə eynidir. Məsələn, Avropa Mərkəzi Bankının gündəlik istinad məzənnələrini dərc edən Frankfurter xidməti açar istəmir və dollar, avro, Türkiyə lirəsi kimi valyutaları tək sorğuda verir.

C++ (Arduino IDE)
1#include <WiFi.h>
2#include <WiFiClientSecure.h>
3#include <HTTPClient.h>
4#include <ArduinoJson.h>
5
6const char* WIFI_SSID = "AgAdi";
7const char* WIFI_PASS = "Sifre123";
8// Avrupa Merkez Bankası kurları, anahtar gerekmez / European Central Bank rates, no key needed
9const char* URL = "https://api.frankfurter.dev/v1/latest?from=USD&to=TRY,EUR";
10
11void setup() {
12  Serial.begin(115200);
13  WiFi.begin(WIFI_SSID, WIFI_PASS);
14  while (WiFi.status() != WL_CONNECTED) delay(500);
15
16  WiFiClientSecure client;
17  client.setInsecure();
18  HTTPClient http;
19  http.begin(client, URL);
20  int code = http.GET();
21  if (code == HTTP_CODE_OK) {
22    JsonDocument doc;
23    if (!deserializeJson(doc, http.getString())) {
24      const char* date = doc["date"];          // kurun tarihi / rate date
25      float usdTry = doc["rates"]["TRY"];      // 1 USD kaç TL / how many TRY per USD
26      float usdEur = doc["rates"]["EUR"];
27      Serial.printf("%s  1 USD = %.2f TRY = %.4f EUR\n", date, usdTry, usdEur);
28      Serial.printf("1 EUR = %.2f TRY\n", usdTry / usdEur);   // çapraz kur / cross rate
29    }
30  } else {
31    Serial.printf("Hata / error: %d\n", code);
32  }
33  http.end();
34}
35
36void loop() {
37}

Mərkəzi bank məzənnələri iş günlərində gündə bir dəfə, Mərkəzi Avropa vaxtı ilə 16:00 civarında yenilənir; ona görə bu sorğunu saatda bir etmək belə kifayətdən artıqdır. Eyni skeletlə zəlzələ məlumatı, namaz vaxtları, kriptovalyuta qiymətləri və ya öz serverindəki bir dəyəri də çəkə bilərsən. Dəyişən yeganə şey ünvan və JSON-dakı açar adlarıdır; onları da ünvanı brauzerdə açıb gələn cavaba baxaraq öyrənirsən.

Raspberry Pi Pico W ilə hava proqnozu (MicroPython)

Raspberry Pi Pico ailəsinin Wi-Fi-lı üzvləri olan Pico W və Pico 2 W-də eyni işi MicroPython-un urequests modulu görür və JSON üçün ayrıca kitabxana lazım olmur: r.json() cavabı birbaşa Python lüğətinə çevirir. Thonny ilə plataya aktual MicroPython yüklə və kodu main.py adı ilə yadda saxla. Wi-Fi əlaqəsinin təfərrüatları Pico W Wi-Fi veb server yazısındadır.

Python
1import network
2import time
3import urequests
4
5SSID = "AgAdi"
6PASS = "Sifre123"
7URL = ("https://api.open-meteo.com/v1/forecast?latitude=41.01&longitude=28.98"
8       "&current=temperature_2m,relative_humidity_2m,weather_code&timezone=auto")
9
10wlan = network.WLAN(network.STA_IF)
11wlan.active(True)
12wlan.connect(SSID, PASS)
13while not wlan.isconnected():          # bağlanana kadar bekle / wait until connected
14    time.sleep(0.5)
15print("IP:", wlan.ifconfig()[0])
16
17while True:
18    try:
19        r = urequests.get(URL)
20        if r.status_code == 200:
21            now = r.json()["current"]  # JSON -> sözlük / JSON -> dict
22            print(now["time"], now["temperature_2m"], "C",
23                  "%", now["relative_humidity_2m"], "kod/code", now["weather_code"])
24        else:
25            print("HTTP hata / error:", r.status_code)
26        r.close()                      # soketi kapat, belleği boşalt / close socket, free memory
27    except OSError as e:               # ağ hatası / network error
28        print("Baglanti hatasi / connection error:", e)
29    time.sleep(600)                    # 10 dakika bekle / wait 10 minutes

MicroPython-dakı urequests HTTPS əlaqəsini şifrələyir, amma server sertifikatını yoxlamır; təhlükəsizlik səviyyəsi ESP32-dəki setInsecure() ilə eynidir. Hər sorğudan sonra r.close() çağırmaq vacibdir: unutsan, Pico-nun soketləri və yaddaşı bir neçə sorğudan sonra tükənir və kod OSError ilə dayanır.

ESP32 hava proqnozu ilə layihə ideyaları

  • Masaüstü hava stansiyası: Open-Meteo məlumatını OLED-də göstər, yanına BME280 ilə otağın temperaturunu və təzyiqini əlavə et; içəri ilə çölü yan-yana gör.
  • Çətir xatırladıcısı: Qapının yanındakı ESP32 günün yağış ehtimalı 60%-i keçəndə qırmızı WS2812B LED yandırsın.
  • Ağıllı suvarma: Sabah yağış gözlənilirsə, suvarmanı keç; torpaq rütubət sensoru ilə birgə istifadə edəndə lazımsız su sərf etmirsən.
  • Səhər bildirişi: Hər səhər 07:00-da günün proqnozunu Telegram botu ilə telefonuna göndər.
  • Ev avtomatlaşdırması: Xarici temperaturu MQTT ilə Home Assistant-a ötür və qızdırma qərarlarında istifadə et.
  • Hava və valyuta lövhəsi: ILI9341 TFT ekranda temperaturu, 3 günlük proqnozu və günün məzənnələrini rəngli kartlar şəklində göstər.

Tez-tez edilən səhvlər və həlləri

ƏlamətMümkün səbəbHəll
Serial Monitor-da dayanmadan nöqtəWi-Fi-a qoşula bilmir2,4 GHz şəbəkə, düzgün şifrə, modemə yaxınlıq
HTTP kodu -1İnternet, domen adı və ya HTTPS problemiÜnvanı brauzerdə yoxla, WiFiClientSecure və sertifikatı yoxla
401 Invalid API keyAçar yanlışdır və ya hələ aktiv deyilAçarı yenidən kopyala, yeni hesabda bir müddət gözlə
JSON xətası InvalidInputGələn cavab JSON deyil (HTML xəta səhifəsi)Əvvəlcə getString() ilə cavabı çap et
JSON xətası IncompleteInputCavab yarıda kəsilib və ya hissə-hissə axıngetString() istifadə et və ya useHTTP10(true) əlavə et
Temperatur həmişə 0.00Açar adı yanlış yazılıbJSON-dakı adı eynilə kopyala (temperature_2m)
Ekranda qəribə simvollarAzərbaycan hərfləri və ya ° işarəsi şriftdə yoxdurlang=en istifadə et, dərəcə işarəsini (char)247 ilə yaz
Bir neçə saatdan sonra donmaBağlanmayan əlaqələr, yaddaşın parçalanmasıHər sorğudan sonra http.end() çağır, intervalı uzat
Problemi ayırd etməyin ən asan yolu ünvanı əvvəlcə kompüterindəki brauzerə yapışdırmaqdır. Brauzerdə düzgün JSON görürsənsə, problem ESP32 tərəfindədir (Wi-Fi, sertifikat və ya təhlil); brauzerdə də xəta görürsənsə, ünvanı və ya API açarını düzəltməlisən.

ESP32 hava proqnozu layihəsi internetə qoşulu cihazların əsas qəlibini öyrədir: qoşul, sorğu göndər, təhlil et, göstər və ağlabatan aralıqlarla təkrarla. Bu qəlibi bir dəfə oturdanda eyni kodla yüzlərlə fərqli API-dən məlumat çəkə bilərsən. BlueGrays tətbiqində ESP32 HTTPClient ilə hava proqnozu API-sini LCD və SSD1306 OLED ekranda göstərən layihələri, Wi-Fi əlaqəsi və NTP saat layihələri ilə birlikdə addım-addım dövrə sxemi və kodları ilə tapa bilərsən.

Tez-tez verilən suallar

ESP32 ilə hava proqnozu necə alınır?

ESP32-ni Wi-Fi-a qoşub HTTPClient kitabxanası ilə Open-Meteo və ya OpenWeatherMap kimi xidmətə GET sorğusu göndərirsən. Gələn JSON cavabından temperaturu, rütubəti və hava kodunu ArduinoJson kitabxanası ilə oxuyursan. Open-Meteo açar istəmədiyi üçün ilk cəhd üçün ən asan seçimdir.

Open-Meteo pulsuzdur?

Open-Meteo qeyri-kommersiya istifadəsi üçün pulsuzdur və qeydiyyat və ya API açarı istəmir. Pulsuz istifadədə gündə 10.000, saatda 5.000 və dəqiqədə 600 sorğu limiti var. Kommersiya məhsulu üçün ödənişli plana keçməlisən.

OpenWeatherMap API açarı niyə 401 xətası verir?

401 açarın yanlış, əskik və ya hələ aktivləşməmiş olduğunu göstərir. Yeni yaradılan açarlar bir neçə dəqiqədən bir neçə saata qədər müddətdə aktivləşir. Açarı boşluq buraxmadan kopyaladığını və ünvanda appid= parametri ilə verdiyini yoxla.

ESP32 HTTP GET -1 xətası nə deməkdir?

-1 əlaqənin heç qurulmadığını göstərən HTTPC_ERROR_CONNECTION_REFUSED kodudur. Adətən internetin olmamasından, domen adının həll olunmamasından, ünvanın yanlış yazılmasından və ya HTTPS serverinə yanlış sertifikatla qoşulmağa çalışmaqdan qaynaqlanır. http.errorToString(code) ilə izahını Serial Monitor-a yazdıra bilərsən.

ESP32 hava proqnozunu nə qədər tez-tez yeniləməlidir?

10 ilə 15 dəqiqədən bir yeniləmək kifayətdir, çünki xidmətlər məlumatı da bu aralıqla yeniləyir. Bu, gündə 96 ilə 144 sorğu edir və pulsuz limitlərin çox altında qalır. Hər saniyə sorğu göndərmək həm boş yerə enerji sərf edir, həm də bloklanmana səbəb ola bilər.

ArduinoJson 6 ilə 7 arasındakı fərq nədir?

ArduinoJson 7-də StaticJsonDocument və DynamicJsonDocument əvəzinə tək bir JsonDocument sinfi var və yaddaş öz-özünə tənzimlənir. Köhnə kodlar xəbərdarlıqla kompilyasiya olunmağa davam edir, amma yeni layihələrdə JsonDocument doc; yazmaq kifayətdir. Təhlil və doc["key"] ilə oxuma yazılışı hər iki versiyada eynidir.

Bütün layihələrə bax
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 HTTPClient + hava proqnozu API (SSD1306 OLED ekranlı)
ES-32Qabaqcıl
Premium

ESP32 HTTPClient + hava proqnozu API (SSD1306 OLED 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. I2C LCD versiyasından fərqli olaraq burada SSD1306 OLED (128×64) ekran istifadə edirik; böyük yazı və vektor ikonlarla zəngin görünüş əldə olunur. Hava üçün 7 vektor ikon (günəşli, yağışlı, qarlı və digərləri) bitmap faylı olmadan çəkilir.

4.3(10)
22
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 NTP ilə internetdən real vaxt
ES-26Qabaqcıl
Premium

ESP32 NTP ilə internetdən real vaxt

ESP32 Wi-Fi-a qoşulub NTP (Network Time Protocol) serverlərindən millisaniyə dəqiqliyi ilə real vaxtı çəkir. configTzTime() funksiyası sayəsində Türkiyə saat qurşağı (TRT, UTC+3) avtomatik tətbiq olunur; yay/qış saatı tətbiq edən ölkələrdə DST keçidi POSIX TZ sətri ilə avtomatik idarə olunur. Saat həm Serial Monitor-a, həm də istəyə bağlı I2C LCD-yə yazdırılır.

4.5(13)
22
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 I2C LCD ekran (16x2)
ES-17Orta
Premium

ESP32 I2C LCD ekran (16x2)

Bu layihədə 16x2 simvol LCD ekranı I2C protokolu ilə ESP32-yə qoşaraq mətn göstəririk. I2C sayəsində ekranı yalnız 2 data pini (SDA və SCL) ilə idarə edə bilirik; klassik paralel qoşulmadakı 6+ pin israfı aradan qalxır. Kod birinci sətirdə sabit mesaj, ikinci sətirdə isə hər saniyə artan sayğac göstərir. Əlavə olaraq başlanğıcda I2C skaneri işlədib ekranın ünvanını Serial Monitor-a yazdırırıq (adətən 0x27 və ya 0x3F).

4.9(23)
40
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 temperatur loqqeri (DHT22 + DS1307 RTC + microSD + OLED)
ES-40Qabaqcıl
Premium

ESP32 temperatur loqqeri (DHT22 + DS1307 RTC + microSD + OLED)

ESP32 ilə zaman etiketli temperatur və rütubət qeydiyyat sistemi qur! Bu layihədə DHT22 sensoru ilə dəqiqədə bir temperatur və rütubət oxuyub DS1307 RTC modulundan aldığın real zaman etiketi ilə microSD karta CSV formatında yazırıq. OLED ekranda iri yazı ilə son temperatur, rütubət faizi, zaman damğası və ümumi qeyd sayı canlı göstərilir.

4.7(7)
12