IAMMETER Wi-Fi-energimätare: Guide till lokal integration och öppet gränssnitt

IAMMETER Wi-Fi-energimätare: Guide till lokal integration och öppet gränssnitt

För utvecklare och systemintegratörer som använder IAMMETER-mätareutanIAMMETER-Molnet.

IAMMETER Wi-Fi-energimätare är utformade för både molnbaserade och lokala integrationer och tillhandahåller öppna API:er (HTTP, MQTT, Modbus/TCP) som gör det möjligt för utvecklare att bygga sina egna energihanteringssystem (EMS), fastighetshanteringssystem (BMS) eller plattformar för smart hemautomation.

IAMMETERs firmware uppgraderas kontinuerligt. Detta dokument listar alla lokala och öppna integrationsfunktioner som stöds av den senaste firmware.(Uppdateras kontinuerligt)

1) Uppdatering av firmware

Hämta de senaste firmware-versionerna här:

• Sida för firmware-version (imeter.club): https://imeter.club/topic/11

2) Körlägen (ej moln)

Välj ett läge baserat på hur du integrerar eller använder enheten.

Äldre firmware-gränssnitt

Senaste firmwareWebbgränssnitt

(Resten av dokumentet fortsätter oförändrat från din senaste version.)

3) TCP/TLS/MQTT-integration

3.1 TCP och TLS

Mätare kan skicka data direkt till din TCP/TLS-slutpunkt.

🔹 Ny firmwarekonfiguration

Konfigurationsprocessen i den senaste firmware liknar den i tidigare versioner.

Körläge: TCP

Adress:

• För en TCP-server — ange{domän}:{port}(till exempel.,abc.com:12345).
• För en TLS-server — användtls://{domän}:{port}(till exempel.,tls://abc.com:12345).

Uppladdningsintervall:Minsta uppladdningsintervall är2 sekunder.

🔹 Konfiguration av äldre firmware

• Guide:Integration av tredjepartsserver (TCP/TLS)
• Video:Ladda upp energidata till tredjepartsserver

3.2 MQTT

🔹 Ny firmwarekonfiguration

Körläge: MQTT Adress:Ange IP-adress eller domän med port, t.ex.192.168.11.163:1883 Användarnamn / Lösenord:MQTT-mäklaruppgifter (valfritt om det inte krävs av mäklaren)

Uppladdningsintervall:Minsta intervall är2 sekunder. HA MQTT-upptäckt: Aktivera MQTT-upptäckt i Home Assistant

🔹 Konfiguration av äldre firmware

Publicera telemetri till en lokal eller offentlig MQTT-mäklare.

• Guide:MQTT-integrationsguide

4) HTTP/HTTPS-integration

🔹 Konfiguration av äldre firmware

Mätare kan skicka data direkt till din anpassade server.

• Datanylastformatet är identiskt med TCP/MQTT-lägen.
• Vilken port som helst kan användas.
• Hamn443aktiverar HTTPS automatiskt.
• Detaljer:Ladda upp via HTTP/HTTPS

🔹 Ny firmwarekonfiguration

Adress:Inmatningsformatet är detsamma som den äldre firmware.

• Om ingen port anges är standardporten80.
• Endast hamn443använder HTTPS-post; alla andra portar använder HTTP-post.

5) Lokalt API (HTTP över LAN)

Kom åt mätaren lokalt via dess LAN-IP – ingen molnanslutning krävs.

5.1 HÄMTA /api/monitorjson

Returnerar mätdata i realtid.Fält:Spänning, ström, aktiv effekt, framåt/bakåt kWh, frekvens, effektfaktor.

Exempel:

{
"Metod": "uploadsn",
"mac": "B0F8933C4F94",
"Version": "i.75.97.9",
"Server": "em",
"SN": "3E0BAF87",
"Data": [
[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]
]
}

📘 Utökning av mätning av reaktiv effekt

5.2 HÄMTA /api/monitor

Avancerad version avMonitorjson, inkluderar information om Wi-Fi-signal:

• SSID(namn på ansluten AP)
• signatur(signalstyrka)

5.3 HÄMTA /api/wifidata

Returnerar Wi-Fi- och nätverkskonfiguration.

