WPC3700:n API-rajapinnat
Lyhenne WPC: Wi-Fi-tehonsäädin
WPC-sarjan tehonsäätimen API
Tämä artikkeli esittelee pääasiassa WPC-sarjan tehonsäätimien tarjoamat API-rajapinnat. Näiden rajapintojen avulla käyttäjät voivat suorittaa seuraavia toimintoja:
- WPC-parametrien määrittäminen
- WPC:n lähtötehon ohjaus
Kenelle tämä artikkeli on tarkoitettu
Tämä osio on sijoitettu alkuun, koska vaikka kirjoitimme tämän artikkelin, se ei itse asiassa koske useimpia WPC-käyttäjiä.
Jos sinulla on WPC-sarjan tehonsäädin, käytössä on muutama mahdollinen toimintatapa:
- Sinulla on jo IAMMETER-mittareita asennettuna verkon puolelle ja käytät WPC3700 -laitetta yhdessä IAMMETER-mittareiden kanssa (WPC3700 toimii automaattitilassa), jolloin WPC3700 voi toimia jatkuvasti aurinkosähkön ylijäämän ohjaamana. Tämä on IAMMETERin ratkaisu PV-lämmittimen ohjausjärjestelmä.
- Sinulla ei ole IAMMETER-mittaria, mutta tunnet Home Assistantin tai Node-RED:n ja olet integroinut WPC3700:n HA- tai Node-RED-automaatiojärjestelmään (MQTT-discoveryn käyttöönotto Home Assistantissa uusimmalla IAMMETER-laiteohjelmistolla (i.76.058.8)).
- Sinun on kutsuttava API-rajapintaa integroidaksesi WPC3700:n omaan järjestelmääsi.
Vain käyttäjien, jotka tarvitsevat kolmatta toimintatapaa, tulisi lukea tämä artikkeli.
/api/setpower
/api/setpower?x=100
Johdanto
Tämä API-rajapinta ohjaa WPC:n lähtötehoa.
Huomautus: Tämä parametri voidaan muuttaa myös setadv-rajapinnan kautta (HTTP POST -kutsu, setPower-parametri).
Koska setPower-parametriä saatetaan joutua muuttamaan usein reaaliaikaisten verkkotehon lukemien perusteella, tämä ylimääräinen HTTP GET -rajapinta on tarjottu.
URL-osoite ja menetelmä
URL: http://{{IP}}/api/setpower
Menetelmä: HTTP GET
| Parametrin nimi | Esimerkkiarvo | Yksikkö | Pakollinen | Tyyppi | Kuvaus |
|---|---|---|---|---|---|
| x | 100 | W | Kyllä | int | Ilmaisee WPC:n lähtötehon. Tämä on sama parametri kuin setPower setadv-rajapinnassa. |
/api/setadv
Johdanto
Tätä API-rajapintaa käytetään WPC:n parametrien asettamiseen.
Huomautus: Kaikki parametrit voidaan asettaa suoraan käyttöliittymän kautta. Vain pieni määrä asiakkaita, joiden on integroitava WPC-sarjan tuotteita omiin järjestelmiinsä, käyttää tätä API-rajapintaa.
URL-osoite ja menetelmä
- URL:
http://{{Local IP of the WPC}}/api/setadv - Menetelmä: HTTP POST
Pyyntöparametrit
Alla on esimerkki setadv-parametreista.
Huomautus: Kun suoritat setadv-kutsun, kaikkia parametreja ei tarvitse lähettää. Vain muutettavat parametrit tulee lähettää. Parametreja, joita ei tarvitse muuttaa, ei tarvitse lähettää. Voit ensin lukea nykyisen määrityksen getadv-rajapinnalla ja lähettää sitten vain muutettavat parametrit.
{
"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
}
Vastaus
{
"successful": 1,
"message": "ok"
}
Parametrien kuvaus
| Parametrin nimi | Tyyppi | Yksikkö | Kuvaus |
|---|---|---|---|
| maxPower | int | W | Ohjattavan kuorman maksimiteho, jonka on oltava alle 3700 |
| setPower | int | W | WPC:n lähtöteho |
| restorePower | int | W | Teho automaattitilan ohjauksesta poistumisen jälkeen |
| setPowerMode | int | Käyttötilan valinta: 0: Manual, 1: Auto | |
| threshold | int | W | Automaattitilassa tämä on verkkotehon perusteella säätämisen kynnysarvo |
| hysteresis | int | W | Automaattitilassa tämä on verkkotehon perusteella säätämisen hystereesi |
| startHour | int | tunti | Automaattitilan alkamisaika |
| stopHour | int | tunti | Automaattitilan päättymisaika |
| tzOffset | int | Aikavyöhykkeen poikkeama | |
| meterType | int | Mittarimerkin valinta verkon mittaukseen automaattitilassa: 0:iMeter, 1:virtualTCP | |
| meterConfig | string | Mittarimallin valinta verkon mittaukseen automaattitilassa: 3:three phase, 2:use phaseB, 1:ratio | |
| ntpServer | string | NTP-palvelimen osoite | |
| haDiscovery | int | Ota käyttöön Home Assistant MQTT -automaattinen discovery: 0: disable, 1: enable | |
| mqttEnabled | int | Ota MQTT käyttöön: 0: disable, 1: enable | |
| meterAddress | string | MQTT-välityspalvelimen osoite, tarvitaan integroitaessa Home Assistantiin: 192.168.1.22:1833 | |
| mqttUsername | string | MQTT-käyttäjänimi | |
| mqttPassword | string | MQTT-salasana | |
| uploadInterval | int | s | Lähetysvälin aika |
/api/getadv
Johdanto
Tämä API-rajapinta lukee kaikki WPC:n parametrit (kaikki setadv-rajapinnan parametrit voidaan lukea täältä).
URL-osoite ja menetelmä
- URL:
http://{{Local IP of the WPC}}/api/getadv - Menetelmä: HTTP GET
Vastaus
{
"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
}
Katso parametrien kuvaukset setadv-rajapinnasta.
/api/setwifiadv
Johdanto
Tämä API-rajapinta määrittää Wi-Fi-parametrit WPC/WEM-laitteille.
URL-osoite ja menetelmä
- URL:
http://{{Local IP of the WPC}}/api/setwifiadv - Menetelmä: HTTP POST
Pyyntöparametrit
{
"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
}
Vastaus
{
"successful": true,
"message": "ok"
}
Parametrien kuvaus
| Parametrin nimi | Tyyppi | Yksikkö | Kuvaus |
|---|---|---|---|
| ssid | string | Wi-Fi-tukiaseman nimi WLAN-yhteyttä varten | |
| pwd | string | Wi-Fi-salasana WLAN-yhteyttä varten | |
| ip | string | Staattinen IP; ei pakollinen DHCP-tilassa | |
| netmask | string | Aliverkon peite; ei pakollinen DHCP-tilassa | |
| gw | string | Yhdyskäytävä; ei pakollinen DHCP-tilassa | |
| dns | string | DNS-palvelin; ei pakollinen DHCP-tilassa | |
| dhcp | bool | false: DHCP pois käytöstä, true: DHCP käytössä |
Viitedokumentaatio
Wi-Fi-energiamittarin laiteohjelmiston "piilotetut" ominaisuudet
Kerro mielipiteesi foorumillamme. https://imeter.club
Tietoja IAMMETERistä
IAMMETER on energiahallinnan tuotteisiin ja palveluihin keskittynyt yritys, joka tarjoaa älykkäitä energiamittareita, hallintasovelluksia ja pilvialustoja.
Tavoitteemme on auttaa asiakkaita hallitsemaan, hyödyntämään ja säästämään energiaa tehokkaasti, mikä vähentää sähkölaskuja älykkään seurannan ja analyysin avulla.
Ratkaisut
Tuotteet
- IAMMETER-energiamittarit yleisesti
- WEM3080T – Kolmivaiheinen/kaksivaiheinen Wi-Fi-energiamittari
- WEM3080 – Yksivaiheinen Wi-Fi-energiamittari
- WEM3050T – Kolmivaiheinen energiamittari
- WEM3046T – Kolmivaiheinen Wi-Fi-energiamittari 5A:n vakiovirtamuuntajatulolla