IAMMETER Wi-Fi-energiemeters kunnen meetgegevens rechtstreeks naar een server, MQTT-broker of dataplatform sturen die door de klant worden beheerd. Dit stelt ontwikkelaars en systeemintegrators in staat om hun eigen EMS, BMS, IoT-dienst, database of monitoringsdashboard te bouwen zonder IAMMETER-Cloud als gegevensbestemming te gebruiken.
Deze gids benadert de integratie vanaf de ontvangende serverzijde:
IAMMETER meter
│
│ HTTP/HTTPS, MQTT/MQTTS of TCP/TLS
▼
Innamedienst van de klant
│
├── Log van ruwe payloads
├── Tijdreeks- of relationele database
├── EMS / BMS / ERP
└── Dashboard-, rapport- en alarmdiensten
Raadpleeg voor meterzijde firmwaremogelijkheden en adresformaten de IAMMETER Local API and Open Interface Guide. Voor architectuurkeuze, zie Develop Your Own Energy Monitoring System.
De meter kan zijn metingen via verschillende transporten verzenden. Het ontvangende systeem moet één primair innamepad kiezen.
| Transport | Ontvangercomponent | Goed startpunt voor |
|---|---|---|
| HTTP / HTTPS | Web-eindpunt | REST-backends en de eenvoudigste eerste integratie |
| MQTT / MQTTS | MQTT-broker en -abonnee | Bestaande IoT-platforms en berichtpijplijnen |
| TCP / TLS | Socket-listener | Dedicated collectors en aangepaste protocoldiensten |
HTTP is normaal gesproken de eenvoudigste manier om de eerste payload te inspecteren, omdat de officiële testontvanger kan worden gestart met een klein Node.js-voorbeeld. MQTT is een goede keuze wanneer er al een broker deel uitmaakt van het systeem. TCP/TLS biedt een socketintegratie op een lager niveau, maar vereist meer engineering aan de ontvangerzijde.
De beveiligde transporten en indelingen voor aangepaste poorten worden onderhouden in de huidige firmwarehandleiding, in plaats van hier te worden herhaald.
IAMMETER biedt een officieel Node.js HTTP-ontvangervoorbeeld voor integratietests.
Download het voorbeeld van:
Voer uit:
node Server.js
Het voorbeeld luistert op poort 8000. Wanneer een verzoek binnenkomt, gebeurt het volgende:
200 geretourneerd met een kleine JSON-succesrespons.Het voorbeeld is bewust minimaal. Het biedt geen authenticatie, persistentie, validatie, snelheidsbeperking of productiebeveiliging.
Controleer voordat u de meter configureert het volgende:
Voor een LAN-test kunnen de meter en ontvanger hetzelfde lokale netwerk gebruiken zonder internettoegang. Voor een externe ontvanger moet de site een route naar de server hebben.
Selecteer in de huidige meter-WebUI de HTTP-runmodus en voer een bestemming in zoals:
{server-adres}:8000/upload
HTTPS-eindpunten kunnen de standaardpoort of een aangepaste poort gebruiken. De huidige adresregels, inclusief https://host:port, worden beschreven in de HTTP/HTTPS-firmwaresectie.
Nadat u de instelling hebt opgeslagen, controleert u de ontvangerconsole op het verzoekpad en de geüploade JSON. Bewaar deze eerste ruwe payload als testmateriaal voor latere parser- en databasetests.
IAMMETER gebruikt een consistente JSON-meetstructuur voor alle ondersteunde pushtransporten. Het transport verandert hoe de payload aankomt, maar het meetmodel blijft consistent.
Een payload bevat normaal gesproken velden op apparaatniveau zoals:
SN — serienummer van de meter, gebruikt om het apparaat te identificeren;version — firmwareversie van de meter;method — berichtmethode of payloadtype;Data of Datas — meetarrays.Data wordt gebruikt voor een enkel meetkanaal. Datas bevat meerdere meetarrays voor een meerkanaals- of driefasenmeter.
Voorbeeld van een enkelkanaalsstructuur:
{
"method": "uploadsn",
"mac": "B0F8932A295C",
"version": "i.75.98.71y",
"server": "em",
"SN": "12345678",
"Data": [228.91, 1.61, 225, 15066.47, 0]
}
Hardcodeer niet één arraytelling voor elke meter. Het aantal kanalen en beschikbare velden hangt af van het metermodel en de ingeschakelde meetfuncties.
Gebruik de gezaghebbende definitie bij het implementeren van de parser:
Houd modelspecifieke verwerking gescheiden van het transportontvangst.
WEM3046T en WEM3046TE meten bijvoorbeeld de 5 A secundaire uitgang van een externe stroomtransformator. Hun waarden moeten worden omgerekend met de toepasselijke CT-verhouding om de primaire meting te verkrijgen. Dit is een kenmerk van de meter en CT, niet een verschil in HTTP, MQTT of TCP.
Een praktische innamestream scheidt daarom:
Sla voldoende informatie op om de oorspronkelijke meting te kunnen reproduceren en diagnosticeren.
Een nuttig minimummodel omvat:
| Veld | Doel |
|---|---|
| Meter-SN | Koppelt de payload aan een geregistreerd apparaat |
| Kanaal- of fase-index | Onderscheidt enkelfasige, split-phase en driefasige gegevens |
| Ontvangsttijd op server | Zorgt voor een consistente innametijdstempel |
| Spanning (Voltage) | Elektrische meting |
| Stroom (Current) | Elektrische meting |
| Actief vermogen (Active power) | Invoer voor realtime import/export of verbruiksberekening |
| Import kWh | Cumulatieve geïmporteerde energie |
| Export kWh | Cumulatieve geëxporteerde energie |
| Firmwareversie | Ondersteunt probleemoplossing en parsercompatibiliteit |
| Ruwe payload | Maakt herhaling, controle en parsercorrectie mogelijk |
Aanvullende velden zoals frequentie, arbeidsfactor en blindmetingen moeten worden opgeslagen wanneer het geselecteerde model en de configuratie deze bieden.
Overweeg voor productiesystemen het volgende gescheiden te houden:
Dit maakt het gemakkelijker om parser- of CT-verhoudingslogica te corrigeren zonder de oorspronkelijke payload te verliezen.
Leg het tijdstip vast waarop de server de payload heeft geaccepteerd. Als het bedrijfssysteem ook een apparaat- of brontijdstempel gebruikt, sla dan beide waarden afzonderlijk op in plaats van de ene door de andere te vervangen.
Netwerkvertraging, herverbindingen en verwerking in de wachtrij kunnen ervoor zorgen dat de innametijd afwijkt van de meettijd. Definieer de tijdstempel die wordt gebruikt door grafieken, facturatie en alarmen vóór productie-implementatie.
Voor MQTT-inname levert het klantsysteem:
IAMMETER publiceert realtime gegevens onder een apparaatonderwerp zoals:
device/{SN}/realtime
Gebruik de speciale gids voor brokerconfiguratie, inloggegevens, onderwerpen en MQTTS-overwegingen:
Home Assistant MQTT Discovery is niet vereist voor een algemene klant-serverintegratie.
IAMMETER biedt een minimale Node.js TCP-listener:
Het voorbeeld luistert op poort 8000 en drukt ontvangen gegevens af. Een productie-TCP-ontvanger moet bovendien het volgende bieden:
Ga er niet vanuit dat één socket data-gebeurtenis altijd overeenkomt met één compleet applicatiebericht.
Het officiële TLS-voorbeeld toont een TLS-listener met een serversleutel en -certificaat:
Vervang vóór productiegebruik de demonstratiecertificaten en -instellingen door de goedgekeurde certificaat-, sleutelbeheer- en beveiligingsconfiguratie van de organisatie. De ontvanger moet TLS-fouten apart loggen van payload-validatiefouten.
De adresformaten aan de meterzijde voor TCP en TLS worden onderhouden in de firmware-interfacehandleiding.
De huidige firmware ondersteunt een uploadinterval voor derden tot 2 seconden. Een kort interval is alleen zinvol wanneer het ontvangende systeem, de opslag en de applicatie de extra resolutie nodig hebben.
Geschatte records per meter:
| Uploadinterval | Records per meter per dag | 100 meters per dag | 1.000 meters per dag |
|---|---|---|---|
| 60 seconden | 1.440 | 144.000 | 1.440.000 |
| 10 seconden | 8.640 | 864.000 | 8.640.000 |
| 2 seconden | 43.200 | 4.320.000 | 43.200.000 |
Deze aantallen vertegenwoordigen uploadgebeurtenissen, niet noodzakelijkerwijs database-rijen. Een driefasen-payload kan worden genormaliseerd naar meerdere kanaalrecords, en indexen, retentie van ruwe payloads of gerepliceerde opslag verhogen het werkelijke databasevolume.
Capaciteitsplanning moet het volgende omvatten:
Overweeg voor besturing of automatisering binnen één seconde op hetzelfde LAN Modbus TCP in plaats van een uploadpijplijn op afstand te gebruiken.
Een productieontvanger moet rekening houden met netwerk- en applicatiefouten.
Valideer ten minste:
Houd misvormde payloads in een gecontroleerd diagnostisch pad zonder dat ze geldige apparaten kunnen blokkeren.
Ga er niet vanuit dat elk interval precies één permanent opgeslagen record oplevert. Netwerkonderbrekingen, herverbindingsgedrag, server-retries of applicatieverwerking kunnen leiden tot ontbrekende of herhaalde innames.
Definieer hoe het bedrijfssysteem:
Monitor meer dan alleen het web- of socketproces. Nuttige signalen zijn onder andere:
Voor een internetgerichte ontvanger:
Raadpleeg het huidige MQTTS-, TLS- en HTTPS-firmwaregedrag in de firmware- en open-interfacehandleiding voordat u een beveiligingsontwerp kiest.
De oorspronkelijke versie van dit document was gericht op het configureren van oudere meter-firmware. Deze schermafbeeldingen worden alleen bewaard voor gebruikers die een bestaande installatie identificeren. Gebruik voor nieuwe integraties de huidige WebUI en nieuwste firmware.
Eerdere firmwaredocumentatie gebruikte ook de lokale /api/uploadinterval-configuratiemethode en beschreef een minimum van zes seconden. De huidige firmware toont het interval in de WebUI en ondersteunt een gedocumenteerd minimum van 2 seconden.
Laatst bijgewerkt: 16 juli 2026
Driefasige Wi-Fi-energiemeter (WEM3080T)
Eenfasige Wi-Fi-energiemeter (WEM3080)
Driefasige Wi-Fi-energiemeter (WEM3046T)
Driefasige Wi-Fi-energiemeter (WEM3050T)