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

ESP32 MQTT bələdçisi: Mosquitto, Home Assistant və ESPHome

ESP32 MQTT bələdçisi: Mosquitto quraşdırılması, PubSubClient ilə sensor məlumatı yayımlama və rele idarəsi, Home Assistant kəşfi, ESPHome YAML nümunəsi, QoS və tez-tez rast gəlinən xətalar.

ESP32 MQTT cütü evdəki sensorların və relelərin bir-biri ilə və Home Assistant kimi ağıllı ev sistemi ilə danışmasının ən geniş yayılmış yoludur. MQTT kiçik cihazlar üçün nəzərdə tutulmuş yüngül mesajlaşma protokoludur: ESP32 ölçdüyü temperaturu "ev/salon/sicaklik" kimi bir mövzuya (topic) buraxır, həmin mövzunu dinləyən hər proqram dəyəri dərhal alır. Eyni yolla, telefondakı Home Assistant tətbiqində düyməyə basanda gedən "ON" komandası saniyədən az müddətdə ESP32-yə çatır və releni işə salır. HTTP-dəki kimi hər sorğu üçün yeni əlaqə qurulmur; yalnız bir açıq əlaqə üzərindən, ən azı iki baytlıq başlıqlarla işlədiyi üçün həm sürətlidir, həm də Wi-Fi-ı və prosessoru yormur.

Bu bələdçidə sıfırdan işləyən bir ağıllı ev düyünü quracaqsan. Əvvəlcə MQTT-nin broker, topic, publish və subscribe anlayışlarını öyrənəcək, sonra Home Assistant-da və ya Raspberry Pi-də Mosquitto broker-ini quraşdıracaqsan. Daha sonra PubSubClient kitabxanası ilə ESP32-dən DHT22 temperatur və rütubət dəyərlərini yayımlayacaq, rele komandalarını dinləyəcək və cihazın Home Assistant-da özbaşına görünməsini təmin edən MQTT Discovery-ni əlavə edəcəksən. QoS və retain ayarlarını, əlaqə kəsiləndə cihazı "əlçatmaz" göstərən son vəsiyyət (LWT) mesajını, heç C++ yazmadan eyni işi görən ESPHome alternativini, ESP8266 və Raspberry Pi Pico W fərqlərini və ən çox rast gəlinən xətaları da tək-tək nəzərdən keçirəcəyik.

MQTT ilə Home Assistant-a qoşulan ESP32 inkişaf platası
ESP32 daxili Wi-Fi sayəsində ev şəbəkəsindəki MQTT broker-inə birbaşa qoşulur; sensor məlumatları və rele komandaları eyni əlaqə üzərindən axır.

MQTT nədir, necə işləyir?

MQTT (Message Queuing Telemetry Transport) yayımla-abunə ol (publish/subscribe) modeli ilə işləyir. Ortada broker adlanan bir server olur; ESP32, Home Assistant, telefonundakı və ya kompüterindəki proqram bu serverə klient kimi qoşulur. Klientlər bir-birini tanımır, IP ünvanlarını bilmir: biri mövzuya mesaj yayımlayır, broker bu mesajı həmin mövzuya abunə olan hər kəsə çatdırır. Bunu poçt şöbəsi kimi düşünə bilərsən: ESP32 məktubu "ev/salon/sicaklik" ünvanlı qutuya atır, o qutunu izləyən Home Assistant məktubu dərhal alır. Əlaqəni həmişə klient başlatdığı üçün ESP32-nin sabit IP-yə və ya modemdə açılmış porta ehtiyacı yoxdur; bilməli olduğu yeganə şey broker-in ünvanıdır.

AnlayışNəyə yarayır?Nümunə
BrokerMesajları qəbul edib abunəçilərə paylayan serverMosquitto, Home Assistant-dakı Mosquitto broker
Klient (client)Broker-ə qoşulan hər cihaz və ya proqram; unikal kimliyi (client ID) olurESP32, Home Assistant, MQTT Explorer
Topic (mövzu)Mesajın ünvanı; maili xəttlə ayrılmış səviyyələrdən ibarətdirev/salon/sicaklik
Publish (yayımla)Mövzuya mesaj göndərmək"23.4" dəyərini ev/salon/sicaklik mövzusuna göndərmək
Subscribe (abunə ol)Mövzudakı mesajları almaq üçün qeydiyyatdan keçməkESP32-nin ev/salon/role/komut mövzusunu dinləməsi
Payload (yük)Mesajın məzmunu; mətn, rəqəm və ya JSON ola bilərON, 23.4, {"sicaklik":23.4}
RetainBroker-in mövzudakı son mesajı saxlayıb yeni abunəçilərə dərhal verməsiRele vəziyyəti: ON
LWT (son vəsiyyət)Klient xəbərsiz qopanda broker-in onun adından yayımladığı mesajev/salon/baglanti: offline
QoSMesajın çatdırılma zəmanəti səviyyəsi (0, 1 və ya 2)Rele komandaları üçün QoS 1

Niyə MQTT? Veb server, Blynk və Telegram ilə müqayisə

ÜsulÜstünlüyüÇatışmazlığıƏn uyğun olduğu iş
MQTT + Home AssistantLokal və sürətli, ikitərəfli; yüzlərlə cihaz bir paneldə, avtomatlaşdırma qurmaq olurBroker qurmaq lazımdırBütün evi bir mərkəzdən idarə etmək
ESP32 veb serverƏlavə server lazım deyil, brauzerdən açılırHər cihazın ayrıca səhifəsi olur, cihazlar arasında avtomatlaşdırma yoxdurTək cihazlıq idarəetmə paneli
Blynk IoTHazır telefon paneli, internetdən girişBuluddan asılıdır, pulsuz planda limitlər varSürətli mobil prototip
Telegram botuPulsuz ani bildiriş, port açmaq lazım deyilQrafik və panel yoxdurSiqnal və sadə komandalar
ESP-NOWModem və broker olmadan ESP-lər arasında əlaqəYalnız ESP platalar arasında, Home Assistant-a birbaşa çatmırBatareya ilə işləyən sensordan şlüzə məlumat daşımaq

Qısası, MQTT cihaz sayı artdıqca parlayan üsuldur: yeni sensor əlavə edəndə mövcud kodların heç birinə toxunmursan, sadəcə yeni mövzuya yayımlamağa başlayırsan. Tək cihazı brauzerdən idarə etmək istəyirsənsə ESP32 Async Web Server və WebSocket, telefona bildiriş istəyirsənsə ESP32 Telegram Bot, hazır mobil panel istəyirsənsə Blynk ESP32 bələdçiləri daha qısa yolla nəticə verir. Modemin çatmadığı bağ sensoru üçün isə ESP-NOW ilə məlumatı MQTT-yə qoşulu şlüz ESP32-yə daşımaq yaxşı həlldir.

MQTT topic quruluşu və joker simvollar

Topic-lər qovluq yoluna bənzəyir: "ev/salon/sicaklik" üç səviyyədən ibarətdir və böyük-kiçik hərfə həssasdır, yəni "Ev/Salon" ilə "ev/salon" iki ayrı mövzudur. Əvvəlinə maili xətt qoyma ("/ev/salon" boş ilk səviyyə yaradır), boşluq və Azərbaycan hərfləri (ə, ş, ç…) işlətmə; ingilis hərfləri, rəqəmlər, tire və alt xətt kifayətdir. Abunə olarkən iki joker simvoldan istifadə edə bilərsən: + tək bir səviyyənin yerini tutur ("ev/+/sicaklik" bütün otaqların temperaturunu gətirir), # isə özündən sonrakı hər şeyi əhatə edir və yalnız sonda yazılır ("ev/#" evdəki bütün mesajları gətirir). Jokerlər yalnız abunə olarkən keçərlidir; mesaj həmişə dəqiq bir mövzuya yayımlanır. $ ilə başlayan mövzular ($SYS kimi) broker-in öz statistikası üçün ayrılıb və # abunəliyinə daxil edilmir. Bu bələdçidəki layihə üçün aşağıdakı quruluşdan istifadə edəcəyik:

