API'er til WPC3700

Forkortelse WPC: Wi-Fi-effektcontroller

API for WPC-seriens effektcontroller

Denne artikel introducerer hovedsageligt de API'er, som WPC-seriens effektcontrollere tilbyder. Gennem disse API'er kan brugerne udføre følgende handlinger:

• Konfigurere WPC-parametre
• Styre WPC'ens udgangseffekt

Hvem bør læse denne artikel

Dette afsnit er placeret i starten, fordi artiklen – selvom vi har skrevet den – faktisk ikke er relevant for de fleste WPC-brugere.

Hvis du har fået en effektcontroller fra WPC-serien, er der et par mulige driftstilstande:

1. Du har allerede installeret IAMMETER-målere på netsiden og bruger direkte WPC3700 sammen med IAMMETER-målere (WPC3700 kører i auto-tilstand), så WPC3700 kan arbejde kontinuerligt drevet af solcelleoverskud – det er IAMMETER-løsningen PV Heater Control System.
2. Du har ikke en IAMMETER-måler, men du kender Home Assistant eller Node-RED og har integreret WPC3700 i HA- eller Node-RED-automatiseringssystemet (Aktivér MQTT-discovery i Home Assistant med den nyeste IAMMETER-firmware (i.76.058.8)).
3. Du skal kalde API'et for at integrere WPC3700 i dit eget system.

Kun brugere, der har brug for den tredje driftstilstand, bør læse denne artikel.

/api/setpower

/api/setpower?x=100

Introduktion

Dette API styrer WPC'ens udgangseffekt.

Bemærk: Denne parameter kan også ændres via setadv-API'et (HTTP POST-kald, parameteren setPower).

Da setPower-parameteren muligvis skal ændres hyppigt baseret på realtidsaflæsninger af neteffekten, tilbydes denne ekstra HTTP GET-API-grænseflade.

URL og metode

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

Metode: HTTP GET

/api/setadv

Introduktion

Dette API bruges til at indstille parametrene for WPC'en.

Bemærk: Alle parametre kan indstilles direkte via UI. Kun et lille antal kunder, der har brug for at integrere produkter fra WPC-serien i deres egne systemer, vil bruge dette API.

URL og metode

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

Anmodningsparametre

Nedenfor er et eksempel på setadv-parametre.

Bemærk: Når setadv udføres, behøver ikke alle parametre at blive sendt. Kun de parametre, der skal ændres, skal sendes. Parametre, der ikke skal ændres, behøver ikke at blive sendt. Du kan først bruge getadv til at læse den aktuelle konfiguration og derefter kun sende de parametre, der skal ændres.

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

/api/getadv

Introduktion

Dette API læser alle parametre for WPC'en (alle parametre fra setadv-API'et kan læses 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 beskrivelsen af parametrene i setadv.

/api/setwifiadv

Introduktion

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

URL og metode

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

Anmodningsparametre

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

Referencedokumentation

De "skjulte" funktioner i firmwaren i Wi-Fi-energimåleren

Avancerede funktioner i IAMMETER

Du er velkommen til at dele dine tanker med os på vores forum. https://imeter.club

Om IAMMETER

IAMMETER er en virksomhed, der fokuserer på produkter og tjenester til energistyring og tilbyder smarte energimålere, styringsapps og cloud-platforme.

Vores mål er at hjælpe kunder med effektivt at styre, udnytte og spare energi og dermed reducere elregninger gennem intelligent overvågning og analyse.

Løsninger

• Hurtig guide til IAMMETERs løsninger
• Integrér IAMMETER med andre systemer

Produkter

• Oversigt over IAMMETER-energimålere
• WEM3080T – Trefaset/split-fase Wi-Fi-energimåler
• WEM3080 – Enfaset Wi-Fi-energimåler
• WEM3050T – Trefaset energimåler
• WEM3046T – Trefaset Wi-Fi-energimåler med 5A standard CT-indgang

System

• Self-Hosting Service