HOME ASSISTANT · GHID DE INTEGRARE
Integrarea contorului de energie în Home Assistant: MQTT, Modbus TCP și IAMMETER-Link
Contoarele de energie IAMMETER pot fi integrate cu Home Assistant prin HTTP local, Modbus TCP sau MQTT. Cea mai bună metodă depinde de preferința pentru o integrare oficială, configurare din interfața UI, actualizări locale rapide, descoperire automată MQTT sau utilizarea în continuare a IAMMETER Cloud.
Acest ghid compară metodele disponibile și vă îndrumă către ghidul de configurare potrivit. Acoperă toate contoarele de energie IAMMETER actuale. WEM3162, scos din producție, nu este inclus.
Pe această pagină
Ce integrare Home Assistant ar trebui să folosesc?
| Metodă | Configurare pe partea contorului | Configurare Home Assistant | Interval tipic de actualizare | Complet local | IAMMETER Cloud în același timp | Descoperire automată | Cel mai potrivit pentru |
|---|---|---|---|---|---|---|---|
| Home Assistant Core | Mențineți contorul accesibil în LAN | Adăugați integrarea IAMMETER încorporată în YAML | 30 de secunde | Da | Da | Nu | Utilizatorii care preferă o integrare oficială încorporată |
| Home Assistant Modbus | Faceți Modbus TCP disponibil în LAN | Configurați integrarea Modbus încorporată și senzorii în YAML | Configurabil; de obicei 1–5 secunde | Da | Da | Nu | Monitorizare rapidă și automatizări în timp real |
| MQTT manual | Configurați brokerul MQTT în WebUI-ul contorului | Activați integrarea MQTT și definiți senzorii în YAML | Configurabil; cel mai recent firmware acceptă până la 2 secunde | Da, cu un broker local | Nu | Nu | Utilizatorii care au nevoie de subiecte și senzori personalizați |
| HACS HTTP | Mențineți contorul accesibil în LAN | Instalați IAMMETER HTTP prin HACS și configurați-l în UI | 60 de secunde | Da | Da | Cu ajutor SSDP | Configurare din UI fără YAML |
| HACS Modbus | Faceți Modbus TCP disponibil în LAN | Instalați IAMMETER Modbus prin HACS și configurați-l în UI | Configurabil; implicit 3 secunde | Da | Da | Cu ajutor SSDP | Actualizări locale rapide cu configurare din UI |
| Descoperirea MQTT | Configurați brokerul și activați HA MQTT Discovery în WebUI-ul contorului | Activați integrarea MQTT; senzorii sunt creați automat | Configurabil; cel mai recent firmware acceptă până la 2 secunde | Da, cu un broker local | Nu | Da | Cea mai simplă configurare MQTT |
Recomandări rapide:
- Alegeți Home Assistant Core dacă doriți integrarea oficială încorporată și un interval de actualizare de 30 de secunde este suficient.
- Alegeți HACS HTTP dacă preferați configurarea din UI și nu aveți nevoie de actualizări rapide.
- Alegeți HACS Modbus dacă doriți configurare din UI cu date locale mai rapide pentru tablouri de bord și automatizări.
- Alegeți Home Assistant Modbus dacă vă simțiți confortabil cu YAML și doriți control complet asupra registrelor, senzorilor și intervalelor de interogare.
- Alegeți Descoperirea MQTT dacă utilizați deja MQTT și doriți ca Home Assistant să creeze automat dispozitivul și entitățile.
- Alegeți MQTT manual dacă aveți nevoie de control complet asupra subiectelor MQTT, șabloanelor și definițiilor entităților.
MQTT manual și Descoperirea MQTT schimbă modul de încărcare al contorului în MQTT. În aceste moduri, contorul nu încarcă simultan măsurătorile către IAMMETER Cloud. Integrările HTTP local și Modbus TCP pot continua să funcționeze în timp ce contorul încarcă date către IAMMETER Cloud.
1. Integrarea oficială Home Assistant Core
Integrarea oficială IAMMETER este inclusă în Home Assistant și citește API-ul HTTP local al contorului. Nu necesită HACS sau o conexiune la internet între Home Assistant și contor.
Caracteristici principale:
- configurată în
configuration.yaml; - interogare HTTP locală la fiecare 30 de secunde;
- poate fi utilizată împreună cu IAMMETER Cloud;
- entitățile de energie importată și exportată includ metadatele necesare pentru Tabloul de bord Energie din Home Assistant;
- fără descoperire automată a dispozitivului.
Utilizați această metodă atunci când stabilitatea și suportul oficial Home Assistant contează mai mult decât frecvențele rapide de reîmprospătare.
2. Integrarea Modbus TCP din Home Assistant
Integrarea Modbus încorporată din Home Assistant citește registrele Modbus TCP locale ale contorului. Este potrivită pentru automatizări bazate pe putere, controlul surplusului solar și alte aplicații care necesită actualizări mai rapide.
Caracteristici principale:
- configurată în YAML;
scan_intervalconfigurabil, de obicei 1–5 secunde pentru automatizare în timp real;- complet locală și independentă de internet;
- poate fi utilizată împreună cu IAMMETER Cloud;
- necesită adresa corectă a registrului, tipul de date, scala și metadatele pentru Tabloul de bord Energie.
Utilizați un interval de interogare mai lung atunci când datele la nivel de secundă nu sunt necesare. Evitați rularea mai multor clienți Modbus cu frecvență ridicată împotriva aceluiași contor.
3. Integrarea HACS HTTP
Integrarea personalizată IAMMETER HTTP oferă o alternativă bazată pe UI la integrarea oficială YAML. Citește /monitorjson prin rețeaua locală și creează entitățile Home Assistant corespunzătoare.
Caracteristici principale:
- instalată prin HACS;
- configurată prin interfața Dispozitive și servicii din Home Assistant;
- interogare HTTP locală la fiecare 60 de secunde;
- SSDP poate ajuta la descoperirea dispozitivului;
- compatibilă cu IAMMETER Cloud și cu Tabloul de bord Energie.
Utilizați această metodă atunci când preferați configurarea din UI și un interval de reîmprospătare de un minut este suficient.
4. Integrarea HACS Modbus
Integrarea personalizată IAMMETER Modbus combină interogarea Modbus TCP locală cu configurarea din interfața Home Assistant. Este opțiunea cea mai convenabilă pentru utilizatorii care au nevoie de actualizări mai rapide, dar nu doresc să definească fiecare registru în YAML.
Caracteristici principale:
instalată prin HACS și configurată în UI;
interval de scanare configurabil, cu valoare implicită de 3 secunde în integrarea actualizată;
funcționare locală și compatibilitate cu IAMMETER Cloud;
creează entități de putere și energie importată/exportată cu metadatele Home Assistant corespunzătoare;
acceptă toate contoarele IAMMETER actuale, cu număr diferit de entități pentru modelele monofazate și trifazate.
5. Integrarea MQTT manuală
În modul MQTT manual, contorul publică datele de măsurare către brokerul dvs. MQTT, iar dvs. definiți senzorii corespunzători în Home Assistant.
Configurarea pe partea contorului și configurarea Home Assistant sunt separate:
- Configurați adresa brokerului, portul, numele de utilizator și parola în cel mai recent WebUI al contorului.
- Activați integrarea MQTT în Home Assistant.
- Definiți senzorii MQTT necesari și șabloanele JSON în YAML.
Această metodă este utilă atunci când mai multe aplicații trebuie să se aboneze la aceleași măsurători sau când aveți nevoie de subiecte și definiții de entități personalizate.
6. Descoperirea MQTT din Home Assistant
Descoperirea MQTT este destinată utilizatorilor care doresc cât mai puțină configurare manuală. După ce configurați brokerul și activați HA MQTT Discovery în WebUI-ul contorului, Home Assistant creează automat dispozitivul IAMMETER și entitățile sale.
Entitățile de energie importată și exportată generate includ:
unit_of_measurement: kWh;device_class: energy;state_class: total_increasing.
Aceste atribute oferă metadatele necesare pentru utilizarea în Tabloul de bord Energie din Home Assistant.
Descoperirea MQTT este acceptată de toate contoarele de energie IAMMETER actuale. Modelele monofazate și trifazate creează numere diferite de entități în funcție de canalele lor de măsurare.
Contoare de energie IAMMETER acceptate
Toate contoarele de energie IAMMETER actuale acceptă metodele de integrare descrise mai sus. Principala diferență în Home Assistant este numărul de faze sau canale de măsurare și, prin urmare, numărul de entități create.
| Model | Aplicație tipică | Suport Home Assistant | Notă importantă |
|---|---|---|---|
| WEM3080 | Monitorizare energie monofazată | Toate metodele | Entități monofazate |
| WEM2067 | Monitorizare solară casnică monofazată | Toate metodele | Două canale de măsurare |
| WEM3080T | Monitorizare energie trifazată | Toate metodele | Entități trifazate |
| WEM3050T | Monitorizare casnică trifazată sau cu fază divizată | Toate metodele | Trei canale de măsurare |
| WEM3080TD | Aplicații trifazate/trei fire și cablare specială | Toate metodele | Interpretarea entităților depinde de modul de cablare |
| WEM3046T / WEM3046TE | Măsurare trifazată cu CT externe de 5 A | Toate metodele | Aplicați raportul CT extern pentru a obține valorile pe partea primară |
WEM3046T și WEM3046TE măsoară ieșirea secundară de 5 A a transformatoarelor de curent externe. Aplicarea raportului CT este o cerință a acestei configurații de măsurare, nu o limitare de compatibilitate cu Home Assistant.
Utilizați entitățile de energie IAMMETER în Tabloul de bord Energie
Tabloul de bord Energie din Home Assistant are nevoie de entități cumulative de energie importată și exportată în kWh, de obicei cu:
device_class: energy;state_class: total_increasing.
Integrările actuale Core, HACS HTTP, HACS Modbus și Descoperirea MQTT oferă metadatele necesare pentru entitățile lor de energie importată/exportată. Cu configurarea manuală Modbus sau MQTT manual, trebuie să adăugați singur unitatea, clasa de dispozitiv și clasa de stare corecte.
Nu utilizați o entitate de putere instantanee în wați ca substitut pentru o entitate de energie cumulativă în kWh.
Trimiteți datele de energie existente din Home Assistant către IAMMETER Cloud
Metodele de mai sus aduc datele contorului IAMMETER în Home Assistant. IAMMETER-Link funcționează în direcția opusă: încarcă entitățile de energie care există deja în Home Assistant către un contor virtual IAMMETER și IAMMETER Cloud.
Acest lucru este util atunci când un invertor sau un contor terț are deja o integrare Home Assistant, dar doriți și tablouri de bord, rapoarte sau acces multi-site în IAMMETER Cloud.
IAMMETER-Link oferă în prezent:
configurare prin HACS și UI;
mapare pentru contor virtual monofazat și trifazat;
un interval de încărcare de 300 de secunde cu IAMMETER Basic;
un interval de încărcare de 60 de secunde cu IAMMETER Pro.
Conectați dispozitivele de energie Home Assistant la IAMMETER Cloud
Exemple de monitorizare a energiei în Home Assistant
După integrarea contorului, datele sale de putere în timp real și energie cumulativă pot fi utilizate pentru:
- monitorizarea generării solare, consumului casnic și importului/exportului către rețea;
- controlul releului în timp real folosind Modbus TCP;
- tablouri de bord Home Assistant și Grafana;
- încărcarea vehiculelor electrice cu surplus solar;
- încălzirea apei cu surplus solar.
Aveți nevoie de ajutor?
Dacă aveți întrebări despre firmware, configurarea entităților, configurarea Tabloului de bord Energie sau alegerea unei metode de integrare, vizitați forumul comunității IAMMETER.