APIs kontrolerów mocy serii WPC

Skróty nazw WPC: Wi-Fi power controller (kontroler mocy Wi-Fi)

API kontrolerów mocy serii WPC

W tym artykule przedstawiono głównie API udostępniane przez kontrolery mocy serii WPC. Za pomocą tych API użytkownicy mogą wykonywać następujące operacje:

• Konfiguracja parametrów WPC
• Sterowanie mocą wyjściową WPC

Kto powinien przeczytać ten artykuł

Ta sekcja znajduje się na początku, ponieważ mimo że napisaliśmy ten artykuł, w rzeczywistości nie jest on istotny dla większości użytkowników WPC.

Jeśli posiadasz kontroler mocy serii WPC, istnieje kilka możliwych trybów działania:

1. Masz już zainstalowane liczniki IAMMETER po stronie sieci i bezpośrednio używasz WPC3700 w połączeniu z licznikami IAMMETER (WPC3700 działa w trybie automatycznym), umożliwiając ciągłą pracę WPC3700 napędzanego nadwyżką energii słonecznej — jest to rozwiązanie IAMMETER PV Heater Control System.
2. Nie posiadasz licznika IAMMETER, ale znasz Home Assistant lub Node-RED i zintegrowałeś WPC3700 z systemem automatyki HA lub Node-RED (Włącz wykrywanie MQTT w Home Assistant z najnowszym oprogramowaniem IAMMETER (i.76.058.8)).
3. Potrzebujesz wywołać API, aby zintegrować WPC3700 z własnym systemem.

Tylko użytkownicy, którzy wymagają trzeciego trybu działania, powinni przeczytać ten artykuł.

/api/setpower

/api/setpower?x=100

Wprowadzenie

To API steruje mocą wyjściową WPC.

Uwaga: Ten parametr można również modyfikować za pomocą API setadv (wywołanie HTTP POST, parametr setPower).

Ponieważ parametr setPower może wymagać częstych modyfikacji na podstawie odczytów mocy sieci w czasie rzeczywistym, udostępniono dodatkowy interfejs API HTTP GET.

URL i metoda

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

Metoda: HTTP GET

/api/setadv

Wprowadzenie

To API służy do ustawiania parametrów WPC.

Uwaga: Wszystkie parametry można ustawić bezpośrednio przez UI. Tylko niewielka liczba klientów, którzy muszą zintegrować produkty serii WPC z własnymi systemami, będzie korzystać z tego API.

URL i metoda

• URL: http://{{Localny IP WPC}}/api/setadv
• Metoda: HTTP POST

Parametry żądania

Poniżej znajduje się przykład parametrów setadv.

Uwaga: Podczas wykonywania setadv nie wszystkie parametry muszą być przesłane. Należy przesłać tylko te parametry, które wymagają modyfikacji. Parametry, które nie wymagają modyfikacji, nie muszą być przesyłane. Możesz najpierw użyć getadv, aby odczytać bieżącą konfigurację, a następnie przesłać tylko parametry wymagające modyfikacji.

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

Odpowiedź

{
  "successful": 1,
  "message": "ok"
}

Opis parametrów

/api/getadv

Wprowadzenie

To API odczytuje wszystkie parametry WPC (wszystkie parametry z API setadv można tutaj odczytać).

URL i metoda

• URL: http://{{Localny IP WPC}}/api/getadv
• Metoda: HTTP GET

Odpowiedź

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

Zapoznaj się z opisem parametrów w setadv.

/api/setwifiadv

Wprowadzenie

To API konfiguruje parametry Wi-Fi dla urządzeń WPC/WEM.

URL i metoda

• URL: http://{{Localny IP WPC}}/api/setwifiadv
• Metoda: HTTP POST

Parametry żądania

{
    "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" // Przydatne tylko jeśli runMode nie jest cloud
}

Odpowiedź

{
    "successful": true,
    "message": "ok"
}

Opis parametrów

Dokumentacja referencyjna

„Ukryte" funkcje w oprogramowaniu licznika energii Wi-Fi

Zaawansowane funkcje IAMMETER

Zapraszamy do podzielenia się swoimi przemyśleniami na naszym forum. https://imeter.club

O IAMMETER

IAMMETER to firma skoncentrowana na produktach i usługach z zakresu zarządzania energią, oferująca inteligentne liczniki energii, aplikacje do zarządzania i platformy chmurowe.

Naszym celem jest pomaganie klientom w efektywnym zarządzaniu, wykorzystywaniu i oszczędzaniu energii, zmniejszaniu rachunków za prąd poprzez inteligentne monitorowanie i analizę.

Rozwiązania

• Szybki przewodnik po rozwiązaniach IAMMETER
• Integracja IAMMETER z innymi systemami

Produkty

• Przegląd liczników energii IAMMETER
• WEM3080T – Trójfazowy/Rozdzielnofazowy licznik energii Wi-Fi
• WEM3080 – Jednofazowy licznik energii Wi-Fi
• WEM3050T – Trójfazowy licznik energii
• WEM3046T – Trójfazowy licznik energii Wi-Fi z wejściem CT 5A

System

• Self-Hosting Service