Comptador d'energia MQTT per a Home Assistant: configuració manual YAML

Configureu manualment un comptador d'energia MQTT a Home Assistant

Un comptador d'energia MQTT pot publicar tensió, corrent, potència activa i energia importada/exportada a un broker de la vostra xarxa local. Home Assistant se subscriu a aquestes dades i converteix els valors JSON en entitats de sensor que es poden utilitzar en taulers, automatitzacions i el tauler d'energia.

Aquesta guia explica el mètode Manual MQTT per als comptadors d'energia IAMMETER:

1. configureu el broker MQTT a la WebUI del comptador;
2. connecteu Home Assistant al mateix broker;
3. definiu els sensors MQTT requerits en YAML;
4. afegiu l'energia importada i exportada al tauler d'energia.

Manual MQTT us dona el control total sobre els noms d'entitat, els topics, les plantilles i les metadades. Si preferiu que Home Assistant creï el dispositiu i les entitats automàticament, utilitzeu MQTT Discovery.

Manual MQTT i MQTT Discovery són mètodes diferents

Tots dos mètodes utilitzen un broker MQTT, però la configuració a Home Assistant és diferent.

Per a aquesta guia, deixeu HA MQTT Discovery desactivat a la WebUI del comptador. Aquest interruptor només és necessari quan voleu la descoberta automàtica de Home Assistant.

Què necessiteu

• un comptador d'energia IAMMETER amb el firmware actual;
• un broker MQTT accessible tant pel comptador com per Home Assistant;
• l'adreça, el port, el nom d'usuari i la contrasenya del broker;
• el número de sèrie del comptador;
• accés a la configuració YAML de Home Assistant.

El broker pot executar-se a la mateixa màquina que Home Assistant, en l'addició del broker Mosquitto, en un altre servidor de la LAN o en un amfitrió remot. Utilitzeu un broker local quan vulgueu que tot el camí de dades romangui dins de la LAN.

Tots els comptadors IAMMETER actuals admeten Manual MQTT. Els models monofàsics, de doble canal i trifàsics publiquen estructures d'array JSON diferents, per la qual cosa les plantilles de valors han de coincidir amb la càrrega útil real.

Pas 1: Configureu el broker MQTT a la WebUI del comptador

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

Desa la configuració i deixa que el comptador es torni a connectar.

La WebUI del firmware actual admet aquestes configuracions de broker directament. No cal configurar el nom d'usuari i la contrasenya mitjançant el procediment històric de l'API local.

Per a la configuració completa del costat del comptador i instruccions per a firmwares antics, vegeu publiqueu dades d'IAMMETER a un broker MQTT.

Mode MQTT i IAMMETER Cloud

Quan el mode d'execució del comptador es canvia a MQTT, aquest publica les mesures al vostre broker en lloc de carregar-les a IAMMETER Cloud. Per tant, Manual MQTT i IAMMETER Cloud no s'executen simultàniament des del mateix comptador.

Si necessiteu Home Assistant i IAMMETER Cloud al mateix temps, utilitzeu una integració HTTP local o Modbus TCP. Compareu els mètodes disponibles a la guia d'integració del comptador d'energia amb Home Assistant.

Pas 2: Verifiqueu el topic i la càrrega útil MQTT

IAMMETER publica les mesures en temps real a:

device/{SN}/realtime

Substituïu {SN} pel número de sèrie del comptador. Per exemple:

device/80123456/realtime

Abans de configurar els sensors de Home Assistant, subscriviu-vos al topic amb un client MQTT i confirmeu que els missatges arriben. Això evita que la resolució de problemes de YAML es barregi amb problemes de broker, credencials, firewall o topics.

JSON monofàsic

Un comptador monofàsic utilitza un array Data. Els cinc primers valors són:

Exemple:

{
  "method": "uploadsn",
  "SN": "12345678",
  "Data": [228.91, 1.61, 225, 15066.47, 0]
}

JSON multicanal i trifàsic

Els comptadors multicanal i trifàsics utilitzen un array Datas. Cada array niuada representa una fase o un canal de mesura:

Datas[0] → fase/canal A
Datas[1] → fase/canal B
Datas[2] → fase/canal C, quan està present

Dins de cada array de fase/canal, les posicions habituals són:

Inspeccioneu sempre el missatge MQTT real del vostre model i firmware abans de copiar plantilles. Vegeu la definició completa de dades JSON d'IAMMETER.

Pas 3: Connecteu Home Assistant al broker

A Home Assistant:

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

