ESP32 NTP ilə internetdən saat: saat qurşağı, OLED və RTC ehtiyatı
ESP32 NTP ilə saat necə alınır? configTzTime və Türkiyə saat qurşağı, getLocalTime, strftime, OLED saat, DS3231 ehtiyatı, hər gün vaxtlı tapşırıq və Pico W ntptime.
ESP32 NTP ilə saat almaq, platanı internetdəki vaxt serverlərinə qoşub tarixi və saatı heç bir saat modulu istifadə etmədən, bir neçə on millisaniyə dəqiqliklə öyrənmək deməkdir. ESP32 Wi-Fi-a qoşulandan sonra yalnız bir configTzTime() çağırışı ilə saatı alır, saat qurşağını tətbiq edir və sonra saatı öz daxilində saymağa davam edir. Masa saatı, vaxtlı sulama, məlumat qeydində vaxt damğası, hər səhər səslənən siqnal və ya müəyyən saatda yanan işıqlandırma kimi layihələrdə ayrıca RTC modulu lazım olmur.
Bu bələdçidə NTP-nin necə işlədiyini, Türkiyə üçün düzgün saat qurşağı ayarını (UTC+3), getLocalTime və strftime ilə tarixi istədiyin formatda yazmağı, saatı OLED ekranda göstərməyi, Wi-Fi kəsiləndə və ya elektrik gedib gələndə saatı DS3231 modulu ilə qorumağı və hər gün müəyyən saatda tapşırıq işlətməyi addım-addım quracağıq. Son bölmədə eyni işi Raspberry Pi Pico W-də MicroPython-un ntptime modulu ilə görəcəyik.