TopicYayımlayanDinləyənRetain
ev/salon/sicaklikESP32 (30 saniyədən bir)Home AssistantBəli
ev/salon/nemESP32 (30 saniyədən bir)Home AssistantBəli
ev/salon/role/komutHome Assistant, telefon, avtomatlaşdırmalarESP32Xeyr
ev/salon/role/durumESP32 (hər dəyişiklikdə)Home AssistantBəli
ev/salon/baglantiESP32 (online), broker (offline)Home AssistantBəli
homeassistant/statusHome Assistant (açılışda online)ESP32Xeyr

MQTT broker quraşdırılması: Mosquitto

Ən geniş yayılmış pulsuz MQTT broker-i Eclipse Mosquitto-dur; Raspberry Pi-də belə saniyədə yüzlərlə mesajı rahatlıqla daşıyır. Quraşdırmağın üç asan yolu var: Home Assistant OS istifadə edirsənsə rəsmi Mosquitto broker tətbiqi, ayrıca Raspberry Pi və ya Linux kompüter istifadə edirsənsə apt paketi, Windows-da isə Mosquitto-nun quraşdırma faylı. Hansını seçsən seç, broker şifrəsiz MQTT üçün 1883, TLS ilə şifrələnmiş MQTT üçün 8883 portundan istifadə edir və ESP32 ilə eyni ev şəbəkəsində olması kifayətdir. Home Assistant-da quraşdırma belədir:

  1. Home Assistant-da Ayarlar > Tətbiqlər bölməsini aç (köhnə versiyalarda bu bölmənin adı Əlavələr / Add-ons-dur), Tətbiq quraşdır düyməsinə bas və siyahıdan Mosquitto broker-i seç.
  2. Quraşdır düyməsinə bas; quraşdırma bitəndə Başlat-a bas və açılışda başlatma seçimini açıq burax.
  3. ESP32 üçün ayrıca istifadəçi yarat: Ayarlar > Şəxslər > İstifadəçilər bölməsindən "esp32" adlı istifadəçi və güclü şifrə yarat. Bu sekmanı görmürsənsə profil səhifəndə Qabaqcıl rejimi aç. "homeassistant" və "addons" adları broker üçün ayrılıb, onlardan istifadə etmə.
  4. Ayarlar > Cihazlar və xidmətlər səhifəsində MQTT inteqrasiyası adətən "Aşkarlandı" kimi özbaşına çıxır; Konfiqurasiya et-ə basıb təsdiq et. Çıxmasa İnteqrasiya əlavə et düyməsi ilə MQTT-ni axtar və Mosquitto-nu avtomatik konfiqurasiya edən seçimdən istifadə et.
  5. ESP32 kodunda broker ünvanı kimi Home Assistant-ın IP ünvanını (məsələn, 192.168.1.10), port kimi 1883-ü və indicə yaratdığın istifadəçini yazacaqsan.

Raspberry Pi və ya Ubuntu kimi Linux maşınında quraşdırma bir neçə əmrdir. sudo apt install mosquitto mosquitto-clients ilə broker-i və test alətlərini quraşdır. sudo mosquitto_passwd -c /etc/mosquitto/passwd esp32 əmri ilə "esp32" istifadəçisini yarat və şifrəni iki dəfə daxil et; -c parametri faylı sıfırdan yaradır, buna görə ikinci istifadəçi əlavə edəndə -c yazma, yoxsa əvvəlki istifadəçilər silinir. Sonra /etc/mosquitto/conf.d/ qovluğunda yerel.conf adlı fayl yaradıb aşağıdakı üç sətri yaz və sudo systemctl restart mosquitto ilə xidməti yenidən başlat. Windows-da eyni sətirləri Mosquitto-nun quraşdırma qovluğundakı mosquitto.conf faylına əlavə edib Mosquitto Broker xidmətini yenidən başlatmaq kifayətdir.

SətirMənası
listener 1883Bütün şəbəkə interfeyslərində 1883 portunu dinləyir; bu sətir olmasa Mosquitto 2.x yalnız eyni kompüterdən gələn əlaqələri qəbul edir
allow_anonymous falseİstifadəçi adı və şifrəsi olmayan əlaqələri rədd edir; 2.x versiyalarında artıq standartdır, amma açıq yazmaq yaxşı vərdişdir
password_file /etc/mosquitto/passwdmosquitto_passwd ilə yaratdığın şifrə faylından istifadə edir; şifrələr faylda hash şəklində saxlanılır
Konfiqurasiyada listener təyin edilməyibsə, Mosquitto 2.0 və sonrakı versiyalar yalnız 127.0.0.1 ünvanını dinləyir və jurnala "Starting in local only mode. Connections will only be possible from clients running on this machine." xəbərdarlığını yazır. Bu halda ESP32 qoşula bilmir və rc=-2 xətası alırsan. Digər tərəfdən, 1883 portunu modemdən internetə açma (port yönləndirməsi etmə): şifrəsiz MQTT trafiki yolda oxuna bilər və evdəki relelər başqalarının əlinə keçə bilər. Evdən kənardan giriş lazımdırsa VPN və ya Home Assistant-ın uzaqdan giriş həllərindən istifadə et.

ESP32-yə keçməzdən əvvəl broker-i kompüterindən test et; problemin kodda, yoxsa broker-də olduğunu əvvəlcədən ayırmaq çox vaxt qazandırır. Bir terminalda mosquitto_sub -h 192.168.1.10 -u esp32 -P sifren -t "ev/#" -v əmri ilə evdəki bütün mövzuları dinləməyə başla. İkinci terminalda mosquitto_pub -h 192.168.1.10 -u esp32 -P sifren -t ev/salon/test -m merhaba yaz. Birinci terminalda "ev/salon/test merhaba" sətri görünürsə, broker işləyir və şifrə düzgündür. -v parametri hər mesajın əvvəlinə mövzusunu yazır, -r parametri isə mesajı retain olaraq göndərir.

Komanda sətrini sevmirsənsə, pulsuz MQTT Explorer proqramı broker-dəki bütün mövzuları ağac görünüşündə, son dəyərləri və retain işarələri ilə birlikdə göstərir. Home Assistant daxilində də Ayarlar > Cihazlar və xidmətlər > MQTT > Konfiqurasiya et səhifəsindəki "Mövzunu dinlə" qutusuna ev/# yazıb dinləməyə başlaya, "Paket yayımla" bölməsindən ESP32-yə əllə komanda göndərə bilərsən.

Lazımi hissələr və qoşulma sxemi

Layihə üçün bir ESP32 inkişaf platası, bir DHT22 temperatur və rütubət sensoru, 3,3 V ilə tətikləniləbilən rele modulu, breadboard və jumper naqillər kifayətdir. DHT22 DHT11-ə görə daha həssasdır: temperaturu ±0,5 °C, rütubəti təxminən ±2–5% dəqiqliklə ölçür və -40 ilə 80 °C arasında işləyir; sensor ailəsini DHT11 temperatur və rütubət sensoru yazısında ətraflı izah etdik. Əlində DHT11 varsa, koddakı DHT22 yazılan yeri DHT11 etməyin kifayətdir. İlk əlaqə testi üçün yalnız ESP32 və USB kabeli yetər; sensoru və releni sonra əlavə edə bilərsən.

