Valitettavasti selaimesi ei tue JavaScriptiä!
Kirjaudu sisään

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:

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

IAMMETERin lisä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

Järjestelmä

Ylös