IAMMETER Wi-Fi Energy Meter: Lokale API-er og åpne grensesnitt

IAMMETER Wi-Fi Energy Meter: Lokale API-er og åpne grensesnitt

IAMMETER Wi-Fi energimålere støtter IAMMETER-Cloud i tillegg til lokale og tredjepartsintegrasjoner.

De tilgjengelige grensesnittene inkluderer:

• Lokalt HTTP-API over LAN
• MQTT- og MQTTS-publisering
• Modbus TCP
• TCP/TLS-last
• HTTP/HTTPS-last
• Frittstående lokal drift

Disse grensesnittene gjør at IAMMETER-målere kan fungere som åpne datakilder for:

• Home Assistant og andre smarthjem-plattformer
• Node-RED-automasjon
• Selvhostede dashbord
• PLC- og SCADA-systemer
• Egendefinerte energistyringssystemer (EMS)
• Egendefinerte byggstyringssystemer (BMS)
• Tredjepartsdataservere

Denne veiledningen beskriver gjeldende fastvare og WebUI først. Skjermbilder og konfigurasjonsmetoder for eldre fastvare finnes i den siste delen om tidligere versjoner (Legacy).

For en ferdig applikasjon bygget på disse funksjonene, se Home Energy Monitoring, Solar Energy Monitoring eller lokal overvåking uten internettilgang.

1) Oppdater til den nyeste fastvaren

IAMMETER-fastvaren oppdateres kontinuerlig. Før du konfigurerer en integrasjon, sjekk gjeldende utgivelse og modellkompatibilitet:

• IAMMETER Fastvare-utgivelsesside

Det nyeste fastvare-WebUI-et viser de vanligste konfigurasjonsalternativene direkte. Manuelle konfigurasjons-API-kall som er tatt med senere i denne artikkelen, er hovedsakelig nyttige ved vedlikehold av eldre installasjoner.

2) Velg kjøremodus i gjeldende WebUI

Velg en kjøremodus ut fra hvor måleren skal sende data, eller hvordan den skal operere lokalt.

Kjøremodusen styrer dataopplastingsatferden. Tilgjengeligheten av lokalt API og Modbus TCP bør likevel sjekkes for målerens modell, fastvare og valgte integrasjon.

3) Hvorfor de åpne grensesnittene betyr noe

Åpne grensesnitt lar brukere bestemme hvor elektrisitetsdata behandles og lagres.

Vanlige grunner inkluderer:

• Å beholde målingene innenfor det lokale nettverket
• Å sende telemetri til en eksisterende server
• Å koble energidata til Home Assistant eller Node-RED
• Å bygge egendefinerte dashbord og alarmer
• Å kombinere elektrisitetsdata med tariff-, sol- eller laststyringslogikk
• Å operere på et sted med begrenset eller ustabil internettilgang

Cloud- og lokal tilgang er ikke nødvendigvis gjensidig utelukkende. Den egnede arkitekturen avhenger av om prosjektet trenger IAMMETER-Cloud-rapporter, en lokal plattform, en tredjepartsserver eller en kombinasjon.

4) Push data til en tredjepartsserver

4.1 TCP og TLS

IAMMETER kan pushe målerdata til et TCP- eller TLS-endepunkt.

I gjeldende WebUI:

1. Velg TCP-kjøremodus.
2. Skriv inn destinasjonsadressen.
3. Konfigurer opplastingsintervallet.
4. Lagre innstillingene og verifiser dataene på mottakerserveren.

For en TCP-server, bruk:

{domain-or-ip}:{port}

Eksempel:

abc.com:12345

For en TLS-server, bruk:

tls://{domain-or-ip}:{port}

Eksempel:

tls://abc.com:12345

Oversikten over gjeldende fastvare dokumenterer et minimumsopplastingsintervall på 2 sekunder. Bekreft gjeldende fastvare og mottakerserverens kapasitet før du velger et kort intervall.

4.2 MQTT og MQTTS

IAMMETER kan publisere telemetri direkte til en vanlig MQTT-broker, eller bruke MQTTS for kryptert transport på støttet fastvare.

I gjeldende WebUI:

1. Velg MQTT-kjøremodus.
2. Skriv inn brokerens IP-adresse eller domenenavn og port med riktig MQTT- eller MQTTS-format.
3. Skriv inn brokerens brukernavn og passord når autentisering kreves.
4. Konfigurer opplastingsintervallet.
5. Lagre og verifiser at meldinger ankommer brokeren.

For vanlig MQTT, skriv inn brokerens adresse og port uten mqtt://-prefiks:

192.168.11.163:1883

For MQTTS, inkluder mqtts://-prefikset:

mqtts://{mqtt-broker-address}:{port}

Eksempel:

mqtts://broker.example.com:8883

MQTTS-støtten som er dokumentert i fastvareoppdateringen fra november 2025, har følgende gjeldende begrensninger:

• Støtter TLS 1.2 og lavere.
• Opplasting av et egendefinert CA-sertifikat støttes ikke.
• Verifisering av vertsnavn støttes ikke.
• Klient-side sertifikater for gjensidig TLS-autentisering støttes ikke.

