Ho sentim, el teu navegador no admet JavaScript!
Inicia sessió

HOME ASSISTANT · MODBUS TCP LOCAL

Integració del mesurador d'energia Modbus TCP de Home Assistant

Modbus TCP és una de les maneres més ràpides de connectar un mesurador 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 d'energia en temps real, l'automatització de l'excedent solar, el control de càrregues i el Tauler d'energia de Home Assistant.

Tots els mesuradors d'energia IAMMETER actuals admeten Modbus TCP. Trieu una de les tres vies d'integració amb Home Assistant, segons el model del mesurador i la interfície que vulgueu utilitzar:

  1. Integració Modbus IAMMETER HACS — configuració mitjançant la interfície d'usuari, entitats creades automàticament i un interval d'escaneig configurable.
  2. Integració Modbus integrada de Home Assistant — configuració YAML amb control directe sobre registres i sensors.
  3. Integració personalitzada SunSpec — configuració mitjançant la interfície d'usuari, descobriment estàndard de models de mesurador i entitats de mesura creades automàticament als models compatibles.

Tant IAMMETER HACS Modbus com una integració personalitzada SunSpec compatible ofereixen una configuració mitjançant la interfície d'usuari sense YAML per a cada sensor. Utilitzeu la integració Modbus integrada quan vulgueu definir vosaltres mateixos els registres i els sensors. La disponibilitat de SunSpec segueix l'abast de models de la guia oficial d'IAMMETER que hi ha a continuació.

Exploreu aquesta guia

Compareu les tres vies d'integració de Modbus TCP

Les tres vies llegeixen el mesurador per Modbus TCP. IAMMETER HACS i el YAML integrat utilitzen el mapa de registres d'IAMMETER; una integració SunSpec descobreix i llegeix models de mesurador SunSpec estàndard.

Característica IAMMETER HACS Modbus Modbus integrat de Home Assistant Integració personalitzada SunSpec
Configuració al costat de Home Assistant IU YAML IU després d'instal·lar una integració personalitzada compatible
Configuració de registres Creada per la integració Definida manualment Descoberta a partir de models de mesurador SunSpec estàndard
Interval d'escaneig Configurable; valor predeterminat: 3 segons Configurable per sensor Configurat a la integració triada
Metadades del Tauler d'energia Incloses per a les entitats d'energia compatibles S'ha de configurar al YAML Proporcionades per un client compatible; verifiqueu les unitats i les metadades
Descobriment automàtic/assistit Configuració assistida per SSDP No Descobriment de models després de la connexió; no és el mateix que el descobriment automàtic a la xarxa local
Funcionament local Sí Sí Sí
Es pot continuar utilitzant IAMMETER Cloud Sí Sí Sí
Ideal per a La majoria d'usuaris de Home Assistant Usuaris avançats i registres personalitzats Usuaris que prefereixen models SunSpec estàndard i configuració mitjançant IU

Trieu IAMMETER HACS Modbus per a entitats específiques d'IAMMETER ja preparades. Trieu una integració personalitzada SunSpec per a una via basada en IU per a models de mesurador estàndard als models compatibles. Trieu el YAML de Modbus integrat per a una llista de registres personalitzada, un esquema de nomenclatura d'entitats, una regla d'escalat o un interval d'enquesta per sensor.

Per comparar l'enquesta HTTP ajustable, MQTT i altres opcions d'integració, consulteu la visió general de la integració del mesurador d'energia amb Home Assistant.

Sense YAML per a sensors individuals: tant IAMMETER HACS Modbus com la via d'integració personalitzada SunSpec poden oferir configuració mitjançant IU. L'opció SunSpec requereix instal·lar una integració personalitzada compatible; no és un commutador natiu dins de la integració genèrica Modbus integrada de HA.

PROVEU ABANS DE COMPRAR

Proveu Modbus TCP sense un mesurador físic

Utilitzeu el simulador públic per connectar Home Assistant, inspeccionar les lectures dels sensors i provar taulers o condicions d'automatització abans de comprar o instal·lar un mesurador.

Seguiu el tutorial d'integració Modbus de Home Assistant →

Obriu el simulador WEM2067 →

Abans de començar

Necessiteu:

  • un mesurador d'energia IAMMETER connectat a la mateixa LAN que Home Assistant;
  • l'adreça IP local del mesurador;
  • el port TCP 502 accessible entre Home Assistant i el mesurador;
  • el firmware actual compatible del mesurador des de Actualitzacions de firmware d'IAMMETER;
  • HACS instal·lat si trieu la integració IAMMETER HACS.