ESP32
ESP32
DHT22
DHT22
Rele modulu
Rele modulu
QoşulmaESP32ESP8266 (NodeMCU)Raspberry Pi Pico W
DHT22 VCC3V33V33V3(OUT)
DHT22 DATAGPIO 4D2 (GPIO 4)GP15
DHT22 GNDGNDGNDGND
Rele VCCVIN (5V)VIN (5V)VBUS (5V)
Rele INGPIO 26D1 (GPIO 5)GP14
Rele GNDGNDGNDGND
ESP32, ESP8266 və Pico-nun pinləri 3,3 V ilə işləyir və 5 V-a davamlı deyil; DHT22-ni buna görə 3V3 pinindən qidalandırırıq. Üç pinli DHT22 modullarının üzərində adətən çəkmə (pull-up) rezistoru olur; dörd ayaqlı çılpaq sensor istifadə edirsənsə DATA ilə VCC arasına 4,7–10 kΩ rezistor əlavə et. Rele ilə 220 V şəbəkə yükünü açıb-bağlayacaqsansa, qoşulmaları fiş çıxarılmış halda et və böyüklərdən kömək al; təfərrüatlar Rele modulu nədir? yazısındadır. Platanın bütün pinlərini Pinout alətində görə bilərsən.

Arduino IDE-də PubSubClient quraşdırılması

  1. Arduino IDE-də ESP32 plata paketi quraşdırılmayıbsa, əvvəlcə onu quraşdır; addımlar ESP32 nədir? yazısındadır.
  2. Tools > Manage Libraries menyusunu aç, axtarış qutusuna PubSubClient yaz və müəllifi Nick O'Leary olan kitabxananı quraşdır. Bu bələdçidəki kodlar 2.8 versiyası ilə kompilyasiya edilib.
  3. Eyni pəncərədə DHT sensor library axtar və Adafruit-in kitabxanasını quraşdır; asılılıqları soruşanda Install all seçərək Adafruit Unified Sensor-u da quraşdır.
  4. Kitabxana quraşdırarkən problem yaşayırsansa, Arduino-da kitabxana əlavə etmə bələdçisinə bax.

İlk test: ESP32-ni MQTT broker-ə qoşmaq

Sensorlara keçməzdən əvvəl Wi-Fi, broker ünvanı və şifrənin düzgün olduğunu ən sadə kodla yoxlayaq. Aşağıdakı kod broker-ə qoşulur, "test/esp32/durum" mövzusuna "merhaba" yayımlayır və "test/esp32/komut" mövzusuna gələn hər mesajı Serial Monitor-a yazır. Wi-Fi adını, şifrəni, broker IP-sini və MQTT istifadəçisini öz məlumatlarınla əvəz et, kodu yüklə və Serial Monitor-u 115200 baud sürətində aç:

C++ (Arduino IDE)
1#include <WiFi.h>
2#include <PubSubClient.h>
3
4const char* WIFI_SSID = "AgAdi";              // Wi-Fi adın (yalnız 2,4 GHz) / your Wi-Fi name (2.4 GHz only)
5const char* WIFI_PASS = "Sifre123";           // Wi-Fi şifren / your Wi-Fi password
6const char* MQTT_SUNUCU = "192.168.1.10";     // broker'ın IP adresi / broker IP address
7const int   MQTT_PORT = 1883;                 // şifresiz MQTT portu / unencrypted MQTT port
8const char* MQTT_KULLANICI = "esp32";         // broker kullanıcı adı / broker username
9const char* MQTT_SIFRE = "mqttSifre";         // broker şifresi / broker password
10
11WiFiClient wifiIstemci;                       // TCP bağlantısı / TCP connection
12PubSubClient mqtt(wifiIstemci);               // MQTT istemcisi / MQTT client
13
14// Abone olunan konuya mesaj gelince çalışır / runs when a subscribed topic receives a message
15void mesajGeldi(char* topic, byte* payload, unsigned int length) {
16  Serial.print("Mesaj [");
17  Serial.print(topic);
18  Serial.print("] ");
19  for (unsigned int i = 0; i < length; i++) {
20    Serial.print((char)payload[i]);           // payload sonunda \0 yoktur / payload is not null-terminated
21  }
22  Serial.println();
23}
24
25void setup() {
26  Serial.begin(115200);
27  WiFi.mode(WIFI_STA);
28  WiFi.begin(WIFI_SSID, WIFI_PASS);
29  while (WiFi.status() != WL_CONNECTED) {
30    delay(500);
31    Serial.print(".");
32  }
33  Serial.print("\nIP: ");
34  Serial.println(WiFi.localIP());
35
36  mqtt.setServer(MQTT_SUNUCU, MQTT_PORT);     // broker adresi / broker address
37  mqtt.setCallback(mesajGeldi);               // gelen mesaj fonksiyonu / incoming message handler
38}
39
40void loop() {
41  if (!mqtt.connected()) {
42    Serial.print("MQTT baglaniyor... ");
43    if (mqtt.connect("esp32-test", MQTT_KULLANICI, MQTT_SIFRE)) {   // istemci kimliği benzersiz olmalı / client ID must be unique
44      Serial.println("baglandi");
45      mqtt.subscribe("test/esp32/komut");                  // bu konuyu dinle / listen to this topic
46      mqtt.publish("test/esp32/durum", "merhaba");         // ilk mesaj / first message
47    } else {
48      Serial.print("hata, rc=");
49      Serial.println(mqtt.state());                        // hata kodu / error code
50      delay(5000);
51      return;
52    }
53  }
54  mqtt.loop();                                             // mesajları işle, bağlantıyı canlı tut / process messages, keep the connection alive
55}

Serial Monitor-da "baglandi" yazısını gördükdən sonra kompüterindəki terminaldan mosquitto_pub -h 192.168.1.10 -u esp32 -P sifren -t test/esp32/komut -m selam göndər; bir neçə millisaniyə ərzində Serial Monitor-da "Mesaj [test/esp32/komut] selam" sətri görünür. Əlaqə alınmasa, kod mqtt.state() ilə xəta kodu yazır və 5 saniyədən sonra yenidən cəhd edir. Bu kodlar problemin harada olduğunu birbaşa deyir:

rcPubSubClient adıMənası və həlli
-4MQTT_CONNECTION_TIMEOUTBroker vaxtında cavab vermədi; şəbəkə zəifdir və ya broker həddindən artıq yüklənib
-3MQTT_CONNECTION_LOSTQurulmuş əlaqə kəsildi; çox vaxt loop() uzun müddət çağırılmadığı və ya Wi-Fi getdiyi üçün
-2MQTT_CONNECT_FAILEDTCP əlaqəsi heç qurulmadı: IP və ya port səhvdir, broker bağlıdır, Mosquitto yalnız lokal rejimdədir və ya firewall 1883-ü əngəlləyir
-1MQTT_DISCONNECTEDƏlaqə düzgün şəkildə bağlandı (disconnect çağırıldı) və ya hələ heç qoşulmayıb
2MQTT_CONNECT_BAD_CLIENT_IDKlient kimliyi rədd edildi; boş və ya yanlış client ID istifadə olunub
4MQTT_CONNECT_BAD_CREDENTIALSİstifadəçi adı və ya şifrə səhvdir (bəzi broker-lər bu kodu qaytarır)
5MQTT_CONNECT_UNAUTHORIZEDİcazə yoxdur; Mosquitto həm yanlış şifrədə, həm də şifrəsiz qoşulmağa cəhd olunanda bu kodu qaytarır

ESP32 ilə sensor məlumatı yayımlama və rele komandası dinləmə

İndi əsas layihəni qururuq. Aşağıdakı kod 30 saniyədən bir DHT22-ni oxuyub temperaturu və rütubəti retain bayrağı ilə yayımlayır, "ev/salon/role/komut" mövzusuna gələn ON, OFF və TOGGLE komandaları ilə releni idarə edir və relenin yeni vəziyyətini "ev/salon/role/durum" mövzusuna bildirir. Qoşularkən broker-ə son vəsiyyət qoyur, özünü Home Assistant-a MQTT Discovery ilə tanıdır və əlaqə kəsiləndə loop()-u kilidləmədən 5 saniyədən bir yenidən qoşulmağa çalışır. Kodun əvvəlindəki #if defined(ESP8266) bloku sayəsində eyni kod heç bir dəyişiklik edilmədən NodeMCU-da da kompilyasiya olunur.

