MQTT Discovery în Home Assistant pentru un contor de energie

MQTT Discovery în Home Assistant pentru un contor de energie

MQTT Discovery în Home Assistant permite unui contor de energie să își creeze automat dispozitivul și entitățile de senzor. După ce contorul și Home Assistant se conectează la același broker MQTT, Home Assistant poate descoperi contorul fără YAML manual pentru senzorii MQTT.

IAMMETER acceptă MQTT Discovery pe toate contoarele de energie actuale. În funcție de model, Home Assistant creează entități pentru tensiune, curent, putere activă, energie importată, energie exportată și alte măsurători disponibile pe fază sau pe canal.

Utilizați această metodă atunci când doriți:

• monitorizare locală a energiei prin MQTT;
• creare automată a dispozitivului și a entităților;
• actualizări mai rapide decât integrările HTTP;
• entități de energie importată/exportată compatibile cu Energy Dashboard;
• configurare minimă în Home Assistant.

Dacă aveți nevoie de control complet asupra topic-urilor, șabloanelor, numelor de entități și metadatelor, utilizați în schimb ghidul manual pentru contorul de energie MQTT.

MQTT Discovery versus MQTT manual

Ambele metode necesită un broker MQTT, dar numai Discovery creează automat entități în Home Assistant.

Nu activați Discovery și nu definiți manual aceleași măsurători, cu excepția cazului în care doriți în mod deliberat două seturi separate de entități.

Cerințe

Aveți nevoie de:

• un contor de energie IAMMETER cu firmware i.76.058.8 sau mai recent;
• un broker MQTT accesibil pentru contor și Home Assistant;
• adresa brokerului, portul, numele de utilizator și parola;
• Home Assistant cu integrarea MQTT activată.

Firmware-ul i.76.058.8 este versiunea stabilă de referință pentru MQTT Discovery. Versiunea anterioară i.76.02 a fost un firmware de testare și nu mai trebuie instalată sau recomandată ca versiune.

Pentru remedieri actuale și cele mai recente opțiuni MQTT, faceți upgrade la cel mai recent firmware IAMMETER.

Pasul 1: Conectați Home Assistant la brokerul MQTT

Dacă Home Assistant nu este deja conectat la broker:

1. Deschideți Settings → Devices & services.
2. Selectați Add integration.
3. Căutați MQTT.
4. Introduceți adresa brokerului, portul, numele de utilizator și parola.
5. Confirmați că integrarea MQTT se conectează cu succes.

Dacă Home Assistant utilizează deja brokerul dorit, păstrați integrarea MQTT existentă. Nu creați o a doua conexiune la broker pentru dispozitivul IAMMETER.

MQTT Discovery este activat implicit într-o configurare MQTT normală a Home Assistant. Dacă discovery a fost dezactivat sau se folosește un prefix de discovery non-standard, asigurați-vă că contorul și Home Assistant utilizează setări compatibile.

Pasul 2: Configurați MQTT Discovery în WebUI-ul contorului

Deschideți WebUI-ul local al contorului și accesați Settings. Configurați:

Salvați setările și permiteți contorului să repornească sau să se reconecteze.

Cel mai recent firmware expune setările necesare în WebUI. Nu este necesar să apelați endpoint-ul istoric /api/mqttha?x=1.

Opțiunea HA MQTT Discovery este destinată în mod specific descoperirii automate în Home Assistant. Pentru un broker general, un sistem personalizat, un flux Node-RED sau o configurare MQTT manuală, lăsați-o dezactivată și utilizați în schimb formatul standard de publicare MQTT al contorului.

Pasul 3: Confirmați că Home Assistant descoperă contorul

După ce contorul se conectează la broker:

1. Deschideți Settings → Devices & services → MQTT.
2. Căutați un dispozitiv IAMMETER nou descoperit.
3. Deschideți dispozitivul și examinați entitățile.
4. Confirmați că valorile de tensiune, curent, putere și energie sunt plauzibile.
5. Verificați că numărul așteptat de faze sau canale de măsurare este prezent.

Configurarea de discovery și starea măsurătorilor sunt trimise prin topic-uri MQTT diferite. Home Assistant folosește configurarea de discovery pentru a crea entitățile, apoi actualizează valorile acestora atunci când sosesc mesajele de stare.

Dacă dispozitivul nu apare, reporniți doar după ce ați verificat conexiunea la broker și topic-urile. O repornire a Home Assistant nu poate remedia o adresă incorectă a brokerului sau acreditări MQTT respinse.

Suport pentru Energy Dashboard

Sarcinile utile actuale MQTT Discovery de la IAMMETER includ metadatele necesare pentru entitățile de energie importată și exportată:

unit_of_measurement: kWh
device_class: energy
state_class: total_increasing

IAMMETER utilizează cheile compacte MQTT Discovery corespunzătoare acestor câmpuri, inclusiv:

{
  "unit_of_meas": "kWh",
  "dev_cla": "energy",
  "stat_cla": "total_increasing"
}

După ce entitățile primesc date valide:

1. accesați Settings → Dashboards → Energy;
2. selectați entitatea de energie importată pentru consumul din rețea;
3. selectați entitatea de energie exportată pentru injecția în rețea;
4. salvați configurația Energy Dashboard.

Nu selectați o entitate de putere activă instantanee, în wați, pentru un câmp de energie. Energy Dashboard necesită kWh cumulativ.

Modelele monofazate și trifazate creează entități de energie diferite. Alegeți entitățile care corespund cablajului contorului și modului în care instalația măsoară importul/exportul din rețea.

Alegeți un interval de actualizare MQTT

Cel mai recent firmware IAMMETER acceptă actualizări MQTT până la 2 secunde. Un interval mai scurt oferă Home Assistant citiri de putere mai proaspete, dar generează și mai mult trafic pe broker, mai multe actualizări de entități și mai multe date pentru recorder.

