Beklager, nettleseren din støtter ikke JavaScript!
Logg inn

API-er for WPC3700

Forkortelser WPC: Wi-Fi effektkontroller

API for WPC-seriens effektkontrollere

Denne artikkelen introduserer hovedsakelig API-ene som tilbys av WPC-seriens effektkontrollere. Gjennom disse API-ene kan brukere utføre følgende operasjoner:

  • Konfigurere WPC-parametere
  • Styring av WPCs utgangseffekt

Hvem bør lese denne artikkelen

Denne delen er plassert i begynnelsen fordi selv om vi skrev denne artikkelen, er den faktisk ikke relevant for de fleste WPC-brukere.

Hvis du har anskaffet en effektkontroller i WPC-serien, finnes det noen mulige bruksmåter:

  1. Du har allerede installert IAMMETER-målere på nettsiden og bruker WPC3700 direkte sammen med IAMMETER-målere (WPC3700 kjører i automatisk modus), slik at WPC3700 kan arbeide kontinuerlig drevet av solenergioverskudd – dette er IAMMETER-løsningen PV-varmeovnstyringssystem.
  2. Du har ikke en IAMMETER-måler, men du er kjent med Home Assistant eller Node-RED og har integrert WPC3700 i HA- eller Node-RED-automasjonssystemet (Aktiver MQTT-discovery i Home Assistant med den nyeste IAMMETER-fastvaren (i.76.058.8)).
  3. Du må kalle på API-et for å integrere WPC3700 i ditt eget system.

Bare brukere som trenger den tredje bruksmåten, bør lese denne artikkelen.


/api/setpower

/api/setpower?x=100

Introduksjon

Dette API-et styrer utgangseffekten til WPC.

Merk: Denne parameteren kan også endres gjennom setadv-API-et (HTTP POST-kall, parameteren setPower).

Siden parameteren setPower kan måtte endres ofte basert på sanntidsmålinger av netteffekten, tilbys dette ekstra HTTP GET-API-et.

URL og metode

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

Metode: HTTP GET

Parameternavn Eksempelverdi Enhet Påkrevd Type Beskrivelse
x 100 W Ja int Angir utgangseffekten til WPC. Dette er samme parameter som setPower i setadv.

/api/setadv

Introduksjon

Dette API-et brukes til å angi parametrene til WPC.

Merk: Alle parametere kan angis direkte gjennom UI-et. Bare et lite antall kunder som trenger å integrere WPC-seriens produkter i egne systemer, vil bruke dette API-et.

URL og metode

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

Forespørselsparametere

Nedenfor er et eksempel på setadv-parametere.

Merk: Når setadv kjøres, er det ikke nødvendig å sende inn alle parametere. Bare parametrene som skal endres, bør sendes inn. Parametere som ikke trenger endring, trenger ikke sendes inn. Du kan først bruke getadv til å lese gjeldende konfigurasjon, og deretter bare sende inn parametrene som skal endres.

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

Parameterbeskrivelse

Parameternavn Type Enhet Beskrivelse
maxPower int W Maksimal effekt for den styrte lasten, må være mindre enn 3700
setPower int W Utgangseffekten til WPC
restorePower int W Effekt etter å ha avsluttet automatisk modus-styring
setPowerMode int Valg av driftsmodus: 0: Manuell, 1: Auto
threshold int W I automatisk modus er dette terskelen for justering basert på netteffekt
hysteresis int W I automatisk modus er dette hysteresen for justering basert på netteffekt
startHour int hour Starttidspunkt for automatisk modus
stopHour int hour Sluttidspunkt for automatisk modus
tzOffset int Tidssoneavvik
meterType int Valg av måler-merke for nettmåling i automatisk modus: 0:iMeter, 1:virtualTCP
meterConfig string Valg av måler-modell for nettmåling i automatisk modus: 3:tre-fase, 2:bruk faseB, 1:forhold
ntpServer string NTP-serveradresse
haDiscovery int Aktiver Home Assistant MQTT auto-discovery: 0: deaktiver, 1: aktiver
mqttEnabled int Aktiver MQTT: 0: deaktiver, 1: aktiver
meterAddress string MQTT-brokeradresse, nødvendig ved integrering med Home Assistant: 192.168.1.22:1833
mqttUsername string MQTT-brukernavn
mqttPassword string MQTT-passord
uploadInterval int s Opplastingsintervall (tid)

/api/getadv

Introduksjon

Dette API-et leser alle parametrene til WPC (alle parametere fra setadv-API-et kan leses her).

URL og metode

  • URL: http://{{Local IP of the WPC}}/api/getadv
  • Metode: 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 parameterbeskrivelsen i setadv.


/api/setwifiadv

Introduksjon

Dette API-et konfigurerer Wi-Fi-parametrene for WPC/WEM-enheter.

URL og metode

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

Forespørselsparametere

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

Parameterbeskrivelse

Parameternavn Type Enhet Beskrivelse
ssid string Wi-Fi-tilgangspunktets navn for WLAN-tilkoblingen
pwd string Wi-Fi-passord for WLAN-tilkoblingen
ip string Statisk IP; ikke nødvendig hvis DHCP-modus brukes
netmask string Nettmaske; ikke nødvendig hvis DHCP-modus brukes
gw string Gateway; ikke nødvendig hvis DHCP-modus brukes
dns string DNS-server; ikke nødvendig hvis DHCP-modus brukes
dhcp bool false: deaktiver DHCP, true: aktiver DHCP

Referansedokumentasjon

De "skjulte" funksjonene i fastvaren til Wi-Fi-energimåleren

Avanserte funksjoner i IAMMETER

Vi setter pris på at du deler dine tanker på forumet vårt. https://imeter.club

Om IAMMETER

IAMMETER er et selskap som fokuserer på produkter og tjenester for energistyring, og tilbyr smarte energimålere, administrasjonsapper og skyplattformer.

Vårt mål er å hjelpe kunder med å administrere, utnytte og spare energi effektivt, og redusere strømregningen gjennom smart overvåking og analyse.

Løsninger

Produkter

System

Topp