És bona idea reservar l'adreça IP del mesurador al router. Una adreça DHCP canviant és una causa habitual que una integració Modbus que funcionava deixi d'estar disponible més endavant.

Mètode 1: Configureu IAMMETER Modbus mitjançant HACS

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

Pas 1: Instal·leu 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:

Utilitzeu una versió actualitzada de la integració. L'interval d'enquesta configurat s'aplica mentre el mesurador està en línia; la integració redueix els intents de connexió repetits quan un mesurador està fora de línia.

Pas 2: Afegiu el mesurador a Home Assistant

  1. Aneu a Configuració → Dispositius i serveis.
  2. Seleccioneu Afegeix una integració.
  3. Cerqueu IamMeter Modbus.
  4. Introduïu l'adreça IP del mesurador i el port Modbus TCP.
  5. Seleccioneu el tipus de mesurador o la configuració de fases adequats.
  6. Establiu l'interval d'escaneig o manteniu el valor predeterminat de 3 segons.
  7. Envieu el formulari i confirmeu que es creen el dispositiu i les entitats.

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

Pas 3: Comproveu 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 les exposa el mesurador i el conjunt de registres aplicables.

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: Trieu un interval d'escaneig adequat

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

Punts de partida recomanats:

Aplicació Interval d'escaneig suggerit
Control de relés o d'excedent solar en temps real 1–5 segons
Tauler de potència en directe 3–10 segons
Monitoratge general d'energia 10–30 segons

Un ajust d'un segon és una sol·licitud d'enquesta, no una garantia que tots els taulers de Home Assistant s'actualitzin visiblement un cop per segon. La latència de la xarxa, el nombre de registres, la càrrega del registrador i el comportament d'actualització del frontend també afecten el resultat.

Eviteu l'enquesta innecessàriament agressiva. 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: Utilitzeu 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 mesurador 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 mesurador. Comproveu el mapa de registres aplicable abans d'afegir més sensors:

Registres Modbus habituals d'IAMMETER

Les adreces següents il·lustren els blocs de fase estàndard utilitzats pels mesuradors IAMMETER habituals. Utilitzeu sempre la documentació de registres actual com a referència autoritzada.

Mesura Fase A / monofàsica Fase B Fase C Tipus de dades
Tensió 0 10 20 uint16
Corrent 1 11 21 uint16
Potència activa 2 12 22 int32
Energia importada 4 14 24 uint32
Energia exportada 6 16 26 uint32

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

Després d'editar el YAML:

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

UNA ALTRA OPCIÓ BASADA EN IU

Mètode 3: Utilitzeu SunSpec sobre Modbus TCP sense YAML per als sensors

Els mesuradors IAMMETER compatibles exposen models de mesurador SunSpec estàndard juntament amb el mapa de registres Modbus existent. Una integració SunSpec compatible per a Home Assistant pot descobrir aquests models i crear sensors mitjançant la configuració d'IU, de manera que no cal definir cada registre en YAML.

Llegiu la guia oficial de suport i integració de SunSpec Modbus/TCP d'IAMMETER per conèixer els mapes de models compatibles, les mesures i les limitacions.

Configureu una integració SunSpec compatible

  1. Instal·leu una integració personalitzada SunSpec compatible per a Home Assistant, com ara SunSpec for Home Assistant, seguint les seves instruccions d'instal·lació.
  2. A Configuració → Dispositius i serveis, afegiu la integració SunSpec instal·lada i seleccioneu la seva opció de connexió Modbus TCP.
  3. Introduïu l'adreça IP de la LAN del mesurador físic, el port TCP 502 i l'ID d'unitat adequat. Si el client demana l'adreça d'inici del descobriment, utilitzeu 40000 a la convenció basada en zero documentada per IAMMETER.
  4. Deixeu que la integració descobreixi els models de mesurador Common i els models enters compatibles. Seleccioneu les mesures i un interval d'enquesta adequat, i després verifiqueu els valors i les unitats d'energia.
  5. Manteniu l'escriptura desactivada: el mapa SunSpec d'IAMMETER és de només lectura.

Comproveu l'abast de suport publicat

La guia oficial enumera WEM3080, WEM2067, WEM3050T, WEM3080T, WEM3046T i WEM3063T amb mapes de models de mesurador enters. La validació física que s'hi indica cobreix WEM3080T; els altres models enumerats encara necessiten proves amb dispositius.