Disse begrensningene er viktige når du velger en broker og vurderer sikkerhetskravene for utrullingen.

Oversikten over gjeldende fastvare dokumenterer et minimumsopplastingsintervall på 2 sekunder.

Home Assistant MQTT Discovery er en ekstra oppdagelsesfunksjon for Home Assistant; den er ikke nødvendig for hver MQTT-integrasjon. Se:

• IAMMETER MQTT-integreringsveiledning
• MQTT Discovery i Home Assistant

Endre uploadInterval eksternt via MQTT/MQTTS

Med fastvaren beskrevet i oppdateringen fra november 2025, abonnerer en måler i MQTT-modus automatisk på:

device/{sn}/config

Publiser følgende JSON fra en annen MQTT-klient for å endre opplastingsintervallet eksternt:

{"uploadInterval": 10}

Erstatt 10 med ønsket intervall i sekunder og {sn} med målerens serienummer i emnet.

Denne eksterne MQTT-konfigurasjonen er forskjellig fra den eldre lokale /api/uploadinterval-metoden som er tatt med i delen om tidligere versjoner (Legacy).

4.3 HTTP og HTTPS

IAMMETER kan poste data til en egendefinert HTTP/HTTPS-server.

I gjeldende WebUI:

1. Velg HTTP-kjøremodus.
2. Skriv inn serveradressen og porten.
3. Konfigurer opplastingsintervallet.
4. Lagre og verifiser forespørslene på serveren.

Gjeldende fastvare støtter både standard HTTPS-port og en egendefinert HTTPS-port.

Bruk ett av disse formatene:

• Vanlig HTTP uten eksplisitt port: {address} — går som standard mot port 80.
• Vanlig HTTP med egendefinert port: {address}:{port}.
• HTTPS uten eksplisitt port: https://{address} — går som standard mot port 443.
• HTTPS med egendefinert port: https://{address}:{port} — bruker den angitte porten.

https://-prefikset velger HTTPS. Port 443 er ikke lenger den eneste tilgjengelige porten for HTTPS.

Eksempler:

api.example.com
api.example.com:8080
https://api.example.com
https://api.example.com:8443

Se Ny fastvare legger til MQTTS, ekstern konfigurering og egendefinert HTTPS-port for fastvareutgivelsesnotatet.

For håndtering av nyttelast på serversiden, se også Integrer IAMMETER med en tredjepartsserver.

5) Les data lokalt over HTTP

Koble måleren til LAN-et og forespør data fra den lokale IP-adressen. Disse forespørslene krever ikke IAMMETER-Cloud.

Test API-ene interaktivt： Åpne IAMMETER Local API Explorer, skriv inn målerens lokale IP-adresse og velg WEM API-testesiden. Utforskeren i Swagger-stil lister opp de tilgjengelige lokale API-ene og lar deg sende testforespørsler direkte fra nettleseren. Nettleseren og IAMMETER-måleren må være på samme LAN.

5.1 GET /api/monitorjson

Returnerer sanntids elektriske målinger.

Standarddataene inkluderer verdier som:

• Spenning
• Strøm
• Aktiv effekt
• Fremover/import kWh
• Revers/eksport kWh
• Frekvens
• Effektfaktor

Eksempel på svar:

{
  "method": "uploadsn",
  "mac": "B0F8933C4F94",
  "version": "i.75.97.9",
  "server": "em",
  "SN": "3E0BAF87",
  "Datas": [
    [220.0, 9.99, 2198, 11.337, 11.201, 49.99, 1.00],
    [222.5, 9.99, 1100, 11.039, 10.908, 49.99, 0.50],
    [263.5, 9.99, 1213, 10.975, 10.846, 49.99, 0.55]
  ]
}

Antallet målings-arrayer avhenger av målerens modell og antall kanaler.

Hvis måling av reaktiv effekt er aktivert på en støttet modell/fastvare, kan svarformatet inneholde ekstra felt. Se Dataformat for reaktiv effektmåling.

5.2 GET /api/monitor

Returnerer et utvidet sanntidssvar som også inkluderer Wi-Fi-informasjon som:

• ssid — navnet på tilkoblet aksesspunkt
• sig — Wi-Fi-signalstyrke

Bruk dette endepunktet når en integrasjon trenger både elektriske målinger og grunnleggende Wi-Fi-status.

5.3 GET /api/wifidata

Returnerer informasjon om fastvare, enhet og nettverkskonfigurasjon.

Eksempel:

{
  "version": "i.75.97.9",
  "SN": "3E0BAF87",
  "mac": "B0F8933C4F94",
  "type": "PM",
  "ssid": "example-wifi",
  "ip": "192.168.11.62",
  "netmask": "255.255.255.0",
  "gw": "192.168.11.1",
  "dns": "192.168.11.1",
  "dhcp": 1,
  "runMode": "tcp",
  "uploadinterval": 60
}

Ikke publiser svar som inneholder enhetens serienumre, MAC-adresser, intern adressering eller Wi-Fi-informasjon med mindre verdiene er anonymisert.

