Envia les dades energètiques de Home Assistant al núvol | IAMMETER-Link

Envia les dades energètiques de Home Assistant al núvol amb IAMMETER-Link

Si un inversor, un comptador d'electricitat, un sistema de bateries o qualsevol altre dispositiu energètic ja ofereix entitats de sensors a Home Assistant, IAMMETER-Link pot pujar aquests valors a un Comptador Virtual d'IAMMETER per tenir quadres de comandament al núvol, accés remot i anàlisi energètica.

Això converteix Home Assistant en un pont de compatibilitat:

Dispositiu energètic → entitats de Home Assistant → IAMMETER-Link → Comptador Virtual → IAMMETER Cloud

El dispositiu d'origen no cal que sigui un comptador IAMMETER. Pot ser qualsevol dispositiu que Home Assistant ja integri, sempre que les seves entitats exposin mesures d'energia vàlides i amb l'escala correcta.

IAMMETER-Link és útil quan vols combinar l'amplia compatibilitat de dispositius de Home Assistant amb els serveis de monitoratge energètic i solar d'IAMMETER Cloud.

Què fa IAMMETER-Link—i què no fa

IAMMETER-Link llegeix entitats seleccionades de Home Assistant i puja els seus valors actuals a un Comptador Virtual d'IAMMETER.

Pot mapar valors com ara:

• tensió en V;
• corrent en A;
• potència activa en W;
• energia importada en kWh;
• energia exportada en kWh;
• estat de càrrega de la bateria quan el model de dades configurat ho admet.

No fa el següent:

• llegir directament un comptador físic IAMMETER per HTTP, Modbus o MQTT;
• crear mesures d'energia que faltin a partir d'una entitat de potència no relacionada;
• convertir IAMMETER Cloud en un servei totalment local;
• substituir la integració original de Home Assistant per al dispositiu d'origen.

Per portar un comptador físic IAMMETER a Home Assistant, consulta la guia d'integració del comptador d'energia amb Home Assistant. IAMMETER-Link envia les dades en la direcció oposada.

Quan és útil el monitoratge energètic al núvol a través de Home Assistant

Un inversor de tercers ja és a Home Assistant

Molts inversors ja exposen la potència de generació i l'energia acumulada mitjançant una integració de Home Assistant. IAMMETER-Link pot mapar aquestes entitats a un Comptador Virtual, de manera que les dades de l'inversor es poden veure a IAMMETER Cloud sense afegir un segon comptador físic només per a la transferència de dades.

Les dades de la xarxa i de l'inversor provenen d'integracions diferents

Per exemple:

• un comptador IAMMETER monitora la importació/exportació de la xarxa;
• una integració d'inversor de tercers proporciona la generació fotovoltaica a Home Assistant;
• IAMMETER-Link puja les entitats de l'inversor com a Comptador Virtual;
• IAMMETER Cloud mostra les dades del costat de la xarxa i del costat de l'inversor al flux de treball de monitoratge solar.

Això és especialment útil quan una plataforma no es comunica de manera nativa amb totes les marques d'inversors.

Cal accés remot o multiinstal·lació

Home Assistant pot continuar sent el centre d'integració local de cada instal·lació, mentre que algunes mesures energètiques seleccionades s'envien a IAMMETER Cloud per a quadres de comandament remots i anàlisis a més llarg termini.

L'estructura exacta d'emplaçament i de Comptador Virtual s'hauria de planificar abans del desplegament. No mapis diversos sistemes independents al mateix número de sèrie de Comptador Virtual.

Requisits

Abans de la instal·lació, comprova que tens:

• una instal·lació de Home Assistant en funcionament;
• entitats d'origen estables per a les mesures necessàries;
• accés a internet des de Home Assistant cap a IAMMETER Cloud;
• un compte d'IAMMETER Cloud;
• un número de sèrie de Comptador Virtual d'IAMMETER;
• HACS, tret que triïs la instal·lació manual del component personalitzat.

Repositori d'IAMMETER-Link:

• Repositori de GitHub
• Versió actual v1.1.1

La versió v1.1.1 inclou una lògica de pujada optimitzada i gestió de l'estat de càrrega.

Interval de pujada: Basic i Pro

L'interval de pujada depèn del nivell de servei d'IAMMETER Cloud:

IAMMETER-Link està pensat per a l'enviament de dades al núvol i el monitoratge remot, no per a bucles de control de nivell de segon. Mantén les automatitzacions ràpides dins de Home Assistant amb les entitats locals originals.

Per exemple:

• fes servir una entitat de potència local per Modbus o MQTT per a una automatització de 2–5 segons;
• fes servir IAMMETER-Link per a actualitzacions al núvol d'un o cinc minuts i per a l'anàlisi.

Pas 1: Instal·la IAMMETER-Link

Instal·lació amb HACS

1. Assegura't que HACS estigui instal·lat.
2. Afegeix https://github.com/lewei50/ha_iammeter_link com a Integration als repositoris personalitzats de HACS si encara no està disponible.
3. Cerca i instal·la IAMMETER-Link.
4. Reinicia Home Assistant quan calgui.

Afegeix la integració

Ves a:

Settings → Devices & services → Add integration

Cerca IAMMETER-Link i inicia el flux de configuració.

Pas 2: Inicia sessió i selecciona un Comptador Virtual

Introdueix la informació del teu compte d'IAMMETER Cloud durant la configuració. Si no tens compte, segueix l'opció de registre que ofereix el flux de configuració.

Si el compte ja té un Comptador Virtual disponible, selecciona'n el número de sèrie. En cas contrari, sol·licita o crea el Comptador Virtual adequat mitjançant el flux de treball disponible d'IAMMETER Cloud.

Tracta el número de sèrie del Comptador Virtual com la identitat de destinació d'aquest flux de dades. Evita configurar diversos clients de pujada perquè escriguin sistemes diferents al mateix Comptador Virtual.

Pas 3: Tria monofàsic o trifàsic

Selecciona l'estructura que coincideixi amb les dades d'origen:

• Single Phase per a un sol grup de tensió, corrent, potència, kWh importats i kWh exportats;
• Three Phase per a mapatges separats de les entitats A, B i C.

Per a dades trifàsiques, defineix amb cura el rol i el mapatge de cada fase. IAMMETER Cloud utilitza aquesta estructura en mostrar i analitzar els valors pujats.

No seleccionis trifàsic només pel fet que existeixin diversos sensors de Home Assistant. Les entitats han de representar les fases elèctriques o els canals de mesura corresponents.

Pas 4: Mapa les entitats de Home Assistant

IAMMETER-Link mapa els ID d'entitat de Home Assistant als camps del Comptador Virtual.

Mapatge monofàsic

Mapatge trifàsic

Mapa els mateixos camps per separat per a les fases A, B i C.

Un camp no utilitzat es pot establir a 0. Tanmateix, si un camp està mapat a una entitat i aquesta entitat no es pot llegir correctament en temps d'execució, el procés de pujada es pot aturar. Mapa només entitats que hagis verificat com a estables.

Valida cada entitat abans de mapar-la

Obre Developer tools → States a Home Assistant i verifica:

1. que l'entitat existeix;
2. que el seu estat és numèric;
3. que la unitat és correcta;
4. que el valor té el signe esperat;
5. que continua disponible després de reiniciar Home Assistant;
6. que l'energia acumulada no es comporta com una potència instantània.

La potència ha d'estar en watts

Si l'origen informa en kW, crea un sensor convertit adequat o fes servir una entitat amb l'escala correcta abans de mapar-la. No etiquetis un valor en kW com a W sense multiplicar-lo per 1.000.

L'energia ha de ser kWh acumulats

Els camps Import i Export normalment haurien de fer servir entitats de kWh acumulats. Un sensor d'energia diària que es reinicia a mitjanit té una semàntica diferent de la d'un total acumulat i pot distorsionar l'anàlisi al núvol si es tracta com a energia total.

Confirma la direcció d'importació/exportació

Integracions diferents fan servir termes com import, consumption, feed-in, return, export, bought o sold. Confirma quina direcció representa cada entitat abans de mapar-la.

No inventis mesures no disponibles

Si una integració d'inversor proporciona generació fotovoltaica però no importació/exportació de xarxa, mapa els camps de generació disponibles al rol corresponent del Comptador Virtual. No reutilitzis la mateixa entitat de potència com a generació i com a potència de xarxa només per omplir tots els camps.

