Descobriment MQTT de Home Assistant per a un comptador d'energia

Descobriment MQTT de Home Assistant per a un comptador d'energia

El descobriment MQTT de Home Assistant permet que un comptador d'energia creï automàticament el seu dispositiu i les seves entitats de sensors. Després que el comptador i Home Assistant es connectin al mateix broker MQTT, Home Assistant pot descobrir el comptador sense YAML manual de sensors MQTT.

IAMMETER ofereix suport de descobriment MQTT a tots els comptadors d'energia actuals. Depenent del model, Home Assistant crea entitats per a la tensió, el corrent, la potència activa, l'energia importada, l'energia exportada i altres mesures de fase o canal disponibles.

Utilitzeu aquest mètode quan vulgueu:

• monitoratge d'energia MQTT local;
• creació automàtica de dispositius i entitats;
• actualitzacions més ràpides que les integracions HTTP;
• entitats d'energia importada/exportada compatibles amb el quadre de bord d'energia (Energy Dashboard);
• configuració mínima de Home Assistant.

Si necessiteu un control complet sobre els temes (topics), les plantilles, els noms d'entitats i les metadades, utilitzeu la guia de comptador d'energia MQTT manual en lloc seu.

Descobriment MQTT versus MQTT manual

Tots dos mètodes requereixen un broker MQTT, però només el descobriment crea automàticament les entitats de Home Assistant.

No activeu el descobriment i definiu manualment les mateixes mesures tret que vulgueu deliberadament dos conjunts d'entitats separats.

Requisits

Necessiteu:

• un comptador d'energia IAMMETER amb el firmware i.76.058.8 o posterior;
• un broker MQTT accessible des del comptador i des de Home Assistant;
• l'adreça, el port, el nom d'usuari i la contrasenya del broker;
• Home Assistant amb la integració MQTT activada.

El firmware i.76.058.8 és la versió estable de referència per al descobriment MQTT. La imatge anterior i.76.02 era un firmware de prova i ja no s'ha d'instal·lar ni enllaçar com a versió recomanada.

Per veure les correccions actuals i les últimes opcions MQTT, actualitzeu al firmware IAMMETER més recent.

Pas 1: Connecteu Home Assistant al broker MQTT

Si Home Assistant encara no està connectat al broker:

1. Obriu Configuració → Dispositius i serveis.
2. Seleccioneu Afegeix una integració.
3. Cerqueu MQTT.
4. Introduïu l'adreça, el port, el nom d'usuari i la contrasenya del broker.
5. Confirmeu que la integració MQTT es connecta correctament.

Si Home Assistant ja utilitza el broker previst, conserveu la integració MQTT existent. No creeu una segona connexió al broker per al dispositiu IAMMETER.

El descobriment MQTT està activat per defecte en una configuració MQTT normal de Home Assistant. Si el descobriment s'ha desactivat o s'utilitza un prefix de descobriment no estàndard, assegureu-vos que el comptador i Home Assistant utilitzin configuracions compatibles.

Pas 2: Configureu el descobriment MQTT a la WebUI del comptador

Obriu la WebUI local del comptador i aneu a Configuració. Configureu:

Deseu la configuració i permeteu que el comptador es reiniciï o es torni a connectar.

El firmware més recent exposa la configuració necessària a la WebUI. No cal cridar l'endpoint històric /api/mqttha?x=1.

L'opció Descobriment MQTT de HA és específicament per al descobriment automàtic de Home Assistant. Per a un broker genèric, un sistema personalitzat, un flux Node-RED o una configuració MQTT manual, deixeu-la desactivada i utilitzeu el format de publicació MQTT estàndard del comptador.

Pas 3: Confirmeu que Home Assistant descobreix el comptador

Després que el comptador es connecti al broker:

1. Obriu Configuració → Dispositius i serveis → MQTT.
2. Busqueu un dispositiu IAMMETER acabat de descobrir.
3. Obriu el dispositiu i reviseu les entitats.
4. Confirmeu que els valors de tensió, corrent, potència i energia són plausibles.
5. Comproveu que hi ha el nombre esperat de fases o canals de mesura.

La configuració del descobriment i l'estat de les mesures s'envien per temes (topics) MQTT diferents. Home Assistant utilitza la configuració del descobriment per crear les entitats i, després, actualitza els seus valors quan arriben els missatges d'estat.

Si el dispositiu no apareix, reinicieu només després de comprovar la connexió al broker i els temes. Un reinici de Home Assistant no pot solucionar una adreça de broker incorrecta ni unes credencials MQTT rebutjades.

Compatibilitat amb el quadre de bord d'energia (Energy Dashboard)

Les càrregues útils del descobriment MQTT d'IAMMETER actuals inclouen les metadades necessàries per a les entitats d'energia importada i exportada:

unit_of_measurement: kWh
device_class: energy
state_class: total_increasing

IAMMETER utilitza les claus compactes del descobriment MQTT corresponents a aquests camps, incloent-hi:

{
  "unit_of_meas": "kWh",
  "dev_cla": "energy",
  "stat_cla": "total_increasing"
}

Després que les entitats rebin dades vàlides:

1. aneu a Configuració → Quadres de bord (Dashboards) → Energia;
2. seleccioneu l'entitat d'energia importada per al consum de la xarxa;
3. seleccioneu l'entitat d'energia exportada per al retorn a la xarxa;
4. deseu la configuració del quadre de bord d'energia.

No seleccioneu una entitat de potència activa instantània en watts per a un camp d'energia. El quadre de bord d'energia requereix kWh acumulats.

Els models monofàsics i trifàsics creen entitats d'energia diferents. Trieu les entitats que corresponguin al cablejat del comptador i a la manera com la instal·lació mesura la importació/exportació de la xarxa.

Trieu un interval d'actualització MQTT

El firmware IAMMETER més recent admet actualitzacions MQTT fins a 2 segons. Un interval més curt proporciona a Home Assistant lectures de potència més recents, però també genera més trànsit al broker, més actualitzacions d'entitats i més dades de registre (recorder).

Punts de partida suggerits:

Utilitzeu l'interval més curt només quan l'automatització se'n beneficiï. Els totals del quadre de bord d'energia generalment no requereixen actualitzacions de dos segons.

Compatibilitat amb IAMMETER Cloud

El descobriment MQTT canvia el mode d'execució del comptador a MQTT. El comptador envia les seves mesures al broker configurat i no les puja simultàniament a IAMMETER Cloud.

Si necessiteu tant Home Assistant com IAMMETER Cloud des del mateix comptador, trieu una integració HTTP local o Modbus TCP. Aquests mètodes llegeixen el comptador localment mentre la pujada normal al núvol continua.

Compareu les opcions a la visió general de les integracions de comptador d'energia amb Home Assistant.

Models IAMMETER compatibles

Tots els comptadors d'energia IAMMETER actuals admeten el descobriment MQTT. La diferència principal és el nombre de fases/canals i, per tant, el nombre d'entitats creades.

WEM3046T i WEM3046TE mesuren la sortida secundària de 5 A dels transformadors de corrent externs. Cal aplicar la relació de transformació (CT) correcta per obtenir el corrent, la potència i l'energia del costat primari. Això és un requisit del sistema de mesura, no una limitació de Home Assistant ni del descobriment MQTT.

El WEM3162, discontinuat, no està inclòs en l'abast de compatibilitat actual.

Resolució de problemes del descobriment MQTT

Home Assistant no descobreix el comptador