C++ (Arduino IDE)
1#if defined(ESP8266)
2#include <ESP8266WiFi.h>
3#else
4#include <WiFi.h>
5#endif
6#include <PubSubClient.h>
7#include <DHT.h>
8
9// ---- Ayarlar / Settings ----
10const char* WIFI_SSID = "AgAdi";
11const char* WIFI_PASS = "Sifre123";
12const char* MQTT_SUNUCU = "192.168.1.10";        // broker IP (Home Assistant ya da Raspberry Pi) / broker IP (Home Assistant or Raspberry Pi)
13const int   MQTT_PORT = 1883;
14const char* MQTT_KULLANICI = "esp32";
15const char* MQTT_SIFRE = "mqttSifre";
16const char* ISTEMCI_ID = "esp32-salon";          // her cihazda farklı olmalı / must be different on every device
17
18#if defined(ESP8266)
19const int DHT_PIN = 4;                           // NodeMCU D2
20const int ROLE_PIN = 5;                          // NodeMCU D1
21#else
22const int DHT_PIN = 4;                           // ESP32 GPIO 4
23const int ROLE_PIN = 26;                         // ESP32 GPIO 26
24#endif
25const bool ROLE_AKTIF_LOW = true;                // çoğu röle modülü LOW ile çeker / most relay modules switch on LOW
26const unsigned long OLCUM_ARALIGI = 30000;       // 30 saniyede bir ölçüm / one reading every 30 s
27
28// ---- Konular (topic) / Topics ----
29const char* T_SICAKLIK = "ev/salon/sicaklik";
30const char* T_NEM      = "ev/salon/nem";
31const char* T_KOMUT    = "ev/salon/role/komut";  // ON, OFF ya da TOGGLE / ON, OFF or TOGGLE
32const char* T_DURUM    = "ev/salon/role/durum";
33const char* T_BAGLANTI = "ev/salon/baglanti";    // online / offline (son vasiyet / last will)
34const char* T_HA_DURUM = "homeassistant/status"; // HA açılınca "online" yayınlar / HA publishes "online" when it starts
35
36WiFiClient wifiIstemci;
37PubSubClient mqtt(wifiIstemci);
38DHT dht(DHT_PIN, DHT22);
39
40bool roleAcik = false;
41unsigned long sonOlcum = 0;
42unsigned long sonDeneme = 0;
43
44// Röleyi sür ve yeni durumu kalıcı (retain) yayınla / drive the relay and publish the new state as retained
45void roleAyarla(bool acik) {
46  roleAcik = acik;
47  bool seviye = ROLE_AKTIF_LOW ? !acik : acik;
48  digitalWrite(ROLE_PIN, seviye ? HIGH : LOW);
49  mqtt.publish(T_DURUM, acik ? "ON" : "OFF", true);
50  Serial.println(acik ? "Role: ON" : "Role: OFF");
51}
52
53// Tek bir Home Assistant keşif mesajı gönder / send one Home Assistant discovery message
54void kesifYayinla(const char* tur, const char* nesne, const char* ad, const char* ekAlanlar) {
55  char konu[96];
56  snprintf(konu, sizeof(konu), "homeassistant/%s/%s/%s/config", tur, ISTEMCI_ID, nesne);
57  char json[600];
58  snprintf(json, sizeof(json),
59           "{\"name\":\"%s\",\"unique_id\":\"%s_%s\",%s,\"availability_topic\":\"%s\","
60           "\"device\":{\"identifiers\":[\"%s\"],\"name\":\"Salon ESP32\",\"model\":\"ESP32 + DHT22\"}}",
61           ad, ISTEMCI_ID, nesne, ekAlanlar, T_BAGLANTI, ISTEMCI_ID);
62  if (!mqtt.publish(konu, json, true)) {         // false: tampon küçük ya da bağlantı yok / false: buffer too small or not connected
63    Serial.println("Kesif mesaji gonderilemedi");
64  }
65}
66
67// Sıcaklık, nem ve röleyi Home Assistant'a tanıt / announce temperature, humidity and relay to Home Assistant
68void haKesifGonder() {
69  char ek[200];
70  snprintf(ek, sizeof(ek), "\"state_topic\":\"%s\",\"device_class\":\"temperature\",\"unit_of_measurement\":\"°C\",\"state_class\":\"measurement\"", T_SICAKLIK);
71  kesifYayinla("sensor", "sicaklik", "Sıcaklık", ek);
72  snprintf(ek, sizeof(ek), "\"state_topic\":\"%s\",\"device_class\":\"humidity\",\"unit_of_measurement\":\"%%\",\"state_class\":\"measurement\"", T_NEM);
73  kesifYayinla("sensor", "nem", "Nem", ek);
74  snprintf(ek, sizeof(ek), "\"state_topic\":\"%s\",\"command_topic\":\"%s\"", T_DURUM, T_KOMUT);
75  kesifYayinla("switch", "role", "Röle", ek);
76}
77
78// DHT22'yi oku ve değerleri yayınla / read the DHT22 and publish the values
79void olcumGonder() {
80  float t = dht.readTemperature();
81  float h = dht.readHumidity();
82  if (isnan(t) || isnan(h)) {
83    Serial.println("DHT22 okunamadi");
84    return;
85  }
86  char deger[12];
87  snprintf(deger, sizeof(deger), "%.1f", t);     // 23.4 gibi / like 23.4
88  mqtt.publish(T_SICAKLIK, deger, true);
89  snprintf(deger, sizeof(deger), "%.0f", h);     // 45 gibi / like 45
90  mqtt.publish(T_NEM, deger, true);
91  Serial.printf("Sicaklik %.1f C, nem %.0f %%\n", t, h);
92}
93
94// Abone olunan konulara mesaj gelince çalışır / runs when a subscribed topic receives a message
95void mesajGeldi(char* topic, byte* payload, unsigned int length) {
96  // Önce kopyala: yayın yapınca kütüphane aynı tamponu kullanır / copy first: publishing reuses the same buffer
97  String konu = topic;
98  String mesaj;
99  for (unsigned int i = 0; i < length; i++) mesaj += (char)payload[i];
100  mesaj.trim();
101
102  if (konu == T_KOMUT) {
103    if (mesaj == "ON") roleAyarla(true);
104    else if (mesaj == "OFF") roleAyarla(false);
105    else if (mesaj == "TOGGLE") roleAyarla(!roleAcik);
106  } else if (konu == T_HA_DURUM && mesaj == "online") {
107    haKesifGonder();                             // HA yeniden başladı, tanıtımı yenile / HA restarted, announce again
108    mqtt.publish(T_DURUM, roleAcik ? "ON" : "OFF", true);
109  }
110}
111
112bool mqttBaglan() {
113  Serial.print("MQTT baglaniyor... ");
114  // Bağlantı koparsa broker T_BAGLANTI'ya "offline" yazar / if we drop, the broker publishes "offline" to T_BAGLANTI
115  if (!mqtt.connect(ISTEMCI_ID, MQTT_KULLANICI, MQTT_SIFRE, T_BAGLANTI, 1, true, "offline")) {
116    Serial.print("hata, rc=");
117    Serial.println(mqtt.state());
118    return false;
119  }
120  Serial.println("baglandi");
121  mqtt.publish(T_BAGLANTI, "online", true);
122  mqtt.subscribe(T_KOMUT, 1);                    // komutları QoS 1 ile dinle / listen to commands with QoS 1
123  mqtt.subscribe(T_HA_DURUM);
124  haKesifGonder();
125  mqtt.publish(T_DURUM, roleAcik ? "ON" : "OFF", true);
126  return true;
127}
128
129void setup() {
130  Serial.begin(115200);
131  pinMode(ROLE_PIN, OUTPUT);
132  roleAyarla(false);                             // güvenli başlangıç: röle kapalı / safe start: relay off
133  dht.begin();
134
135  WiFi.mode(WIFI_STA);
136  WiFi.begin(WIFI_SSID, WIFI_PASS);
137  Serial.print("Wi-Fi");
138  while (WiFi.status() != WL_CONNECTED) {
139    delay(500);
140    Serial.print(".");
141  }
142  Serial.print(" IP: ");
143  Serial.println(WiFi.localIP());
144
145  mqtt.setServer(MQTT_SUNUCU, MQTT_PORT);
146  mqtt.setCallback(mesajGeldi);
147  mqtt.setBufferSize(1024);                      // keşif JSON'u varsayılan 256 bayta sığmaz / discovery JSON doesn't fit the default 256 bytes
148}
149
150void loop() {
151  if (!mqtt.connected()) {
152    unsigned long simdi = millis();
153    if (sonDeneme == 0 || simdi - sonDeneme >= 5000) {   // 5 sn'de bir dene, loop'u kilitleme / retry every 5 s without blocking
154      sonDeneme = simdi;
155      if (mqttBaglan()) sonOlcum = simdi - OLCUM_ARALIGI;  // bağlanınca hemen ölç / measure right after connecting
156    }
157    return;
158  }
159  mqtt.loop();                                   // gelen komutlar ve keep-alive / incoming commands and keep-alive
160
161  if (millis() - sonOlcum >= OLCUM_ARALIGI) {
162    sonOlcum = millis();
163    olcumGonder();
164  }
165}
SətirVəzifəsi
mqtt.connect(ISTEMCI_ID, ..., T_BAGLANTI, 1, true, "offline")Qoşularkən son vəsiyyəti də bildirir: ESP32 xəbərsiz qopsa, broker ev/salon/baglanti mövzusuna daimi olaraq "offline" yazır
mqtt.publish(T_BAGLANTI, "online", true)Qoşulan kimi vəziyyəti "online" edir; Home Assistant cihazı yenidən əlçatan göstərir
mqtt.subscribe(T_KOMUT, 1)Rele komandalarını QoS 1 ilə dinləyir; PubSubClient abunəlikdə yalnız QoS 0 və 1-i dəstəkləyir
mqtt.setBufferSize(1024)Paket buferini standart 256 baytdan böyüdür; ən böyük kəşf paketi təxminən 355 baytdır
mqtt.loop()Gələn mesajları oxuyur və keep-alive (PINGREQ) paketlərini göndərir; hər loop dövründə çağırılmalıdır
ROLE_AKTIF_LOWƏksər rele modulları LOW siqnalla işə düşür; modulun HIGH ilə işə düşürsə false et
OLCUM_ARALIGIÖlçmə tezliyi; DHT22 ən çox 2 saniyədən bir oxuna bilər, otaq temperaturu üçün 30–60 saniyə idealdır

