API на WPC3700
Съкращения WPC: Wi-Fi контролер на мощност
API на контролерите на мощност от серия WPC
Тази статия представя главно API интерфейсите, предоставени от контролерите на мощност от серия WPC. Чрез тези API потребителите могат да извършват следните операции:
- Конфигуриране на параметрите на WPC
- Управление на изходната мощност на WPC
Кой трябва да прочете тази статия
Този раздел е поставен в началото, защото, макар да сме написали тази статия, тя всъщност не е от значение за повечето потребители на WPC.
Ако сте се сдобили с контролер на мощност от серия WPC, има няколко възможни режима на работа:
- Вече сте инсталирали измервателни уреди IAMMETER от страната на мрежата и използвате директно WPC3700 заедно с измервателни уреди IAMMETER (WPC3700 работи в автоматичен режим), което позволява на WPC3700 да работи непрекъснато под действието на излишната слънчева енергия — това е решението на IAMMETER Система за управление на PV нагревател.
- Нямате измервателен уред IAMMETER, но сте запознати с Home Assistant или Node-RED и сте интегрирали WPC3700 в автоматизационната система на HA или Node-RED (Активиране на MQTT откриване в Home Assistant с най-новия фърмуер на IAMMETER (i.76.058.8)).
- Трябва да извикате 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 електромера
Ще се радваме да споделите мнението си във нашия форум. https://imeter.club
За IAMMETER
IAMMETER е компания, фокусирана върху продукти и услуги за управление на енергията, предлагаща интелигентни електромери, приложения за управление и облачни платформи.
Нашата цел е да помогнем на клиентите да управляват, използват и пестят енергия ефективно, намалявайки сметките за електроенергия чрез интелигентно наблюдение и анализ.
Решения
Продукти
- Преглед на електромерите IAMMETER
- WEM3080T – Трифазен/разделен фазов Wi-Fi електромер
- WEM3080 – Еднофазен Wi-Fi електромер
- WEM3050T – Трифазен електромер
- WEM3046T – Трифазен Wi-Fi електромер с 5A стандартен CT вход