La guia encara no afirma la disponibilitat del Model 204 per a WEM3080TD, i WEM3046TE encara no té una verificació dedicada d'identificació de model. Utilitzeu aquest abast documentat en lloc de suposar un suport SunSpec idèntic per a tots els models.

L'energia SunSpec utilitza Wh amb factors d'escala, a diferència de les entitats en kWh dels exemples específics d'IAMMETER. Confirmeu que la integració gestiona correctament les unitats i els camps no disponibles.

Trieu la integració, no un commutador YAML ocult. El suport SunSpec no converteix la integració genèrica Modbus YAML integrada de Home Assistant en una configuració mitjançant IU. Instal·leu una integració SunSpec compatible per a aquesta via. IAMMETER HACS Modbus ja ofereix una opció separada sense YAML per als sensors utilitzant registres IAMMETER. La implementació SunSpec no està certificada per SunSpec i cal comprovar la compatibilitat del client.

Obteniu el firmware compatible actual des de Actualitzacions de firmware d'IAMMETER. Mantingueu una sola integració d'enquesta activa per mesurador mentre compareu els mètodes.

Afegiu l'energia importada i exportada al Tauler d'energia

El Tauler d'energia de Home Assistant necessita entitats d'energia acumulada, no 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; els kWh importats/exportats registren energia acumulada.

Models IAMMETER compatibles

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

Model Configuració del mesurador Nota de Home Assistant
WEM3080 Monofàsic Conjunt d'entitats monofàsiques
WEM2067 Doble canal per a aplicacions monofàsiques Dos canals de mesura
WEM3080T Trifàsic Grups trifàsics/d'entitats
WEM3050T Trifàsic o fase dividida Tres canals de mesura
WEM3080TD Trifàsic/tres fils i cablejat especial Interpreteu les entitats segons el mode de cablejat
WEM3046T / WEM3046TE Entrada de CT extern de 5 A Apliqueu la relació del CT extern

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 CT correcta. Aquesta és una característica del sistema de mesura amb CT de 5 A, no una limitació de compatibilitat de Home Assistant o Modbus.

Poden funcionar Modbus i IAMMETER Cloud alhora?

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

Això us ofereix dues visions complementàries:

  • dades locals ràpides i automatitzacions a Home Assistant;
  • informes a llarg termini, anàlisi de costos elèctrics, anàlisi solar i accés remot a IAMMETER Cloud.

Eviteu diversos clients Modbus d'alta freqüència

Utilitzeu un sol client d'enquesta Modbus TCP actiu per mesurador com a model de desplegament segur. No configureu Home Assistant, Node-RED, un PLC i un altre registrador perquè facin enquestes independents al mateix mesurador 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 mesurador són a la mateixa xarxa accessible.
  • Verifiqueu l'adreça IP del mesurador i reserveu-la al router.
  • Comproveu que el port TCP 502 no estigui bloquejat per una regla de tallafocs o VLAN.
  • Assegureu-vos que cap altre client Modbus estigui mantenint o reobrint repetidament la connexió.

Les entitats no estan disponibles o els valors no canvien

  • Confirmeu el tipus de mesurador/fase seleccionat a la integració HACS.
  • Amb YAML, verifiqueu l'ID d'esclau, l'adreça del registre, el tipus de dades, l'escala i l'ordre de paraules.
  • Augmenteu temporalment l'interval d'escaneig per descartar una enquesta massa agressiva.
  • Utilitzeu l'opció Reconfigura de la integració per actualitzar una adreça o un port del mesurador que hagin canviat, i després confirmeu que es reprenen les lectures.

Els valors són implausiblement alts o baixos

  • Comproveu l'escalat dels registres i el tipus de dades.
  • Per a WEM3046T/WEM3046TE, verifiqueu la relació del CT 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 acumulada importada/exportada 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 funcionin, Home Assistant pot utilitzar la potència activa o la potència exportada a la xarxa per controlar altres dispositius. Els exemples inclouen:

Establiu primer lectures fiables. Afegiu 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 mesurador deixa d'estar disponible.

Historial d'actualitzacions

  • S'ha afegit el tutorial de proves Modbus amb el simulador públic i una entrada directa al simulador.
  • S'ha afegit una via d'integració SunSpec mitjançant IU, amb l'abast oficial de suport d'IAMMETER i referències de configuració.
  • S'han actualitzat les indicacions sobre enquesta i connexió i s'ha redissenyat la guia per a escriptori i mòbil.
  • S'han presentat IAMMETER HACS, el YAML integrat i la integració personalitzada SunSpec com tres opcions paral·leles de Modbus TCP.
Amunt