Lokale APIs der IAMMETER-Firmware
IAMMETER unterstützt lokale HTTP-APIs. Informationen zu den Funktionen realer Geräte finden Sie in der offiziellen Dokumentation. Dieser Simulator implementiert nur die unten aufgeführte Teilmenge.
Pfade und Sitzungen
Stellen Sie jedem Zählerendpunkt /WEM3080, /WEM2067 oder /WEM3050T voran. Geräteseiten und APIs unterstützen HTTP auf Port 80 sowie HTTPS auf Port 443. Physische Geräte verwenden normalerweise lokales HTTP.
Öffentliche Messanfragen funktionieren ohne Sitzung und geben die Standardquelle Inverter and grid zurück. Für private Einstellungen ist das vorhandene Zählerseiten-Cookie erforderlich. Eine separate Curl-Anfrage erbt nicht die ausgewählte Quelle oder Einstellungen Ihres Browsers.
HTTP und HTTPS verwenden separate Browsersitzungen. Öffnen Sie die Messgeräteseite nach dem gleichen Schema, bevor Sie Einstellungen ändern. Anonyme Lesevorgänge verwenden die Standardquelle Inverter and grid.
Unterstützte Firmware-API-Teilmenge
| Verfahren | Endpunkt | Zweck | Unterstützte Modelle |
|---|---|---|---|
| GET | /api/monitor | Lesen Sie Spannung, Strom, Leistung und Energie ab. | Alle Modelle |
| GET | /api/monitorjson · /monitorjson | Lesen Sie Legacy-JSON mit optionalen reaktiven Daten. | Alle Modelle |
| GET | /api/wifidata | Lesen Sie die virtuellen WLAN- und Geräteeinstellungen. | Alle Modelle |
| POST | /api/setwifiadv | Speichern Sie die virtuellen WLAN-Einstellungen für diese Sitzung und dieses Modell. | Alle Modelle |
| GET | /api/getadv | Erweiterte Einstellungen und Upload-Einstellungen lesen; Passwort ist leer. | Alle Modelle |
| POST | /api/setadv | Speichern Sie die Upload-Einstellungen sowie die Flags Reactive und NEM. | Alle Modelle; NEM nur auf WEM3050T |
Messantworten
WEM3080 gibt Data zurück; WEM2067 und WEM3050T geben Datas mit einer Zeile pro Kanal zurück. Die Feldreihenfolge ist unten dargestellt. Beispiele dienen der Veranschaulichung und sind keine Live-Antworten.
| Index | Messung | Einheit |
|---|---|---|
| 0 | Spannung | V |
| 1 | Stromstärke | A |
| 2 | Wirkleistung | W |
| 3 | Bezugsenergie | kWh |
| 4 | Einspeiseenergie | kWh |
| 5 | Frequenz | Hz |
| 6 | Leistungsfaktor | — |
Lesen Sie öffentliche Messungen
curl 'https://simulator.iammeter.com/WEM3050T/api/monitor'Antwortform
{
"ssid": "IAMMETER-Simulator",
"sig": 100,
"mac": "020000003050",
"version": "simulator-1.0",
"server": "em",
"SN": "1AD9B537",
"model": "WEM3050T",
"Datas": [
[230.0,1.252,270.0,2.092,0.000,50.00,0.94],
[229.5,0.487,110.0,1.280,0.000,50.00,0.98],
[229.0,0.399,90.0,0.747,0.000,50.00,0.98]
]
}Virtuelle WLAN-Einstellungen
setwifiadv akzeptiert SSID, PWD, DHCP (boolesch), IP, Netzmaske, GW und DNS. Diese Werte ändern nur das virtuelle Gerät; Sie konfigurieren einen Netzwerkadapter nicht neu.
Beispiel-Anfragetext
{"ssid":"Test network","dhcp":true}Erfolgreiche Speicherung
{"successful":1,"message":"ok"}Erweiterte Einstellungen
setadv akzeptiert teilweise JSON-Updates. Nicht spezifizierte Felder behalten ihre aktuellen Werte. Das Upload-Intervall beträgt 10–3600 Sekunden.
Reactive fügt EA.Reactive zu monitorjson hinzu und lädt hoch, nicht api/monitor. Jede Zeile ist [var, induktiver kvarh, kapazitiver kvarh].
NEM wird nur von WEM3050T unterstützt. In der vierten Zeile Datas werden Wirkleistung, Import-kWh und Export-kWh getrennt summiert; alle anderen Felder sind Null.
| Parameter | Akzeptierte Werte |
|---|---|
| runMode | 1 = TCP/TLS; 2 = HTTP/HTTPS; 3 = MQTT/MQTTS; 4 = stand alone |
| uploadAddress | Empfängeradresse; Folgen Sie dem Eingabehinweis Settings. |
| mqttUsername · mqttPassword | Referenzen als Makler; getadv gibt niemals das gespeicherte Passwort zurück. |
| uploadInterval | 10–3600 s |
| reactive | 0 / 1 |
| netmetering | 0 / 1 |
| ntpServer | Nur gespeicherter Text; ändert die Serverzeit nicht. |
| haDiscovery · ctcRatio | Nur 0 bzw. 1; Funktionen sind nicht implementiert. |
Aktivieren Sie Reactive und NEM auf WEM3050T
{"reactive":1,"netmetering":1}Ergebnisse prüfen
Eine erfolgreiche Speicherung gibt successful=1 zurück. Ungültige Einstellungswerte können HTTP 200 mit successful=0 zurückgeben; Überprüfen Sie den JSON sowie den Statuscode. Fehlende Sitzungen geben 401 zurück; Cross-Origin-Schreibvorgänge werden abgelehnt.
Das Speichern der Upload-Einstellungen stellt keinen Beweis für die Zustellung dar. Überprüfen Sie den Debug-Upload-Status und bestätigen Sie die Meldungen an Ihrem Empfänger.
Nicht implementiert
Die folgenden Funktionen werden nur angezeigt oder werden nicht unterstützt. Sie stellen keine funktionierenden Schreib-APIs bereit.
| Funktion | Aktuelles Verhalten |
|---|---|
| WLAN-Scan · Neustart · Werksreset | Keine echte Operation. |
| Gerätesicherheit · Firmware-Upgrade | Nur Anzeige. |
| IAMMETER-cloud · HA Discovery · MQTT Downlink | Kein Cloud-Upload, keine Erkennung oder Remote-Konfiguration. |
Simulator-Tools werden separat dokumentiert
Simulator-Debug-Endpunkte sind keine IAMMETER-Firmware-APIs. Sie sind von der Firmware-API-Liste oben ausgeschlossen.