Ghid de configurare a contorului de energie Modbus TCP în Home Assistant

Integrarea contorului de energie Modbus TCP în Home Assistant

Modbus TCP este una dintre cele mai rapide modalități de a conecta un contor de energie la Home Assistant. Funcționează prin rețeaua locală, nu depinde de o conexiune la internet și este potrivit pentru monitorizarea puterii în timp real, automatizările bazate pe surplusul solar, controlul sarcinilor și Energy Dashboard-ul Home Assistant.

Toate contoarele de energie IAMMETER actuale acceptă Modbus TCP. Le puteți integra cu Home Assistant în două moduri:

1. Integrarea Modbus IAMMETER HACS — configurare prin interfață, entități create automat și un interval de scanare configurabil.
2. Integrarea Modbus încorporată în Home Assistant — configurare YAML cu control direct asupra registrelor și senzorilor.

Acest ghid explică diferențele și vă ajută să configurați metoda potrivită.

Modbus HACS sau Modbus încorporat în Home Assistant?

Ambele metode citesc aceleași date locale Modbus TCP de la contor. Principala diferență constă în modul în care sunt configurate entitățile Home Assistant.

Pentru majoritatea utilizatorilor, integrarea Modbus HACS este opțiunea mai simplă. Utilizați integrarea Modbus încorporată în Home Assistant atunci când aveți nevoie de o listă personalizată de registre, de o schemă de denumire a entităților, de o regulă de scalare sau de un interval de interogare specific pentru senzorii individuali.

Dacă nu aveți nevoie de actualizări rapide, comparați alternativele HTTP și MQTT în prezentarea generală a integrării contorului de energie în Home Assistant.

Înainte de a începe

Aveți nevoie de:

• un contor de energie IAMMETER conectat la aceeași rețea LAN ca Home Assistant;
• adresa IP locală a contorului;
• portul TCP 502 accesibil între Home Assistant și contor;
• o versiune recentă de firmware a contorului;
• HACS instalat dacă alegeți integrarea IAMMETER HACS.

Este o idee bună să rezervați adresa IP a contorului în router. O adresă DHCP schimbătoare este un motiv frecvent pentru care o integrare Modbus funcțională devine indisponibilă ulterior.

Metoda 1: Configurarea Modbus IAMMETER prin HACS

Integrarea Modbus IAMMETER HACS este concepută pentru utilizatorii care doresc date locale rapide fără să definească manual fiecare registru în YAML.

Pasul 1: Instalarea integrării

1. Deschideți HACS în Home Assistant.
2. Căutați IamMeter Modbus.
3. Instalați cea mai recentă versiune.
4. Reporniți Home Assistant dacă vi se solicită.

Informații despre proiect și versiuni:

• Depozitul Modbus IAMMETER HACS
• Versiunile Modbus IAMMETER HACS

Utilizați cea mai recentă versiune disponibilă. Setarea intervalului de scanare este acceptată de integrarea actualizată și este transmisă către DataUpdateCoordinator.

Pasul 2: Adăugarea contorului în Home Assistant

1. Accesați Settings → Devices & services.
2. Selectați Add integration.
3. Căutați IamMeter Modbus.
4. Introduceți adresa IP a contorului și portul Modbus TCP.
5. Selectați tipul de contor sau configurația de fază corespunzătoare.
6. Setați intervalul de scanare sau păstrați valoarea implicită de 3 secunde.
7. Trimiteți formularul și confirmați că dispozitivul și entitățile au fost create.

Integrarea creează un număr diferit de entități pentru contoarele monofazate, bifazate și trifazate. O listă mai scurtă de entități nu înseamnă că un model monofazat are suport limitat în Home Assistant.

Pasul 3: Verificarea entităților

Deschideți dispozitivul IAMMETER sub Settings → Devices & services. În funcție de model, entitățile disponibile pot include:

• tensiune;
• curent;
• putere activă;
• factor de putere;
• energie importată;
• energie exportată;
• putere reactivă sau energie reactivă atunci când acestea sunt expuse de contorul și setul de registre aplicabile.

Entitățile de energie importată și exportată utilizează kWh și includ metadatele de energie Home Assistant cerute de Energy Dashboard.

Pasul 4: Alegerea unui interval de scanare adecvat

Intervalul de scanare implicit este de 3 secunde. Acesta este un punct de plecare practic pentru tablouri de bord live și automatizări bazate pe putere.

Puncte de plecare recomandate:

O setare de o secundă este o cerere de interogare, nu o garanție că fiecare tablou de bord Home Assistant se va reîmprospăta vizibil o dată pe secundă. Latența rețelei, numărul de registre, sarcina recorderului și comportamentul de reîmprospătare al interfeței afectează, de asemenea, rezultatul.

Evitați interogarea agresivă inutilă. Pentru majoritatea automatizărilor, o actualizare stabilă la fiecare 2–5 secunde este mai utilă decât cel mai scurt interval posibil.

Metoda 2: Utilizarea integrării Modbus încorporate în Home Assistant

Home Assistant include o integrare Modbus standard. Această metodă este complet locală și nu necesită HACS, dar conexiunea și senzorii sunt definiți în YAML.

Următorul exemplu citește tensiunea și puterea activă de la un contor monofazat:

modbus:
  - name: iammeter_hub
    type: tcp
    host: 192.168.1.6
    port: 502
    sensors:
      - name: IAMMETER Voltage
        slave: 1
        address: 0
        input_type: holding
        data_type: uint16
        scale: 0.01
        precision: 1
        unit_of_measurement: V
        device_class: voltage
        state_class: measurement
        scan_interval: 5

      - name: IAMMETER Active Power
        slave: 1
        address: 2
        input_type: holding
        data_type: int32
        unit_of_measurement: W
        device_class: power
        state_class: measurement
        scan_interval: 5

