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 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ə |
|---|---|---|
| Broker | Mesajları qəbul edib abunəçilərə paylayan server | Mosquitto, Home Assistant-dakı Mosquitto broker |
| Klient (client) | Broker-ə qoşulan hər cihaz və ya proqram; unikal kimliyi (client ID) olur | ESP32, Home Assistant, MQTT Explorer |
| Topic (mövzu) | Mesajın ünvanı; maili xəttlə ayrılmış səviyyələrdən ibarətdir | ev/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ək | ESP32-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ər | ON, 23.4, {"sicaklik":23.4} |
| Retain | Broker-in mövzudakı son mesajı saxlayıb yeni abunəçilərə dərhal verməsi | Rele vəziyyəti: ON |
| LWT (son vəsiyyət) | Klient xəbərsiz qopanda broker-in onun adından yayımladığı mesaj | ev/salon/baglanti: offline |
| QoS | Mesajı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 Assistant | Lokal və sürətli, ikitərəfli; yüzlərlə cihaz bir paneldə, avtomatlaşdırma qurmaq olur | Broker qurmaq lazımdır | Bütün evi bir mərkəzdən idarə etmək |
| ESP32 veb server | Əlavə server lazım deyil, brauzerdən açılır | Hər cihazın ayrıca səhifəsi olur, cihazlar arasında avtomatlaşdırma yoxdur | Tək cihazlıq idarəetmə paneli |
| Blynk IoT | Hazır telefon paneli, internetdən giriş | Buluddan asılıdır, pulsuz planda limitlər var | Sürətli mobil prototip |
| Telegram botu | Pulsuz ani bildiriş, port açmaq lazım deyil | Qrafik və panel yoxdur | Siqnal və sadə komandalar |
| ESP-NOW | Modem və broker olmadan ESP-lər arasında əlaqə | Yalnız ESP platalar arasında, Home Assistant-a birbaşa çatmır | Batareya 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:
| Topic | Yayımlayan | Dinləyən | Retain |
|---|---|---|---|
| ev/salon/sicaklik | ESP32 (30 saniyədən bir) | Home Assistant | Bəli |
| ev/salon/nem | ESP32 (30 saniyədən bir) | Home Assistant | Bəli |
| ev/salon/role/komut | Home Assistant, telefon, avtomatlaşdırmalar | ESP32 | Xeyr |
| ev/salon/role/durum | ESP32 (hər dəyişiklikdə) | Home Assistant | Bəli |
| ev/salon/baglanti | ESP32 (online), broker (offline) | Home Assistant | Bəli |
| homeassistant/status | Home Assistant (açılışda online) | ESP32 | Xeyr |
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:
- 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ç.
- 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.
- 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ə.
- 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.
- 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ətir | Mənası |
|---|---|
| listener 1883 | Bü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/passwd | mosquitto_passwd ilə yaratdığın şifrə faylından istifadə edir; şifrələr faylda hash şəklində saxlanılır |
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.
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.



