MQTT-energimåler: Udgiv IAMMETER-data til din MQTT-broker

Udgiv IAMMETER-energidata til en MQTT-broker

IAMMETER Wi-Fi-energimålere kan fungere som MQTT-energimålere og udgive realtidsdata for spænding, strøm, aktiv effekt og energi direkte til din egen MQTT-broker. Dette giver en lokal og åben måde at integrere IAMMETER med et tilpasset overvågningssystem, en automatiseringsplatform eller Home Assistant.

Den nyeste IAMMETER-firmware giver dig mulighed for at konfigurere MQTT-forbindelsen direkte fra målerens lokale WebUI.

1. Konfigurér MQTT-udgivelse

1.1 MQTT-indstillinger

Åbn målerens lokale WebUI, og gå til siden Settings. Konfigurér MQTT-forbindelsen ved hjælp af felterne vist nedenfor:

Indstilling	Konfiguration
Run Mode	Vælg MQTT
Address	Indtast MQTT-brokerens adresse og port
Username/Password	Indtast brokerens legitimationsoplysninger; lad dem stå tomme, kun hvis anonyme forbindelser er tilladt
HA MQTT Discovery	Aktivér kun til automatisk registrering i Home Assistant
Real-time topic	device/{SN}/realtime

Når du har udfyldt indstillingerne, skal du klikke på Save. Måleren opretter forbindelse til den konfigurerede broker og udgiver sine måledata som en MQTT-klient.

Den nyeste firmwares WebUI understøtter de MQTT-indstillinger, der er beskrevet ovenfor. Der er ikke behov for at konfigurere brokerens brugernavn og adgangskode via et lokalt API.

1.2 Hvornår skal HA MQTT Discovery aktiveres

HA MQTT Discovery bruges kun til automatisk registrering i Home Assistant.

• Hvis du udgiver data til en almindelig MQTT-broker eller et andet tredjepartssystem, skal du holde HA MQTT Discovery deaktiveret.
• Hvis Home Assistant er forbundet til den samme MQTT-broker, og du vil have, at den automatisk registrerer IAMMETER-måleren og opretter de tilsvarende enheds- og sensor-entities, skal du aktivere HA MQTT Discovery.
• Aktivering af MQTT-udgivelse kræver ikke, at HA MQTT Discovery er aktiveret. Det er relaterede, men separate funktioner.

For den fulde registreringsprocedure, se Aktivér MQTT Discovery i Home Assistant med IAMMETER. Hvis du vil sammenligne MQTT Discovery med IAMMETER's andre Home Assistant-integrationsmetoder, herunder den officielle integration, Modbus/TCP og manuel MQTT-konfiguration, så start med IAMMETER Home Assistant-integrationsguiden.

2. MQTT-emne og -payload

2.1 Abonnér på realtidsemnet

Emne: device/{SN}/realtime

Erstat {SN} med serienummeret på din IAMMETER-måler. Når måleren har oprettet forbindelse til MQTT-brokeren, kan en MQTT-klient abonnere på dette emne for at modtage realtidsmåledata.

2.2 Fortolk JSON-payloaden

Uanset om måleren er konfigureret til at uploade data til en tredjepartsserver via HTTP/HTTPS, TCP/TLS eller MQTT, eller om måledataene hentes via et lokalt API, forbliver JSON-formatet for målingerne det samme.

For eksempel udgiver en enkeltfasemåler et Data-array, der indeholder spænding, strøm, aktiv effekt, fremadrettet aktiv energi og tilbageregistreret aktiv energi:

{
  "method": "uploadsn",
  "mac": "B0F8932A295C",
  "version": "i.75.98.71y",
  "server": "em",
  "SN": "12345678",
  "Data": [228.91, 1.61, 225, 15066.47, 0]
}

Trefasemålere bruger et Datas-array med separate målearrays for faserne A, B og C. Se den fuldstændige IAMMETER JSON-datadefinition, før du parser payloaden i et tredjepartsprogram.

3. Relaterede vejledninger

• Opgrader til den nyeste IAMMETER-firmware
• Aktivér MQTT Discovery i Home Assistant med IAMMETER
• IAMMETER MQTT JSON-dataformat
• Andre måder at integrere IAMMETER med en tredjepartsserver

4. Konfiguration til ældre firmware

Instruktionerne nedenfor er bevaret til målere, der stadig bruger en ældre firmwareversion og ikke tilbyder de nuværende MQTT-konfigurationsmuligheder i WebUI.

Hvis din målers WebUI ligner skærmbillederne nedenfor, skal du følge denne ældre procedure. Alternativt kan du opgradere til den nyeste firmware og bruge WebUI-proceduren i afsnit 1.

4.1 Ældre enhedskonfiguration

Konfigurér uploadtilstanden og MQTT-brokeradressen som følger:

• Run Mode: TCP
• TCP-adresse: mqtt://[URL of your MQTT server]:[port]

4.2 Ældre konfiguration af brugernavn og adgangskode

Konfiguration af brugernavn og adgangskode kræver firmware i.75.97.5 eller nyere.

I denne tilstand fungerer Wi-Fi-energimåleren som en MQTT-klient og understøtter følgende broker-godkendelsesmetoder:

1. Brugernavn og adgangskode
2. Client ID, hvor målerens serienummer bruges som Client ID
3. Anonym forbindelse

På ældre firmware kan du angive MQTT-brugernavnet og -adgangskoden via målerens lokale API:

http://{local IP of the energy meter}/api/mqtt?user=laoliu&pwd=123456

Erstat laoliu og 123456 med den faktiske MQTT-brokers brugernavn og adgangskode.

Noter om ældre konfiguration:

• Maksimal længde for både brugernavn og adgangskode er 20 tegn.
• Tegnet & understøttes ikke i brugernavnet eller adgangskoden.

For at hente den aktuelle MQTT-godkendelsesindstilling skal du bruge:

http://{local IP of the energy meter}/api/mqtt

API'et returnerer ikke selve MQTT-adgangskoden; det returnerer kun adgangskodens længde.