{
"Version": "i.75.97.9", "SN": "3E0BAF87", "MAC": "B0F8933C4F94",
"Typ": "PM", "SSID": "CMCC-laohe", "IP": "192.168.11.62",
"Nätmask": "255.255.255.0", "gw": "192.168.11.253",

"dns": "114.114.114.114", "dhcp": 1, "runMode": "tcp", "uploadinterval": 60

5.4 HÄMTA /api/uploadinterval?x=

Ställer in uppladdningsintervall (i sekunder).

Fungerar i icke-molnlägen (TCP/HTTP/MQTT).

ISenaste firmware, kan denna parameter nu konfigureras direkt frånWebUI-gränssnitt, utan att anropa API:et manuellt.

5.5 HÄMTA /api/mqtt

Konfigurerar MQTT-inloggningsuppgifter. 📘MQTT-konfigurations-API-dokumentation

ISenaste firmware, kan denna parameter nu konfigureras direkt frånWebUI-gränssnitt, utan att anropa API:et manuellt.

5.6 HÄMTA /api/netmetring

VäxlarNettoenergimätning (NEM)läge. 📘Aktivera NEM-läge

ISenaste firmware, kan denna parameter nu konfigureras direkt frånWebUI-gränssnitt, utan att anropa API:et manuellt.

5.7 HÄMTA /api/ctcratio

JusterarFas C-multiplikatorför scenarier med delad fas/balanserade scenarier.

• x=2fördubblar fas C-avläsningarna (ström, effekt, kWh). 📘Förklaring av CTC-förhållandet

ISenaste firmware, kan denna parameter nu konfigureras direkt frånWebUI-gränssnitt, utan att anropa API:et manuellt.

5.8 HÄMTA /api/reaktiv

Aktiverar eller inaktiverarReaktiv effekt (Q)ochReaktiv energi (kVARh)mätning. 📘Dokumentation av reaktiv effekt

ISenaste firmware, kan denna parameter nu konfigureras direkt frånWebUI-gränssnitt, utan att anropa API:et manuellt.

5.9 GET /api/ratio (endast tillgängligt för WEM3046T)

SedanWEM3046Tanvänder externa CT:er med5A sekundära utgångar(t.ex. 1000:5, 1500:5, 2000:5, etc.), måste de uppmätta värdena (ström, effekt, energi) multipliceras med CT-förhållandet.

Exempel:

/api/ratio?x=400

• Ställ in förhållandet: /api/ratio?x={ct_ratio}
• Frågekvot: /api/ratio

EndastWEM3046Tstöder externa 5A CT:er — detta API är ogiltigt för andra modeller.

6) JSON-formatkonsekvens

Alla kommunikationssätt —HTTP, TCP, MQTT, lokalt API— använd samma JSON-struktur. 📘JSON-datadefinition

7) Modbus/TCP-stöd

IAMMETER-mätare har nativt stödModbus/TCP, vilket möjliggör direkt integration medHemassistent, PLC:er, ellerSCADAsystem.

• Översikt över Modbus/TCP
• Hemassistent Modbus-exempel

8) Stödda integrationsscenarier

9) Resurser

• Firmware-utgåvor
• Video tutorials
• JSON-definition
• Översikt över Modbus/TCP
• Utveckla ditt eget system

10) Utvecklarens sammanfattning

| Funktioner | Åtkomst | Anteckningar | | ----- ...---------- | | Lokala data i realtid | Lokalt API |/api/monitorjson, /api/monitor| | Uppladdning från tredje part | TCP/TLS, HTTP/HTTPS | Samma nyttolastschema | | MQTT-publicering | MQTT-mäklare |/api/mqttför att ställa in inloggningsuppgifter | | Nätmätning | Lokalt API |/api/nätmetrering| | Reaktiv effekt/energi | Lokalt API |/api/reactive| | Fas C-multiplikator | Lokalt API |/api/ctcratio?x=1 | | CT-förhållande (WEM3046T) | Lokalt API |/api/ratio?x=` | | Modbus/TCP | Modbus-klient | Kompatibel med HA/PLC/SCADA |

Senast uppdaterad: 15 oktober 2025