IAMMETER Wi-Fi електромер: локални API и отворени интерфейси

IAMMETER Wi-Fi електромер: локални API и отворени интерфейси

IAMMETER Wi-Fi електромерите поддържат IAMMETER-Cloud, както и локални интеграции и интеграции с трети страни.

Наличните интерфейси включват:

• Локално HTTP API в LAN мрежата
• Публикуване чрез MQTT и MQTTS
• Modbus TCP
• Качване чрез TCP/TLS
• Качване чрез HTTP/HTTPS
• Самостоятелна локална работа

Тези интерфейси позволяват на електромерите IAMMETER да служат като отворени източници на данни за:

• Home Assistant и други платформи за умен дом
• Автоматизация с Node-RED
• Самостоятелно хоствани табла за управление
• PLC и SCADA системи
• Персонализирани системи за управление на енергията (EMS)
• Персонализирани системи за управление на сгради (BMS)
• Сървъри за данни на трети страни

Това ръководство описва първо актуалния фърмуер и WebUI. Екранните снимки и методите за конфигуриране при по-стар фърмуер са запазени в последния раздел „Остарял фърмуер“.

За готово за използване приложение, изградено върху тези възможности, вижте Мониторинг на домашна енергия, Мониторинг на слънчева енергия или локален мониторинг без достъп до интернет.

1) Актуализирайте до най-новия фърмуер

Фърмуерът на IAMMETER се актуализира непрекъснато. Преди да конфигурирате интеграция, проверете текущата версия и съвместимостта с моделите:

• Страница с версиите на фърмуера на IAMMETER

WebUI на най-новия фърмуер предоставя често използваните опции за конфигуриране директно. Извикванията на API за ръчна конфигурация, запазени по-нататък в тази статия, са полезни главно при поддръжка на по-стари инсталации.

2) Изберете режим на работа в актуалния WebUI

Изберете режим на работа според това къде електромерът трябва да изпраща данни или как трябва да работи локално.

Режимът на работа определя поведението при качване на данни. Наличността на локалното API и на Modbus TCP трябва да се провери отделно за конкретния модел електромер, фърмуер и избрана интеграция.

3) Защо отворените интерфейси са важни

Отворените интерфейси позволяват на потребителите да решат къде да се обработват и съхраняват данните за електроенергията.

Типичните причини включват:

• Запазване на измерванията в локалната мрежа
• Изпращане на телеметрия към съществуващ сървър
• Свързване на енергийните данни с Home Assistant или Node-RED
• Създаване на персонализирани табла и аларми
• Комбиниране на данните за електроенергията с тарифи, слънчева енергия или логика за управление на товара
• Работа на обект с ограничен или ненадежден достъп до интернет

Достъпът през облака и локалният достъп не се изключват взаимно. Подходящата архитектура зависи от това дали проектът се нуждае от отчетите на IAMMETER-Cloud, от локална платформа, от сървър на трета страна или от комбинация.

4) Изпращане на данни към сървър на трета страна

4.1 TCP и TLS

IAMMETER може да изпраща данни от електромера към TCP или TLS крайна точка.

В актуалния WebUI:

1. Изберете режим на работа TCP.
2. Въведете адреса на получателя.
3. Конфигурирайте интервала на качване.
4. Запазете настройките и проверете данните на приемащия сървър.

За TCP сървър използвайте:

{domain-or-ip}:{port}

Пример:

abc.com:12345

За TLS сървър използвайте:

tls://{domain-or-ip}:{port}

Пример:

tls://abc.com:12345

Прегледът на актуалния фърмуер посочва минимален интервал на качване от 2 секунди. Проверете актуалния фърмуер и капацитета на приемащия сървър, преди да изберете кратък интервал.

4.2 MQTT и MQTTS

IAMMETER може да публикува телеметрия директно към обикновен MQTT брокер или да използва MQTTS за шифрован транспорт при поддържан фърмуер.

В актуалния WebUI:

1. Изберете режим на работа MQTT.
2. Въведете IP адреса или домейна на брокера и порта в съответния формат за MQTT или MQTTS.
3. Въведете потребителското име и паролата за брокера, когато се изисква удостоверяване.
4. Конфигурирайте интервала на качване.
5. Запазете и проверете дали съобщенията пристигат в брокера.

За обикновен MQTT въведете адреса и порта на брокера без префикс mqtt://:

192.168.11.163:1883

За MQTTS добавете префикса mqtts://:

mqtts://{mqtt-broker-address}:{port}

Пример:

mqtts://broker.example.com:8883

Поддръжката на MQTTS, описана в актуализацията на фърмуера от ноември 2025 г., има следните актуални ограничения:

