Tyvärr stöder din webbläsare inte JavaScript!
Logga in

API:er för WPC3700

Förkortning av substantiv WPC: Wi-Fi-strömkontroller

API för WPC-seriens strömkontroller

Den här artikeln beskriver huvudsakligen de API:er som tillhandahålls av WPC-seriens strömkontroller. Genom dessa API:er kan användare utföra följande operationer:

  • Konfigurera WPC-parametrar
  • Styra WPC:ns utgångseffekt

Vem bör läsa den här artikeln

Det här avsnittet är placerat i början eftersom det, även om vi skrev den här artikeln, faktiskt inte är relevant för de flesta WPC-användare.

Om du har skaffat en strömkontroller i WPC-serien finns det några möjliga driftslägen:

  1. Du har redan installerat IAMMETER-mätare på nätsidan och använder direkt WPC3700 tillsammans med IAMMETER-mätare (WPC3700 körs i autoläge), vilket gör att WPC3700 kan arbeta kontinuerligt under drivkraften av solöverskott. Detta är IAMMETER-lösningen Styrsystem för PV-värmare.
  2. Du har ingen IAMMETER-mätare, men du är bekant med Home Assistant eller Node-RED och har integrerat WPC3700 i HA- eller Node-RED-automationssystemet (Aktivera MQTT discovery i Home Assistant med den senaste IAMMETER-firmwaren (i.76.058.8)).
  3. Du behöver anropa API:et för att integrera WPC3700 i ditt eget system.

Endast användare som behöver det tredje driftläget bör läsa den här artikeln.


/api/setpower

/api/setpower?x=100

Introduktion

Detta API styr WPC:ns utgångseffekt.

Notera: Den här parametern kan också ändras via setadv-API:et (HTTP POST-anrop, parametern setPower).

Eftersom parametern setPower kan behöva ändras ofta baserat på realtidsavläsningar av nätets effekt, tillhandahålls detta extra HTTP GET-API.

URL och metod

URL: http://{{IP}}/api/setpower

Metod: HTTP GET

Parameternamn Exempelvärde Enhet Obligatorisk Typ Beskrivning
x 100 W Ja int Representerar WPC:ns effektutgång. Detta är samma parameter som setPower i setadv.

/api/setadv

Introduktion

Detta API används för att ställa in WPC:ns parametrar.

Notera: Alla parametrar kan ställas in direkt via UI. Endast ett litet antal kunder som behöver integrera WPC-seriens produkter i sina egna system kommer att använda detta API.

URL och metod

  • URL: http://{{Local IP of the WPC}}/api/setadv
  • Metod: HTTP POST

Parametrar för begäran

Nedan följer ett exempel på setadv-parametrar.

Notera: När setadv exekveras behöver inte alla parametrar skickas med. Endast parametrarna som behöver ändras ska skickas med. Parametrar som inte behöver ändras behöver inte skickas med. Du kan först använda getadv för att läsa den aktuella konfigurationen och sedan bara skicka de parametrar som behöver ändras.

{
  "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
}

Svar

{
  "successful": 1,
  "message": "ok"
}

Parameterbeskrivning

Parameternamn Typ Enhet Beskrivning
maxPower int W Maximal effekt för den styrda lasten, måste vara mindre än 3700
setPower int W WPC:ns effektutgång
restorePower int W Effekt efter att styrningen i autoläge avslutats
setPowerMode int Val av driftsläge: 0: Manuell, 1: Auto
threshold int W I autoläge är detta tröskeln för justering baserat på nätets effekt
hysteresis int W I autoläge är detta hysteresen för justering baserat på nätets effekt
startHour int timme Starttid för autoläge
stopHour int timme Sluttid för autoläge
tzOffset int Tidszonsförskjutning
meterType int Val av mätarmärke för nätmätning i autoläge: 0:iMeter, 1:virtualTCP
meterConfig string Val av mätarmodell för nätmätning i autoläge: 3:tre faser, 2:använd fasB, 1:kvot
ntpServer string NTP-serverns adress
haDiscovery int Aktivera Home Assistant MQTT auto discovery: 0: avaktivera, 1: aktivera
mqttEnabled int Aktivera MQTT: 0: avaktivera, 1: aktivera
meterAddress string MQTT-brokeradress, krävs vid integrering med Home Assistant: 192.168.1.22:1833
mqttUsername string MQTT-användarnamn
mqttPassword string MQTT-lösenord
uploadInterval int s Uppladdningsintervall

/api/getadv

Introduktion

Detta API läser alla parametrar för WPC (alla parametrar från setadv-API:et kan läsas här).

URL och metod

  • URL: http://{{Local IP of the WPC}}/api/getadv
  • Metod: HTTP GET

Svar

{
  "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
}

Se parameterbeskrivningen i setadv.


/api/setwifiadv

Introduktion

Detta API konfigurerar Wi-Fi-parametrarna för WPC/WEM-enheter.

URL och metod

  • URL: http://{{Local IP of the WPC}}/api/setwifiadv
  • Metod: HTTP POST

Parametrar för begäran

{
    "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" // Useful only if runMode is non-cloud
}

Svar

{
    "successful": true,
    "message": "ok"
}

Parameterbeskrivning

Parameternamn Typ Enhet Beskrivning
ssid string Wi-Fi-AP-namn för WLAN-anslutningen
pwd string Wi-Fi-lösenord för WLAN-anslutningen
ip string Statisk IP; krävs inte om DHCP-läge används
netmask string Nätmask; krävs inte om DHCP-läge används
gw string Gateway; krävs inte om DHCP-läge används
dns string DNS-server; krävs inte om DHCP-läge används
dhcp bool false: avaktivera DHCP, true: aktivera DHCP

Referensdokumentation

De "dolda" funktionerna i firmware för Wi-Fi-energimätaren

IAMMETER:s avancerade funktioner

Berätta gärna för oss vad du tycker på vårt forum. https://imeter.club

Om IAMMETER

IAMMETER är ett företag som fokuserar på produkter och tjänster för energihantering och erbjuder smarta energimätare, hanteringsappar och molnplattformar.

Vårt mål är att hjälpa kunder att hantera, utnyttja och spara energi på ett effektivt sätt och därmed minska elräkningarna genom smart övervakning och analys.

Lösningar

Produkter

System

Upp