Koddakı bir neçə təfərrüat qəsdən seçilib. mesajGeldi() funksiyası mövzunu və payload-u ilk iş olaraq String-ə kopyalayır, çünki PubSubClient gələn və gedən mesajlar üçün tək bufer istifadə edir: geri çağırma daxilində publish() etdiyin anda topic və payload göstəricilərinin göstərdiyi məlumat silinir. Payload-un sonunda C massivlərindəki kimi \0 simvolu da yoxdur; buna görə length qədər simvol oxuyuruq. Ölçmələrdə və rele vəziyyətində retain istifadə edirik ki, Home Assistant yenidən başlayanda son dəyəri 30 saniyə gözləmədən görsün. Zamanlama da millis() ilə aparılır: loop() daxilində uzun delay() olsaydı keep-alive paketləri gecikərdi, broker əlaqəni kəsərdi. Bu texnikanı Arduino millis() və delay() fərqi yazısında ətraflı izah etdik.

Komanda mövzularına heç vaxt retain bayrağı ilə mesaj göndərmə. "ev/salon/role/komut" mövzusunda retain-li bir "ON" qalarsa, ESP32 elektrik kəsintisindən və ya Wi-Fi qopmasından sonra hər yenidən qoşulanda bu köhnə komandanı yenidən alır və releni gecənin yarısı özbaşına açır. Səhvən retain-li komanda göndərmisənsə, mosquitto_pub -r -n -t ev/salon/role/komut əmri ilə boş retain mesajı yayımlayaraq onu silə bilərsən. Home Assistant-ın MQTT açarları komandaları standart olaraq retain-siz göndərir.

Home Assistant-da görünüş: MQTT Discovery

Home Assistant homeassistant/ prefiksi ilə başlayan mövzuları daima dinləyir. Cihaz homeassistant/[növ]/[düyün]/[obyekt]/config formatlı mövzuya JSON konfiqurasiyası yayımlayanda Home Assistant həmin varlığı özbaşına yaradır; buna MQTT Discovery deyilir. Bizim kodumuz üç mesaj göndərir: iki sensor (temperatur və rütubət) üçün homeassistant/sensor/esp32-salon/... və rele üçün homeassistant/switch/esp32-salon/role/config. Mesajlar retain-li olduğu üçün Home Assistant yenidən başlayanda belə itmir. Bundan əlavə, kod homeassistant/status mövzusuna abunədir: Home Assistant açılanda ora "online" yazır və ESP32 təqdimatı yeniləyir. Home Assistant sənədləri çoxlu cihaz varsa, bu yenidən təqdimatın kiçik təsadüfi gecikmə ilə edilməsini tövsiyə edir.

JSON sahəsiMənasıBizim dəyərimiz
nameVarlığın görünən adı; əvvəlinə cihaz adı əlavə olunurSıcaklık (Salon ESP32 Sıcaklık kimi görünür)
unique_idVarlığın dəyişməyən kimliyi; olmasa varlığın adı və otağı interfeysdən redaktə edilə bilməzesp32-salon_sicaklik
state_topicDəyərin oxunacağı mövzuev/salon/sicaklik
command_topicAçar (switch) komandalarının göndəriləcəyi mövzuev/salon/role/komut
device_classİkonu, vahid seçimlərini və qrafik növünü müəyyən edirtemperature, humidity
unit_of_measurementÖlçü vahidi°C və %
state_classmeasurement dəyəri uzunmüddətli statistika və qrafik saxlanmasını təmin edirmeasurement
availability_topiconline/offline vəziyyətinin oxunacağı mövzu; standart yüklər online və offline-dırev/salon/baglanti
deviceVarlıqları tək cihaz kartında toplayıridentifiers, name, model

Kodu yüklədikdən bir neçə saniyə sonra Ayarlar > Cihazlar və xidmətlər > MQTT səhifəsində "Salon ESP32" adlı cihaz görünür. Cihaz kartında temperatur və rütubət sensorları ilə rele açarı olur; temperatura toxunanda tarixçə qrafiki açılır, açara basanda rele işə düşür. Bu varlıqları panelə (dashboard) əlavə edə, səsli köməkçilərə aça və ya avtomatlaşdırmalarda istifadə edə bilərsən: məsələn, "salon temperaturu 27 °C-ni keçsə, ventilyatorun qoşulduğu releni aç, 25 °C-dən aşağı düşəndə bağla" qaydası bir neçə kliklə qurulur. ESP32-nin fişini çıxaranda ən geci 22 saniyə sonra varlıqlar "Əlçatmaz" vəziyyətinə keçir; bu, son vəsiyyət mesajının işlədiyini göstərir. Discovery istifadə etmək istəmirsənsə, eyni varlıqları configuration.yaml faylında mqtt: başlığı altında sensor və switch kimi əllə də təyin edə bilərsən.

Cihazın adını və ya mövzularını dəyişmisənsə və Home Assistant-da köhnə varlıqlar qalıbsa, müvafiq config mövzusuna boş retain mesajı göndər: mosquitto_pub -r -n -t homeassistant/sensor/esp32-salon/sicaklik/config. Home Assistant varlığı silir, cihaza bağlı başqa varlıq qalmayıbsa cihazı da aradan qaldırır. Hər ESP32-yə fərqli ISTEMCI_ID verəndə unique_id-lər də özbaşına fərqli olur və bir neçə otağı qarışıqlıq olmadan əlavə edə bilərsən.

