Съжаляваме, вашият браузър не поддържа JavaScript!
Вход

API на WPC3700

Съкращения WPC: Wi-Fi контролер на мощност

API на контролерите на мощност от серия WPC

Тази статия представя главно API интерфейсите, предоставени от контролерите на мощност от серия WPC. Чрез тези API потребителите могат да извършват следните операции:

  • Конфигуриране на параметрите на WPC
  • Управление на изходната мощност на WPC

Кой трябва да прочете тази статия

Този раздел е поставен в началото, защото, макар да сме написали тази статия, тя всъщност не е от значение за повечето потребители на WPC.

Ако сте се сдобили с контролер на мощност от серия WPC, има няколко възможни режима на работа:

  1. Вече сте инсталирали измервателни уреди IAMMETER от страната на мрежата и използвате директно WPC3700 заедно с измервателни уреди IAMMETER (WPC3700 работи в автоматичен режим), което позволява на WPC3700 да работи непрекъснато под действието на излишната слънчева енергия — това е решението на IAMMETER Система за управление на PV нагревател.
  2. Нямате измервателен уред IAMMETER, но сте запознати с Home Assistant или Node-RED и сте интегрирали WPC3700 в автоматизационната система на HA или Node-RED (Активиране на MQTT откриване в Home Assistant с най-новия фърмуер на IAMMETER (i.76.058.8)).
  3. Трябва да извикате API, за да интегрирате WPC3700 във вашата собствена система.

Само потребителите, които се нуждаят от третия режим на работа, трябва да прочетат тази статия.


/api/setpower

/api/setpower?x=100

Въведение

Този API управлява изходната мощност на WPC.

Забележка: Този параметър може да бъде променен и чрез API setadv (HTTP POST заявка, параметър setPower).

Тъй като параметърът setPower може да се налага да бъде променян често въз основа на показанията на мощността в мрежата в реално време, е предоставен този допълнителен API интерфейс с HTTP GET.

URL и метод

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

Метод: HTTP GET

Име на параметъра Примерна стойност Единица Задължителен Тип Описание
x 100 W Да int Представлява изходната мощност на WPC. Това е същият параметър като setPower в setadv.

/api/setadv

Въведение

Този API се използва за задаване на параметрите на WPC.

Забележка: Всички параметри могат да бъдат зададени директно чрез потребителския интерфейс. Само малък брой клиенти, които трябва да интегрират продуктите от серия WPC в собствените си системи, ще използват този API.

URL и метод

  • URL: http://{{Local IP of the WPC}}/api/setadv
  • Метод: HTTP POST

Параметри на заявката

По-долу е даден пример с параметрите на setadv.

Забележка: При изпълнение на setadv не е необходимо да се подават всички параметри. Трябва да се подадат само параметрите, които трябва да бъдат променени. Параметрите, които не е необходимо да се променят, не е нужно да се подават. Можете първо да използвате getadv, за да прочетете текущата конфигурация, и след това да подадете само параметрите, които трябва да бъдат променени.

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

Отговор

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

Описание на параметрите

Име на параметъра Тип Единица Описание
maxPower int W Максималната мощност на управлявания товар, трябва да бъде по-малка от 3700
setPower int W Изходната мощност на WPC
restorePower int W Мощност след излизане от управлението в автоматичен режим
setPowerMode int Избор на режим на работа: 0: Ръчен, 1: Автоматичен
threshold int W В автоматичен режим това е прагът за регулиране въз основа на мощността в мрежата
hysteresis int W В автоматичен режим това е хистерезисът за регулиране въз основа на мощността в мрежата
startHour int hour Начален час на автоматичния режим
stopHour int hour Краен час на автоматичния режим
tzOffset int Отместване на часовата зона
meterType int Избор на марка измервателен уред за измерване в мрежата в автоматичен режим: 0:iMeter, 1:virtualTCP
meterConfig string Избор на модел измервателен уред за измерване в мрежата в автоматичен режим: 3:трифазен, 2:използване на фаза B, 1:съотношение
ntpServer string Адрес на NTP сървъра
haDiscovery int Активиране на автоматично MQTT откриване в Home Assistant: 0: изключено, 1: включено
mqttEnabled int Активиране на MQTT: 0: изключено, 1: включено
meterAddress string Адрес на MQTT брокера, необходим при интеграция с Home Assistant: 192.168.1.22:1833
mqttUsername string Потребителско име за MQTT
mqttPassword string Парола за MQTT
uploadInterval int s Интервал на качване

/api/getadv

Въведение

Този API прочита всички параметри на WPC (всички параметри от API setadv могат да бъдат прочетени тук).

URL и метод

  • URL: http://{{Local IP of the WPC}}/api/getadv
  • Метод: HTTP GET

Отговор

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

Направете справка с описанието на параметрите в setadv.


/api/setwifiadv

Въведение

Този API конфигурира Wi-Fi параметрите за устройства WPC/WEM.

URL и метод

  • URL: http://{{Local IP of the WPC}}/api/setwifiadv
  • Метод: HTTP POST

Параметри на заявката

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

Отговор

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

Описание на параметрите

Име на параметъра Тип Единица Описание
ssid string Име на Wi-Fi AP за WLAN връзката
pwd string Парола за Wi-Fi за WLAN връзката
ip string Статичен IP адрес; не е необходим при използване на DHCP режим
netmask string Мрежова маска; не е необходима при използване на DHCP режим
gw string Шлюз; не е необходим при използване на DHCP режим
dns string DNS сървър; не е необходим при използване на DHCP режим
dhcp bool false: изключване на DHCP, true: включване на DHCP

Референтна документация

„Скритите“ функции във фърмуера на Wi-Fi електромера

Разширена функция на IAMMETER

Ще се радваме да споделите мнението си във нашия форум. https://imeter.club

За IAMMETER

IAMMETER е компания, фокусирана върху продукти и услуги за управление на енергията, предлагаща интелигентни електромери, приложения за управление и облачни платформи.

Нашата цел е да помогнем на клиентите да управляват, използват и пестят енергия ефективно, намалявайки сметките за електроенергия чрез интелигентно наблюдение и анализ.

Решения

Продукти

Система

Нагоре