IAMMETER Wi-Fi-energiemeter: handleiding voor lokale integratie en open interface

IAMMETER Wi-Fi-energiemeter: handleiding voor lokale integratie en open interface

Voor ontwikkelaars en systeemintegratoren die IAMMETER-meters gebruikenzonderIAMMETER-Wolk.

De Wi-Fi-energiemeters van IAMMETER zijn ontworpen voor zowel cloudgebaseerde als lokale integratie en bieden open API's (HTTP, MQTT, Modbus/TCP) waarmee ontwikkelaars hun eigen energiebeheersystemen (EMS), gebouwbeheersystemen (BMS) of platforms voor slimme huisautomatisering kunnen bouwen.

De firmware van de IAMMETER wordt continu geüpdatet. Dit document bevat een overzicht van alle lokale en open integratiefuncties die door de nieuwste firmware worden ondersteund.(Wordt continu bijgewerkt)

1) Firmware-update

Download hier de nieuwste firmwareversies:

• Firmware-releasepagina (imeter.club): https://imeter.club/topic/11

2) Uitvoeringsmodi (niet-cloud)

Kies een modus op basis van hoe u het apparaat integreert of gebruikt.

Legacy Firmware-gebruikersinterface

Nieuwste firmwareWebUI

(De rest van uw document blijft ongewijzigd ten opzichte van uw laatste versie.)

3) TCP / TLS / MQTT-integratie

3.1 TCP en TLS

Meters kunnen gegevens rechtstreeks naar uw TCP/TLS-eindpunt pushen.

🔹 Nieuwe firmwareconfiguratie

Het configuratieproces in de nieuwste firmware is vergelijkbaar met dat in eerdere versies.

Uitvoeringsmodus: TCP

Adres:

• Voor een TCP-server — voer in{domein}:{poort}(bijv.abc.com:12345).
• Voor een TLS-server — gebruiktls://{domein}:{poort}(bijv.tls://abc.com:12345).

Uploadinterval:Het minimale uploadinterval is2 seconden.

🔹 Legacy Firmware-configuratie

• Gids:Integratie van servers van derden (TCP/TLS)
• Video:Energiegegevens uploaden naar een server van derden

3.2 MQTT

🔹 Nieuwe firmwareconfiguratie

Uitvoeringsmodus: MQTT Adres:Voer IP of domein met poort in, bijvoorbeeld:192.168.11.163:1883 Gebruikersnaam / Wachtwoord:MQTT-brokerreferenties (optioneel indien niet vereist door de broker)

Uploadinterval:Minimale interval is2 seconden. HA MQTT-ontdekking: MQTT-detectie inschakelen in Home Assistant

🔹 Legacy Firmware-configuratie

Publiceer telemetrie naar een lokale of openbare MQTT-broker.

• Gids:MQTT-integratiehandleiding

4) HTTP/HTTPS-integratie

🔹 Legacy Firmware-configuratie

Meters kunnen gegevens rechtstreeks naar uw eigen server sturen.

• Het gegevensladingformaat is identiek aan de TCP/MQTT-modi.
• Elke poort kan gebruikt worden.
• Haven443schakelt HTTPS automatisch in.
• Details:Uploaden via HTTP/HTTPS

🔹 Nieuwe firmwareconfiguratie

Adres:Het invoerformaat is hetzelfde als dat van de oude firmware.

• Als er geen poort is opgegeven, is de standaardpoort80.
• Alleen poort443gebruikt HTTPS post; alle andere poorten gebruiken HTTP post.

5) Lokale API (HTTP over LAN)

U hebt lokaal toegang tot de meter via het LAN-IP-adres. Er is geen cloudverbinding nodig.

5.1 GET /api/monitorjson

Geeft realtime meetgegevens terug.Velden:Spanning, stroom, actief vermogen, vooruit/achteruit kWh, frequentie, vermogensfactor.

Voorbeeld:

{
"methode": "uploadsn",
"mac": "B0F8933C4F94",
"versie": "i.75.97.9",
"server": "em",
"SN": "3E0BAF87",
"Gegevens": [
[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]
]
}

📘 Uitbreiding voor het meten van reactief vermogen

5.2 GET /api/monitor

Geavanceerde versie vanMonitorjson, inclusief Wi-Fi-signaalinformatie:

