API del WPC3700
Abbreviazioni WPC: controller di potenza Wi-Fi
API del Controller di Potenza Serie WPC
Questo articolo presenta principalmente le API fornite dai Controller di Potenza Serie WPC. Tramite queste API, gli utenti possono eseguire le seguenti operazioni:
- Configurare i parametri del WPC
- Controllare la potenza in uscita del WPC
Chi Dovrebbe Leggere Questo Articolo
Questa sezione è posta all'inizio perché, sebbene abbiamo scritto questo articolo, in realtà non è rilevante per la maggior parte degli utenti WPC.
Se hai ottenuto un controller di potenza della serie WPC, ci sono alcune possibili modalità operative:
- Hai già installato i contatori IAMMETER sul lato rete e stai utilizzando direttamente il WPC3700 in combinazione con i contatori IAMMETER (WPC3700 opera in modalità automatica), consentendo al WPC3700 di funzionare continuamente sotto la spinta del surplus solare, che è la soluzione IAMMETER Sistema di Controllo del Riscaldamento Fotovoltaico.
- Non possiedi un contatore IAMMETER, ma conosci Home Assistant o Node-RED e hai integrato il WPC3700 nel sistema di automazione HA o Node-RED (Abilita il discovery MQTT in Home Assistant con l'ultimo firmware IAMMETER (i.76.058.8)).
- Hai bisogno di chiamare l'API per integrare il WPC3700 nel tuo sistema.
Solo gli utenti che richiedono la terza modalità operativa dovrebbero leggere questo articolo.
/api/setpower
/api/setpower?x=100
Introduzione
Questa API controlla la potenza in uscita del WPC.
Nota: Questo parametro può essere modificato anche tramite l'API setadv (chiamata HTTP POST, parametro setPower).
Poiché il parametro setPower potrebbe dover essere modificato frequentemente in base alle letture in tempo reale della potenza di rete, viene fornita questa interfaccia API HTTP GET aggiuntiva.
URL e Metodo
URL: http://{{IP}}/api/setpower
Metodo: HTTP GET
| Nome Parametro | Esempio Valore | Unità | Obbligatorio | Tipo | Descrizione |
|---|---|---|---|---|---|
| x | 100 | W | Sì | int | Rappresenta la potenza in uscita del WPC. È lo stesso parametro di setPower in setadv. |
/api/setadv
Introduzione
Questa API viene utilizzata per impostare i parametri del WPC.
Nota: Tutti i parametri possono essere impostati direttamente tramite l'interfaccia utente. Solo un numero limitato di clienti che necessitano di integrare i prodotti della serie WPC nei propri sistemi utilizzerà questa API.
URL e Metodo
- URL:
http://{{IP Locale del WPC}}/api/setadv - Metodo: HTTP POST
Parametri della Richiesta
Di seguito è riportato un esempio dei parametri di setadv.
Nota: Quando si esegue setadv, non è necessario inviare tutti i parametri. Devono essere inviati solo i parametri che devono essere modificati. I parametri che non necessitano di modifica non devono essere inviati. Puoi prima utilizzare getadv per leggere la configurazione corrente, quindi inviare solo i parametri che devono essere modificati.
{
"maxPower": 3500,
"setPower": 0,
"restorePower": 0,
"setPowerMode": 0,
"meterAddress": "10.10.30.35",
"threshold": 30,
"hysteresis": 50,
"startHour": 8,
"stopHour": 18,
"tzOffset": 8,
"meterType": 0,
"meterConfig": "3,2,1",
"ntpServer": "ntp.aliyun.com",
"haDiscovery": 1,
"mqttEnabled": 1,
"mqttAddress": "10.10.30.89:1883",
"mqttUsername": "test",
"mqttPassword": "123456",
"uploadInterval": 6
}
Risposta
{
"successful": 1,
"message": "ok"
}
Descrizione dei Parametri
| Nome Parametro | Tipo | Unità | Descrizione |
|---|---|---|---|
| maxPower | int | W | La potenza massima del carico controllato, deve essere inferiore a 3700 |
| setPower | int | W | La potenza in uscita del WPC |
| restorePower | int | W | Potenza dopo l'uscita dal controllo in modalità automatica |
| setPowerMode | int | Selezione della modalità operativa: 0: Manuale, 1: Automatica | |
| threshold | int | W | In modalità automatica, è la soglia per la regolazione in base alla potenza di rete |
| hysteresis | int | W | In modalità automatica, è l'isteresi per la regolazione in base alla potenza di rete |
| startHour | int | ora | Ora di inizio della modalità automatica |
| stopHour | int | ora | Ora di fine della modalità automatica |
| tzOffset | int | Offset del fuso orario | |
| meterType | int | Scelta della marca del contatore per la misurazione di rete in modalità automatica: 0:iMeter, 1:virtualTCP | |
| meterConfig | string | Scelta del modello del contatore per la misurazione di rete in modalità automatica: 3:trifase, 2:usa faseB, 1:rapporto | |
| ntpServer | string | Indirizzo del server NTP | |
| haDiscovery | int | Abilita il rilevamento automatico MQTT di Home Assistant: 0:disabilita, 1:abilita | |
| mqttEnabled | int | Abilita MQTT: 0:disabilita, 1:abilita | |
| meterAddress | string | Indirizzo del broker MQTT, necessario per l'integrazione con Home Assistant: 192.168.1.22:1833 | |
| mqttUsername | string | Nome utente MQTT | |
| mqttPassword | string | Password MQTT | |
| uploadInterval | int | s | Intervallo di tempo di caricamento |
/api/getadv
Introduzione
Questa API legge tutti i parametri del WPC (tutti i parametri dell'API setadv possono essere letti qui).
URL e Metodo
- URL:
http://{{IP Locale del WPC}}/api/getadv - Metodo: HTTP GET
Risposta
{
"maxPower": 3500,
"setPower": 0,
"restorePower": 0,
"setPowerMode": 0,
"setPowerModeList": "Manual,Auto",
"meterAddress": "10.10.30.35",
"threshold": 20,
"hysteresis": 30,
"startHour": 8,
"stopHour": 18,
"tzOffset": 8,
"meterType": 0,
"meterConfig": "3,2,1",
"meterList": "iMeter,virtualTCP",
"ntpServer": "ntp.aliyun.com",
"haDiscovery": 0,
"mqttEnabled": 0,
"mqttAddress": "192.168.1.22:1833",
"mqttUsername": "test",
"mqttPassword": "123456",
"uploadInterval": 60
}
Fai riferimento alla descrizione dei parametri in setadv.
/api/setwifiadv
Introduzione
Questa API configura i parametri Wi-Fi per i dispositivi WPC/WEM.
URL e Metodo
- URL:
http://{{IP Locale del WPC}}/api/setwifiadv - Metodo: HTTP POST
Parametri della Richiesta
{
"ssid":"xxxx",
"pwd":"xxxx",
"ip":"xxxx",
"netmask":"xxxxx",
"gw":"xxxx",
"dns":"192.168.1.1",
"dhcp":true,
"runMode":"cloud", // cloud, tcp, http
"uploadAddress":"http://myserver.com/upload" // Utile solo se runMode non è cloud
}
Risposta
{
"successful": true,
"message": "ok"
}
Descrizione dei Parametri
| Nome Parametro | Tipo | Unità | Descrizione |
|---|---|---|---|
| ssid | string | Nome della rete Wi-Fi per la connessione WLAN | |
| pwd | string | Password Wi-Fi per la connessione WLAN | |
| ip | string | IP statico; non richiesto se si utilizza la modalità DHCP | |
| netmask | string | Maschera di rete; non richiesta se si utilizza la modalità DHCP | |
| gw | string | Gateway; non richiesto se si utilizza la modalità DHCP | |
| dns | string | Server DNS; non richiesto se si utilizza la modalità DHCP | |
| dhcp | bool | false: disabilita DHCP, true: abilita DHCP |
Documentazione di Riferimento
Le funzionalità "nascoste" nel firmware del contatore energetico Wi-Fi
Ti invitiamo a farci sapere cosa ne pensi sul nostro forum. https://imeter.club
Informazioni su IAMMETER
IAMMETER è un'azienda specializzata in prodotti e servizi per la gestione dell'energia, che offre contatori energetici intelligenti, app di gestione e piattaforme cloud.
Il nostro obiettivo è aiutare i clienti a gestire, utilizzare e risparmiare energia in modo efficace, riducendo le bollette elettriche attraverso il monitoraggio e l'analisi intelligenti.
Soluzioni
Prodotti
- Panoramica dei Contatori Energetici IAMMETER
- WEM3080T – Contatore Energetico Wi-Fi Trifase/Bifase
- WEM3080 – Contatore Energetico Wi-Fi Monofase
- WEM3050T – Contatore Energetico Trifase
- WEM3046T – Contatore Energetico Wi-Fi Trifase con Ingresso CT Standard 5A