QoS və retain: hansı nə vaxt istifadə olunur?

QoS (Quality of Service) mesajın qarşı tərəfə çatdığından nə dərəcədə əmin olmaq istədiyini müəyyən edir. Vacib təfərrüat: QoS iki ayrı yolda ayrıca tətbiq olunur. Yayımlayan ilə broker arasında yayımlayanın seçdiyi QoS, broker ilə abunəçi arasında isə abunəliyin QoS-u keçərlidir; abunəçinin aldığı mesajın zəmanəti bu ikisindən aşağı olanıdır. PubSubClient yayımlarda yalnız QoS 0-ı, abunəliklərdə QoS 0 və 1-i dəstəkləyir. Ev daxili Wi-Fi-da QoS 0 ilə itən mesaj çox nadirdir; yenə də komandalar üçün abunəliyi QoS 1 etmək ucuz sığortadır.

QoSZəmanətNecə işləyir?Nə vaxt istifadə olunur?
0Ən çox bir dəfəMesaj bir dəfə göndərilir, təsdiq gözlənilmir; əlaqə həmin an qopsa itə bilərTez-tez gələn sensor ölçmələri
1Ən azı bir dəfəQəbul edən PUBACK ilə təsdiqləyir, təsdiq gəlməsə mesaj yenidən göndərilir; eyni mesaj iki dəfə gələ bilərRele komandaları, siqnallar
2Dəqiq bir dəfəPUBREC, PUBREL və PUBCOMP ilə dörd addımlı əl sıxma; ən yavaş səviyyəTəkrarın zərərli olduğu sayğac kimi işlər; PubSubClient dəstəkləmir

Retain bayrağı isə çatdırılma ilə yox, yaddaşla bağlıdır: broker hər mövzunun yalnız son retain-li mesajını saxlayır və həmin mövzuya yeni abunə olan hər kəsə dərhal göndərir. Sensor dəyərləri, rele vəziyyəti və onlayn məlumatı kimi "hazırkı vəziyyət" mesajları üçün idealdır; komandalar və birdəfəlik hadisələr üçün isə təhlükəlidir. Son vəsiyyət (LWT) bunun tamamlayıcısıdır: broker klientdən keep-alive müddətinin 1,5 qatı boyunca heç bir paket gəlməsə, əlaqənin kəsildiyinə qərar verir və vəsiyyət mesajını yayımlayır. PubSubClient-in standart keep-alive müddəti 15 saniyədir, yəni fişi çıxarılan ESP32 ən geci təxminən 22 saniyə sonra "offline" görünür. Bu müddəti mqtt.setKeepAlive(30) kimi sətirlə dəyişə bilərsən, amma uzatdıqca qopmanı daha gec hiss edərsən.

ESPHome ilə kodsuz alternativ

ESPHome YAML faylı ilə təsvir etdiyin cihazı ESP32 üçün hazır proqram təminatına çevirən pulsuz alətdir; bir sətir də C++ yazmırsan. Home Assistant-da Ayarlar > Tətbiqlər bölməsindən ESPHome Device Builder-i quraşdır, interfeysini aç və Yeni cihaz sehrbazı ilə konfiqurasiya yarat. İlk yükləmə bir dəfə USB kabeli ilə edilir: Chrome və ya Edge brauzeri platanı birbaşa proqramlaşdıra bilər, alınmasa sehrbazın endirdiyi faylı ESPHome Web səhifəsi ilə yükləyə bilərsən. Sonrakı bütün yeniləmələr Wi-Fi üzərindən simsiz (OTA) gedir. Aşağıdakı konfiqurasiya yuxarıdakı Arduino layihəsinin eynisidir: GPIO 4-dəki DHT22-ni 30 saniyədən bir oxuyur və GPIO 26-dakı aktiv LOW releni açar kimi təqdim edir. Wi-Fi və şifrə məlumatları !secret ilə ayrıca secrets.yaml faylından oxunur:

Kod
1esphome:
2  name: salon-sensor               # küçük harf, rakam ve tire / lowercase, digits and hyphens
3  friendly_name: Salon Sensör
4
5esp32:
6  board: esp32dev
7
8logger:
9
10api:                               # Home Assistant ile doğrudan bağlantı / direct link to Home Assistant
11  encryption:
12    key: !secret api_anahtari
13
14ota:
15  - platform: esphome
16    password: !secret ota_sifresi
17
18wifi:
19  ssid: !secret wifi_ssid
20  password: !secret wifi_sifresi
21  ap:                              # Wi-Fi yoksa kendi ağını açar / opens its own network if Wi-Fi fails
22    ssid: "Salon-Sensor"
23    password: "yedek1234"
24
25captive_portal:
26
27sensor:
28  - platform: dht
29    pin: GPIO4
30    model: DHT22
31    update_interval: 30s
32    temperature:
33      name: "Sıcaklık"
34    humidity:
35      name: "Nem"
36
37switch:
38  - platform: gpio
39    name: "Röle"
40    pin:
41      number: GPIO26
42      inverted: true               # aktif LOW röle / active-LOW relay
43    restore_mode: ALWAYS_OFF       # açılışta kapalı / off at boot
44
45# MQTT ile kullanmak için api: bloğunu sil, bunu aç / to use MQTT, delete api: and uncomment this
46# mqtt:
47#   broker: 192.168.1.10
48#   username: esp32
49#   password: !secret mqtt_sifresi

Diqqət etməli olduğun bir fərq var: ESPHome standart olaraq MQTT yox, öz şifrələnmiş native API-sindən istifadə edir. Home Assistant cihazı şəbəkədə özbaşına tapır və broker-ə heç ehtiyac duymur. MQTT-ni yalnız Node-RED kimi başqa sistemlərin də eyni məlumatı oxumasını istəyirsənsə və ya Home Assistant istifadə etmirsənsə seçməlisən. Bunun üçün faylın sonundakı mqtt: sətirlərini aç və api: blokunu sil; silməsən, native API-yə 15 dəqiqə ərzində heç kim qoşulmayanda cihaz özünü yenidən başladır (bu müddət reboot_timeout ayarıdır). MQTT rejimində ESPHome Home Assistant kəşf mesajlarını və salon-sensor/status mövzusundakı online/offline mesajlarını özü göndərir; yəni bizim Arduino kodunda əllə etdiyimiz hər şeyi avtomatik edir.

XüsusiyyətPubSubClient (Arduino kodu)ESPHome (YAML)
Kod yazmaqHər şeyi C++ ilə özün yazırsanYalnız YAML; proqram təminatı avtomatik kompilyasiya olunur
Home Assistant-a əlavə etməKəşf JSON-larını özün göndərirsənÖzbaşına tapılır
ÇeviklikLimitsiz; hər kitabxana və məntiq istifadə oluna bilərHazır komponentlərlə məhduddur, amma yüzlərlə sensor dəstəklənir; lazım olsa lambda ilə C++ əlavə olunur
Simsiz yeniləməArduinoOTA-nı koda özün əlavə edirsənHazır gəlir
Broker tələbiLazımdırNative API ilə lazım deyil
Öyrənmə dəyəriMQTT protokolunu və proqramlaşdırmanı öyrədirTez nəticə verir, arxa planı gizlədir

ESP8266 və Raspberry Pi Pico W ilə MQTT

