IAMMETER Wi-Fi energiemeter: Lokale API's en Open Interfaces

IAMMETER Wi-Fi energiemeter: Lokale API's en Open Interfaces

IAMMETER Wi-Fi energiemeters ondersteunen IAMMETER-Cloud, evenals lokale en third-party integraties.

De beschikbare interfaces omvatten:

• Lokale HTTP API via het LAN
• MQTT en MQTTS publicatie
• Modbus TCP
• TCP/TLS upload
• HTTP/HTTPS upload
• Zelfstandige lokale werking

Deze interfaces stellen IAMMETER meters in staat om te fungeren als open databronnen voor:

• Home Assistant en andere smart-home platforms
• Node-RED automatisering
• Zelfgehoste dashboards
• PLC- en SCADA-systemen
• Maatwerk Energy Management Systemen (EMS)
• Maatwerk Building Management Systemen (BMS)
• Third-party dataservers

Deze gids beschrijft de huidige firmware en WebUI eerst. Schermafbeeldingen en configuratiemethoden voor oudere firmware zijn bewaard in de laatste Legacy-sectie.

Voor een kant-en-klare toepassing gebouwd op deze mogelijkheden, zie Home Energy Monitoring, Solar Energy Monitoring, of lokale monitoring zonder internettoegang.

1) Update naar de nieuwste firmware

IAMMETER firmware wordt continu bijgewerkt. Controleer vóór het configureren van een integratie de huidige release en modelcompatibiliteit:

• IAMMETER Firmware Release Pagina

De nieuwste firmware WebUI toont de veelgebruikte configuratieopties direct. Handmatige configuratie API-aanroepen die later in dit artikel worden bewaard, zijn voornamelijk nuttig bij het onderhouden van oudere installaties.

2) Kies de uitvoermodus in de huidige WebUI

Selecteer een uitvoermodus op basis van waar de meter gegevens naartoe moet sturen of hoe deze lokaal moet werken.

De uitvoermodus bepaalt het gedrag van data-upload. Lokale API- en Modbus TCP-beschikbaarheid moeten nog worden gecontroleerd voor het metermodel, de firmware en de geselecteerde integratie.

3) Waarom de open interfaces belangrijk zijn

Open interfaces laten gebruikers zelf beslissen waar elektriciteitsgegevens worden verwerkt en opgeslagen.

Typische redenen zijn onder meer:

• Metingen binnen het lokale netwerk houden
• Telemetrie naar een bestaande server sturen
• Energiegegevens koppelen aan Home Assistant of Node-RED
• Maatwerk dashboards en alarmen bouwen
• Elektriciteitsgegevens combineren met tarieven, zonne-energie of belastingsregellogica
• Werken op een locatie met beperkte of onbetrouwbare internettoegang

Cloud en lokale toegang sluiten elkaar niet noodzakelijkerwijs uit. De geschikte architectuur hangt af van of het project IAMMETER-Cloud rapporten, een lokaal platform, een third-party server of een combinatie nodig heeft.

4) Gegevens naar een third-party server pushen

4.1 TCP en TLS

IAMMETER kan metergegevens naar een TCP- of TLS-endpoint pushen.

In de huidige WebUI:

1. Selecteer de TCP-uitvoermodus.
2. Voer het bestemmingsadres in.
3. Configureer het uploadinterval.
4. Sla de instellingen op en verifieer de gegevens op de ontvangende server.

Gebruik voor een TCP-server:

{domein-of-ip}:{poort}

Voorbeeld:

abc.com:12345

Gebruik voor een TLS-server:

tls://{domein-of-ip}:{poort}

Voorbeeld:

tls://abc.com:12345

Het huidige firmwareoverzicht documenteert een minimum uploadinterval van 2 seconden. Bevestig de huidige firmware en capaciteit van de ontvangende server voordat u een kort interval selecteert.

4.2 MQTT en MQTTS

IAMMETER kan telemetrie rechtstreeks publiceren naar een gewone MQTT-broker of MQTTS gebruiken voor versleuteld transport op ondersteunde firmware.

In de huidige WebUI:

1. Selecteer de MQTT-uitvoermodus.
2. Voer het IP-adres of domein van de broker en de poort in met de juiste MQTT- of MQTTS-notatie.
3. Voer de gebruikersnaam en het wachtwoord van de broker in wanneer authenticatie vereist is.
4. Configureer het uploadinterval.
5. Sla op en verifieer dat berichten aankomen bij de broker.

Gebruik voor gewone MQTT het brokeradres en de poort zonder een mqtt:// voorvoegsel:

192.168.11.163:1883

Gebruik voor MQTTS het mqtts:// voorvoegsel:

mqtts://{mqtt-broker-adres}:{poort}

Voorbeeld:

mqtts://broker.example.com:8883

