Spiacenti, il tuo browser non supporta JavaScript!
Accedi

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:

  1. 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.
  2. 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)).
  3. 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 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

Funzione avanzata di IAMMETER

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

Sistema

In alto