Yuxarıdakı tam kod ESP8266 NodeMCU və Wemos D1 Mini platalarında olduğu kimi işləyir: Tools > Board menyusundan NodeMCU 1.0 seçəndə #if defined(ESP8266) bloku WiFi.h əvəzinə ESP8266WiFi.h faylını və D2, D1 pinlərini özbaşına seçir. Raspberry Pi Pico W tərəfdə isə MicroPython-un umqtt.simple modulundan istifadə edirik. Bu modul Pico W-nın MicroPython proqram təminatında hazır gəlmir; Thonny-də Tools > Manage packages menyusundan umqtt.simple axtararaq və ya Wi-Fi-a qoşulu ikən komanda sətrində import mip; mip.install("umqtt.simple") yazaraq quraşdıra bilərsən. DHT22 üçün lazım olan dht modulu isə proqram təminatı ilə birlikdə gəlir. Aşağıdakı kod mətbəxə qoyduğun Pico W-nın eyni ölçmə və rele işini görməsini təmin edir. Kod qısa qalsın deyə kəşf mesajlarını əlavə etmədik; Pico W-nı Home Assistant-da görmək üçün ESP32 kodundakı kəşf JSON-larını ev/mutfak mövzuları ilə yayımlaya və ya varlıqları configuration.yaml faylında mqtt: başlığı altında əllə təyin edə bilərsən. Faylı main.py adı ilə yadda saxlasan, plata hər açılanda işləyir:

MicroPython
1import network, time, dht
2from machine import Pin
3from umqtt.simple import MQTTClient    # önce mip ile kur / install with mip first
4
5WIFI_SSID = "AgAdi"                    # Wi-Fi adın / your Wi-Fi name
6WIFI_PASS = "Sifre123"                 # Wi-Fi şifren / your Wi-Fi password
7MQTT_SUNUCU = "192.168.1.10"           # broker IP / broker IP
8ISTEMCI_ID = "pico-mutfak"             # benzersiz olmalı / must be unique
9
10T_SICAKLIK = b"ev/mutfak/sicaklik"
11T_NEM = b"ev/mutfak/nem"
12T_KOMUT = b"ev/mutfak/role/komut"
13T_DURUM = b"ev/mutfak/role/durum"
14T_BAGLANTI = b"ev/mutfak/baglanti"
15
16sensor = dht.DHT22(Pin(15))            # DHT22 DATA -> GP15
17role = Pin(14, Pin.OUT, value=1)       # aktif LOW röle kapalı başlar / active-LOW relay starts off
18led = Pin("LED", Pin.OUT)              # Pico W dahili LED / Pico W onboard LED
19
20wlan = network.WLAN(network.STA_IF)
21wlan.active(True)
22wlan.connect(WIFI_SSID, WIFI_PASS)
23while not wlan.isconnected():
24    time.sleep(0.5)
25print("IP:", wlan.ifconfig()[0])
26
27def mesaj_geldi(konu, mesaj):          # ikisi de bytes gelir / both arrive as bytes
28    if konu == T_KOMUT and mesaj in (b"ON", b"OFF"):
29        acik = mesaj == b"ON"
30        role.value(0 if acik else 1)
31        led.value(1 if acik else 0)
32        istemci.publish(T_DURUM, mesaj, retain=True)
33
34istemci = MQTTClient(ISTEMCI_ID, MQTT_SUNUCU, user="esp32", password="mqttSifre", keepalive=60)   # Mosquitto kullanıcısı / Mosquitto user
35istemci.set_callback(mesaj_geldi)
36istemci.set_last_will(T_BAGLANTI, b"offline", retain=True)   # son vasiyet / last will
37
38def baglan():
39    while True:
40        try:
41            if not wlan.isconnected():         # Wi-Fi koptuysa yeniden bağlan / reconnect Wi-Fi if it dropped
42                wlan.connect(WIFI_SSID, WIFI_PASS)
43                time.sleep(5)
44            istemci.connect()
45            istemci.publish(T_BAGLANTI, b"online", retain=True)
46            istemci.publish(T_DURUM, b"OFF" if role.value() else b"ON", retain=True)
47            istemci.subscribe(T_KOMUT)
48            print("MQTT baglandi")
49            return
50        except Exception as e:         # MQTTException(5): yetki yok / not authorized
51            print("MQTT hatasi:", e)
52            time.sleep(5)
53
54baglan()
55son = time.ticks_add(time.ticks_ms(), -30000)   # ilk ölçüm hemen / first reading right away
56while True:
57    try:
58        istemci.check_msg()            # bekleyen komut var mı? / any pending command?
59        if time.ticks_diff(time.ticks_ms(), son) >= 30000:
60            son = time.ticks_ms()
61            try:
62                sensor.measure()
63            except OSError:
64                print("DHT22 okunamadi")
65                istemci.ping()         # veri yoksa da bağlantıyı canlı tut / keep the link alive without data
66            else:
67                istemci.publish(T_SICAKLIK, "{:.1f}".format(sensor.temperature()).encode(), retain=True)
68                istemci.publish(T_NEM, "{:.0f}".format(sensor.humidity()).encode(), retain=True)
69    except OSError:
70        print("Baglanti koptu, yeniden baglaniliyor")
71        time.sleep(5)
72        baglan()
73    time.sleep_ms(100)

ESP32 MQTT layihə ideyaları

  • Otaq-otaq temperatur xəritəsi: Hər otağa ESP32 ilə DHT22 və ya BME280 qoy, ev/+/sicaklik abunəliyi ilə bütün evi tək qrafikdə izlə.
  • Ağıllı lampa və rozetka: Releni Home Assistant avtomatlaşdırmasına qoş; gün batanda yandır, gecə yarısı söndür.
  • Qapı və pəncərə sensoru: Reed rele ilə qapı açılanda MQTT-yə mesaj göndər, evdə heç kim olmayanda telefona bildiriş al.
  • Hərəkətlə yanan dəhliz işığı: PIR sensoru hərəkəti yayımlasın, işığı Home Assistant avtomatlaşdırması yandırsın.
  • Bitki suvarma stansiyası: Torpaq rütubət sensorunun dəyərini yayımla, rütubət düşəndə nasosu MQTT komandası ilə işə sal.
  • Enerji monitorinqi: ACS712 cərəyan sensoru ilə cihazın çəkdiyi cərəyanı ölç və gündəlik istehlakı qrafiklə göstər.
  • Batareya ilə işləyən sensor: Ölçüb MQTT-yə göndərən, sonra yuxuya dalan düyün qur; təfərrüatlar ESP32 Deep Sleep yazısındadır.

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

Əlamət və ya mesajSəbəbHəll
Daim rc=-2Broker IP-si və ya portu səhvdir, broker bağlıdır və ya Mosquitto yalnız lokal rejimdədirIP-ni yoxla, konfiqurasiyaya listener 1883 əlavə et, firewall-da 1883 portuna icazə ver
rc=5İstifadəçi adı və ya şifrə səhvdir, ya da şifrəsiz qoşulmağa çalışılırŞifrəni kompüterdən mosquitto_sub ilə yoxla; lazım olsa istifadəçini yenidən yarat
Qoşulur, bir neçə saniyəyə qopur, dövr davam edirİki cihaz eyni client ID istifadə edir; Mosquitto jurnala "Client esp32-salon already connected, closing old connection." yazırHər cihaza unikal ISTEMCI_ID ver
Kəşf mesajları getmir, publish() false qaytarırPubSubClient buferi standart olaraq 256 baytdır, JSON sığmırsetup() daxilində mqtt.setBufferSize(1024) çağır
Tez-tez rc=-3loop() daxilində uzun delay() var, keep-alive göndərilə bilmir və ya Wi-Fi siqnalı zəifdirZamanlamanı millis() ilə et, platanı modemə yaxınlaşdır
Komandalar ESP32-yə çatmırMövzu adında hərf fərqi var və ya subscribe() yenidən qoşulanda təkrarlanmırMövzunu mosquitto_sub ilə yoxla; subscribe() sətirlərini qoşulma funksiyasının içinə qoy
Rele açılışda özbaşına açılırKomanda mövzusunda retain-li köhnə mesaj dururmosquitto_pub -r -n -t ev/salon/role/komut ilə retain mesajını sil
Home Assistant-da varlıqlar "Əlçatmaz" göstəriliravailability mövzusunda offline var və ya online yazılışı fərqlidirev/salon/baglanti mövzusunu dinlə; kodun qoşulanda online yayımladığına əmin ol
Dəyər əvəzinə mənasız simvollarPayload \0 ilə bitmir, length istifadə edilmədən oxunubPayload-u length qədər dövrlə kopyala
ESPHome cihazı hər 15 dəqiqədən bir yenidən başlayırMQTT rejimində api: bloku durur, amma Home Assistant qoşulmurapi: blokunu sil və ya reboot_timeout: 0s əlavə et
Problem axtararkən ardıcıllığı qoru: əvvəlcə Serial Monitor-da Wi-Fi əlaqəsini və IP ünvanını gör, sonra kompüterdə mosquitto_sub -v -t "#" ilə broker-ə həqiqətən nə gəldiyini izlə, ən sonda Home Assistant-a bax. Mesaj broker-də görünür, amma Home Assistant-da görünmürsə, problem kəşf JSON-undadır; broker-ə heç gəlmirsə, ESP32 tərəfindədir. Wi-Fi mərhələsində ilişirsənsə ESP32 Wi-Fi-a qoşulmur, plata rele işə düşəndə yenidən başlayırsa ESP32 Brownout və Guru Meditation bələdçisinə bax.

