API на WPC3700
Съществително съкращение WPC: Wi-Fi захранващ контролер
API на WPC Series Power Controller
Тази статия представя главно API, предоставени отСерия WPC Контролери на мощността. Чрез тези API потребителите могат да извършват следните операции:
- Конфигуриране на WPC параметри
- Контролирайте WPC изходната мощност
Кой трябва да прочете тази статия
Този раздел е поставен в началото, защото въпреки че написахме тази статия, тя всъщност не е подходяща за повечето потребители на WPC.
Ако сте се сдобили с контролер за захранване от серия WPC, има няколко възможни режима на работа:
- Вече сте инсталирали измервателни уреди IAMMETER от страната на мрежата и използвате директноWPC3700във връзка сМетри IAMMETER(WPC3700 работи в автоматичен режим), което позволява на WPC3700 да работи непрекъснато под задвижването на слънчевия излишък, което е решението на IAMMETERСистема за управление на фотоволтаични нагреватели.
- Нямате измервателен уред 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.
Забележка: Този параметър може да се променя и чрезsetadvAPI (HTTP POST повикване,setPowerпараметър).
Тъй катоsetPowerпараметърът може да се наложи често да се модифицира въз основа на показанията на мощността на мрежата в реално време, този допълнителен HTTP GET API интерфейс е предоставен.
URL адрес и метод
URL:http://{{IP}}/api/setpower
Метод: HTTP GET
| Име на параметър | Примерна стойност | Мерна единица | Задължително | Тип | Описание |
|---|---|---|---|---|---|
| х | 100 | У | да | вътр | Представлява изходната мощност на WPC. Това е същият параметър катоsetPowerвsetadv. |
/api/setadv
Въведение
Този API се използва за задаване на параметрите на WPC.
Забележка: Всички параметри могат да бъдат директно зададени чрезпотребителски интерфейс. Само малък брой клиенти, които трябва да интегрират продукти от серията WPC в собствените си системи, ще използват този API.
URL адрес и метод
- URL:
http://{{Локален IP на WPC}}/api/setadv - Метод: HTTP POST
Параметри на заявката
По-долу е даден пример заsetadvпараметри.
Забележка: При изпълнениеsetadv, не е необходимо да се изпращат всички параметри. Трябва да бъдат изпратени само параметрите, които трябва да бъдат променени. Не е необходимо да се изпращат параметри, които не се нуждаят от промяна. Първо можете да използватеgetadvза да прочетете текущата конфигурация, след това изпратете само параметрите, които трябва да бъдат променени.
{
"maxPower": 3500,
"setPower": 0,
"restorePower": 0,
"setPowerMode": 0,
"meterAddress": "10.10.30.35",
"праг": 30,
"хистерезис": 50,
"начален час": 8,
"стопЧас": 18,
"tzOffset": 8,
"meterType": 0,
"meterConfig": "3,2,1",
"ntpServer": "ntp.aliyun.com",
"haDiscovery": 1,
"mqttEnabled": 1,
"mqttAddress": "10.10.30.89:1883",
"mqttUsername": "тест",
"mqttPassword": "123456",
"интервал за качване": 6
}
Отговор
{
"успешно": 1,
"съобщение": "добре"
}
Параметър Описание
| Име на параметър | Тип | Мерна единица | Описание |
|---|---|---|---|
| maxPower | вътр | У | Максималната мощност на контролирания товар трябва да бъде по-малка от 3700 |
| setPower | вътр | У | Изходната мощност на WPC |
| възстановяване на мощността | вътр | У | Захранване след излизане от управлението на автоматичния режим |
| setPowerMode | вътр | Избор на режим на работа: 0: Ръчен, 1: Автоматичен | |
| праг | вътр | У | В автоматичен режим това е прагът за регулиране въз основа на мощността на мрежата |
| хистерезис | вътр | У | В автоматичен режим това е хистерезисът за регулиране въз основа на мощността на мрежата |
| начален час | вътр | час | Начало на автоматичния режим |
| stopHour | вътр | час | Краен час на автоматичния режим |
| tzOffset | вътр | Отместване на часовата зона | |
| meterType | вътр | Избор на марка измервателен уред за измерване на мрежата в автоматичен режим: 0:iMeter, 1:virtualTCP | |
| meterConfig | низ | Избор на модел на измервателния уред за измерване на мрежата в автоматичен режим: 3: трифазен, 2: използване на фаза B, 1: съотношение | |
| ntpServer | низ | Адрес на NTP сървър | |
| haDiscovery | вътр | Активиране на автоматичното откриване на MQTT на Home Assistant: 0: деактивиране, 1: активиране | |
| mqttEnabled | вътр | Активиране на MQTT: 0: деактивиране, 1: активиране | |
| meterAddress | низ | Адрес на MQTT брокер, необходим при интегриране с Home Assistant: 192.168.1.22:1833 | |
| mqttПотребителско име | низ | MQTT потребителско име | |
| mqttПарола | низ | MQTT парола | |
| uploadInterval | вътр | s | Интервал на качване |
/api/getadv
Въведение
Този API чете всички параметри на WPC (всички параметри отsetadvAPI можете да прочетете тук).
URL адрес и метод
- URL:
http://{{Локален IP на WPC}}/api/getadv - Метод: HTTP GET
Отговор
{
"maxPower": 3500,
"setPower": 0,
"restorePower": 0,
"setPowerMode": 0,
"setPowerModeList": "Ръчно,Автоматично",
"meterAddress": "10.10.30.35",
"праг": 20,
"хистерезис": 30,
"начален час": 8,
"стопЧас": 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": "тест",
"mqttPassword": "123456",
"интервал за качване": 60
}
Вижте описанието на параметрите вsetadv.
/api/setwifiadv
Въведение
Този API конфигурира Wi-Fi параметрите за WPC/WEM устройства.
URL адрес и метод
- URL:
http://{{Локален IP на WPC}}/api/setwifiadv - Метод: HTTP POST
Параметри на заявката
{
"ssid":"xxxx",
"pwd":"xxxx",
"ip":"xxxx",
"мрежова маска":"xxxxx",
"gw":"xxxx",
"dns":"192.168.1.1",
"dhcp":вярно,
"runMode":"облак", // облак, tcp, http
"uploadAddress":"http://myserver.com/upload" // Полезно само ако runMode не е облак
}
Отговор
{
"успешно": вярно,
"съобщение": "добре"
}
Параметър Описание
| Име на параметър | Тип | Мерна единица | Описание |
|---|---|---|---|
| ssid | низ | Име на Wi-Fi AP за WLAN връзката | |
| pwd | низ | Wi-Fi парола за WLAN връзка | |
| ip | низ | Статично IP; не се изисква, ако използвате DHCP режим | |
| мрежова маска | низ | маска на мрежата; не се изисква, ако използвате DHCP режим | |
| gw | низ | Портал; не се изисква, ако използвате DHCP режим | |
| dns | низ | 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 вход