MQTTS-ondersteuning, gedocumenteerd in de November 2025 firmware-update, heeft de volgende huidige beperkingen:

• Ondersteunt TLS 1.2 en lager.
• Uploaden van een aangepast CA-certificaat wordt niet ondersteund.
• Hostnaamverificatie wordt niet ondersteund.
• Client-side certificaten voor wederzijdse TLS-authenticatie worden niet ondersteund.

Deze beperkingen zijn belangrijk bij het kiezen van een broker en het evalueren van de beveiligingseisen van de implementatie.

Het huidige firmwareoverzicht documenteert een minimum uploadinterval van 2 seconden.

Home Assistant MQTT Discovery is een aanvullende Home Assistant-detectiefunctie; het is niet vereist voor elke MQTT-integratie. Zie:

• IAMMETER MQTT-integratiegids
• MQTT Discovery in Home Assistant

uploadInterval op afstand wijzigen via MQTT/MQTTS

Met de firmware beschreven in de November 2025 update, abonneert een meter die in MQTT-modus draait zich automatisch op:

device/{sn}/config

Publiceer de volgende JSON vanaf een andere MQTT-client om het uploadinterval op afstand te wijzigen:

{"uploadInterval": 10}

Vervang 10 door het gewenste interval in seconden en {sn} door het serienummer van de meter in het onderwerp.

Deze externe MQTT-configuratie verschilt van de oudere lokale /api/uploadinterval methode die in de Legacy-sectie wordt bewaard.

4.3 HTTP en HTTPS

IAMMETER kan gegevens posten naar een aangepaste HTTP/HTTPS-server.

In de huidige WebUI:

1. Selecteer de HTTP-uitvoermodus.
2. Voer het serveradres en de poort in.
3. Configureer het uploadinterval.
4. Sla op en verifieer verzoeken op de server.

Huidige firmware ondersteunt zowel de standaard HTTPS-poort als een aangepaste HTTPS-poort.

Gebruik een van deze notaties:

• Gewone HTTP zonder expliciete poort: {adres} — standaard poort 80.
• Gewone HTTP met een aangepaste poort: {adres}:{poort}.
• HTTPS zonder expliciete poort: https://{adres} — standaard poort 443.
• HTTPS met een aangepaste poort: https://{adres}:{poort} — gebruikt de opgegeven poort.

Het https:// voorvoegsel selecteert HTTPS. Poort 443 is niet langer de enige beschikbare poort voor HTTPS.

Voorbeelden:

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

Zie Nieuwe firmware voegt MQTTS, externe configuratie en aangepaste HTTPS-poort toe voor de firmware release-opmerkingen.

Voor server-side payload-verwerking, zie ook IAMMETER integreren met een third-party server.

5) Gegevens lokaal uitlezen via HTTP

Sluit de meter aan op het LAN en vraag gegevens op via het lokale IP-adres. Deze verzoeken vereisen geen IAMMETER-Cloud.

Test de API's interactief: Open de IAMMETER Local API Explorer, voer het lokale IP-adres van de meter in en selecteer de WEM API-testpagina. De Swagger-stijl explorer toont de beschikbare lokale API's en laat u testverzoeken rechtstreeks vanuit de browser verzenden. Uw browser en de IAMMETER meter moeten zich op hetzelfde LAN bevinden.

5.1 GET /api/monitorjson

Geeft real-time elektrische metingen terug.

De standaardgegevens bevatten waarden zoals:

• Spanning (Voltage)
• Stroom (Current)
• Actief vermogen (Active power)
• Geïmporteerde kWh (Forward/import kWh)
• Geëxporteerde kWh (Reverse/export kWh)
• Frequentie (Frequency)
• Vermogensfactor (Power factor)

Voorbeeld respons:

{
  "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]
  ]
}

Het aantal meetarrays hangt af van het metermodel en het aantal kanalen.

Als reactief vermogen is ingeschakeld op een ondersteund model/firmware, kan de responsindeling extra velden bevatten. Zie Reactief vermogen meetgegevensindeling.

5.2 GET /api/monitor

Geeft een uitgebreide real-time respons terug die ook Wi-Fi-informatie bevat, zoals:

• ssid — naam van het verbonden toegangspunt
• sig — Wi-Fi-signaalsterkte

Gebruik dit endpoint wanneer een integratie zowel elektrische metingen als basis Wi-Fi-status nodig heeft.

5.3 GET /api/wifidata

Geeft firmware-, apparaat- en netwerkconfiguratie-informatie terug.

Voorbeeld:

{
  "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
}

Publiceer geen responses die apparaatserienummers, MAC-adressen, interne adressering of Wi-Fi-informatie bevatten, tenzij de waarden zijn geschoond.

6) JSON-indeling voor alle uploadmodi

IAMMETER gebruikt een consistente kern-JSON-meetstructuur voor HTTP, TCP, MQTT en de lokale API. Dit vermindert het benodigde werk wanneer een ontvangend systeem meerdere transportmethoden ondersteunt.

