Beklager, din browser understøtter ikke JavaScript!

IAMMETER Wi-Fi-energimåler: Guide til lokal integration og åben grænseflade

IAMMETER Wi-Fi-energimåler: Guide til lokal integration og åben grænseflade

For udviklere og systemintegratorer, der bruger IAMMETER-målereudenIAMMETER-Cloud.

IAMMETER Wi-Fi-energimålere er designet til både cloudbaserede og lokale integrationer og leverer åbne API'er (HTTP, MQTT, Modbus/TCP), der gør det muligt for udviklere at bygge deres egne energistyringssystemer (EMS), bygningsstyringssystemer (BMS) eller smart home automation-platforme.

IAMMETER-firmware opgraderes løbende. Dette dokument viser alle lokale og åbne integrationsfunktioner, der understøttes af den nyeste firmware.(Opdateres løbende)


1) Firmwareopdatering

Få de seneste firmwareudgivelser her:


2) Køretilstande (ikke-cloud)

Vælg en tilstand baseret på, hvordan du integrerer eller bruger enheden.

Mode Beskrivelse Typisk brug
Sky Upload data til IAMMETER-Cloud 🚫 Ikke dækket i denne artikel
TCP Upload til tredjepartsservere viaTCP/TLSellerMQTT Lokale servere, brugerdefinerede mæglere
HTTP Upload til tredjepartsservere viaHTTP/HTTPS Brugerdefinerede REST API'er/web-backends
MQTT Upload data direkte til en MQTT-broker Kun tilgængelig i den nyeste firmware
Selvstændig Ingen dataupload; måleren fungerer som en lokal server, der reagerer på API'er eller Modbus/TCP-klienter Kun tilgængelig i den nyeste firmware

Ældre firmware-brugergrænseflade

Skærm til valg af køretilstand for ældre firmware

Seneste firmwareWebUI

Ny firmware WebUI-grænseflade, der viser muligheder for kørselstilstand


(Resten af dit dokument fortsætter uændret fra din seneste version.)

3) TCP/TLS/MQTT-integration

3.1 TCP og TLS

Målere kan sende data direkte til dit TCP/TLS-slutpunkt.

🔹 Ny firmwarekonfiguration

Konfigurationsprocessen i den nyeste firmware ligner den i tidligere versioner.

Køretilstand: TCP

Adresse:

  • For en TCP-server — indtast{domæne}:{port}(f.eks.abc.com:12345). Eksempel på konfiguration af TCP-serveradresse
  • For en TLS-server — brugtls://{domæne}:{port}(f.eks.tls://abc.com:12345). Eksempel på konfiguration af TLS-serveradresse

Uploadinterval:Minimumsinterval for upload er2 sekunder.

🔹 Konfiguration af ældre firmware

Eksempel på TCP/TLS-konfiguration for ældre firmware


3.2 MQTT

🔹 Ny firmwarekonfiguration

Køretilstand: MQTT Adresse:Indtast IP eller domæne med port, f.eks.192.168.11.163:1883 Brugernavn / Adgangskode:MQTT-mæglerlegitimationsoplysninger (valgfrit, hvis det ikke kræves af mægleren)

Uploadinterval:Minimumsinterval er2 sekunder. HA MQTT-opdagelse: Aktivér MQTT-opdagelse i Home Assistant

Eksempel på opsætning af ny firmware MQTT-broker

🔹 Konfiguration af ældre firmware

Publicer telemetri til en lokal eller offentlig MQTT-mægler.

MQTT-opsætningsgrænseflade for ældre firmware


4) HTTP/HTTPS-integration

🔹 Konfiguration af ældre firmware

Målere kan sende data direkte til din brugerdefinerede server.

  • Datanyttelastformatet er identisk med TCP/MQTT-tilstande.
  • Enhver port kan bruges.
  • Havn443aktiverer HTTPS automatisk.
  • Detaljer:Upload via HTTP/HTTPS

Eksempel på HTTP/HTTPS-dataopslag for ældre firmware

🔹 Ny firmwarekonfiguration

Adresse:Inputformatet er det samme som den ældre firmware.

  • Hvis der ikke er angivet nogen port, er standardporten80.
  • Kun havn443bruger HTTPS post; alle andre porte bruger HTTP post.

Konfigurationsskærm for ny firmware-HTTP/HTTPS-adresse


5) Lokal API (HTTP over LAN)

Få adgang til måleren lokalt via dens LAN IP — ingen cloud-forbindelse nødvendig.

5.1 HENT /api/monitorjson

Returnerer måledata i realtid.Felter:Spænding, strøm, aktiv effekt, frem/tilbage kWh, frekvens, effektfaktor.