Si Home Assistant ja utilitza aquest broker, no afegiu una integració MQTT duplicada. Els sensors definits manualment utilitzaran la connexió al broker existent.

Pas 4: Afegiu sensors de Manual MQTT en YAML

Els exemples següents utilitzen l'estructura de configuració actual mqtt: sensor: de Home Assistant. Substituïu el número de sèrie a cada state_topic.

YAML del comptador d'energia monofàsic

mqtt:
  sensor:
    - name: "IAMMETER Voltage"
      unique_id: "iammeter_12345678_voltage"
      state_topic: "device/12345678/realtime"
      value_template: "{{ value_json.Data[0] | float(0) }}"
      unit_of_measurement: "V"
      device_class: voltage
      state_class: measurement

    - name: "IAMMETER Current"
      unique_id: "iammeter_12345678_current"
      state_topic: "device/12345678/realtime"
      value_template: "{{ value_json.Data[1] | float(0) }}"
      unit_of_measurement: "A"
      device_class: current
      state_class: measurement

    - name: "IAMMETER Active Power"
      unique_id: "iammeter_12345678_active_power"
      state_topic: "device/12345678/realtime"
      value_template: "{{ value_json.Data[2] | float(0) }}"
      unit_of_measurement: "W"
      device_class: power
      state_class: measurement

    - name: "IAMMETER Imported Energy"
      unique_id: "iammeter_12345678_import_energy"
      state_topic: "device/12345678/realtime"
      value_template: "{{ value_json.Data[3] | float(0) }}"
      unit_of_measurement: "kWh"
      device_class: energy
      state_class: total_increasing

    - name: "IAMMETER Exported Energy"
      unique_id: "iammeter_12345678_export_energy"
      state_topic: "device/12345678/realtime"
      value_template: "{{ value_json.Data[4] | float(0) }}"
      unit_of_measurement: "kWh"
      device_class: energy
      state_class: total_increasing

unique_id permet que Home Assistant gestioni la configuració de les entitats a la interfície. Mantingueu cada ID únic i estable. No el canvieu només per canviar el nom de l'entitat mostrada.

YAML del comptador d'energia trifàsic

L'exemple següent crea les entitats de la fase A. Dupliqueu el bloc per a les fases B i C, canviant Datas[0] a Datas[1] i Datas[2], i utilitzeu noms i IDs únics diferents.

mqtt:
  sensor:
    - name: "IAMMETER Voltage A"
      unique_id: "iammeter_80123456_voltage_a"
      state_topic: "device/80123456/realtime"
      value_template: "{{ value_json.Datas[0][0] | float(0) }}"
      unit_of_measurement: "V"
      device_class: voltage
      state_class: measurement

    - name: "IAMMETER Current A"
      unique_id: "iammeter_80123456_current_a"
      state_topic: "device/80123456/realtime"
      value_template: "{{ value_json.Datas[0][1] | float(0) }}"
      unit_of_measurement: "A"
      device_class: current
      state_class: measurement

    - name: "IAMMETER Active Power A"
      unique_id: "iammeter_80123456_active_power_a"
      state_topic: "device/80123456/realtime"
      value_template: "{{ value_json.Datas[0][2] | float(0) }}"
      unit_of_measurement: "W"
      device_class: power
      state_class: measurement

    - name: "IAMMETER Imported Energy A"
      unique_id: "iammeter_80123456_import_energy_a"
      state_topic: "device/80123456/realtime"
      value_template: "{{ value_json.Datas[0][3] | float(0) }}"
      unit_of_measurement: "kWh"
      device_class: energy
      state_class: total_increasing

    - name: "IAMMETER Exported Energy A"
      unique_id: "iammeter_80123456_export_energy_a"
      state_topic: "device/80123456/realtime"
      value_template: "{{ value_json.Datas[0][4] | float(0) }}"
      unit_of_measurement: "kWh"
      device_class: energy
      state_class: total_increasing

Per al WEM2067 i altres models multicanal, creeu només el nombre de blocs de canals presents a la càrrega útil Datas real.

Eviteu dos blocs mqtt: de nivell superior

Si configuration.yaml ja conté una secció mqtt:, afegiu els sensors sota la secció existent. YAML no pot contenir de manera segura dues claus de nivell superior independents amb el mateix nom.

Per a una configuració gran, podeu mantenir els sensors MQTT en un fitxer inclòs, però seguiu l'estructura d'inclusió i les regles de sagnat de Home Assistant.

Pas 5: Comproveu la configuració i carregueu els sensors

Després de desar el YAML:

