Guia de configuració del comptador d'energia Modbus TCP amb Home Assistant

Integració del comptador d'energia Modbus TCP amb Home Assistant

Modbus TCP és una de les maneres més ràpides de connectar un comptador d'energia a Home Assistant. Funciona a través de la xarxa local, no depèn d'una connexió a Internet i és adequat per al monitoratge de potència en temps real, l'automatització de l'excedent solar, el control de càrregues i el tauler d'energia de Home Assistant.

Tots els comptadors d'energia IAMMETER actuals admeten Modbus TCP. Podeu integrar-los amb Home Assistant de dues maneres:

1. Integració Modbus de IAMMETER per a HACS — configuració des de la interfície, entitats creades automàticament i un interval d'escaneig configurable.
2. Integració Modbus integrada de Home Assistant — configuració en YAML amb control directe sobre els registres i els sensors.

Aquesta guia explica les diferències i us ajuda a configurar el mètode adequat.

HACS Modbus o el Modbus integrat de Home Assistant?

Tots dos mètodes llegeixen les mateixes dades Modbus TCP locals del comptador. La diferència principal és com es configuren les entitats de Home Assistant.

Per a la majoria d'usuaris, la integració Modbus per a HACS és l'opció més senzilla. Feu servir la integració Modbus integrada de Home Assistant quan necessiteu una llista de registres personalitzada, un esquema propi de noms d'entitats, una regla d'escalat o un interval de sondeig per a sensors individuals.

Si no necessiteu actualitzacions ràpides, compareu les alternatives HTTP i MQTT a la visió general de les integracions de comptadors d'energia amb Home Assistant.

Abans de començar

Necessiteu:

• un comptador d'energia IAMMETER connectat a la mateixa LAN que Home Assistant;
• l'adreça IP local del comptador;
• el port TCP 502 accessible entre Home Assistant i el comptador;
• una versió de firmware del comptador recent;
• HACS instal·lat si trieu la integració IAMMETER per a HACS.

És recomanable reservar l'adreça IP del comptador al router. Una adreça DHCP canviant és un motiu habitual pel qual una integració Modbus que funcionava deixa d'estar disponible més endavant.

Mètode 1: configurar el Modbus d'IAMMETER a través de HACS

La integració Modbus de IAMMETER per a HACS està pensada per als usuaris que volen dades locals ràpides sense definir manualment cada registre en YAML.

Pas 1: instal·lar la integració

1. Obriu HACS a Home Assistant.
2. Cerqueu IamMeter Modbus.
3. Instal·leu la darrera versió.
4. Reinicieu Home Assistant si se us demana.

Informació del projecte i de les versions:

• Repositori de IAMMETER HACS Modbus
• Versions de IAMMETER HACS Modbus

Utilitzeu la darrera versió disponible. El paràmetre de l'interval d'escaneig és compatible amb la integració actualitzada i es passa al DataUpdateCoordinator.

Pas 2: afegir el comptador a Home Assistant

1. Aneu a Configuració → Dispositius i serveis.
2. Seleccioneu Afegir integració.
3. Cerqueu IamMeter Modbus.
4. Introduïu l'adreça IP del comptador i el port Modbus TCP.
5. Seleccioneu el tipus de comptador o la configuració de fases adequada.
6. Definiu l'interval d'escaneig o manteniu el valor per defecte de 3 segons.
7. Envieu el formulari i confirmeu que el dispositiu i les entitats s'han creat.

La integració crea un nombre diferent d'entitats per als comptadors monofàsics, de doble canal i trifàsics. Una llista d'entitats més curta no vol dir que un model monofàsic tingui un suport limitat a Home Assistant.

Pas 3: comprovar les entitats

Obriu el dispositiu IAMMETER a Configuració → Dispositius i serveis. Segons el model, les entitats disponibles poden incloure:

• tensió;
• corrent;
• potència activa;
• factor de potència;
• energia importada;
• energia exportada;
• potència reactiva o energia reactiva quan el comptador i el conjunt de registres aplicables les exposen.

Les entitats d'energia importada i exportada utilitzen kWh i inclouen les metadades d'energia de Home Assistant que requereix el tauler d'energia.

Pas 4: triar un interval d'escaneig adequat

L'interval d'escaneig per defecte és de 3 segons. És un punt de partida pràctic per a taulers en directe i automatitzacions basades en la potència.

Punts de partida recomanats:

Un valor d'un segon és una petició de sondeig, no una garantia que tots els taulers de Home Assistant es refresquin visiblement un cop per segon. La latència de la xarxa, el nombre de registres, la càrrega del recorder i el comportament de refresc de la interfície també afecten el resultat.

Eviteu el sondeig innecessàriament agressiu. Per a la majoria d'automatitzacions, una actualització estable de 2–5 segons és més útil que l'interval més curt possible.

Mètode 2: utilitzar la integració Modbus integrada de Home Assistant

Home Assistant inclou una integració Modbus estàndard. Aquest mètode és completament local i no requereix HACS, però la connexió i els sensors es defineixen en YAML.

L'exemple següent llegeix la tensió i la potència activa d'un comptador monofàsic:

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

Substituïu 192.168.1.6 per l'adreça IP real del comptador. Consulteu el mapa de registres aplicable abans d'afegir més sensors:

• Mapa de registres Modbus TCP d'IAMMETER
• Documentació de Modbus de Home Assistant

Registres Modbus habituals d'IAMMETER

