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:
- Integració Modbus IAMMETER HACS — configuració mitjançant la interfície d'usuari, entitats creades automàticament i un interval d'escaneig configurable.
- Integració Modbus integrada de Home Assistant — configuració YAML amb control directe sobre registres i sensors.
- 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
502accessible 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ó
- Obriu HACS a Home Assistant.
- Cerqueu IamMeter Modbus.
- Instal·leu la darrera versió.
- 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
- Aneu a Configuració → Dispositius i serveis.
- Seleccioneu Afegeix una integració.
- Cerqueu IamMeter Modbus.
- Introduïu l'adreça IP del mesurador i el port Modbus TCP.
- Seleccioneu el tipus de mesurador o la configuració de fases adequats.
- Establiu l'interval d'escaneig o manteniu el valor predeterminat de 3 segons.
- 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:
- executeu la comprovació de configuració de Home Assistant;
- reinicieu Home Assistant;
- obriu Eines per a desenvolupadors → Estats;
- 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
- Instal·leu una integració personalitzada SunSpec compatible per a Home Assistant, com ara SunSpec for Home Assistant, seguint les seves instruccions d'instal·lació.
- A Configuració → Dispositius i serveis, afegiu la integració SunSpec instal·lada i seleccioneu la seva opció de connexió Modbus TCP.
- Introduïu l'adreça IP de la LAN del mesurador físic, el port TCP
502i l'ID d'unitat adequat. Si el client demana l'adreça d'inici del descobriment, utilitzeu40000a la convenció basada en zero documentada per IAMMETER. - 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.
- 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
502no 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:
- controlar un relé a partir de dades de potència Modbus en temps real;
- carregar un vehicle elèctric quan l'exportació 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.
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.
Guies relacionades de Home Assistant
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.