De transportmethode en envelop kunnen nog steeds beïnvloeden hoe een ontvanger verbinding maakt, authenticeert of een bericht formatteert. Implementeer het ontvangende systeem volgens de gedocumenteerde indeling voor de geselecteerde modus.

• IAMMETER energiemeter JSON-gegevensdefinitie

7) Modbus TCP

IAMMETER meters ondersteunen Modbus TCP voor directe LAN-integratie met compatibele clients.

Typische clients zijn onder meer:

• Home Assistant
• PLC's
• SCADA-systemen
• Industriële gateways
• Maatwerk Modbus-toepassingen

Referenties:

• IAMMETER Modbus TCP overzicht
• Home Assistant integratieoverzicht

Bevestig het metermodel, de firmware, de registerdefinitie, het polling-interval en het clientgedrag vóór implementatie.

8) Integratiescenario's

9) Huidige interface-samenvatting en bronnen

Aanvullende bronnen:

• Nieuwste firmware
• MQTTS en aangepaste HTTPS-poort firmware-opmerking
• Video-tutorials
• JSON-gegevensdefinitie
• Modbus TCP overzicht
• Ontwikkel uw eigen systeem
• Monitor zonder internettoegang

IAMMETER's lokale API's en open protocollen maken het mogelijk om te beginnen met real-time monitoring en later een aangepast EMS, zelfgehost dashboard of automatiseringsworkflow toe te voegen.

10) Legacy firmware-pagina's en configuratiemethoden

Het volgende materiaal is alleen bewaard voor meters die nog oudere firmware draaien of voor gebruikers die een bestaande integratie onderhouden. Voor een nieuwe installatie, update naar de nieuwste firmware en gebruik de huidige WebUI waar de benodigde optie beschikbaar is.

10.1 Legacy uitvoermodus-pagina

Oudere firmware gebruikte de volgende uitvoermodus-selectiepagina:

De lay-out en optienamen kunnen afwijken van de huidige WebUI die eerder in deze gids wordt getoond.

10.2 Legacy TCP/TLS-pagina

Oudere firmware-integraties kunnen verwijzen naar deze TCP/TLS-configuratiepagina en gerelateerde gids:

• Legacy third-party server integratiegids
• Legacy upload-naar-server video

10.3 Legacy MQTT-pagina

Oudere MQTT-documentatie gebruikte deze configuratie-interface:

Gebruik voor de huidige workflow de huidige WebUI-instructies eerder in dit artikel en de bijgewerkte MQTT-integratiegids.

10.4 Legacy HTTP/HTTPS-pagina

Oudere firmware gebruikte de volgende HTTP/HTTPS bestemmingspagina:

De legacy integratiegids is bewaard op Upload via HTTP/HTTPS.

In deze oudere workflow was HTTPS gekoppeld aan de standaardpoort 443 en was het https:// voorvoegsel niet vereist. Huidige firmware gebruikt daarentegen het https:// voorvoegsel om HTTPS te selecteren en ondersteunt zowel de standaardpoort 443 als een expliciet opgegeven aangepaste poort.

10.5 Legacy configuratie-API's

De volgende lokale API-aanroepen verschenen in eerdere configuratieworkflows. In de huidige firmware moeten de bijbehorende instellingen normaal gesproken via de WebUI worden geconfigureerd wanneer de optie beschikbaar is.

/api/uploadinterval?x=<seconden>

Legacy-methode voor het instellen van het niet-Cloud uploadinterval.

/api/mqtt

Legacy-methode voor het configureren van MQTT-inloggegevens.

/api/netmetring

Legacy-methode voor het in- of uitschakelen van de Net Energy Metering-modus.

• Net Energy Metering referentie

/api/ctcratio

Legacy-methode voor het toepassen van de gedocumenteerde Phase-C vermenigvuldiger in specifieke split-phase of gebalanceerde scenario's.

• CTC Ratio referentie

/api/reactive

Legacy-methode voor het in- of uitschakelen van reactief vermogen en reactieve energiemeting op ondersteunde firmware/modellen.

• Reactief vermogen referentie

/api/ratio — alleen WEM3046T

WEM3046T gebruikt externe stroomtransformatoren (CT's) met 5 A secundaire uitgangen. Oudere configuratie-instructies stelden de CT-verhouding in met:

/api/ratio?x={ct_ratio}

Voorbeeld:

/api/ratio?x=400

Dit endpoint is specifiek voor WEM3046T en is ongeldig voor andere IAMMETER modellen. Gebruik voor huidige firmware de huidige WebUI-configuratie van het model wanneer beschikbaar.

Legacy-materiaal bewaard voor achterwaartse referentie; huidige installaties moeten de nieuwste firmware WebUI volgen.