• Поддържа TLS 1.2 и по-стари версии.
• Качването на персонализиран CA сертификат не се поддържа.
• Проверката на името на хоста не се поддържа.
• Клиентски сертификати за взаимно TLS удостоверяване не се поддържат.

Тези ограничения са важни при избора на брокер и при оценката на изискванията за сигурност на внедряването.

Прегледът на актуалния фърмуер посочва минимален интервал на качване от 2 секунди.

MQTT Discovery на Home Assistant е допълнителна функция за откриване в Home Assistant; тя не е задължителна за всяка MQTT интеграция. Вижте:

• Ръководство за MQTT интеграция с IAMMETER
• MQTT Discovery в Home Assistant

Промяна на uploadInterval отдалечено чрез MQTT/MQTTS

С фърмуера, описан в актуализацията от ноември 2025 г., електромер, работещ в MQTT режим, автоматично се абонира за:

device/{sn}/config

Публикувайте следния JSON от друг MQTT клиент, за да промените интервала на качване отдалечено:

{"uploadInterval": 10}

Заменете 10 с необходимия интервал в секунди, а {sn} — със серийния номер на електромера в темата.

Тази отдалечена MQTT конфигурация е различна от по-стария локален метод /api/uploadinterval, запазен в раздела „Остарял фърмуер“.

4.3 HTTP и HTTPS

IAMMETER може да изпраща данни към персонализиран HTTP/HTTPS сървър.

В актуалния WebUI:

1. Изберете режим на работа HTTP.
2. Въведете адреса и порта на сървъра.
3. Конфигурирайте интервала на качване.
4. Запазете и проверете заявките на сървъра.

Актуалният фърмуер поддържа както порта по подразбиране за HTTPS, така и персонализиран HTTPS порт.

Използвайте един от следните формати:

• Обикновен HTTP без изричен порт: {address} — по подразбиране порт 80.
• Обикновен HTTP с персонализиран порт: {address}:{port}.
• HTTPS без изричен порт: https://{address} — по подразбиране порт 443.
• HTTPS с персонализиран порт: https://{address}:{port} — използва посочения порт.

Префиксът https:// избира HTTPS. Порт 443 вече не е единственият наличен порт за HTTPS.

Примери:

api.example.com
api.example.com:8080
https://api.example.com
https://api.example.com:8443

Вижте Нов фърмуер добавя MQTTS, отдалечена конфигурация и персонализиран HTTPS порт за бележките към версията на фърмуера.

За обработка на полезния товар от страна на сървъра вижте също Интегриране на IAMMETER със сървър на трета страна.

5) Четене на данни локално чрез HTTP

Свържете електромера към LAN мрежата и заявявайте данни от неговия локален IP адрес. Тези заявки не изискват IAMMETER-Cloud.

Тествайте API интерактивно: Отворете IAMMETER Local API Explorer, въведете локалния IP адрес на електромера и изберете тестовата страница на WEM API. Explorer-ът в стил Swagger изброява наличните локални API и ви позволява да изпращате тестови заявки директно от браузъра. Браузърът ви и електромерът IAMMETER трябва да са в една и съща LAN мрежа.

5.1 GET /api/monitorjson

Връща електрически измервания в реално време.

Стандартните данни включват стойности като:

• Напрежение
• Ток
• Активна мощност
• kWh в права/внасяна посока
• kWh в обратна/изнасяна посока
• Честота
• Фактор на мощността

Примерен отговор:

{
  "method": "uploadsn",
  "mac": "B0F8933C4F94",
  "version": "i.75.97.9",
  "server": "em",
  "SN": "3E0BAF87",
  "Datas": [
    [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 GET /api/monitor

Връща разширен отговор в реално време, който включва и информация за Wi-Fi като:

• ssid — име на свързаната точка за достъп
• sig — сила на Wi-Fi сигнала

Използвайте тази крайна точка, когато интеграцията се нуждае както от електрически измервания, така и от основен Wi-Fi статус.

5.3 GET /api/wifidata

Връща информация за фърмуера, устройството и мрежовата конфигурация.

Пример:

{
  "version": "i.75.97.9",
  "SN": "3E0BAF87",
  "mac": "B0F8933C4F94",
  "type": "PM",
  "ssid": "example-wifi",
  "ip": "192.168.11.62",
  "netmask": "255.255.255.0",
  "gw": "192.168.11.1",
  "dns": "192.168.11.1",
  "dhcp": 1,
  "runMode": "tcp",
  "uploadinterval": 60
}

Не публикувайте отговори, съдържащи серийни номера на устройства, MAC адреси, вътрешна адресация или Wi-Fi информация, освен ако стойностите не са анонимизирани.

6) JSON формат при различните режими на качване

IAMMETER използва последователна основна JSON структура за измерванията при HTTP, TCP, MQTT и локалното API. Това намалява работата, необходима, когато една приемаща система поддържа няколко транспортни метода.

Транспортният метод и обвивката на съобщението все още могат да влияят на начина, по който получателят се свързва, удостоверява или рамкира съобщението. Реализирайте приемащата система съгласно документирания формат за избрания режим.

• Дефиниция на JSON данните на електромера IAMMETER

7) Modbus TCP

Електромерите IAMMETER поддържат Modbus TCP за директна интеграция в LAN със съвместими клиенти.

Типичните клиенти включват:

• Home Assistant
• PLC
• SCADA системи
• Индустриални шлюзове
• Персонализирани Modbus приложения

Препратки:

• Преглед на Modbus TCP при IAMMETER
• Преглед на интеграцията с Home Assistant

Проверете модела на електромера, фърмуера, дефиницията на регистрите, интервала на запитване и поведението на клиента преди внедряване.

8) Сценарии за интеграция

