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:
- 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.
- 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)).
- 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
- Översikt över IAMMETER:s energimätare
- WEM3080T – Wi-Fi-energimätare för trefas/delad fas
- WEM3080 – Wi-Fi-energimätare för enfas
- WEM3050T – Trefasenergimätare
- WEM3046T – Wi-Fi-energimätare för trefas med 5A standard CT-ingång