NTP nədir, ESP32 saatı necə alır?
NTP (Network Time Protocol) kompüterlərin və cihazların saatlarını internet üzərindən sinxronlaşdırmaq üçün istifadə olunan, 1980-ci illərdən bəri işləyən protokoldur. Serverlər qatlar (stratum) şəklində düzülür: stratum 1 serverlər birbaşa atom saatına və ya GPS-ə qoşulur, stratum 2 serverlər saatı onlardan alır və bu belə davam edir. ESP32 saatı UDP 123 portundan kiçik bir paketlə istəyir; server 1900-cü ildən bəri keçən saniyəni və saniyənin hissəsini ehtiva edən vaxt damğası qaytarır. ESP32 paketin gedib-gəlmə müddətini nəzərə alaraq öz saatını tənzimləyir. Ev internetində bu üsulla əldə edilən dəqiqlik adətən 10–50 millisaniyə arasındadır; saat layihəsi üçün kifayət qədərdir.
ESP32-nin içindəki lwIP şəbəkə steki NTP-nin sadələşdirilmiş versiyası olan SNTP-dən istifadə edir. Saat bir dəfə alınandan sonra ESP32 onu sistem saatı kimi saxlayır və kvarsdan alınan sayğacla saymağa davam edir; hər saniyə internetə getmir. Arxa planda müəyyən aralıqlarla (Arduino ESP32 nüvəsində susmaya görə 3 saatdan bir) serverdən yenidən soruşub kiçik sürüşmələri düzəldir. Sistem saatı UTC ilə saxlanılır; sənin gördüyün yerli saat buna saat qurşağı qaydası tətbiq edilərək hesablanır.
| Anlayış | Dəyər / izah |
|---|---|
| Protokol və port | SNTP, UDP 123 |
| Vaxt damğası | 1900-cü ildən bəri keçən saniyə (ESP32 bunu 1970 əsaslı Unix vaxtına çevirir) |
| Tipik dəqiqlik | Ev internetində 10–50 ms |
| Yenidən sinxronlaşdırma | Arduino ESP32-də susmaya görə 3 saat, sntp_set_sync_interval() ilə dəyişir (ən azı 15 san) |
| Maksimum server sayı | 3 (configTzTime-a verilən server adları) |
| İnternet trafiki | Sorğu və cavab 48 baytlıq NTP paketləridir; gündə bir neçə kilobayt belə etmir |
| Lazım olanlar | ESP32, 2,4 GHz Wi-Fi şəbəkəsi və internet əlaqəsi |
configTime və configTzTime: Türkiyə saat qurşağı (UTC+3)
Arduino ESP32 nüvəsində NTP-ni başlatmağın iki yolu var. configTime(gmtOffset_sec, daylightOffset_sec, server1, server2, server3) UTC fərqini və yay vaxtı fərqini saniyə ilə qəbul edir: Türkiyə üçün configTime(10800, 0, "pool.ntp.org") yazırsan, çünki 3 saat 10.800 saniyədir və Türkiyə 2016-dan bəri yay vaxtına keçmədən il boyu UTC+3-də qalır. Bu üsul sadədir, amma bölgənin yay vaxtına keçid tarixlərini bilmir; Avropa kimi yay vaxtı tətbiq edilən yerdə keçidlər səhv gündə olur, buna görə orada configTzTime istifadə etməlisən.
Daha düzgün yol configTzTime(TZ, server1, server2, server3) funksiyasıdır. Bu funksiya POSIX formatında saat qurşağı mətni qəbul edir və yay vaxtına keçid qaydalarını da ehtiva edir; ESP32 hər il keçidi özü edir. Türkiyə üçün mətn "<+03>-3" şəklindədir: bucaq mötərizələrinin içindəki +03 ekranda görünəcək qısaltmadır, -3 isə UTC-yə çatmaq üçün yerli saatdan 3 saat çıxılmalı olduğunu bildirir. Aşağıdakı cədvəldə tez-tez istifadə olunan bölgələrin mətnləri var.
| Bölgə | TZ mətni (configTzTime) | configTime qarşılığı |
|---|---|---|
| Türkiyə (il boyu UTC+3) | <+03>-3 | configTime(10800, 0, ...) |
| Almaniya, Fransa, İtaliya, İspaniya | CET-1CEST,M3.5.0,M10.5.0/3 | Uyğun deyil, configTzTime istifadə et |
| Böyük Britaniya, Portuqaliya | GMT0BST,M3.5.0/1,M10.5.0 | Uyğun deyil, configTzTime istifadə et |
| ABŞ şərqi (Nyu-York) | EST5EDT,M3.2.0,M11.1.0 | Uyğun deyil, configTzTime istifadə et |
| Azərbaycan, Gürcüstan (UTC+4) | <+04>-4 | configTime(14400, 0, ...) |
| UTC (vaxt damğası üçün) | UTC0 | configTime(0, 0, ...) |
Lazım olanlar və qoşulmalar
Yalnız saatı Serial Monitor-da görmək üçün ESP32 və Wi-Fi şəbəkəsi kifayətdir. Bələdçinin sonrakı bölmələrində saatı göstərmək üçün 0,96 düymlük SSD1306 OLED ekran, saatı elektrik kəsilməsində qorumaq üçün DS3231 RTC modulu və vaxtlı tapşırıq nümunəsində rele modulu istifadə edirik. OLED ilə DS3231 eyni I2C xəttini paylaşır, yəni ikisi də eyni iki pinə qoşulur. ESP32-nin pin düzülüşünə Pinout alətindən baxa bilərsən.
| Hissənin pini | ESP32 | Raspberry Pi Pico W | Qeyd |
|---|---|---|---|
| OLED / DS3231 VCC | 3V3 | 3V3 (OUT) | İkisi də 3,3 V ilə işləyir |
| OLED / DS3231 GND | GND | GND | Ortaq torpaq |
| OLED / DS3231 SDA | GPIO 21 | GP4 | I2C data xətti |
| OLED / DS3231 SCL | GPIO 22 | GP5 | I2C saat xətti |
| Rele modulu IN | GPIO 26 | GP15 | Vaxtlı tapşırıq nümunəsi |
| Rele modulu VCC | 5V (VIN) | VBUS | Əksər rele sarğıları 5 V tələb edir |
Addım-addım ilk ESP32 NTP kodu
- Arduino IDE-də ESP32 plata paketinin quraşdırıldığına əmin ol və Tools menyusundan ESP32 Dev Module platasını seç. Quraşdırmanı bilmirsənsə, ESP32 nədir yazısına baxa bilərsən.
- Əlavə kitabxana lazım deyil: WiFi.h və time.h ESP32 nüvəsi ilə gəlir.
- Koddakı WIFI_SSID və WIFI_PASS dəyərlərini öz şəbəkənlə əvəz et.
- Kodu yüklə (Upload), Serial Monitor-u 115200 baud sürətində aç.
- Əvvəlcə Wi-Fi nöqtələri, bir neçə saniyə sonra hər saniyə yenilənən tarix və saat görünməlidir.
1#include <WiFi.h>
2#include <time.h>
3
4const char* WIFI_SSID = "AgAdi"; // Wi-Fi adı / Wi-Fi name
5const char* WIFI_PASS = "Sifre123"; // Wi-Fi şifresi / Wi-Fi password
6const char* TZ_INFO = "<+03>-3"; // Türkiye: UTC+3, yaz saati yok / Turkey: UTC+3, no DST
7
8void setup() {
9 Serial.begin(115200);
10 WiFi.begin(WIFI_SSID, WIFI_PASS);
11 Serial.print("Wi-Fi");
12 while (WiFi.status() != WL_CONNECTED) { // bağlanana kadar bekle / wait until connected
13 delay(500);
14 Serial.print(".");
15 }
16 Serial.println(" OK");
17
18 // NTP sunucuları + saat dilimi / NTP servers + time zone
19 configTzTime(TZ_INFO, "pool.ntp.org", "time.cloudflare.com");
20
21 struct tm t;
22 while (!getLocalTime(&t)) { // ilk eşitlemeyi bekle (5 sn deneme) / wait for the first sync (5 s per try)
23 Serial.println("NTP bekleniyor / waiting for NTP");
24 }
25 Serial.println("Saat alindi / time received");
26}
27
28void loop() {
29 struct tm t;
30 if (getLocalTime(&t)) {
31 Serial.println(&t, "%d.%m.%Y %H:%M:%S"); // ör. 16.11.2026 14:05:09 / e.g. 16.11.2026 14:05:09
32 }
33 delay(1000);
34}
35| Sətir | Nə edir? |
|---|---|
| configTzTime(TZ_INFO, ...) | SNTP müştərisini başladır, serverləri və saat qurşağını tənzimləyir; dərhal qayıdır, saat arxa planda gəlir |
| getLocalTime(&t) | Yerli saatı struct tm strukturuna doldurur; saat yoxdursa ən çox 5 saniyə gözləyib false qaytarır |
| Serial.println(&t, "...") | ESP32-nin Print sinfi struct tm-i birbaşa strftime formatı ilə çap edə bilir |
| time(nullptr) | 1970-ci ildən bəri keçən saniyəni (Unix vaxtı, UTC) verir |
Burada vacib bir təfərrüat var: getLocalTime() saatın "etibarlı" olub-olmadığını ilə baxaraq anlayır. ESP32 ilk açılanda sistem saatı 1 yanvar 1970-dir və funksiya il 2016-dan böyük olana qədər false qaytarır. Buna görə NTP gəlmədən işləyən tapşırıq və ya qeyd kodu təsadüfən 1970 tarixli məlumatlar yaratmır; təbii ki, qaytarma dəyərini yoxlasan. Funksiyanın ikinci parametri gözləmə müddətidir (millisaniyə); loop() daxilində kodu gözlətmək istəmirsənsə, getLocalTime(&t, 0) yazıb yalnız bir dəfə cəhd etməsini təmin edə bilərsən.
struct tm: saatın hissələri
getLocalTime() saatı struct tm strukturuna hissələrə ayıraraq yazır. Bu sahələrlə saat, gün və ya ay müqayisəsi edərək vaxtlı tapşırıqlar qurursan. Strukturun iki sahəsi yeni başlayanları tez çaşdırır: ay 0-dan, il isə 1900-dan başlayaraq sayılır.
| Sahə | Aralıq | Nümunə (16 noyabr 2026, 14:05:09, bazar ertəsi) |
|---|---|---|
| tm_sec | 0–59 (artıq saniyədə 60) | 9 |
| tm_min | 0–59 | 5 |
| tm_hour | 0–23 | 14 |
| tm_mday | 1–31 | 16 |
| tm_mon | 0–11 (0 = yanvar) | 10 |
| tm_year | 1900-cü ildən bəri keçən illər | 126 (1900 + 126 = 2026) |
| tm_wday | 0–6 (0 = bazar) | 1 |
| tm_yday | 0–365 (ilin neçənci günü, 0-dan) | 319 |
strftime ilə tarixin və saatın formatlanması
strftime() struct tm-dəki saatı istədiyin şablona uyğun simvol massivinə yazır. Şablondakı faiz işarəli kodlar müvafiq dəyərlə əvəz olunur, qalan simvollar olduğu kimi qalır. Massivin ölçüsünü ən uzun çıxış üstəgəl bir (sondakı sıfır simvolu) olacaq şəkildə ayırmalısan: "14:05:09" 8 simvoldur, buna görə massiv ən azı 9 bayt olmalıdır. Tez-tez istifadə olunan kodlar:
| Kod | Mənası | Nümunə çıxış |
|---|---|---|
| %H / %M / %S | Saat (00–23) / dəqiqə / saniyə | 14 / 05 / 09 |
| %I və %p | 12 saatlıq saat və AM/PM | 02 PM |
| %d / %m / %Y | Gün / ay (01–12) / dörd rəqəmli il | 16 / 11 / 2026 |
| %y | İki rəqəmli il | 26 |
| %A / %a | Həftənin günü adı, uzun / qısa (ingiliscə) | Monday / Mon |
| %B / %b | Ay adı, uzun / qısa (ingiliscə) | November / Nov |
| %j | İlin günü (001–366) | 320 |
| %F / %T | %Y-%m-%d / %H:%M:%S qısayolları | 2026-11-16 / 14:05:09 |
| %Z | Saat qurşağının qısaltması | +03 |
ESP32-dəki C kitabxanası yalnız ingiliscə gün və ay adlarını bilir; %A həmişə "Monday" yazır. Azərbaycanca tarix üçün gün və ay adlarını öz massivində saxlayıb tm_wday və tm_mon dəyərlərini massiv indeksi kimi istifadə edirsən. Serial Monitor UTF-8-i dəstəklədiyi üçün Azərbaycan hərfləri orada düzgün görünür. Aşağıdakı kod həm "16 noyabr 2026, bazar ertəsi" kimi oxunaqlı tarix, həm də məlumat qeydi üçün sıralana bilən ISO formatını (2026-11-16 14:05:09) yaradır.
1#include <WiFi.h>
2#include <time.h>
3
4const char* WIFI_SSID = "AgAdi";
5const char* WIFI_PASS = "Sifre123";
6const char* TZ_INFO = "<+03>-3";
7
8// tm_wday: 0 = Pazar ... 6 = Cumartesi / 0 = Sunday ... 6 = Saturday
9const char* GUNLER[] = {"Pazar", "Pazartesi", "Salı", "Çarşamba", "Perşembe", "Cuma", "Cumartesi"};
10const char* AYLAR[] = {"Ocak", "Şubat", "Mart", "Nisan", "Mayıs", "Haziran",
11 "Temmuz", "Ağustos", "Eylül", "Ekim", "Kasım", "Aralık"};
12
13void setup() {
14 Serial.begin(115200);
15 WiFi.begin(WIFI_SSID, WIFI_PASS);
16 while (WiFi.status() != WL_CONNECTED) delay(500);
17 configTzTime(TZ_INFO, "pool.ntp.org");
18}
19
20void loop() {
21 struct tm t;
22 if (!getLocalTime(&t)) return; // saat henüz yok / time not set yet
23
24 char saat[9]; // "HH:MM:SS" + '\0'
25 char iso[20]; // "YYYY-MM-DD HH:MM:SS" + '\0'
26 strftime(saat, sizeof(saat), "%H:%M:%S", &t);
27 strftime(iso, sizeof(iso), "%Y-%m-%d %H:%M:%S", &t);
28
29 // Türkçe tarih: 16 Kasım 2026 Pazartesi / Turkish date
30 Serial.printf("%d %s %d %s %s\n", t.tm_mday, AYLAR[t.tm_mon], t.tm_year + 1900, GUNLER[t.tm_wday], saat);
31 Serial.printf("Kayit / log: %s epoch: %ld\n", iso, (long)time(nullptr));
32 delay(1000);
33}
34OLED ekranda saat və tarixi göstərmək
Saatı Serial Monitor-dan çıxarıb real masa saatına çevirmək üçün 0,96 düymlük SSD1306 OLED ekran idealdır: ucuzdur, iki naqillə qoşulur və iri rəqəmləri kəskin göstərir. Aşağıdakı kod yuxarıda gün adını və tarixi, ortada iri şriftlə saatı, aşağıda isə Wi-Fi vəziyyətini göstərir. Ekranı hər dövrdə yox, yalnız saniyə dəyişəndə yenidən çəkdiyi üçün I2C xəttini boş yerə məşğul etmir. Adafruit SSD1306 və Adafruit GFX kitabxanalarını Library Manager-dən quraşdırmalısan; ekranın təfərrüatları OLED ekran (SSD1306) yazısındadır.
1#include <WiFi.h>
2#include <Wire.h>
3#include <Adafruit_GFX.h>
4#include <Adafruit_SSD1306.h>
5#include <time.h>
6
7const char* WIFI_SSID = "AgAdi";
8const char* WIFI_PASS = "Sifre123";
9const char* TZ_INFO = "<+03>-3";
10// OLED yazı tipinde Türkçe harf yok / the OLED font has no Turkish letters
11const char* GUNLER[] = {"Pazar", "Pazartesi", "Sali", "Carsamba", "Persembe", "Cuma", "Cumartesi"};
12
13Adafruit_SSD1306 display(128, 64, &Wire, -1);
14int sonSaniye = -1; // son çizilen saniye / last drawn second
15
16void yaz(const char* mesaj) { // ekrana tek satır / one line on screen
17 display.clearDisplay();
18 display.setTextSize(1);
19 display.setCursor(0, 0);
20 display.print(mesaj);
21 display.display();
22}
23
24void setup() {
25 Wire.begin(21, 22); // SDA = 21, SCL = 22
26 display.begin(SSD1306_SWITCHCAPVCC, 0x3C);
27 display.setTextColor(SSD1306_WHITE);
28 yaz("Wi-Fi baglaniyor...");
29
30 WiFi.begin(WIFI_SSID, WIFI_PASS);
31 while (WiFi.status() != WL_CONNECTED) delay(300);
32 configTzTime(TZ_INFO, "pool.ntp.org", "time.cloudflare.com");
33 yaz("NTP bekleniyor...");
34}
35
36void loop() {
37 struct tm t;
38 if (!getLocalTime(&t, 0)) { // 0 = beklemeden dene / try without waiting
39 delay(200);
40 return;
41 }
42 if (t.tm_sec == sonSaniye) { // saniye değişmediyse çizme / redraw only on a new second
43 delay(20);
44 return;
45 }
46 sonSaniye = t.tm_sec;
47
48 char saat[9], tarih[11];
49 strftime(saat, sizeof(saat), "%H:%M:%S", &t);
50 strftime(tarih, sizeof(tarih), "%d.%m.%Y", &t);
51
52 display.clearDisplay();
53 display.setTextSize(1);
54 display.setCursor(0, 0);
55 display.print(GUNLER[t.tm_wday]); // gün adı / day name
56 display.setCursor(68, 0);
57 display.print(tarih); // 10 karakter = 60 piksel / 10 chars = 60 px
58 display.setTextSize(2);
59 display.setCursor(16, 26);
60 display.print(saat); // 8 x 12 = 96 piksel genişlik / 96 px wide
61 display.setTextSize(1);
62 display.setCursor(0, 56);
63 display.print(WiFi.status() == WL_CONNECTED ? "Wi-Fi: var" : "Wi-Fi: yok");
64 display.display();
65}
66Kodda gün adlarının Azərbaycan hərfləri olmadan yazıldığına diqqət et: Adafruit GFX-in susmaya görə şriftində ə, ş, ç və ı kimi hərflər yoxdur və onların yerinə mənasız simvollar çıxır. Mətn ölçüsü 2 olanda hər simvol 12 piksel enindədir; 8 simvollu "14:05:09" 96 piksel tutur, 16-cı pikseldən başlatsan 128 pikselik ekranda tam ortalanır. 16x2 simvollu LCD istifadə etmək istəsən, eyni strftime çıxışlarını lcd.print() ilə yazmaq kifayətdir; qoşulması I2C LCD ekran yazısında izah olunur.
Wi-Fi kəsiləndə saata nə olur? DS3231 ilə RTC ehtiyatı
Ən çox verilən sual budur: Wi-Fi getsə, saat da gedirmi? Xeyr. ESP32 saatı bir dəfə aldıqdan sonra öz sayğacı ilə saymağa davam edir; Wi-Fi-ın qopması saatı dayandırmır. Bu sayğac 40 MHz kvarsdan qidalandığı üçün sürüşməsi gündə təxminən bir-iki saniyədir və Wi-Fi geri gələndə növbəti sinxronlaşdırmada düzəldilir. Əsas problem elektrik kəsilməsi və ya EN düyməsi ilə yenidən başlatmadır: bu halda sistem saatı 1970-ə qayıdır və Wi-Fi yoxdursa, ESP32 saatı bilə bilməz.
| Vəziyyət | Saat qorunurmu? | Nə etməli? |
|---|---|---|
| Wi-Fi bir müddət kəsildi | Bəli, ESP32 saymağa davam edir | Heç nə; Wi-Fi gələndə NTP düzəldir |
| Deep sleep (dərin yuxu) | Bəli, RTC taymeri sayır | Yuxu uzundursa, oyananda ara-sıra NTP ilə sinxronlaşdır |
| Elektrik kəsildi və ya EN düyməsi | Xeyr, saat 1970-ə qayıdır | DS3231 kimi batareyalı RTC modulu əlavə et |
| İnternet ümumiyyətlə yoxdur (tarla, anbar) | NTP heç gəlmir | Saatı yalnız RTC modulundan götür |
Dərin yuxu zamanı saat əsas kvars əvəzinə çipin içindəki daha az dəqiq RC osilyatorla sayılır. Bu osilyator temperaturdan təsirləndiyi üçün uzun yuxularda saat bir neçə saniyə, hətta daha çox sürüşə bilər; buna görə batareya ilə işləyən və saatlarla yatan layihələrdə bir neçə oyanmadan bir NTP sinxronlaşdırması etmək yaxşı vərdişdir. Təfərrüatlar ESP32 Deep Sleep yazısındadır.