• Confirmeu que el comptador i Home Assistant utilitzen el mateix broker.
• Comproveu l'adreça, el port, el nom d'usuari i la contrasenya del broker.
• Confirmeu que Descobriment MQTT de HA està activat a la WebUI del comptador.
• Reviseu els registres del broker per detectar connexions rebutjades o errors d'autorització.
• Verifiqueu que la integració MQTT de Home Assistant està connectada.
• Subscriviu-vos al prefix de descobriment de Home Assistant del broker amb un client MQTT i comproveu si hi ha missatges de configuració.

El dispositiu apareix, però les entitats no estan disponibles

• Confirmeu que el comptador continua publicant missatges d'estat després de la configuració del descobriment.
• Comproveu si un tallafocs, una VLAN o una ACL del broker permet tant els temes de descobriment com els d'estat.
• Verifiqueu que el comptador no ha canviat a un broker diferent.
• Actualitzeu al firmware més recent i torneu a connectar.

L'energia importada/exportada no es pot seleccionar al quadre de bord d'energia

• Confirmeu que l'entitat ha rebut un valor numèric de kWh vàlid.
• Obriu Eines de desenvolupament → Estats i inspeccioneu la seva unitat, classe de dispositiu i classe d'estat.
• Elimineu les entitats obsoletes creades per firmwares de prova antics abans d'avaluar la càrrega útil de descobriment actual.
• Confirmeu que seleccioneu una entitat d'energia, no una entitat de potència activa.

Apareixen entitats MQTT duplicades

Els duplicats normalment es produeixen quan:

• el YAML MQTT manual i el descobriment MQTT estan actius alhora;
• el número de sèrie del comptador o l'ID únic del descobriment han canviat;
• un firmware antic va publicar una configuració de descobriment diferent;
• queden al broker temes de descobriment retinguts d'una configuració antiga.

Trieu o bé MQTT manual o bé descobriment MQTT per a les mateixes mesures i, després, elimineu la configuració obsoleta.

Elimineu les entitats de descobriment retingudes antigues

Els missatges de configuració del descobriment MQTT sovint queden retinguts al broker perquè Home Assistant pugui recrear les entitats després d'un reinici. Si queda un tema de configuració antic, suprimir el dispositiu només a la interfície de Home Assistant pot no ser suficient: l'entitat pot tornar quan es torni a rebre la configuració retinguda.

Procediment de neteja segur:

1. Desactiveu Descobriment MQTT de HA al comptador o desconnecteu-lo temporalment perquè no torni a publicar immediatament la configuració antiga.
2. Utilitzeu un client MQTT per inspeccionar el prefix de descobriment de Home Assistant, normalment homeassistant/#.
3. Identifiqueu només els temes de configuració que pertanyen al número de sèrie/dispositiu IAMMETER afectat.
4. Publiqueu una càrrega útil retinguda buida a cada tema de configuració obsolet.
5. Elimineu el dispositiu/les entitats obsoletes de Home Assistant si encara hi són.
6. Activeu de nou el descobriment al firmware actual.
7. Confirmeu que es crea un únic dispositiu i les entitats actuals esperades.

No suprimiu tot l'arbre de temes retinguts homeassistant/# en un broker compartit. Això podria eliminar la configuració de descobriment de dispositius no relacionats.

Quan el MQTT manual és la millor opció

Utilitzeu MQTT manual quan necessiteu:

• noms d'entitat i ID únics personalitzats;
• plantilles o càlculs JSON personalitzats;
• només un subconjunt seleccionat de mesures;
• una estructura de temes compartida amb aplicacions que no són de Home Assistant;
• control explícit de la classe de dispositiu i la classe d'estat;
• compatibilitat amb un sistema on el descobriment de Home Assistant està desactivat intencionadament.

Guies relacionades

• Configuració de comptador d'energia MQTT manual per a Home Assistant
• Publiqueu dades d'IAMMETER a un broker MQTT
• Compareu tots els mètodes d'integració IAMMETER–Home Assistant
• Actualitzeu al firmware IAMMETER més recent
• Documentació MQTT de Home Assistant

Actualitzat: 19 de juliol de 2026.