1. executeu la comprovació de configuració de Home Assistant;
2. corregiu qualsevol error de YAML, sagnat o plantilla;
3. reinicieu Home Assistant si cal;
4. obriu Eines de desenvolupament → Estats;
5. confirmeu que cada entitat MQTT té un valor, una unitat, una classe de dispositiu i una classe d'estat plausibles.

El valor de l'entitat hauria de canviar després que arribi un missatge nou a device/{SN}/realtime.

Pas 6: Afegiu l'energia importada i exportada al tauler d'energia

El tauler d'energia de Home Assistant requereix entitats d'energia acumulades. Els exemples YAML utilitzen:

unit_of_measurement: "kWh"
device_class: energy
state_class: total_increasing

Aneu a Configuració → Taulers → Energia i seleccioneu:

• IAMMETER Imported Energy per al consum de la xarxa;
• IAMMETER Exported Energy per a la devolució a la xarxa.

Per a un comptador trifàsic, trieu l'estructura d'entitat que coincideixi amb la instal·lació i el disseny del tauler de Home Assistant. Podeu exposar l'energia de cada fase individualment o crear una entitat total adequada, però no sumeu valors sense confirmar com el comptador informa de l'energia de fase i neta per al mode de cablejat seleccionat.

No seleccioneu l'entitat de potència activa mesurada en watts en un camp d'energia del tauler d'energia. La potència és una taxa instantània; el tauler requereix kWh acumulats.

Trieu un interval de publicació MQTT

El firmware actual d'IAMMETER admet un interval de publicació MQTT de fins a 2 segons. L'interval més curt no sempre és la millor configuració.

Punts de partida suggerits:

Tingueu en compte la capacitat del broker, el creixement de l'historial de Home Assistant, la fiabilitat de la xarxa i el nombre d'entitats. Un missatge amb molts valors de fase pot actualitzar diversos sensors de Home Assistant alhora.

Models IAMMETER admesos

Tots els comptadors d'energia IAMMETER actuals admeten Manual MQTT. La seva principal diferència amb Home Assistant és l'estructura de la càrrega útil i el nombre de canals de mesura.

El WEM3046T i el WEM3046TE mesuren la sortida secundària de 5 A dels CT externs. Apliqueu la relació de transformació CT correcta per obtenir els valors del costat primari. Això és una característica del sistema de mesura, no una limitació de MQTT o Home Assistant.

Resolució de problemes

No arriben missatges MQTT

• Verifiqueu l'adreça i el port del broker a la WebUI del comptador.
• Confirmeu el nom d'usuari i la contrasenya.
• Consulteu els registres del broker per detectar errors d'autenticació o connexió.
• Confirmeu que el comptador pot arribar al broker a través de qualsevol regla de firewall o VLAN.
• Subscriviu-vos a device/{SN}/realtime amb un client MQTT independent.

Els missatges arriben, però les entitats de Home Assistant no estan disponibles

• Confirmeu que Home Assistant està connectat al mateix broker.
• Comproveu el topic i el número de sèrie exactes.
• Compareu Data amb Datas amb la càrrega útil real.
• Valideu el sagnat i les plantilles YAML.
• Consulteu els registres de Home Assistant després de recarregar o reiniciar.

Algunes entitats mostren zero o la mesura incorrecta

• No copieu una plantilla Data monofàsica per a una càrrega útil Datas.
• Verifiqueu la posició de l'array segons la definició JSON.
• Confirmeu l'índex de fase/canal.
• Per al WEM3046T/WEM3046TE, confirmeu la relació de transformació CT externa.

Les entitats d'energia falten al tauler d'energia

Confirmeu els tres camps:

unit_of_measurement: "kWh"
device_class: energy
state_class: total_increasing

També confirmeu que l'entitat ha rebut dades numèriques vàlides i apareix a Eines de desenvolupament → Estats.

Apareixen dispositius o sensors duplicats

Manual MQTT i MQTT Discovery poden crear entitats separades a partir del mateix comptador. Si utilitzeu el mètode YAML, manteniu HA MQTT Discovery desactivat tret que vulgueu deliberadament ambdós conjunts i hagueu planificat noms d'entitat únics.

Guies relacionades

• Publiqueu dades d'IAMMETER al vostre broker MQTT
• Utilitzeu MQTT Discovery en lloc de YAML
• Compareu tots els mètodes d'integració IAMMETER–Home Assistant
• Definició de dades JSON d'IAMMETER
• Actualitzeu el firmware d'IAMMETER

Actualitzat: 19 de juliol de 2026.