Les adreces següents il·lustren els blocs de fase estàndard que utilitzen els comptadors IAMMETER habituals. Feu servir sempre la documentació de registres actual com a referència autoritzada.

Utilitzeu l'escala, la precisió i l'ordre de paraules documentats per a cada registre. No deduïu l'escalat de l'energia a partir de l'exemple de la tensió.

Després d'editar el YAML:

1. executeu la comprovació de configuració de Home Assistant;
2. reinicieu Home Assistant;
3. obriu Eines de desenvolupament → Estats;
4. confirmeu que les noves entitats tenen valors i unitats plausibles.

Afegir l'energia importada i exportada al tauler d'energia

El tauler d'energia de Home Assistant necessita entitats d'energia acumulada, no de potència instantània.

Per a un sensor d'energia Modbus configurat manualment, incloeu les metadades adequades:

unit_of_measurement: kWh
device_class: energy
state_class: total_increasing

A continuació, aneu a Configuració → Taulers → Energia i seleccioneu l'entitat d'energia importada com a consum de la xarxa i l'entitat d'energia exportada com a retorn a la xarxa.

No seleccioneu una entitat de potència activa mesurada en watts per a un camp d'energia del tauler d'energia. La potència mostra la taxa actual; l'energia importada/exportada en kWh registra l'energia acumulada.

Models IAMMETER compatibles

Tots els comptadors d'energia IAMMETER actuals admeten tant el Modbus per a HACS com la integració Modbus integrada de Home Assistant.

Els WEM3046T i WEM3046TE mesuren la sortida secundària de 5 A d'un transformador de corrent extern. Per obtenir el corrent, la potència i l'energia reals del costat primari, cal aplicar la relació de TC correcta. Això és una característica del sistema de mesura amb TC de 5 A, no una limitació de compatibilitat amb Home Assistant o Modbus.

Poden funcionar alhora el Modbus i IAMMETER Cloud?

Sí. Home Assistant llegeix Modbus TCP localment mentre el comptador pot continuar pujant dades a IAMMETER Cloud. No cal canviar el comptador al mode de pujada MQTT per utilitzar Modbus.

Això us ofereix dues vistes complementàries:

• dades locals ràpides i automatitzacions a Home Assistant;
• informes a llarg termini, anàlisi del cost de l'electricitat, anàlisi solar i accés remot a IAMMETER Cloud.

Eviteu diversos clients Modbus d'alta freqüència

Feu servir un sol client de sondeig Modbus TCP actiu per comptador com a model de desplegament segur. No configureu Home Assistant, Node-RED, un PLC i un altre registrador perquè sondegin el mateix comptador de manera independent i a alta freqüència.

Si diversos sistemes necessiten les mateixes mesures en directe, deixeu que un sol sistema llegeixi Modbus i redistribueixi les dades, o utilitzeu una arquitectura MQTT en què diversos consumidors se subscriguin a un broker.

Resolució de problemes

Home Assistant no es pot connectar al port 502

• Confirmeu que Home Assistant i el comptador són en una xarxa accessible comuna.
• Verifiqueu l'adreça IP del comptador i reserveu-la al router.
• Comproveu que el port TCP 502 no estigui bloquejat per un tallafoc o una regla de VLAN.
• Assegureu-vos que cap altre client Modbus estigui mantenint o reobrint la connexió repetidament.

Les entitats no estan disponibles o els valors no canvien

• Confirmeu el tipus de comptador o de fase seleccionat a la integració de HACS.
• Amb YAML, verifiqueu l'ID d'esclau, l'adreça del registre, el tipus de dada, l'escala i l'ordre de paraules.
• Augmenteu temporalment l'interval d'escaneig per descartar un sondeig massa agressiu.
• Reinicieu la integració després de canviar l'adreça IP del comptador.

Els valors són implausiblement alts o baixos

• Comproveu l'escalat i el tipus de dada dels registres.
• Per als WEM3046T/WEM3046TE, verifiqueu la relació del TC extern.
• Confirmeu que l'entitat correspon a la fase o al canal de mesura esperats.

Les entitats d'energia no apareixen al tauler d'energia

• Utilitzeu energia importada/exportada acumulada en kWh.
• Confirmeu device_class: energy.
• Confirmeu state_class: total_increasing.
• No utilitzeu una entitat de potència en watts.

Creeu automatitzacions amb dades de potència en temps real

Un cop les entitats Modbus funcionen, Home Assistant pot utilitzar la potència activa o la potència exportada a la xarxa per controlar altres dispositius. Alguns exemples són:

• controlar un relé a partir de dades de potència Modbus en temps real;
• carregar un vehicle elèctric quan l'excedent solar supera un llindar;
• escalfar aigua amb l'excedent solar disponible;
• notificar l'usuari quan la demanda de la llar supera un límit;
• reduir una càrrega controlable abans d'importar electricitat cara en hora punta.

Manteniu la guia d'integració centrada a establir primer dades fiables. Afegiu la lògica de control només després de comprovar la convenció de signes, les unitats, l'interval d'actualització i el comportament quan el comptador deixa d'estar disponible.

Guies relacionades de Home Assistant

• Compareu tots els mètodes d'integració entre IAMMETER i Home Assistant
• Configurar un comptador d'energia amb un servidor MQTT
• Descobriment MQTT de Home Assistant per a un comptador d'energia
• Monitoratge d'energia solar amb Home Assistant
• Home Assistant i Grafana