Înlocuiți 192.168.1.6 cu adresa IP reală a contorului. Verificați harta registrelor aplicabilă înainte de a adăuga mai mulți senzori:

• Harta registrelor Modbus TCP IAMMETER
• Documentația Modbus Home Assistant

Registre Modbus IAMMETER uzuale

Următoarele adrese ilustrează blocurile standard de fază utilizate de contoarele IAMMETER uzuale. Folosiți întotdeauna documentația actuală a registrelor ca referință autoritară.

Utilizați scala, precizia și ordinea cuvintelor documentate pentru fiecare registru. Nu deduceți scalarea energiei din exemplul de tensiune.

După editarea YAML:

1. rulați verificarea configurației Home Assistant;
2. reporniți Home Assistant;
3. deschideți Developer tools → States;
4. confirmați că noile entități au valori și unități plauzibile.

Adăugarea energiei importate și exportate în Energy Dashboard

Energy Dashboard-ul Home Assistant are nevoie de entități de energie cumulative, nu de putere instantanee.

Pentru un senzor de energie Modbus configurat manual, includeți metadatele corespunzătoare:

unit_of_measurement: kWh
device_class: energy
state_class: total_increasing

Apoi accesați Settings → Dashboards → Energy și selectați entitatea de energie importată ca consum din rețea și entitatea de energie exportată ca returnare în rețea.

Nu selectați o entitate de putere activă măsurată în wați pentru un câmp de energie din Energy Dashboard. Puterea arată rata curentă; kWh-ul importat/exportat înregistrează energia cumulativă.

Modele IAMMETER acceptate

Toate contoarele de energie IAMMETER actuale acceptă atât integrarea Modbus HACS, cât și integrarea Modbus încorporată în Home Assistant.

WEM3046T și WEM3046TE măsoară ieșirea secundară de 5 A a unui transformator de curent extern. Pentru a obține curentul, puterea și energia reale din partea primară, trebuie aplicat raportul CT corect. Aceasta este o caracteristică a sistemului de măsurare cu CT de 5 A, nu o limitare de compatibilitate Home Assistant sau Modbus.

Pot funcționa Modbus și IAMMETER Cloud în același timp?

Da. Home Assistant citește Modbus TCP local, în timp ce contorul poate continua să încarce date în IAMMETER Cloud. Nu trebuie să comutați contorul în modul de încărcare MQTT pentru a utiliza Modbus.

Astfel obțineți două perspective complementare:

• date locale rapide și automatizări în Home Assistant;
• rapoarte pe termen lung, analiza costurilor de energie, analiza solară și acces de la distanță în IAMMETER Cloud.

Evitați mai mulți clienți Modbus de înaltă frecvență

Utilizați un singur client Modbus TCP de interogare activ per contor ca model de implementare sigur. Nu configurați Home Assistant, Node-RED, un PLC și un alt logger să interogheze același contor independent la frecvență ridicată.

Dacă mai multe sisteme au nevoie de aceleași măsurători live, lăsați un singur sistem să citească Modbus și să redistribuie datele, sau utilizați o arhitectură MQTT în care mai mulți consumatori se abonează la un broker.

Depanare

Home Assistant nu se poate conecta la portul 502

• Confirmați că Home Assistant și contorul sunt în aceeași rețea accesibilă.
• Verificați adresa IP a contorului și rezervați-o în router.
• Verificați că portul TCP 502 nu este blocat de o regulă de firewall sau VLAN.
• Asigurați-vă că un alt client Modbus nu menține sau nu redeschide în mod repetat conexiunea.

Entitățile sunt indisponibile sau valorile nu se schimbă

• Confirmați tipul de contor/fază selectat în integrarea HACS.
• Cu YAML, verificați ID-ul slave, adresa registrului, tipul de date, scala și ordinea cuvintelor.
• Măriți temporar intervalul de scanare pentru a exclude o interogare prea agresivă.
• Reporniți integrarea după modificarea adresei IP a contorului.

Valorile sunt incredibil de mari sau de mici

• Verificați scalarea registrelor și tipul de date.
• Pentru WEM3046T/WEM3046TE, verificați raportul CT extern.
• Confirmați că entitatea corespunde fazei sau canalului de măsurare așteptat.

Entitățile de energie nu apar în Energy Dashboard

• Utilizați energia cumulativă importată/exportată în kWh.
• Confirmați device_class: energy.
• Confirmați state_class: total_increasing.
• Nu utilizați o entitate de putere în wați.

Construiți automatizări cu date de putere în timp real

Odată ce entitățile Modbus funcționează, Home Assistant poate utiliza puterea activă sau puterea exportată în rețea pentru a controla alte dispozitive. Exemple includ:

• controlați un releu din datele de putere Modbus în timp real;
• încărcarea unui vehicul electric atunci când exportul solar depășește un prag;
• încălzirea apei cu surplusul solar disponibil;
• notificarea utilizatorului atunci când consumul casnic depășește o limită;
• reducerea unei sarcini controlabile înainte de importul de energie electrică scumpă la orele de vârf.

Mențineți ghidul de integrare concentrat pe stabilirea unor date fiabile în primul rând. Adăugați logica de control doar după ce ați verificat convenția de semn, unitățile, intervalul de actualizare și comportamentul atunci când contorul devine indisponibil.

Ghiduri Home Assistant conexe

• Comparați fiecare metodă de integrare IAMMETER–Home Assistant
• Configurați un contor de energie cu un server MQTT
• Home Assistant MQTT Discovery pentru un contor de energie
• Monitorizarea energiei solare cu Home Assistant
• Home Assistant și Grafana