IAMMETER-firmware Lokale API's
IAMMETER ondersteunt lokale HTTP API's. Zie de officiële documentatie voor de mogelijkheden van echte apparaten. Deze simulator implementeert alleen de hieronder genoemde subset.
Paden en sessies
Voeg voor elk metereindpunt /WEM3080, /WEM2067 of /WEM3050T toe. Apparaatpagina's en API's ondersteunen HTTP op poort 80 en HTTPS op poort 443. Fysieke apparaten gebruiken normaal gesproken de lokale HTTP.
Openbare meetverzoeken werken zonder sessie en retourneren de standaard Inverter and grid-bron. Voor privé-instellingen is de bestaande meterpaginacookie vereist. Een afzonderlijk curlverzoek neemt de geselecteerde bron of instellingen van uw browser niet over.
HTTP en HTTPS gebruiken afzonderlijke browsersessies. Open de meterpagina met hetzelfde schema voordat u de instellingen wijzigt. Anonieme lezingen gebruiken de standaard Inverter and grid-bron.
Ondersteunde firmware-API-subset
| Methode | Eindpunt | Doel | Ondersteunde modellen |
|---|---|---|---|
| GET | /api/monitor | Lees spanning, stroom, vermogen en energie af. | Alle modellen |
| GET | /api/monitorjson · /monitorjson | Lees verouderde JSON, met optionele reactieve gegevens. | Alle modellen |
| GET | /api/wifidata | Lees virtuele Wi-Fi en apparaatinstellingen. | Alle modellen |
| POST | /api/setwifiadv | Sla virtuele Wi-Fi-instellingen op voor deze sessie en dit model. | Alle modellen |
| GET | /api/getadv | Geavanceerde instellingen lezen en uploaden; wachtwoord is leeg. | Alle modellen |
| POST | /api/setadv | Bewaar uploadinstellingen, Reactive- en NEM-vlaggen. | Alle modellen; NEM alleen op WEM3050T |
Meetreacties
WEM3080 retourneert Data; WEM2067 en WEM3050T retourneren Datas met één rij per kanaal. De veldvolgorde wordt hieronder weergegeven. Voorbeelden zijn illustratief, geen live reacties.
| Index | Meting | Eenheid |
|---|---|---|
| 0 | Spanning | V |
| 1 | Stroom | A |
| 2 | Actief vermogen | W |
| 3 | Afgenomen energie | kWh |
| 4 | Teruggeleverde energie | kWh |
| 5 | Frequentie | Hz |
| 6 | Arbeidsfactor | — |
Lees openbare metingen
curl 'https://simulator.iammeter.com/WEM3050T/api/monitor'Reactie vorm
{
"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]
]
}Virtuele Wi-Fi-instellingen
setwifiadv accepteert ssid, pwd, dhcp (boolean), ip, netmask, gw en dns. Deze waarden veranderen alleen het virtuele apparaat; ze configureren een netwerkadapter niet opnieuw.
Voorbeeld van een verzoektekst
{"ssid":"Test network","dhcp":true}Succesvol opslaan
{"successful":1,"message":"ok"}Geavanceerde instellingen
setadv accepteert gedeeltelijke JSON-updates. Niet-gespecificeerde velden behouden hun huidige waarden. Het uploadinterval is 10–3600 seconden.
Reactive voegt EA.Reactive toe aan monitorjson en uploadt, niet api/monitor. Elke rij is [var, inductieve kvarh, capacitieve kvarh].
NEM wordt alleen ondersteund door WEM3050T. De vierde Datas-rij somt het actieve vermogen, de import-kWh en de export-kWh afzonderlijk op; alle andere velden zijn nul.
| Parameter | Geaccepteerde waarden |
|---|---|
| runMode | 1 = TCP/TLS; 2 = HTTP/HTTPS; 3 = MQTT/MQTTS; 4 = stand alone |
| uploadAddress | Adres ontvanger; volg de invoerhint van de Settings. |
| mqttUsername · mqttPassword | Makelaarsreferenties; getadv retourneert nooit het opgeslagen wachtwoord. |
| uploadInterval | 10–3600 sec |
| reactive | 0 / 1 |
| netmetering | 0 / 1 |
| ntpServer | Alleen opgeslagen tekst; verandert de servertijd niet. |
| haDiscovery · ctcRatio | Slechts respectievelijk 0 en 1; functies zijn niet geïmplementeerd. |
Schakel Reactive en NEM in op WEM3050T
{"reactive":1,"netmetering":1}Resultaten controleren
Een succesvolle save retourneert successful=1. Ongeldige instellingswaarden kunnen HTTP 200 retourneren met successful=0; controleer zowel de JSON als de statuscode. Ontbrekende sessies retourneren 401; cross-origin schrijfbewerkingen worden afgewezen.
Het opslaan van de uploadinstellingen vormt geen bewijs van bezorging. Controleer de debug-uploadstatus en bevestig berichten op uw ontvanger.
Niet geïmplementeerd
De onderstaande functies zijn alleen voor weergave of worden niet ondersteund. Ze bieden geen werkende schrijf-API's.
| Functie | Huidig gedrag |
|---|---|
| Wi-Fi-scan · opnieuw opstarten · fabrieksinstellingen herstellen | Geen echte operatie. |
| Apparaatbeveiliging · firmware-upgrade | Alleen weergeven. |
| IAMMETER-cloud · HA Discovery · MQTT downlink | Geen cloudupload, ontdekking of configuratie op afstand. |
Simulatietools worden afzonderlijk gedocumenteerd
Debug-eindpunten van de simulator zijn geen IAMMETER-firmware-API's. Ze zijn uitgesloten van de bovenstaande firmware-API-lijst.