Pas 5: Verifica les dades pujades a IAMMETER Cloud

Després de completar la configuració, espera l'interval de pujada corresponent de Basic o Pro i obre IAMMETER Cloud.

Comprova:

• que el Comptador Virtual està en línia;
• que la tensió, el corrent i la potència tenen magnituds plausibles;
• que Import i Export no estan invertits;
• que les fases A/B/C apareixen en l'ordre esperat;
• que l'energia acumulada augmenta correctament;
• que les marques de temps continuen actualitzant-se;
• que els gràfics solars o de càrrega coincideixen amb l'historial de Home Assistant d'origen.

Compara diverses marques de temps entre Home Assistant i IAMMETER Cloud abans de confiar en els informes.

Exemple de monitoratge solar

Suposem una instal·lació que té:

• un comptador trifàsic IAMMETER que mesura la xarxa;
• un inversor trifàsic ja integrat a Home Assistant;
• cap connexió de dades compatible directa entre aquest inversor i IAMMETER Cloud.

IAMMETER-Link pot enviar les entitats de potència i energia de l'inversor de Home Assistant a un Comptador Virtual trifàsic. Aleshores IAMMETER Cloud pot fer servir:

• el comptador físic per a la interacció amb la xarxa;
• el Comptador Virtual per a la producció de l'inversor;
• totes dues fonts de dades a la vista ampliada de monitoratge solar.

Consulta la solució de monitoratge solar d'IAMMETER i el monitoratge solar amb Home Assistant per a casos d'ús relacionats.

Resolució de problemes

No apareixen dades després de la configuració

• Confirma que Home Assistant té accés a internet.
• Verifica el compte d'IAMMETER Cloud i el número de sèrie del Comptador Virtual.
• Espera l'interval complet de pujada de Basic o Pro.
• Revisa els registres de Home Assistant per si hi ha errors d'IAMMETER-Link.
• Confirma que totes les entitats mapades existeixen i retornen un valor numèric.

La pujada s'atura després d'haver funcionat normalment

• Busca alguna entitat mapada que hagi passat a unknown o unavailable.
• Comprova si alguna actualització d'integració ha canviat el nom d'un ID d'entitat.
• Confirma que un sensor de plantilla encara renderitza un número.
• Revisa els errors d'autenticació i de xarxa.
• Actualitza a la versió més recent d'IAMMETER-Link.

Els valors són 1.000 vegades massa grans o massa petits

• Comprova W davant de kW.
• Comprova kWh davant de Wh.
• Comprova qualsevol conversió de plantilla aplicada a Home Assistant.
• Confirma les ràtios dels transformadors de corrent externs al sistema de mesura d'origen.

Import i Export estan invertits

• Verifica la convenció de nomenclatura de la integració d'origen.
• Compara el valor mentre l'emplaçament clarament importa o exporta de la xarxa.
• Corregeix el mapatge d'entitats en lloc de compensar-ho als informes del núvol.

Els gràfics trifàsics es veuen malament

• Confirma el mapatge A/B/C i els rols de fase.
• Verifica que cada entitat pertany a la fase prevista.
• No barregis la potència total amb camps específics de fase.

El control local i l'enviament de dades al núvol han de romandre separats

IAMMETER-Link depèn de Home Assistant, de l'accés a internet i d'IAMMETER Cloud. No hauria de ser la via de retroalimentació per a automatitzacions crítiques per a la seguretat o de nivell de segon.

Fes servir les entitats locals de Home Assistant per a:

• control de relés;
• commutació de l'excedent solar;
• decisions de càrrega de vehicles elèctrics;
• alarmes que requereixen resposta immediata.

Fes servir IAMMETER-Link i IAMMETER Cloud per a:

• visibilitat remota;
• quadres de comandament a més llarg termini;
• anàlisi del cost de l'electricitat i de l'energia;
• combinar fonts d'energia seleccionades;
• revisió operativa de múltiples emplaçaments.

Guies relacionades

• Repositori de GitHub d'IAMMETER-Link
• IAMMETER-Link v1.1.1
• Comptador Virtual d'IAMMETER
• IAMMETER Cloud
• Compara les integracions de comptadors d'energia amb Home Assistant
• Matriu d'integracions de Home Assistant

Actualitzat: 22 de juliol de 2026.