6) JSON-format på tvers av opplastingsmoduser

IAMMETER bruker en konsistent kjernestruktur for JSON-målinger på tvers av HTTP, TCP, MQTT og det lokale API-et. Dette reduserer arbeidet som kreves når ett mottakersystem støtter flere transportmetoder.

Transportmetoden og konvolutten kan likevel påvirke hvordan en mottaker kobler til, autentiserer eller rammer inn en melding. Implementer mottakersystemet mot det dokumenterte formatet for den valgte modusen.

• IAMMETER Energy Meter JSON-data-definisjon

7) Modbus TCP

IAMMETER-målere støtter Modbus TCP for direkte LAN-integrasjon med kompatible klienter.

Typiske klienter inkluderer:

• Home Assistant
• PLC-er
• SCADA-systemer
• Industrielle gatewayer
• Egendefinerte Modbus-applikasjoner

Referanser:

• IAMMETER Modbus TCP-oversikt
• Oversikt over Home Assistant-integrasjon

Bekreft målerens modell, fastvare, registerdefinisjon, pollingsintervall og klientatferd før utrulling.

8) Integrasjonsscenarier

9) Sammendrag av gjeldende grensesnitt og ressurser

Ytterligere ressurser:

• Nyeste fastvare
• Fastvarenotat om MQTTS og egendefinert HTTPS-port
• Videoveiledninger
• JSON-data-definisjon
• Modbus TCP-oversikt
• Utvikle ditt eget system
• Overvåking uten internettilgang

IAMMETERs lokale API-er og åpne protokoller gjør det mulig å starte med sanntidsovervåking og senere legge til et egendefinert EMS, selvhostet dashbord eller automasjonsflyt.

10) Sider og konfigurasjonsmetoder for eldre fastvare

Materialet nedenfor er kun tatt med for målere som fortsatt kjører eldre fastvare, eller for brukere som vedlikeholder en eksisterende integrasjon. For en ny installasjon, oppdater til nyeste fastvare og bruk gjeldende WebUI der det nødvendige alternativet er tilgjengelig.

10.1 Side for kjøremodus i eldre fastvare

Eldre fastvare brukte følgende side for valg av kjøremodus:

Utformingen og alternativnavnene kan avvike fra det gjeldende WebUI-et som er vist tidligere i denne veiledningen.

10.2 Side for TCP/TLS i eldre fastvare

Integrasjoner med eldre fastvare kan referere til denne TCP/TLS-konfigurasjonssiden og den tilhørende veiledningen:

• Veiledning for tredjepartsserver-integrasjon
• Video om opplasting til server

10.3 Side for MQTT i eldre fastvare

Eldre MQTT-dokumentasjon brukte dette konfigurasjonsgrensesnittet:

For gjeldende arbeidsflyt, bruk instruksjonene for det gjeldende WebUI-et tidligere i denne artikkelen og den oppdaterte MQTT-integreringsveiledningen.

10.4 Side for HTTP/HTTPS i eldre fastvare

Eldre fastvare brukte følgende HTTP/HTTPS-destinasjonsside:

Den eldre integreringsveiledningen er tatt med under Opplasting via HTTP/HTTPS.

I denne eldre arbeidsflyten var HTTPS knyttet til standardporten 443 og krevde ikke https://-prefikset. Gjeldende fastvare bruker i stedet https://-prefikset for å velge HTTPS og støtter enten standardporten 443 eller en eksplisitt angitt egendefinert port.

10.5 Konfigurasjons-API-er i eldre fastvare

Følgende lokale API-kall forekom i tidligere konfigurasjonsarbeidsflyter. I gjeldende fastvare bør de tilsvarende innstillingene normalt konfigureres via WebUI-et når alternativet er tilgjengelig.

/api/uploadinterval?x=<seconds>

Tidligere metode for å angi opplastingsintervallet utenom Cloud.

/api/mqtt

Tidligere metode for å konfigurere MQTT-innlogging.

/api/netmetring

Tidligere metode for å aktivere eller deaktivere Net Energy Metering-modus.

• Referanse for Net Energy Metering

/api/ctcratio

Tidligere metode for å bruke den dokumenterte fase-C-multiplikatoren i spesifikke split-phase- eller balanserte scenarier.

• Referanse for CTC-forhold

/api/reactive

Tidligere metode for å aktivere eller deaktivere måling av reaktiv effekt og reaktiv energi på støttet fastvare/modeller.

• Referanse for reaktiv effekt

/api/ratio — kun WEM3046T

WEM3046T bruker eksterne strømtransformatorer (CT) med 5 A sekundærutgang. Eldre konfigurasjonsinstruksjoner angir CT-forholdet med:

/api/ratio?x={ct_ratio}

Eksempel:

/api/ratio?x=400

Dette endepunktet er spesifikt for WEM3046T og er ugyldig for andre IAMMETER-modeller. For gjeldende fastvare, bruk modellens gjeldende WebUI-konfigurasjon når den er tilgjengelig.

Tidligere materiale er tatt med for bakoverreferanse; nye installasjoner bør følge den nyeste fastvarens WebUI.