| Qoşulma | ESP32 | ESP8266 (NodeMCU) | Raspberry Pi Pico W |
|---|---|---|---|
| DHT22 VCC | 3V3 | 3V3 | 3V3(OUT) |
| DHT22 DATA | GPIO 4 | D2 (GPIO 4) | GP15 |
| DHT22 GND | GND | GND | GND |
| Rele VCC | VIN (5V) | VIN (5V) | VBUS (5V) |
| Rele IN | GPIO 26 | D1 (GPIO 5) | GP14 |
| Rele GND | GND | GND | GND |
Arduino IDE-də PubSubClient quraşdırılması
- 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.
- 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.
- 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.
- 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ç:
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:
| rc | PubSubClient adı | Mənası və həlli |
|---|---|---|
| -4 | MQTT_CONNECTION_TIMEOUT | Broker vaxtında cavab vermədi; şəbəkə zəifdir və ya broker həddindən artıq yüklənib |
| -3 | MQTT_CONNECTION_LOST | Qurulmuş əlaqə kəsildi; çox vaxt loop() uzun müddət çağırılmadığı və ya Wi-Fi getdiyi üçün |
| -2 | MQTT_CONNECT_FAILED | TCP ə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 |
| -1 | MQTT_DISCONNECTED | Əlaqə düzgün şəkildə bağlandı (disconnect çağırıldı) və ya hələ heç qoşulmayıb |
| 2 | MQTT_CONNECT_BAD_CLIENT_ID | Klient kimliyi rədd edildi; boş və ya yanlış client ID istifadə olunub |
| 4 | MQTT_CONNECT_BAD_CREDENTIALS | İstifadəçi adı və ya şifrə səhvdir (bəzi broker-lər bu kodu qaytarır) |
| 5 | MQTT_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.
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ətir | Və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.
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əsi | Mənası | Bizim dəyərimiz |
|---|---|---|
| name | Varlığın görünən adı; əvvəlinə cihaz adı əlavə olunur | Sıcaklık (Salon ESP32 Sıcaklık kimi görünür) |
| unique_id | Varlığın dəyişməyən kimliyi; olmasa varlığın adı və otağı interfeysdən redaktə edilə bilməz | esp32-salon_sicaklik |
| state_topic | Dəyərin oxunacağı mövzu | ev/salon/sicaklik |
| command_topic | Açar (switch) komandalarının göndəriləcəyi mövzu | ev/salon/role/komut |
| device_class | İkonu, vahid seçimlərini və qrafik növünü müəyyən edir | temperature, humidity |
| unit_of_measurement | Ölçü vahidi | °C və % |
| state_class | measurement dəyəri uzunmüddətli statistika və qrafik saxlanmasını təmin edir | measurement |
| availability_topic | online/offline vəziyyətinin oxunacağı mövzu; standart yüklər online və offline-dır | ev/salon/baglanti |
| device | Varlıqları tək cihaz kartında toplayır | identifiers, 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.
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.
| QoS | Zəmanət | Necə 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ər | Tez-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ər | Rele komandaları, siqnallar |
| 2 | Də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:
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_sifresiDiqqə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ət | PubSubClient (Arduino kodu) | ESPHome (YAML) |
|---|---|---|
| Kod yazmaq | Hər şeyi C++ ilə özün yazırsan | Yalnı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 |
| Çeviklik | Limitsiz; hər kitabxana və məntiq istifadə oluna bilər | Hazı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ən | Hazır gəlir |
| Broker tələbi | Lazımdır | Native API ilə lazım deyil |
| Öyrənmə dəyəri | MQTT protokolunu və proqramlaşdırmanı öyrədir | Tez 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:
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 mesaj | Səbəb | Həll |
|---|---|---|
| Daim rc=-2 | Broker IP-si və ya portu səhvdir, broker bağlıdır və ya Mosquitto yalnız lokal rejimdədir | IP-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ır | Hər cihaza unikal ISTEMCI_ID ver |
| Kəşf mesajları getmir, publish() false qaytarır | PubSubClient buferi standart olaraq 256 baytdır, JSON sığmır | setup() daxilində mqtt.setBufferSize(1024) çağır |
| Tez-tez rc=-3 | loop() daxilində uzun delay() var, keep-alive göndərilə bilmir və ya Wi-Fi siqnalı zəifdir | Zamanlamanı millis() ilə et, platanı modemə yaxınlaşdır |
| Komandalar ESP32-yə çatmır | Mövzu adında hərf fərqi var və ya subscribe() yenidən qoşulanda təkrarlanmır | Mö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ır | Komanda mövzusunda retain-li köhnə mesaj durur | mosquitto_pub -r -n -t ev/salon/role/komut ilə retain mesajını sil |
| Home Assistant-da varlıqlar "Əlçatmaz" göstərilir | availability mövzusunda offline var və ya online yazılışı fərqlidir | ev/salon/baglanti mövzusunu dinlə; kodun qoşulanda online yayımladığına əmin ol |
| Dəyər əvəzinə mənasız simvollar | Payload \0 ilə bitmir, length istifadə edilmədən oxunub | Payload-u length qədər dövrlə kopyala |
| ESPHome cihazı hər 15 dəqiqədən bir yenidən başlayır | MQTT rejimində api: bloku durur, amma Home Assistant qoşulmur | api: blokunu sil və ya reboot_timeout: 0s əlavə et |
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.
Bu yazıdan sonra edə biləcəyin layihələr
Bütün layihələrə bax
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.

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 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.

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.

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.

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.

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.
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ç

