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 discovery в 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 | Вт | Да | int | Указывает выходную мощность WPC. Это тот же параметр, что и setPower в setadv. |
/api/setadv
Введение
Этот API используется для настройки параметров WPC.
Примечание: Все параметры можно напрямую настроить через UI. Лишь небольшое количество клиентов, которым необходимо интегрировать продукты серии 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",
"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 | Вт | Максимальная мощность управляемой нагрузки, должна быть менее 3700 |
| setPower | int | Вт | Выходная мощность WPC |
| restorePower | int | Вт | Мощность после выхода из режима автоматического управления |
| setPowerMode | int | Выбор режима работы: 0: Ручной, 1: Автоматический | |
| threshold | int | Вт | В автоматическом режиме это порог для регулировки на основе мощности сети |
| hysteresis | int | Вт | В автоматическом режиме это гистерезис для регулировки на основе мощности сети |
| startHour | int | час | Время начала автоматического режима |
| stopHour | int | час | Время окончания автоматического режима |
| tzOffset | int | Смещение часового пояса | |
| meterType | int | Выбор бренда счетчика для измерения сети в автоматическом режиме: 0:iMeter, 1:virtualTCP | |
| meterConfig | string | Выбор модели счетчика для измерения сети в автоматическом режиме: 3:трехфазный, 2:использовать фазу B, 1:коэффициент | |
| ntpServer | string | Адрес NTP-сервера | |
| haDiscovery | int | Включить автоматическое обнаружение Home Assistant MQTT: 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 | с | Интервал времени загрузки |
/api/getadv
Введение
Этот API считывает все параметры WPC (все параметры из API setadv могут быть считаны здесь).
URL и метод
- URL:
http://{{Локальный IP 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://{{Локальный IP 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" // Полезно только если runMode не cloud
}
Ответ
{
"successful": true,
"message": "ok"
}
Описание параметров
| Имя параметра | Тип | Единица | Описание |
|---|---|---|---|
| ssid | string | Имя точки доступа Wi-Fi для подключения к 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 счетчик энергии с входом стандартных CT 5A