Счётчик энергии Wi-Fi IAMMETER: руководство по локальной интеграции и открытому интерфейсу
Счётчик энергии Wi-Fi IAMMETER: руководство по локальной интеграции и открытому интерфейсу
Для разработчиков и системных интеграторов, использующих счетчики IAMMETERбезIAMMETER-Cloud.
Счетчики электроэнергии IAMMETER с Wi-Fi предназначены как для облачной, так и для локальной интеграции, предоставляя открытые API (HTTP, MQTT, Modbus/TCP), которые позволяют разработчикам создавать собственные системы управления энергоресурсами (EMS), системы управления зданиями (BMS) или платформы автоматизации умного дома.
Прошивка IAMMETER постоянно обновляется. В этом документе перечислены все функции локальной и открытой интеграции, поддерживаемые последней версией прошивки.(Постоянно обновляется)
1) Обновление прошивки
Последние версии прошивок можно получить здесь:
- Страница выпуска прошивки (imeter.club): https://imeter.club/topic/11
2) Режимы работы (не облачные)
Выберите режим в зависимости от того, как вы интегрируете или используете устройство.
| Режим | Описание | Типичное использование |
|---|---|---|
| Облако | Загрузка данных в IAMMETER-Cloud | 🚫 Не рассматривается в этой статье |
| ТКП | Загрузка на сторонние серверы черезTCP/TLSилиMQTT | Локальные серверы, таможенные брокеры |
| HTTP | Загрузка на сторонние серверы черезHTTP/HTTPS | Пользовательские REST API/веб-бэкэнды |
| MQTT | Загружайте данные напрямую в MQTT-брокер | Доступно только в последней версии прошивки |
| Автономный | Нет загрузки данных; счетчик действует как локальный сервер, отвечающий API или клиентам Modbus/TCP | Доступно только в последней версии прошивки |
Устаревший интерфейс прошивки
Последняя прошивкаWebUI
(Остальная часть документа остается неизменной по сравнению с последней версией.)
3) Интеграция TCP/TLS/MQTT
3.1 TCP и TLS
Счетчики могут передавать данные непосредственно на вашу конечную точку TCP/TLS.
🔹 Новая конфигурация прошивки
Процесс настройки в последней версии прошивки аналогичен предыдущим версиям.
Режим работы: ТКП
Адрес:
- Для TCP-сервера — введите
{домен}:{порт}(например.,abc.com:12345).
- Для TLS-сервера — используйте
tls://{домен}:{порт}(например.,tls://abc.com:12345).
Интервал загрузки:Минимальный интервал загрузки составляет2 секунды.
🔹 Конфигурация устаревшей прошивки
3.2 MQTT
🔹 Новая конфигурация прошивки
Режим работы: MQTT
Адрес:Введите IP или домен с портом, например,192.168.11.163:1883
Имя пользователя / Пароль:Учетные данные брокера MQTT (необязательно, если брокер этого не требует)
Интервал загрузки:Минимальный интервал2 секунды. HA MQTT Discovery: Включить обнаружение MQTT в Home Assistant
🔹 Конфигурация устаревшей прошивки
Публикуйте телеметрию локальному или публичному брокеру MQTT.
4) Интеграция HTTP/HTTPS
🔹 Конфигурация устаревшей прошивки
Счетчики могут отправлять данные непосредственно на ваш сервер.
- Формат полезной нагрузки данных идентичен режимам TCP/MQTT.
- Можно использовать любой порт.
- Порт443автоматически включает HTTPS.
- Подробности:Загрузка через HTTP/HTTPS
🔹 Новая конфигурация прошивки
Адрес:Формат входных данных такой же, как и в старой прошивке.
- Если порт не указан, порт по умолчанию80.
- Только порт443использует HTTPS-запись; все остальные порты используют HTTP-запись.
5) Локальный API (HTTP через LAN)
Доступ к счетчику осуществляется локально через его IP-адрес в локальной сети — подключение к облаку не требуется.
5.1 ПОЛУЧИТЬ /api/monitorjson
Возвращает данные измерений в реальном времени.Поля:Напряжение, ток, активная мощность, прямые/обратные кВт·ч, частота, коэффициент мощности.
Пример:
{
«Метод»: «uploadsn»,
«Mac»: «B0F8933C4F94»,
«Версия»: «i.75.97.9»,
«Сервер»: «em»,
«Серийный номер»: «3E0BAF87»,
«Данные»: [
[220.0, 9.99, 2198, 11.337, 11.201, 49.99, 1.00],
[222.5, 9.99, 1100, 11.039, 10.908, 49.99, 0.50],
[263.5, 9.99, 1213, 10,975, 10,846, 49,99, 0,55]
]
}📘 Расширение измерения реактивной мощности
5.2 ПОЛУЧИТЬ /api/monitor
Расширенная версияМониторджсон, включает информацию о сигнале Wi-Fi:
SSID(имя подключенной точки доступа)сиг(уровень сигнала)
5.3 ПОЛУЧИТЬ /api/wifidata
Возвращает конфигурацию Wi-Fi и сети.
{
«Версия»: i.75.97.9, «SN»: 3E0BAF87, «Mac»: B0F8933C4F94,
«Тип»: PM, «SSID»: CMCC-laohe, «IP»: 192.168.11.62,
«Маска сети»: 255.255.255.0, «GW»: 192.168.11.253,
«dns»: «114.114.114.114», «dhcp»: 1, «runMode»: «tcp», «uploadinterval»: 60
}5.4 GET /api/uploadinterval?x=<секунд>
Устанавливает интервал загрузки (в секундах).
Работает в необлачных режимах (TCP/HTTP/MQTT).
ВПоследняя прошивка, этот параметр теперь можно настроить непосредственно изWebUI-интерфейс, без вызова API вручную.
5.5 ПОЛУЧИТЬ /api/mqtt
Настраивает учетные данные MQTT. 📘Документация API конфигурации MQTT
ВПоследняя прошивка, этот параметр теперь можно настроить непосредственно изWebUI-интерфейс, без вызова API вручную.
5.6 ПОЛУЧИТЬ /api/netmetering
ПереключателиИзмерение чистой энергии (NEM)режим. 📘Включить режим NEM
ВПоследняя прошивка, этот параметр теперь можно настроить непосредственно изWebUI-интерфейс, без вызова API вручную.
5.7 ПОЛУЧИТЬ /api/ctcratio
РегулируетУмножитель фазы Cдля сценариев с расщепленной фазой/сбалансированным питанием.
х=2Удваивает показания фазы C (ток, мощность, кВт·ч). 📘Объяснение коэффициента CTC
ВПоследняя прошивка, этот параметр теперь можно настроить непосредственно изWebUI-интерфейс, без вызова API вручную.
5.8 ПОЛУЧИТЬ /api/реактивный
Включает или выключаетРеактивная мощность (Q)иРеактивная энергия (кварч)измерение. 📘Документация по реактивной мощности
ВПоследняя прошивка, этот параметр теперь можно настроить непосредственно изWebUI-интерфейс, без вызова API вручную.
5.9 ПОЛУЧИТЬ /API/Ratio (доступно только для WEM3046T)
Так какВЭМ3046Тиспользует внешние КТ сВторичные выходы 5А(например, 1000:5, 1500:5, 2000:5 и т. д.), измеренные значения (ток, мощность, энергия) необходимо умножить на коэффициент трансформации трансформатора тока.
Пример:
/api/ratio?x=400- Установить соотношение:
/api/ratio?x={ct_ratio} - Коэффициент запросов:
/API/соотношение
ТолькоВЭМ3046Тподдерживает внешние трансформаторы тока 5 А — этот API недействителен для других моделей.
6) Согласованность формата JSON
Все виды связи —HTTP, TCP, MQTT, локальный API— используйте ту же структуру JSON. 📘Определение данных JSON
7) Поддержка Modbus/TCP
Счетчики IAMMETER изначально поддерживаютModbus/TCP, что позволяет прямую интеграцию сДомашний помощник, ПЛК, илиСКАДАсистемы.
8) Поддерживаемые сценарии интеграции
| Система | Протокол(ы) | Пример использования | Ссылка |
|---|---|---|---|
| Домашний помощник | HTTP/Modbus/MQTT | Панель управления и автоматизация | Гид |
| Узел-КРАСНЫЙ | HTTP/Modbus/MQTT | Автоматизация потоков | Гид |
| OpenHAB / ioBroker | HTTP | Локальные панели управления | Интеграция |
| ЗАББИКС | HTTP | Панели мониторинга | Интеграция |
| Доска объявлений | HTTP | визуализация Интернета вещей | Интеграция |
| Пользовательские серверы | HTTP/MQTT/TCP | Корпоративный или локальный прием данных | Создайте свою собственную систему |
9) Ресурсы
10) Обзор разработчика
| Возможности | Доступ | Примечания |
| --------------------- | ------------------- | ---------------------------------- |
| Локальные данные в реальном времени | Локальный API |/апи/мониторджсон, /апи/монитор|
| Загрузка сторонних приложений | TCP/TLS, HTTP/HTTPS | Та же схема полезной нагрузки |
| Публикация MQTT | Брокер MQTT |/api/mqttдля настройки учётных данных |
| Сетевые измерения | Локальный API |/api/netmetering|
| Реактивная мощность/энергия | Местный API |/апи/реактивный|
| Умножитель фазы C | Локальный API |/api/ctcratio?x=1 | | Коэффициент CT (WEM3046T) | Локальный API |/api/ratio?x=` |
| Modbus/TCP | Клиент Modbus | Совместимость с HA/PLC/SCADA |
Последнее обновление: 15 октября 2025 г.
