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:
- Firmware-udgivelsesside (imeter.club): https://imeter.club/topic/11
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

Seneste firmwareWebUI

(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).
- For en TLS-server — brug
tls://{domæne}:{port}(f.eks.tls://abc.com:12345).
Uploadinterval:Minimumsinterval for upload er2 sekunder.
🔹 Konfiguration af æ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

🔹 Konfiguration af ældre firmware
Publicer telemetri til en lokal eller offentlig MQTT-mægler.

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

🔹 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.

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.
x=2fordobler fase C-aflæsninger (strøm, effekt, kWh). 📘Forklaring af CTC-forholdet
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