API-ji naprave WPC3700
Okrajšave izrazov WPC: Wi-Fi krmilnik moči (Wi-Fi power controller)
API krmilnikov serije WPC
Ta članek v glavnem predstavlja API-je, ki jih ponujajo krmilniki serije WPC. Prek teh API-jev lahko uporabniki izvajajo naslednje operacije:
- Konfiguracija parametrov naprave WPC
- Nadzor izhodne moči naprave WPC
Komu je ta članek namenjen
Ta razdelek je postavljen na začetek, ker članek, čeprav smo ga napisali, dejansko ni pomemben za večino uporabnikov naprav WPC.
Če ste pridobili krmilnik moči serije WPC, obstaja nekaj možnih načinov delovanja:
- Na omrežni strani že imate nameščene števce IAMMETER in WPC3700 uporabljate neposredno skupaj s števci IAMMETER (WPC3700 deluje v samodejnem načinu), kar omogoča, da WPC3700 neprekinjeno deluje pod vodstvom sončnega presežka – to je rešitev IAMMETER Sistem za krmiljenje grelnika na PV.
- Nimate števca IAMMETER, poznate pa Home Assistant ali Node-RED in ste WPC3700 vključili v avtomatizacijski sistem HA ali Node-RED (Omogočite odkrivanje MQTT v Home Assistantu z najnovejšo vdelano programsko opremo IAMMETER (i.76.058.8)).
- Poklicati morate API, da bi WPC3700 vključili v svoj sistem.
Ta članek naj preberejo le uporabniki, ki potrebujejo tretji način delovanja.
/api/setpower
/api/setpower?x=100
Uvod
Ta API krmili izhodno moč naprave WPC.
Opomba: Ta parameter je mogoče spremeniti tudi prek API-ja setadv (klic HTTP POST, parameter setPower).
Ker je treba parameter setPower morda pogosto spreminjati glede na odčitke moči omrežja v realnem času, je na voljo ta dodatni vmesnik API z metodo HTTP GET.
URL in metoda
URL: http://{{IP}}/api/setpower
Metoda: HTTP GET
| Ime parametra | Primer vrednosti | Enota | Obvezen | Tip | Opis |
|---|---|---|---|---|---|
| x | 100 | W | Da | int | Predstavlja izhodno moč naprave WPC. To je isti parameter kot setPower v setadv. |
/api/setadv
Uvod
Ta API se uporablja za nastavljanje parametrov naprave WPC.
Opomba: Vse parametre je mogoče neposredno nastaviti prek uporabniškega vmesnika. Ta API bo uporabilo le majhno število strank, ki morajo izdelke serije WPC vključiti v svoje sisteme.
URL in metoda
- URL:
http://{{Lokalni IP naprave WPC}}/api/setadv - Metoda: HTTP POST
Parametri zahteve
Spodaj je primer parametrov setadv.
Opomba: Pri izvajanju setadv ni treba poslati vseh parametrov. Poslati je treba le parametre, ki jih želite spremeniti. Parametrov, ki jih ni treba spreminjati, ni treba poslati. Najprej lahko z uporabo getadv preberete trenutno konfiguracijo, nato pa posredujete le parametre, ki jih želite spremeniti.
{
"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
}
Odziv
{
"successful": 1,
"message": "ok"
}
Opis parametrov
| Ime parametra | Tip | Enota | Opis |
|---|---|---|---|
| maxPower | int | W | Največja moč krmiljenega bremena, mora biti manjša od 3700 |
| setPower | int | W | Izhodna moč naprave WPC |
| restorePower | int | W | Moč po izhodu iz samodejnega načina krmiljenja |
| setPowerMode | int | Izbira načina delovanja: 0: Ročno, 1: Samodejno | |
| threshold | int | W | V samodejnem načinu je to prag za prilagajanje glede na moč omrežja |
| hysteresis | int | W | V samodejnem načinu je to histereza za prilagajanje glede na moč omrežja |
| startHour | int | ura | Začetni čas samodejnega načina |
| stopHour | int | ura | Končni čas samodejnega načina |
| tzOffset | int | Odmik časovnega pasu | |
| meterType | int | Izbira znamke števca za merjenje omrežja v samodejnem načinu: 0:iMeter, 1:virtualTCP | |
| meterConfig | string | Izbira modela števca za merjenje omrežja v samodejnem načinu: 3:trifazno, 2:uporaba faze B, 1:razmerje | |
| ntpServer | string | Naslov NTP strežnika | |
| haDiscovery | int | Omogoči samodejno odkrivanje MQTT v Home Assistantu: 0: onemogoči, 1: omogoči | |
| mqttEnabled | int | Omogoči MQTT: 0: onemogoči, 1: omogoči | |
| meterAddress | string | Naslov MQTT posrednika, potreben pri integraciji s Home Assistantom: 192.168.1.22:1833 | |
| mqttUsername | string | MQTT uporabniško ime | |
| mqttPassword | string | MQTT geslo | |
| uploadInterval | int | s | Čas intervala nalaganja |
/api/getadv
Uvod
Ta API prebere vse parametre naprave WPC (vsi parametri iz API-ja setadv se lahko preberejo tukaj).
URL in metoda
- URL:
http://{{Lokalni IP naprave WPC}}/api/getadv - Metoda: HTTP GET
Odziv
{
"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
}
Glejte opis parametrov v setadv.
/api/setwifiadv
Uvod
Ta API konfigurira parametre Wi-Fi za naprave WPC/WEM.
URL in metoda
- URL:
http://{{Lokalni IP naprave WPC}}/api/setwifiadv - Metoda: HTTP POST
Parametri zahteve
{
"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" // Uporabno le, če runMode ni cloud
}
Odziv
{
"successful": true,
"message": "ok"
}
Opis parametrov
| Ime parametra | Tip | Enota | Opis |
|---|---|---|---|
| ssid | string | Ime Wi-Fi dostopne točke za WLAN povezavo | |
| pwd | string | Wi-Fi geslo za WLAN povezavo | |
| ip | string | Statični IP; ni potreben, če uporabljate način DHCP | |
| netmask | string | Mrežna maska; ni potrebna, če uporabljate način DHCP | |
| gw | string | Prehod; ni potreben, če uporabljate način DHCP | |
| dns | string | DNS strežnik; ni potreben, če uporabljate način DHCP | |
| dhcp | bool | false: onemogoči DHCP, true: omogoči DHCP |
Referenčna dokumentacija
"Skrite" funkcije v vdelani programski opremi Wi-Fi števca energije
Dobrodošli, da nam na našem forumu sporočite svoje mnenje. https://imeter.club
O podjetju IAMMETER
IAMMETER je podjetje, osredotočeno na izdelke in storitve za upravljanje energije, ki ponuja pametne števce energije, aplikacije za upravljanje in oblačne platforme.
Naš cilj je strankam pomagati pri učinkovitem upravljanju, izkoriščanju in varčevanju z energijo ter zmanjševanju računov za elektriko s pametnim spremljanjem in analizo.
Rešitve
Izdelki
- Pregled števcev energije IAMMETER
- WEM3080T – Trifazni/dvorazdeljeni Wi-Fi števec energije
- WEM3080 – Enofazni Wi-Fi števec energije
- WEM3050T – Trifazni števec energije
- WEM3046T – Trifazni Wi-Fi števec energije s standardnim vhodom tokovnega transformatorja 5A