Kəsintiyə davamlı saat üçün ən yaxşı üsul ikisini birləşdirməkdir: açılışda saatı dərhal DS3231 modulundan al, Wi-Fi gələndə NTP ilə düzəlt və hər NTP sinxronlaşdırmasında DS3231-i də yenilə. Aşağıdakı kodda DS3231-ə yerli saat əvəzinə UTC yazılır; beləliklə saat qurşağı qaydası tək yerdə (TZ mətnində) qalır və yay vaxtı keçidləri RTC-ni pozmur. NTP sinxronlaşdırmasını tutmaq üçün sntp_set_time_sync_notification_cb() ilə geri çağırış (callback) funksiyası təyin edilir. Bu funksiya şəbəkə tapşırığı daxilində işlədiyi üçün I2C işi orada görülmür; yalnız bayraq qaldırılır və DS3231-ə yazma işini loop() öz üzərinə götürür. Kod RTClib kitabxanasından istifadə edir.
1#include <WiFi.h>
2#include <Wire.h>
3#include <RTClib.h>
4#include <sys/time.h>
5#include "esp_sntp.h"
6
7const char* WIFI_SSID = "AgAdi";
8const char* WIFI_PASS = "Sifre123";
9const char* TZ_INFO = "<+03>-3";
10
11RTC_DS3231 rtc;
12volatile bool ntpGeldi = false; // NTP eşitlemesi oldu mu? / did an NTP sync happen?
13
14void ntpCallback(struct timeval* tv) { // her NTP eşitlemesinde çağrılır / called on every NTP sync
15 ntpGeldi = true; // I2C işini loop() yapsın / let loop() do the I2C work
16}
17
18void setup() {
19 Serial.begin(115200);
20 Wire.begin(21, 22);
21 setenv("TZ", TZ_INFO, 1); // NTP gelmese de saat dilimi geçerli / TZ valid even without NTP
22 tzset();
23
24 // 1) Sistem saatini önce DS3231'den kur (DS3231'de UTC saklanır) / set system time from the DS3231 (stores UTC)
25 if (rtc.begin() && !rtc.lostPower()) {
26 struct timeval tv = { (time_t)rtc.now().unixtime(), 0 };
27 settimeofday(&tv, nullptr);
28 Serial.println("Saat DS3231'den / time from DS3231");
29 }
30
31 // 2) Wi-Fi gelince NTP saati düzeltir; bağlantı sonra gelse de SNTP yeniden dener
32 // NTP corrects the clock once Wi-Fi is up; SNTP keeps retrying if the link comes later
33 sntp_set_time_sync_notification_cb(ntpCallback);
34 WiFi.begin(WIFI_SSID, WIFI_PASS);
35 configTzTime(TZ_INFO, "pool.ntp.org", "time.cloudflare.com");
36}
37
38void loop() {
39 if (ntpGeldi) {
40 ntpGeldi = false;
41 rtc.adjust(DateTime((uint32_t)time(nullptr))); // DS3231'e UTC yaz / write UTC to the DS3231
42 Serial.println("DS3231 NTP ile guncellendi / DS3231 updated from NTP");
43 }
44
45 struct tm t;
46 if (getLocalTime(&t, 0)) {
47 Serial.println(&t, "%d.%m.%Y %H:%M:%S");
48 } else {
49 Serial.println("Saat yok: NTP ve DS3231 bekleniyor / no time yet");
50 }
51 delay(1000);
52}
53Hər gün müəyyən saatda tapşırıq işlətmək
NTP saatı ilə ən çox görülən iş vaxtlı tapşırıqdır: səhər 07:30-da sulama nasosunu 10 dəqiqə işlətmək, axşam 19:00-da bağça işıqlarını yandırmaq, hər saat başı ölçmə göndərmək. Üsul sadədir: loop() daxilində saatı oxu, saat və dəqiqə hədəflə üst-üstə düşürsə, tapşırığı başlat. Əsas incəlik tapşırığın eyni dəqiqə ərzində yüzlərlə dəfə işə düşməsinin qarşısını almaqdır. Bunun üçün tapşırığın işlədiyi günü (tm_yday) dəyişəndə saxlayırsan; eyni gün ikinci dəfə işləmir. Aşağıdakı kod iş günlərində hər səhər 07:30-da GPIO 26-dakı releni 10 dəqiqə açır; müddəti millis() ilə ölçdüyü üçün kod heç yerdə bloklanmır.
1#include <WiFi.h>
2#include <time.h>
3
4const char* WIFI_SSID = "AgAdi";
5const char* WIFI_PASS = "Sifre123";
6const char* TZ_INFO = "<+03>-3";
7
8const int ROLE_PIN = 26; // röle modülü IN / relay module IN
9const int GOREV_SAAT = 7; // her gün 07:30 / every day at 07:30
10const int GOREV_DAKIKA = 30;
11const unsigned long SURE_MS = 10UL * 60 * 1000; // 10 dakika çalış / run for 10 minutes
12
13int sonGun = -1; // görevin çalıştığı son gün (tm_yday) / last day the task ran
14bool roleAcik = false;
15unsigned long acilisMs = 0;
16
17void setup() {
18 Serial.begin(115200);
19 pinMode(ROLE_PIN, OUTPUT);
20 digitalWrite(ROLE_PIN, LOW);
21 WiFi.begin(WIFI_SSID, WIFI_PASS);
22 while (WiFi.status() != WL_CONNECTED) delay(500);
23 configTzTime(TZ_INFO, "pool.ntp.org");
24}
25
26void loop() {
27 struct tm t;
28 if (getLocalTime(&t, 0)) { // saat geçerliyse / only when the time is valid
29 bool haftaici = (t.tm_wday >= 1 && t.tm_wday <= 5); // Pzt-Cuma / Mon-Fri
30 if (haftaici && t.tm_hour == GOREV_SAAT && t.tm_min == GOREV_DAKIKA && t.tm_yday != sonGun) {
31 sonGun = t.tm_yday; // bugün bir kez / once per day
32 digitalWrite(ROLE_PIN, HIGH);
33 roleAcik = true;
34 acilisMs = millis();
35 Serial.println(&t, "%H:%M gorev basladi / task started");
36 }
37 }
38 if (roleAcik && millis() - acilisMs >= SURE_MS) { // süre dolunca kapat / switch off after the period
39 digitalWrite(ROLE_PIN, LOW);
40 roleAcik = false;
41 Serial.println("Gorev bitti / task finished");
42 }
43 delay(200);
44}
45- Saniyəyə bərabərlik axtarmaq: t.tm_sec == 0 kimi şərt, dövr həmin saniyəni qaçırsa (Wi-Fi yenidən qoşulanda, uzun delay zamanı) tapşırığı atlayır. Dəqiqə və gün yoxlaması daha etibarlıdır.
- Etibarlı saat yoxlaması: getLocalTime() false qaytararkən tapşırıq işlətmə; əks halda açılışda 1970 tarixinə görə səhv qərarlar verilir.
- Qaçırılan tapşırıq: Elektrik 07:29-da gedib 07:35-də gəlsə, tapşırıq həmin gün işləmir. Vacibdirsə, şərti "saat 07:30-u keçdi və bu gün işləməyib" şəklində qur və sonGun dəyərini Preferences ilə daimi yaddaşa yaz.
- Bir neçə tapşırıq: Saatı, dəqiqəni və müddəti massivdə saxla; hər tapşırıq üçün son işləmə günü ilə bağlı ayrıca dəyişən istifadə et.
- Yüksək cərəyanlı yük: Nasosu və ya lampanı birbaşa pindən yox, rele modulu və ya MOSFET üzərindən idarə et.
Sinxronlaşdırma aralığını dəyişmək və NTP-ni izləmək
Susmaya görə 3 saatlıq sinxronlaşdırma aralığı əksər layihələr üçün uyğundur. Daha tez-tez sinxronlaşdırmaq (məs., temperatur dəyişməsi yüksək olan xarici mühitdə) və ya trafiki azaltmaq üçün sntp_set_sync_interval() funksiyasına millisaniyə ilə yeni aralığı verirsən. Bu çağırışı configTzTime()-dan əvvəl etməlisən; çünki yeni aralıq növbəti başlatmada və ya mövcud aralıq dolanda qüvvəyə minir. Protokol qaydalarına görə aralıq 15 saniyədən qısa ola bilməz. sntp_get_sync_status() sinxronlaşdırma tamamlananda bir dəfə SNTP_SYNC_STATUS_COMPLETED qaytarır, sonra özünü sıfırlayır; beləliklə hər yeni sinxronlaşdırmanı tuta bilərsən.
1#include <WiFi.h>
2#include <time.h>
3#include "esp_sntp.h"
4
5const char* TZ_INFO = "<+03>-3";
6
7void setup() {
8 Serial.begin(115200);
9 WiFi.begin("AgAdi", "Sifre123");
10 while (WiFi.status() != WL_CONNECTED) delay(500);
11
12 sntp_set_sync_interval(6UL * 60 * 60 * 1000); // 6 saatte bir eşitle (en az 15 sn) / sync every 6 hours (min 15 s)
13 configTzTime(TZ_INFO, "pool.ntp.org"); // ayar sntp_init() öncesi verilir / set before sntp_init()
14}
15
16void loop() {
17 if (sntp_get_sync_status() == SNTP_SYNC_STATUS_COMPLETED) {
18 Serial.println("Yeni NTP esitlemesi / new NTP sync");
19 }
20 delay(1000);
21}
22Hansı NTP serverindən istifadə etməli?
Ən geniş yayılmış seçim pool.ntp.org-dur: dünya üzrə könüllülər tərəfindən işlədilən minlərlə serverdən ibarət hovuzdur və hər sorğuda sənə yaxın serverin ünvanını verir. Ölkə alt domenləri (tr.pool.ntp.org, de.pool.ntp.org) serveri daha da yaxına çəkir. configTzTime() ən çox üç server adı qəbul edir; birincisi cavab verməsə, növbətiyə keçir.
| Server | Xüsusiyyət | Qeyd |
|---|---|---|
| pool.ntp.org | Könüllü hovuz, ən yaxın server | Ümumi istifadə üçün ilk seçim |
| az.pool.ntp.org / europe.pool.ntp.org | Ölkə və ya qitə hovuzu | Gecikmə bir az aşağıdır |
| time.cloudflare.com | Böyük şirkət infrastrukturu | Ehtiyat server kimi yaxşıdır |
| time.google.com | Artıq saniyəni yayaraq tətbiq edir (leap smear) | Digər serverlərlə qarışdırma |
| Modemin IP ünvanı | Bəzi modemlər yerli NTP təklif edir | İnternetsiz yerli şəbəkədə işə yarayır |
Raspberry Pi Pico W ilə NTP: ntptime
Raspberry Pi Pico W-də (və Pico 2 W-də) eyni iş MicroPython-un ntptime modulu ilə görülür. ntptime.settime() NTP serverindən soruşur və Pico-nun daxili RTC-sini UTC-yə tənzimləyir. MicroPython-da ESP32-dəki kimi saat qurşağı mətni yoxdur; Türkiyə saatı üçün UTC-yə 3 × 3600 saniyə əlavə edirsən. ntptime yalnız bir dəfə saat alır, avtomatik yenidən sinxronlaşdırma etmir; uzun müddət işləyən layihələrdə settime() çağırışını gündə bir-iki dəfə təkrarlamaq sürüşməni aradan qaldırır. Pico W-nin RTC-si də elektrik kəsiləndə sıfırlanır, buna görə eyni DS3231 ehtiyatı burada da keçərlidir. Pico W ilə Wi-Fi-a qoşulmağın təfərrüatları Pico W Wi-Fi və veb server yazısındadır.
1import network
2import ntptime
3import time
4
5SSID = "AgAdi"
6PASS = "Sifre123"
7UTC_OFFSET = 3 * 3600 # Türkiye UTC+3 / Turkey UTC+3
8# localtime(): 0 = Pazartesi / 0 = Monday
9GUNLER = ("Pazartesi", "Sali", "Carsamba", "Persembe", "Cuma", "Cumartesi", "Pazar")
10
11wlan = network.WLAN(network.STA_IF)
12wlan.active(True)
13wlan.connect(SSID, PASS)
14while not wlan.isconnected(): # bağlanana kadar bekle / wait until connected
15 time.sleep(0.5)
16
17ntptime.host = "pool.ntp.org"
18for deneme in range(5): # NTP bazen zaman aşımına uğrar / NTP may time out
19 try:
20 ntptime.settime() # dahili RTC'yi UTC'ye ayarlar / sets the internal RTC to UTC
21 break
22 except OSError:
23 time.sleep(2)
24
25def yerel_saat(): # UTC + 3 saat / UTC + 3 hours
26 return time.localtime(time.time() + UTC_OFFSET)
27
28son_gun = -1
29while True:
30 yil, ay, gun, saat, dk, sn, hgun, ygun = yerel_saat()
31 print("{:02d}.{:02d}.{} {} {:02d}:{:02d}:{:02d}".format(gun, ay, yil, GUNLER[hgun], saat, dk, sn))
32 if saat == 7 and dk == 30 and ygun != son_gun: # her gün 07:30'da bir kez / once a day at 07:30
33 son_gun = ygun
34 print("Gorev calisti / task ran")
35 time.sleep(1)
36MicroPython-dakı time.localtime() səkkiz elementli kortej qaytarır: il, ay (1–12), gün, saat, dəqiqə, saniyə, həftənin günü və ilin günü. ESP32-dəki struct tm-dən iki fərqi var: ay 1-dən başlayır və həftənin günü 0 = bazar ertəsi kimi sayılır. ntptime.settime() şəbəkə vaxt aşımına uğrayanda OSError atır; koddakı beş cəhdlik dövr buna görə var.
ESP32 NTP saatı ilə layihə ideyaları
- Wi-Fi masa saatı: Saatı, tarixi və otaq temperaturunu tək OLED ekranda göstər; gecə müəyyən saatda parlaqlığı azalt.
- Nəhəng LED saat: NTP saatını MAX7219 LED matrisi üzərində sürüşən yazı ilə göstər.
- Vaxtlı bitki sulama: Hər səhər torpaq rütubətinə baxıb lazım gələrsə mini su nasosunu müəyyən müddət işlət.
- Vaxt damğalı məlumat qeydi: Sensor ölçmələrini ISO tarix formatı ilə SD karta yaz.
- Hava məlumatlı saat: Saatın yanına internetdən çəkilən hava məlumatını əlavə et; ESP32 hava məlumatı yazısı bunun davamıdır.
- Səhər hesabatı: Hər gün 08:00-da ev temperaturunu və gecə boyu aşkarlanan hərəkətləri Telegram ilə telefonuna göndər.
Tez-tez edilən səhvlər və həlləri
| Əlamət | Ehtimal olunan səbəb | Həll |
|---|---|---|
| Saat 1970 göstərir və ya heç gəlmir | Wi-Fi qoşulu deyil və ya NTP portu (UDP 123) bloklanıb | Əvvəlcə WiFi.status() yoxla; məktəb və iş şəbəkələrində başqa şəbəkə və ya telefon hotspotunu sına |
| Saat düz 3 saat geridədir | Saat qurşağı verilməyib, UTC göstərilir | configTzTime("<+03>-3", ...) və ya zonan üçün uyğun sətir |
| Saat 6 saat səhvdir | TZ mətnində işarə tərsdir ("UTC+3") | Türkiyə üçün "<+03>-3" və ya "UTC-3" yaz |
| Ay bir azdır, il 126-dır | tm_mon 0-dan, tm_year 1900-dan sayılır | tm_mon + 1, tm_year + 1900 və ya strftime istifadə et |
| Tapşırıq eyni dəqiqədə dəfələrlə işləyir | Təkrardan qorunma yoxdur | İşlədiyi günü (tm_yday) saxlayıb yoxla |
| Dövr hər turda 5 saniyə ilişir | Saat olmayanda getLocalTime() susmaya görə 5000 ms gözləyir | loop() daxilində getLocalTime(&t, 0) istifadə et |
| OLED-də gün adında qəribə simvollar | Şriftdə Azərbaycan hərfləri yoxdur | Gün adlarını ASCII ilə yaz və ya U8g2 kitabxanasına keç |
ESP32 NTP layihəyə düzgün saat əlavə etməyin ən ucuz və ən zəhmətsiz yoludur: bir neçə sətir kodla saniyəsi-saniyəsinə saat alır, saat qurşağını və yay vaxtını özü idarə edir; DS3231 əlavə etməklə elektrik kəsintilərinə də davamlı olur. BlueGrays tətbiqində ESP32 NTP ilə internetdən real vaxt, DS1307 RTC-li rəqəmsal saat, OLED ekranlı hava məlumatı və vaxt damğalı temperatur qeydedici layihələrini addım-addım dövrə sxemləri və kodları ilə tapa bilərsən.
Tez-tez verilən suallar
ESP32 internet olmadan saatı saxlaya bilərmi?
Saatı bir dəfə NTP-dən aldıqdan sonra bəli: ESP32 sistem saatını öz sayğacı ilə saymağa davam edir və Wi-Fi-ın kəsilməsi saatı dayandırmır. Lakin elektrik kəsilsə və ya plata yenidən başlasa, saat 1970-ə qayıdır. İnternetin ümumiyyətlə olmadığı yerlərdə və ya kəsintiyə davamlı saat üçün DS3231 kimi batareyalı RTC modulu əlavə et.
ESP32 NTP saatı niyə 3 saat geri göstərir?
Saat qurşağı tənzimlənmədikdə ESP32 saatı UTC kimi göstərir və Türkiyə UTC+3 olduğu üçün saat düz 3 saat geri qalır. configTzTime("<+03>-3", "pool.ntp.org") istifadə et. TZ sətrinə "UTC+3" yazdıqda isə işarə tərsinə başa düşüldüyü üçün saat 6 saat sürüşür.
Türkiyə üçün configTime dəyərləri nədir?
Türkiyə 2016-dan bəri il boyu UTC+3-də qalır və yay vaxtına keçmir. Buna görə configTime(10800, 0, "pool.ntp.org") yazırsan: 10800 saniyə 3 saatdır, yay vaxtı fərqi 0-dır. Eyni ayar configTzTime ilə "<+03>-3" mətni ilə edilir.
ESP32 NTP ilə nə qədər tez-tez sinxronlaşır?
Arduino ESP32 nüvəsində SNTP susmaya görə 3 saatdan bir serverdən yenidən soruşur; arada saatı öz sayğacı ilə saxlayır. Aralığı sntp_set_sync_interval() funksiyası ilə millisaniyə ilə dəyişə bilərsən, lakin protokol qaydalarına görə 15 saniyədən qısa ola bilməz.
ESP32 istifadə edərkən RTC moduluna ehtiyac varmı?
Cihaz daim elektriklidirsə və Wi-Fi-a qoşula bilirsə, ehtiyac yoxdur; NTP daha dəqiq saat verir. Elektrik kəsilməsindən sonra internet gəlmədən düzgün saat lazımdırsa və ya cihaz internetsiz yerdə işləyəcəksə, DS3231 kimi batareyalı RTC modulu əlavə etmək lazımdır.
Raspberry Pi Pico W ilə NTP saatı necə alınır?
MicroPython-da Wi-Fi-a qoşulandan sonra import ntptime və ntptime.settime() yazmaq kifayətdir; bu əmr Pico-nun daxili RTC-sini UTC-yə tənzimləyir. Türkiyə saatı üçün time.localtime(time.time() + 10800) istifadə edirsən. ntptime avtomatik yenidən sinxronlaşdırma etmədiyi üçün settime() çağırışını gündə bir-iki dəfə təkrarlamaq yaxşı olar.
Bu yazıdan sonra edə biləcəyin layihələr
Bütün layihələrə bax
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.

ESP32 RTC DS1307 ilə rəqəmsal saat (I2C + LCD)
Bu layihədə DS1307 real vaxt saatı (RTC) modulu ilə 16x2 I2C LCD ekranda saat və tarix məlumatı göstəririk. DS1307 batareya dəstəkli RTC-dir; ESP32 söndürülsə belə vaxtı saxlayır. Hər iki modul eyni I2C xəttini (SDA/SCL) paylaşır, beləcə cəmi iki siqnal naqili ilə çoxlu cihaz idarəsini öyrənmiş oluruq. Bu layihə ilə I2C rabitə protokolunu, RTC modullarının iş prinsipini və LCD ekranda dinamik məlumat göstərilməsini praktik şəkildə öyrənəcəksən.

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.

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.

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.

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.

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.

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).
Digər yazılar
BlueGrays tətbiqi
Bu dövrəni telefonunda addım-addım qur
Dövrə sxemi, kod və hissə siyahısı bir ekranda. 500-dən çox Arduino, ESP32 və Pico layihəsi səni gözləyir.
Telefonunla skan et
Kameranı koda tut; telefonunun tətbiq mağazası açılır.
ya da mağazada aç