Puncte de pornire sugerate:

Utilizați cel mai scurt interval doar atunci când automatizarea beneficiază de el. Totalurile Energy Dashboard nu necesită, în general, actualizări la fiecare două secunde.

Compatibilitate cu IAMMETER Cloud

MQTT Discovery schimbă modul de funcționare (Run Mode) al contorului în MQTT. Contorul trimite măsurătorile către brokerul configurat și nu le mai încarcă simultan în IAMMETER Cloud.

Dacă aveți nevoie de ambele, Home Assistant și IAMMETER Cloud, de la același contor, alegeți în schimb o integrare locală HTTP sau Modbus TCP. Aceste metode citesc contorul local, în timp ce încărcarea normală în Cloud continuă.

Comparați opțiunile în prezentarea generală a integrării contorului de energie în Home Assistant.

Modele IAMMETER acceptate

Toate contoarele de energie IAMMETER actuale acceptă MQTT Discovery. Principala diferență este numărul de faze/canale și, prin urmare, numărul de entități create.

WEM3046T și WEM3046TE măsoară ieșirea secundară de 5 A a transformatoarelor de curent externe. Raportul CT corect trebuie aplicat pentru a obține curentul, puterea și energia de pe partea primară. Aceasta este o cerință a sistemului de măsurare, nu o limitare a Home Assistant sau a MQTT Discovery.

Modelul WEM3162, scos din producție, nu este inclus în domeniul de compatibilitate actual.

Depanarea MQTT Discovery

Home Assistant nu descoperă contorul

• Confirmați că contorul și Home Assistant folosesc același broker.
• Verificați adresa brokerului, portul, numele de utilizator și parola.
• Confirmați că HA MQTT Discovery este activat în WebUI-ul contorului.
• Verificați jurnalele brokerului pentru conexiuni respinse sau erori de autorizare.
• Verificați că integrarea MQTT din Home Assistant este conectată.
• Abonați-vă la prefixul de discovery Home Assistant al brokerului cu un client MQTT și verificați dacă mesajele de configurare sunt prezente.

Dispozitivul apare, dar entitățile nu sunt disponibile

• Confirmați că contorul continuă să publice mesaje de stare după configurarea de discovery.
• Verificați dacă un firewall, o VLAN sau o ACL a brokerului permite atât topic-urile de discovery, cât și cele de stare.
• Verificați că contorul nu a comutat la un alt broker.
• Faceți upgrade la cel mai recent firmware și reconectați.

Energia importată/exportată nu poate fi selectată în Energy Dashboard

• Confirmați că entitatea a primit o valoare numerică validă în kWh.
• Deschideți Developer tools → States și inspectați unitatea, clasa de dispozitiv și clasa de stare.
• Eliminați entitățile perimate create de firmware-ul timpuriu de testare înainte de a evalua sarcinile utile de discovery actuale.
• Confirmați că selectați o entitate de energie, nu o entitate de putere activă.

Apar entități MQTT duplicate

Duplicatele apar de obicei atunci când:

• YAML-ul MQTT manual și MQTT Discovery sunt ambele active;
• numărul de serie al contorului sau ID-ul unic de discovery s-a schimbat;
• firmware-ul timpuriu a publicat o configurare de discovery diferită;
• topic-urile de discovery reținute dintr-o configurare veche rămân pe broker.

Alegeți fie MQTT manual, fie MQTT Discovery pentru aceleași măsurători, apoi eliminați configurarea perimată.

Eliminarea entităților de discovery reținute vechi

Mesajele de configurare MQTT Discovery sunt, de obicei, reținute de broker, astfel încât Home Assistant să poată recrea entitățile după o repornire. Dacă un topic de configurare vechi rămâne, ștergerea dispozitivului doar din interfața Home Assistant poate să nu fie suficientă — entitatea poate reveni atunci când configurarea reținută este primită din nou.

Procedură sigură de curățare:

1. Dezactivați HA MQTT Discovery pe contor sau deconectați-l temporar, astfel încât să nu republice imediat configurarea veche.
2. Utilizați un client MQTT pentru a inspecta prefixul de discovery Home Assistant, în mod normal homeassistant/#.
3. Identificați numai topic-urile de configurare care aparțin numărului de serie/dispozitivului IAMMETER afectat.
4. Publicați un payload reținut gol pe fiecare topic de configurare perimat.
5. Eliminați dispozitivul/entitățile perimate din Home Assistant, dacă acestea rămân.
6. Activați din nou Discovery pe firmware-ul actual.
7. Confirmați că un singur dispozitiv și entitățile curente așteptate sunt create.

Nu ștergeți întregul arbore de topic-uri reținute homeassistant/# pe un broker partajat. Acest lucru ar putea elimina configurarea de discovery pentru dispozitive fără legătură.

Când MQTT manual este alegerea mai bună

Utilizați MQTT manual în schimb atunci când aveți nevoie de:

• nume de entități și ID-uri unice personalizate;
• șabloane sau calcule JSON personalizate;
• doar un subset selectat de măsurători;
• o structură de topic-uri partajată cu aplicații non-Home Assistant;
• control explicit asupra clasei de dispozitiv și a clasei de stare;
• compatibilitate cu un sistem în care Discovery în Home Assistant este dezactivat în mod intenționat.

Ghiduri conexe

• Configurarea manuală a contorului de energie MQTT pentru Home Assistant
• Publicarea datelor IAMMETER către un broker MQTT
• Comparați toate metodele de integrare IAMMETER–Home Assistant
• Faceți upgrade la cel mai recent firmware IAMMETER
• Documentația MQTT Home Assistant

Actualizat: 19 iulie 2026.