Eksempel:

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

📘 Udvidelse af måling af reaktiv effekt


5.2 HENT /api/monitor

Avanceret version afMonitorjson, inkluderer Wi-Fi-signaloplysninger:

  • SSID(navn på tilsluttet AP)
  • signatur(signalstyrke)

5.3 HENT /api/wifidata

Returnerer Wi-Fi- og netværkskonfiguration.

{
"Version": "i.75.97.9", "SN": "3E0BAF87", "mac": "B0F8933C4F94",
"Type": "PM", "SSID": "CMCC-laohe", "IP": "192.168.11.62",
"Netmaske": "255.255.255.0", "gw": "192.168.11.253",

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

5.4 HENT /api/uploadinterval?x=

Indstiller uploadinterval (i sekunder).

Fungerer i ikke-cloud-tilstande (TCP/HTTP/MQTT).

ISeneste firmware, kan denne parameter nu konfigureres direkte fraWebUI-grænsefladeuden at kalde API'en manuelt.


5.5 HENT /api/mqtt

Konfigurerer MQTT-legitimationsoplysninger. 📘MQTT-konfigurations-API-dokumentation

ISeneste firmware, kan denne parameter nu konfigureres direkte fraWebUI-grænsefladeuden at kalde API'en manuelt.


5.6 GET /api/netmetring

SkifterNettoenergimåling (NEM)tilstand. 📘Aktivér NEM-tilstand

ISeneste firmware, kan denne parameter nu konfigureres direkte fraWebUI-grænsefladeuden at kalde API'en manuelt.


5.7 GET /api/ctcratio

JustererFase C-multiplikatorfor scenarier med delt fase/balancerede scenarier.

ISeneste firmware, kan denne parameter nu konfigureres direkte fraWebUI-grænsefladeuden at kalde API'en manuelt.


5.8 GET /api/reaktiv

Aktiverer eller deaktivererReaktiv effekt (Q)ogReaktiv energi (kVARh)måling. 📘Dokumentation af reaktiv effekt

ISeneste firmware, kan denne parameter nu konfigureres direkte fraWebUI-grænsefladeuden at kalde API'en manuelt.


5.9 GET /api/ratio (kun tilgængelig for WEM3046T)

SidenWEM3046Tbruger eksterne CT'er med5A sekundære udgange(f.eks. 1000:5, 1500:5, 2000:5 osv.), skal de målte værdier (strøm, effekt, energi) ganges med CT-forholdet.

Eksempel:

/api/ratio?x=400
  • Indstil forhold: /api/ratio?x={ct_ratio}
  • Forespørgselsforhold: /api/forhold

KunWEM3046Tunderstøtter eksterne 5A CT'er — denne API er ugyldig for andre modeller.


6) JSON-formatkonsistens

Alle kommunikationsformer —HTTP, TCP, MQTT, lokal API— brug den samme JSON-struktur. 📘JSON-datadefinition


7) Modbus/TCP-understøttelse

IAMMETER-målere understøttes nativtModbus/TCP, hvilket muliggør direkte integration medHjemmeassistent, PLC'er, ellerSCADAsystemer.


8) Understøttede integrationsscenarier

System Protokol(ler) Eksempel på brug Reference
Hjemmeassistent HTTP / Modbus / MQTT Dashboard og automatisering Guide
Node-RØD HTTP / Modbus / MQTT Automatiseringsflow Guide
OpenHAB / ioBroker HTTP Lokale dashboards Integration
ZABBIX HTTP Overvågningsdashboards Integration
Thingsboard HTTP IoT-visualisering Integration
Brugerdefinerede servere HTTP / MQTT / TCP Indtagelse af virksomheds- eller lokal data Byg dit eget system

9) Ressourcer


10) Udvikleroversigt

| Funktioner | Adgang | Noter | | ----- ...---------- | | Lokale data i realtid | Lokal API |/api/monitorjson, /api/monitor| | Upload fra tredjepart | TCP/TLS, HTTP/HTTPS | Samme nyttelastskema | | MQTT-publicering | MQTT-broker |/api/mqttfor at indstille legitimationsoplysninger | | Netmåling | Lokal API |/api/netmetring| | Reaktiv effekt/energi | Lokal API |/api/reaktiv| | Fase C-multiplikator | Lokal API |/api/ctcratio?x=1 | | CT-forhold (WEM3046T) | Lokal API |/api/ratio?x=` | | Modbus/TCP | Modbus-klient | Kompatibel med HA/PLC/SCADA |


Sidst opdateret: 15. oktober 2025

Top