9) Обобщение на актуалните интерфейси и ресурси

Допълнителни ресурси:

• Най-нов фърмуер
• Бележка за фърмуера с MQTTS и персонализиран HTTPS порт
• Видео уроци
• Дефиниция на JSON данните
• Преглед на Modbus TCP
• Разработете своя собствена система
• Мониторинг без достъп до интернет

Локалните API и отворените протоколи на IAMMETER правят възможно да започнете с мониторинг в реално време и по-късно да добавите персонализирана EMS, самостоятелно хоствано табло или работен поток за автоматизация.

10) Страници и методи за конфигуриране при остарял фърмуер

Следващият материал е запазен само за електромери, които все още работят със стар фърмуер, или за потребители, които поддържат съществуваща интеграция. За нова инсталация актуализирайте до най-новия фърмуер и използвайте актуалния WebUI, където наличната опция го позволява.

10.1 Страница за избор на режим при остарял фърмуер

По-старият фърмуер използваше следната страница за избор на режим на работа:

Оформлението и имената на опциите може да не съвпадат с актуалния WebUI, показан по-рано в това ръководство.

10.2 Страница TCP/TLS при остарял фърмуер

Интеграциите със стар фърмуер може да се позовават на тази страница за конфигуриране на TCP/TLS и свързаното ръководство:

• Ръководство за интеграция със сървър на трета страна (остаряло)
• Видео за качване към сървър (остаряло)

10.3 Страница MQTT при остарял фърмуер

По-старата MQTT документация използваше този интерфейс за конфигуриране:

За актуалния работен процес използвайте инструкциите за актуалния WebUI по-рано в тази статия и обновеното Ръководство за MQTT интеграция.

10.4 Страница HTTP/HTTPS при остарял фърмуер

По-старият фърмуер използваше следната страница за HTTP/HTTPS дестинация:

Ръководството за остарялата интеграция е запазено на Качване чрез HTTP/HTTPS.

При този по-стар работен процес HTTPS се свързваше с порта по подразбиране 443 и не изискваше префикс https://. Актуалният фърмуер вместо това използва префикса https://, за да избере HTTPS, и поддържа или порта по подразбиране 443, или изрично зададен персонализиран порт.

10.5 API за конфигуриране при остарял фърмуер

Следните локални API извиквания се срещаха в по-стари работни процеси за конфигуриране. При актуалния фърмуер съответните настройки обикновено трябва да се конфигурират чрез WebUI, когато опцията е налична.

/api/uploadinterval?x=<seconds>

Остарял метод за задаване на интервала на качване извън Cloud.

/api/mqtt

Остарял метод за конфигуриране на MQTT идентификационните данни.

/api/netmetring

Остарял метод за включване или изключване на режима Net Energy Metering.

• Препратка за Net Energy Metering

/api/ctcratio

Остарял метод за прилагане на документирания множител за фаза C в определени сценарии с раздвоена фаза или балансирани сценарии.

• Препратка за CTC Ratio

/api/reactive

Остарял метод за включване или изключване на измерването на реактивна мощност и реактивна енергия при поддържан фърмуер/модели.

• Препратка за реактивна мощност

/api/ratio — само за WEM3046T

WEM3046T използва външни CT с вторичен изход 5 A. По-старите инструкции за конфигуриране задаваха съотношението на CT с:

/api/ratio?x={ct_ratio}

Пример:

/api/ratio?x=400

Тази крайна точка е специфична за WEM3046T и е невалидна за други модели на IAMMETER. За актуалния фърмуер използвайте конфигурацията в актуалния WebUI на модела, когато е налична.

Остарелият материал е запазен за обратна справка; актуалните инсталации трябва да следват WebUI на най-новия фърмуер.