Bir broker, bir neçə mövzu və PubSubClient ilə ESP32-n artıq evin qalan hissəsi ilə eyni dildə danışan ağıllı ev cihazına çevrildi. Eyni quruluşa yeni sensorlar, başqa otaqlar və Pico W kimi fərqli platalar əlavə edə, hamısını Home Assistant-dan tək paneldə idarə edə bilərsən. BlueGrays tətbiqində ESP32 Wi-Fi əlaqəsi, DHT22 ilə temperatur və rütubət ölçmə, PIR və releli ağıllı işıqlandırma, WebSocket ilə real vaxt idarəsi və ağıllı bitki suvarma kimi layihələri dövrə sxemləri və kodları ilə addım-addım tapa bilərsən.

Tez-tez verilən suallar

MQTT nədir, nəyə yarayır?

MQTT cihazların broker vasitəsilə mövzu (topic) adları ilə mesaj alıb-verdiyi yüngül mesajlaşma protokoludur. Az ötürmə zolağı və az enerji sərf etdiyi üçün ESP32 kimi kiçik cihazların sensor məlumatı göndərməsi və komanda alması üçün idealdır. Home Assistant, Node-RED və sənaye IoT sistemlərinin çoxu MQTT ilə danışır.

MQTT hansı portdan istifadə edir?

Şifrəsiz MQTT standart olaraq 1883, TLS ilə şifrələnmiş MQTT isə 8883 portundan istifadə edir. Brauzerdən qoşulmaq üçün istifadə olunan WebSocket portu broker-ə görə dəyişir; Home Assistant-dakı Mosquitto broker-də bu port 1884-dür. ESP32 ev şəbəkəsində adətən 1883-ə qoşulur.

MQTT üçün internet lazımdırmı?

Xeyr. Broker evdəki Raspberry Pi-də və ya Home Assistant-da işləyirsə, ESP32 ilə broker arasındakı trafik tamamilə lokal şəbəkədə qalır; internet kəsilsə belə sensorlar və relelər işləməyə davam edir. İnternet yalnız evdən kənardan giriş etmək və ya bulud əsaslı broker istifadə etmək istəyəndə lazım olur.

ESP32 niyə Home Assistant-da görünmür?

Ən çox rast gəlinən səbəblər kəşf mesajının 256 baytlıq PubSubClient buferinə sığmaması, config mövzusunun yanlış yazılması və ya JSON-da dırnaq xətasıdır. mosquitto_sub ilə homeassistant/# mövzusunu dinləyərək mesajın broker-ə gəlib-gəlmədiyini yoxla və kodda mqtt.setBufferSize(1024) sətrinin olduğuna əmin ol. Home Assistant-dakı MQTT inteqrasiyasının da eyni broker-ə qoşulu olması lazımdır.

ESPHome, yoxsa Arduino ilə MQTT istifadə etməliyəm?

Məqsədin işləyən ağıllı ev cihazını tez qurmaqdırsa, ESPHome daha az əziyyət verir: YAML yazırsan, cihaz Home Assistant-da özbaşına görünür və simsiz yenilənir. MQTT protokolunu öyrənmək, öz məntiqini yazmaq və ya Home Assistant-dan kənar sistemlərlə işləmək istəyirsənsə, Arduino və PubSubClient daha çevikdir. İkisi eyni evdə problemsiz birlikdə istifadə oluna bilər.

MQTT QoS 0, 1 və 2 arasında fərq nədir?

QoS 0 mesajı bir dəfə göndərir və təsdiq gözləmir, QoS 1 təsdiq gələnə qədər təkrar göndərir, amma mesaj iki dəfə çata bilər, QoS 2 isə dörd addımlı əl sıxma ilə mesajın dəqiq bir dəfə çatmasına zəmanət verir. Sensor ölçmələri üçün QoS 0, komandalar üçün QoS 1 kifayətdir. PubSubClient yalnız QoS 0 ilə yayım edə bilir və QoS 0 və ya 1 ilə abunə ola bilir.

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)
107
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 DHT22 temperatur və rütubət (LCD ekranlı)
ES-15Orta

ESP32 DHT22 temperatur və rütubət (LCD ekranlı)

DHT22 sensoru ilə mühitin temperaturunu və rütubət nisbətini ölçüb 16x2 I2C LCD ekranda real vaxtda göstərən layihədir. Adafruit DHT kitabxanasından istifadə edilərək tək naqilli (one-wire) protokolla sensordan məlumat oxunur. Bu layihə IoT hava stansiyası, ağıllı ev avtomatlaşdırması və ya istixanalarda mühit izləmə sistemlərinin əsasını təşkil edir. DHT22 ilə əlaqə ESP32-nin GPIO 4 pini üzərindən təmin olunur.

4.8(38)
57
ESP32 ağıllı işıqlandırma (PIR + LDR + Rele + OLED)
ES-37Qabaqcıl
Premium

ESP32 ağıllı işıqlandırma (PIR + LDR + Rele + OLED)

ESP32, PIR hərəkət sensoru, LDR işıq sensoru və rele modulu ilə evinin dəhlizini, tualetini və ya kilerini ağıllı işıqlandırmaya çeviririk. Mühit işıqlıdırsa, hərəkət olsa belə işıq yanmır; beləliklə gündüz boş yerə enerji sərf olunmur. İşıq 30 saniyə açıq qalır; hərəkət davam edərsə, müddət avtomatik uzanır.

4.3(6)
11
ESP32 WebSocket sayğac (2 düymə + LCD + veb real vaxt)
ES-28Qabaqcıl
Premium

ESP32 WebSocket sayğac (2 düymə + LCD + veb real vaxt)

Bu layihədə ESP32-yə qoşulu iki düymə ilə (GPIO 5 artırır, GPIO 4 azaldır) sayğac dəyişdirilir. Dəyər həm 16x2 I2C LCD-də, həm də ESPAsyncWebServer-in WebSocket dəstəyi ilə qoşulu bütün brauzerlərdə dərhal yenilənir; səhifəni yeniləmək lazım deyil. HTTP polling əvəzinə tək daimi əlaqə istifadə olunur və ESP32 yeni dəyəri ws.textAll() ilə hamıya göndərir.

4.5(14)
23
ESP32 mDNS: bluegrays-esp.local ilə cihaza giriş (LCD ekranlı)
ES-29Qabaqcıl
Premium

ESP32 mDNS: bluegrays-esp.local ilə cihaza giriş (LCD ekranlı)

Bu layihədə ESP32-yə mDNS (Multicast DNS) xidməti əlavə edərək IP ünvanı əvəzinə bluegrays-esp.local kimi oxunaqlı host adı ilə giriş təmin edirik. DHCP-nin verdiyi IP dəyişsə belə cihaza həmişə eyni adla çatırsan. Platada işləyən kiçik veb serverlə LED-i brauzerdən http://bluegrays-esp.local/ ünvanı ilə idarə edirsən.

4.8(14)
23
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