Firmware IAMMETER API locali
IAMMETER supporta le API HTTP locali. Consulta la documentazione ufficiale per le funzionalità del dispositivo reale. Questo simulatore implementa solo il sottoinsieme elencato di seguito.
Percorsi e sessioni
Anteporre a ogni punto finale del contatore /WEM3080, /WEM2067 o /WEM3050T. Le pagine e le API del dispositivo supportano HTTP sulla porta 80 e HTTPS sulla porta 443. I dispositivi fisici normalmente utilizzano HTTP locale.
Le richieste di misurazione pubbliche funzionano senza una sessione e restituiscono la sorgente Inverter and grid predefinita. Le impostazioni private richiedono il cookie meter-page esistente. Una richiesta curl separata non eredita la sorgente o le impostazioni selezionate dal tuo browser.
HTTP e HTTPS utilizzano sessioni browser separate. Aprire la pagina del misuratore utilizzando lo stesso schema prima di modificare le impostazioni. Le letture anonime utilizzano l'origine Inverter and grid predefinita.
Sottoinsieme API firmware supportato
| Metodo | Punto finale | Scopo | Modelli supportati |
|---|---|---|---|
| GET | /api/monitor | Leggere tensione, corrente, potenza ed energia. | Tutti i modelli |
| GET | /api/monitorjson · /monitorjson | Leggi JSON legacy, con dati reattivi opzionali. | Tutti i modelli |
| GET | /api/wifidata | Leggi il Wi-Fi virtuale e le impostazioni del dispositivo. | Tutti i modelli |
| POST | /api/setwifiadv | Salva le impostazioni Wi-Fi virtuali per questa sessione e modello. | Tutti i modelli |
| GET | /api/getadv | Leggi le impostazioni avanzate e di caricamento; la password è vuota. | Tutti i modelli |
| POST | /api/setadv | Salva le impostazioni di caricamento, i flag Reactive e NEM. | Tutti i modelli; NEM solo su WEM3050T |
Risposte di misurazione
WEM3080 restituisce Data; WEM2067 e WEM3050T restituiscono Datas con una riga per canale. L'ordine dei campi è mostrato di seguito. Gli esempi sono illustrativi, non risposte in tempo reale.
| Indice | Misurazione | Unità |
|---|---|---|
| 0 | Tensione | V |
| 1 | Corrente | A |
| 2 | Potenza attiva | W |
| 3 | Energia importata | kWh |
| 4 | Energia esportata | kWh |
| 5 | Frequenza | Hz |
| 6 | Fattore di potenza | — |
Leggi le misurazioni pubbliche
curl 'https://simulator.iammeter.com/WEM3050T/api/monitor'Forma della risposta
{
"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]
]
}Impostazioni Wi-Fi virtuale
setwifiadv accetta ssid, pwd, dhcp (booleano), ip, netmask, gw e dns. Questi valori modificano solo il dispositivo virtuale; non riconfigurano una scheda di rete.
Corpo della richiesta di esempio
{"ssid":"Test network","dhcp":true}Salvataggio riuscito
{"successful":1,"message":"ok"}Impostazioni avanzate
setadv accetta aggiornamenti JSON parziali. I campi non specificati mantengono i valori correnti. L'intervallo di caricamento è compreso tra 10 e 3600 secondi.
Reactive aggiunge EA.Reactive a monitorjson e carica, non api/monitor. Ogni riga è [var, kvarh induttivo, kvarh capacitivo].
NEM è supportato solo da WEM3050T. La sua quarta riga Datas somma separatamente la potenza attiva, i kWh importati e i kWh esportati; tutti gli altri campi sono zero.
| Parametro | Valori accettati |
|---|---|
| runMode | 1 =TCP/TLS; 2 = HTTP/HTTPS; 3 = MQTT/MQTTS; 4 = stand alone |
| uploadAddress | Indirizzo del destinatario; seguire il suggerimento di input Settings. |
| mqttUsername · mqttPassword | Credenziali dell'intermediario; getadv non restituisce mai la password salvata. |
| uploadInterval | 10–3600 secondi |
| reactive | 0 / 1 |
| netmetering | 0 / 1 |
| ntpServer | Solo testo memorizzato; non cambia l'ora del server. |
| haDiscovery · ctcRatio | Solo 0 e 1 rispettivamente; le funzionalità non sono implementate. |
Abilita Reactive e NEM su WEM3050T
{"reactive":1,"netmetering":1}Controllo dei risultati
Un salvataggio riuscito restituisce successful=1. Valori di impostazione non validi possono restituire HTTP 200 con successful=0; controlla il JSON e il codice di stato. Le sessioni mancanti restituiscono 401; le scritture multiorigine vengono rifiutate.
Il salvataggio delle impostazioni di caricamento non comprova la consegna. Controlla lo stato del caricamento del debug e conferma i messaggi al tuo ricevitore.
Non implementato
Le funzioni seguenti sono di sola visualizzazione o non supportate. Non forniscono API di scrittura funzionanti.
| Funzione | Comportamento attuale |
|---|---|
| Scansione Wi-Fi · riavvio · ripristino delle impostazioni di fabbrica | Nessuna vera operazione. |
| Sicurezza del dispositivo · aggiornamento del firmware | Solo visualizzazione. |
| IAMMETER-cloud · Rilevamento HA · Downlink MQTT | Nessun caricamento nel cloud, rilevamento o configurazione remota. |
Gli strumenti del simulatore sono documentati separatamente
Gli endpoint di debug del simulatore non sono API del firmware IAMMETER. Sono esclusi dall'elenco delle API firmware riportato sopra.