Прошивка IAMMETER Локальные API
IAMMETER поддерживает локальные API-интерфейсы HTTP. См. официальную документацию о возможностях реального устройства. Этот симулятор реализует только подмножество, указанное ниже.
Пути и сеансы
Присвойте каждой конечной точке счетчика префикс /WEM3080, /WEM2067 или /WEM3050T. Страницы устройств и API поддерживают HTTP на порту 80, а также HTTPS на порту 443. Физические устройства обычно используют локальный HTTP.
Запросы общедоступных измерений работают без сеанса и возвращают источник Inverter and grid по умолчанию. Для частных настроек требуется существующий файл cookie страницы счетчика. Отдельный запрос на завивку не наследует выбранный источник или настройки вашего браузера.
HTTP и HTTPS используют отдельные сеансы браузера. Перед изменением настроек откройте страницу счетчика по той же схеме. Анонимное чтение использует источник Inverter and grid по умолчанию.
Поддерживаемое подмножество API прошивки
| Метод | Конечная точка | Цель | Поддерживаемые модели |
|---|---|---|---|
| GET | /api/monitor | Чтение напряжения, тока, мощности и энергии. | Все модели |
| GET | /api/monitorjson · /monitorjson | Чтение устаревшего JSON с дополнительными реактивными данными. | Все модели |
| GET | /api/wifidata | Чтение виртуального Wi-Fi и настроек устройства. | Все модели |
| POST | /api/setwifiadv | Сохраните настройки виртуального Wi-Fi для этого сеанса и модели. | Все модели |
| GET | /api/getadv | Прочитайте дополнительные и загрузите настройки; пароль пуст. | Все модели |
| POST | /api/setadv | Сохраните настройки загрузки, флаги Reactive и NEM. | Все модели; NEM только на WEM3050T |
Ответы на измерения
WEM3080 возвращает Data; WEM2067 и WEM3050T возвращают Datas с одной строкой на канал. Порядок полей показан ниже. Примеры иллюстративны, а не живые ответы.
| Индекс | Измерение | Единица |
|---|---|---|
| 0 | Напряжение | V |
| 1 | Ток | A |
| 2 | Активная мощность | W |
| 3 | Импортированная энергия | kWh |
| 4 | Экспортированная энергия | kWh |
| 5 | Частота | Hz |
| 6 | Коэффициент мощности | — |
Читать общедоступные измерения
curl 'https://simulator.iammeter.com/WEM3050T/api/monitor'Форма ответа
{
"ssid": "IAMMETER-Simulator",
"sig": 100,
"mac": "020000003050",
"version": "simulator-1.0",
"server": "em",
"SN": "1AD9B537",
"model": "WEM3050T",
"Datas": [
[230.0,1.252,270.0,2.092,0.000,50.00,0.94],
[229.5,0.487,110.0,1.280,0.000,50.00,0.98],
[229.0,0.399,90.0,0.747,0.000,50.00,0.98]
]
}Настройки виртуального Wi-Fi
setwifiadv принимает ssid, pwd, dhcp (логическое значение), ip, сетевую маску, gw и DNS. Эти значения изменяют только виртуальное устройство; они не перенастраивают сетевой адаптер.
Пример тела запроса
{"ssid":"Test network","dhcp":true}Успешное сохранение
{"successful":1,"message":"ok"}Расширенные настройки
setadv принимает частичные обновления JSON. Неуказанные поля сохраняют свои текущие значения. Интервал загрузки 10–3600 секунд.
Reactive добавляет EA.Reactive к monitorjson и загружает, а не api/monitor. Каждая строка равна [вар, индуктивная квар, емкостная квар].
NEM поддерживается только WEM3050T. Четвертая строка Datas суммирует активную мощность, отдельно импортирует и экспортирует кВтч; все остальные поля равны нулю.
| Параметр | Принятые значения |
|---|---|
| runMode | 1 = TCP/TLS; 2 = HTTP/HTTPS; 3 = MQTT/MQTTS; 4 = stand alone |
| uploadAddress | адрес получателя; следуйте подсказке по вводу Settings. |
| mqttUsername · mqttPassword | учетные данные брокера; getadv никогда не возвращает сохраненный пароль. |
| uploadInterval | 10–3600 с |
| reactive | 0 / 1 |
| netmetering | 0 / 1 |
| ntpServer | Только сохраненный текст; не меняет время сервера. |
| haDiscovery · ctcRatio | Только 0 и 1 соответственно; функции не реализованы. |
Включите Reactive и NEM на WEM3050T.
{"reactive":1,"netmetering":1}Проверка результатов
Успешное сохранение возвращает successful=1. Неверные значения настроек могут возвращать HTTP 200 с successful=0; проверьте JSON, а также код состояния. Отсутствующие сеансы возвращают 401; Запись между источниками отклоняется.
Сохранение настроек загрузки не является подтверждением доставки. Проверьте статус загрузки отладки и подтвердите сообщения на своем приемнике.
Не реализовано
Приведенные ниже функции предназначены только для отображения или не поддерживаются. Они не предоставляют рабочие API записи.
| Функция | Текущее поведение |
|---|---|
| Сканирование Wi-Fi · перезагрузка · сброс настроек к заводским настройкам | Никакой реальной операции. |
| Безопасность устройства · обновление прошивки | Только отображение. |
| Облако IAMMETER · HA Discovery · Нисходящий канал MQTT | Никакой загрузки в облако, обнаружения или удаленной настройки. |
Инструменты симулятора документированы отдельно.
Конечные точки отладки симулятора не являются API-интерфейсами прошивки IAMMETER. Они исключены из приведенного выше списка API прошивки.