• SSID(verbonden AP-naam)
• handtekening(signaalsterkte)

5.3 GET /api/wifidata

Geeft de Wi-Fi- en netwerkconfiguratie terug.

{
"versie":"i.75.97.9","SN":"3E0BAF87","mac":"B0F8933C4F94",
"type":"PM","ssid":"CMCC-laohe","ip":"192.168.11.62",
"netmasker":"255.255.255.0","gw":"192.168.11.253",
"dns": "114.114.114.114", "dhcp": 1, "runMode": "tcp", "uploadinterval": 60
}

5.4 GET /api/uploadinterval?x=<seconden>

Stelt uploadinterval in (in seconden).

Werkt in niet-cloudmodi (TCP/HTTP/MQTT).

In deNieuwste firmware, deze parameter kan nu rechtstreeks vanuit deWebUI-interface, zonder de API handmatig aan te roepen.

5.5 GET /api/mqtt

Configureert MQTT-referenties. 📘MQTT Config API-documentatie

In deNieuwste firmware, deze parameter kan nu rechtstreeks vanuit deWebUI-interface, zonder de API handmatig aan te roepen.

5.6 GET /api/netmetring

SchakeltNetto-energiemeting (NEM)modus. 📘NEM-modus inschakelen

In deNieuwste firmware, deze parameter kan nu rechtstreeks vanuit deWebUI-interface, zonder de API handmatig aan te roepen.

5.7 GET /api/ctcration

AanpassenFase C-vermenigvuldigervoor scenario's met gesplitste fase/gebalanceerde scenario's.

• x=2Verdubbelt de Fase C-waarden (stroom, vermogen, kWh). 📘Uitleg CTC-ratio

In deNieuwste firmware, deze parameter kan nu rechtstreeks vanuit deWebUI-interface, zonder de API handmatig aan te roepen.

5.8 GET /api/reactive

In- of uitschakelenReactief vermogen (Q)enReactieve energie (kVARh)meting. 📘Documentatie over reactief vermogen

In deNieuwste firmware, deze parameter kan nu rechtstreeks vanuit deWebUI-interface, zonder de API handmatig aan te roepen.

5.9 GET /api/ratio (alleen beschikbaar voor WEM3046T)

Sinds deWEM3046Tmaakt gebruik van externe CT's met5A secundaire uitgangen(bijv. 1000:5, 1500:5, 2000:5, enz.), moeten de gemeten waarden (stroomsterkte, vermogen, energie) worden vermenigvuldigd met de CT-verhouding.

Voorbeeld:

/api/verhouding?x=400

• Verhouding instellen: /api/ratio?x={ct_ratio}
• Queryverhouding: /api/verhouding

AlleenWEM3046TOndersteunt externe 5A CT's — deze API is ongeldig voor andere modellen.

6) Consistentie in JSON-indeling

Alle communicatiemodi —HTTP, TCP, MQTT, lokale API— gebruik dezelfde JSON-structuur. 📘JSON-gegevensdefinitie

7) Modbus/TCP-ondersteuning

IAMMETER-meters ondersteunen standaardModbus/TCP, waardoor directe integratie metThuisassistent, PLC's, ofSCADAsystemen.

• Modbus/TCP-overzicht
• Home Assistant Modbus-voorbeeld

8) Ondersteunde integratiescenario's

9) Hulpbronnen

• Firmware-releases
• Video uitleg
• JSON-definitie
• Modbus/TCP-overzicht
• Ontwikkel je eigen systeem

10) Samenvatting voor ontwikkelaars

| Mogelijkheden | Toegang | Notities | | --------------------- | ------------------- | ---------------------------------- | | Realtime lokale gegevens | Lokale API |/api/monitorjson, /api/monitor| | Uploaden door derden | TCP/TLS, HTTP/HTTPS | Hetzelfde payloadschema | | MQTT-publicatie | MQTT-broker |/api/mqttinloggegevens instellen | | Nettometering | Lokale API |/api/netmeting| | Blindvermogen/energie | Lokale API |/api/reactief| | Fase-C-multiplier | Lokale API |/api/ctcratio?x=1 | | CT-ratio (WEM3046T) | Lokale API |/api/ratio?x=` | | Modbus/TCP | Modbus-client | Compatibel met HA/PLC/SCADA |

Laatst bijgewerkt: 15 oktober 2025