IAMMETER Wi-Fi elektroměr: Lokální API a otevřená rozhraní

IAMMETER Wi-Fi elektroměr: Lokální API a otevřená rozhraní

Wi-Fi elektroměry IAMMETER podporují kromě služby IAMMETER-Cloud také lokální integrace a integrace třetích stran.

K dispozici jsou tato rozhraní:

• Lokální HTTP API v rámci sítě LAN
• Publikování MQTT a MQTTS
• Modbus TCP
• Nahrávání přes TCP/TLS
• Nahrávání přes HTTP/HTTPS
• Samostatný lokální provoz

Tato rozhraní umožňují elektroměrům IAMMETER fungovat jako otevřené zdroje dat pro:

• Home Assistant a další platformy chytré domácnosti
• Automatizaci Node-RED
• Vlastní (self-hosted) dashboardy
• Systémy PLC a SCADA
• Vlastní systémy řízení energie (EMS)
• Vlastní systémy řízení budov (BMS)
• Servery třetích stran pro ukládání dat

Tato příručka popisuje nejprve aktuální firmware a WebUI. Snímky obrazovky a způsoby konfigurace staršího firmwaru jsou zachovány v závěrečné části Legacy.

Pro hotovou aplikaci postavenou na těchto možnostech se podívejte na Monitorování energie v domácnosti, Monitorování solární energie nebo lokální monitorování bez přístupu k internetu.

1) Aktualizace na nejnovější firmware

Firmware IAMMETER je průběžně aktualizován. Před konfigurací integrace zkontrolujte aktuální verzi a kompatibilitu s modelem:

• Stránka vydání firmwaru IAMMETER

WebUI nejnovějšího firmwaru zobrazuje běžně používané možnosti konfigurace přímo. Ruční volání konfiguračních API uvedená dále v tomto článku jsou užitečná zejména při údržbě starších instalací.

2) Volba režimu provozu v aktuálním WebUI

Vyberte režim provozu podle toho, kam má elektroměr odesílat data nebo jak má fungovat lokálně.

Režim provozu řídí chování nahrávání dat. Dostupnost lokálního API a Modbus TCP je třeba vždy ověřit pro konkrétní model elektroměru, firmware a zvolenou integraci.

3) Proč na otevřených rozhraních záleží

Otevřená rozhraní umožňují uživatelům rozhodnout, kde budou data o spotřebě elektřiny zpracovávána a ukládána.

Typické důvody zahrnují:

• Uchovávání měření v rámci lokální sítě
• Zasílání telemetrie na stávající server
• Propojení dat o energii s Home Assistant nebo Node-RED
• Tvorba vlastních dashboardů a alarmů
• Kombinace dat o elektřině s tarify, logikou řízení solárních zdrojů nebo zátěže
• Provoz v místě s omezeným nebo nespolehlivým přístupem k internetu

Cloudový a lokální přístup se vzájemně nevylučují. Vhodná architektura závisí na tom, zda projekt potřebuje sestavy IAMMETER-Cloud, lokální platformu, server třetí strany nebo jejich kombinaci.

4) Odesílání dat na server třetí strany

4.1 TCP a TLS

IAMMETER může odesílat data elektroměru na koncový bod TCP nebo TLS.

V aktuálním WebUI:

1. Vyberte režim provozu TCP.
2. Zadejte cílovou adresu.
3. Nakonfigurujte interval nahrávání.
4. Uložte nastavení a ověřte data na přijímajícím serveru.

Pro server TCP použijte:

{domain-or-ip}:{port}

Příklad:

abc.com:12345

Pro server TLS použijte:

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

Příklad:

tls://abc.com:12345

Přehled aktuálního firmwaru uvádí minimální interval nahrávání 2 sekundy. Před zvolením krátkého intervalu ověřte aktuální firmware a kapacitu přijímajícího serveru.

4.2 MQTT a MQTTS

IAMMETER může publikovat telemetrii přímo do běžného MQTT brokeru, případně použít MQTTS pro šifrovaný přenos u podporovaného firmwaru.

V aktuálním WebUI:

1. Vyberte režim provozu MQTT.
2. Zadejte IP adresu nebo doménu brokeru a port v odpovídajícím formátu MQTT nebo MQTTS.
3. Pokud je vyžadováno ověření, zadejte uživatelské jméno a heslo brokeru.
4. Nakonfigurujte interval nahrávání.
5. Uložte a ověřte, že zprávy dorazí do brokeru.

Pro běžné MQTT zadejte adresu a port brokeru bez předpony mqtt://:

192.168.11.163:1883

Pro MQTTS uveďte předponu mqtts://:

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

Příklad:

mqtts://broker.example.com:8883

Podpora MQTTS popsaná v aktualizaci firmwaru z listopadu 2025 má následující aktuální omezení:

• Podporuje TLS 1.2 a nižší.
• Nahrávání vlastního certifikátu CA není podporováno.
• Ověřování názvu hostitele není podporováno.
• Klientské certifikáty pro vzájemnou autentizaci TLS nejsou podporovány.

Tato omezení jsou důležitá při výběru brokeru a při posuzování bezpečnostních požadavků nasazení.

Přehled aktuálního firmwaru uvádí minimální interval nahrávání 2 sekundy.

MQTT Discovery v Home Assistant je doplňková funkce zjišťování zařízení v Home Assistant; není vyžadována pro každou integraci MQTT. Viz:

• Průvodce integrací IAMMETER s MQTT
• MQTT Discovery v Home Assistant

Změna uploadInterval na dálku přes MQTT/MQTTS

U firmwaru popsaného v aktualizaci z listopadu 2025 se elektroměr v režimu MQTT automaticky přihlašuje k odběru:

device/{sn}/config

Pro dálkovou změnu intervalu nahrávání publikujte z jiného MQTT klienta následující JSON:

{"uploadInterval": 10}

Nahraďte 10 požadovaným intervalem v sekundách a {sn} výrobním číslem elektroměru v tématu (topic).

Tato dálková konfigurace přes MQTT se liší od starší lokální metody /api/uploadinterval zachované v části Legacy.

4.3 HTTP a HTTPS

IAMMETER může odesílat data na vlastní server HTTP/HTTPS.

V aktuálním WebUI:

1. Vyberte režim provozu HTTP.
2. Zadejte adresu serveru a port.
3. Nakonfigurujte interval nahrávání.
4. Uložte a ověřte požadavky na serveru.

Aktuální firmware podporuje jak výchozí port HTTPS, tak vlastní port HTTPS.

Použijte jeden z těchto formátů:

• Běžné HTTP bez explicitního portu: {address} — výchozí port 80.
• Běžné HTTP s vlastním portem: {address}:{port}.
• HTTPS bez explicitního portu: https://{address} — výchozí port 443.
• HTTPS s vlastním portem: https://{address}:{port} — použije zadaný port.

Předpona https:// volí HTTPS. Port 443 již není jediným dostupným portem pro HTTPS.

Příklady:

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

Poznámku k vydání firmwaru najdete v článku Nový firmware přidává MQTTS, dálkovou konfiguraci a vlastní port HTTPS.

Pro zpracování dat na straně serveru viz také Integrace IAMMETER se serverem třetí strany.

5) Lokální čtení dat přes HTTP

Připojte elektroměr k síti LAN a vyžádejte si data z jeho lokální IP adresy. Tyto požadavky nevyžadují IAMMETER-Cloud.

Vyzkoušejte API interaktivně: Otevřete Průzkumník lokálního API IAMMETER, zadejte lokální IP adresu elektroměru a vyberte testovací stránku WEM API. Průzkumník ve stylu Swagger zobrazuje dostupná lokální API a umožňuje odesílat testovací požadavky přímo z prohlížeče. Váš prohlížeč a elektroměr IAMMETER musí být ve stejné síti LAN.

5.1 GET /api/monitorjson

Vrací měření elektrických veličin v reálném čase.

Standardní data zahrnují hodnoty jako:

• Napětí (Voltage)
• Proud (Current)
• Činný výkon (Active power)
• Odběr/import kWh (Forward/import kWh)
• Dodávka/export kWh (Reverse/export kWh)
• Kmitočet (Frequency)
• Účiník (Power factor)

Příklad odpovědi:

{
  "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]
  ]
}

Počet polí měření závisí na modelu elektroměru a počtu kanálů.

Pokud je u podporovaného modelu/firmwaru povoleno měření jalového výkonu, může formát odpovědi obsahovat další pole. Viz Formát dat měření jalového výkonu.

5.2 GET /api/monitor

Vrací rozšířenou odpověď v reálném čase, která obsahuje také informace o Wi-Fi, například:

• ssid — název připojeného přístupového bodu
• sig — síla signálu Wi-Fi

Tento koncový bod použijte, pokud integrace potřebuje jak měření elektrických veličin, tak základní stav Wi-Fi.

5.3 GET /api/wifidata

Vrací informace o firmwaru, zařízení a síťové konfiguraci.

Příklad:

{
  "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
}

Nezveřejňujte odpovědi obsahující výrobní čísla zařízení, MAC adresy, interní adresy nebo informace o Wi-Fi, pokud nebyly hodnoty anonymizovány.

6) Formát JSON napříč režimy nahrávání

IAMMETER používá jednotnou strukturu měření JSON napříč HTTP, TCP, MQTT a lokálním API. Tím se snižuje množství práce, když jeden přijímající systém podporuje více přenosových metod.

Způsob přenosu a obálka (envelope) mohou přesto ovlivnit, jak se přijímač připojuje, autentizuje nebo rámuje zprávu. Implementujte přijímající systém podle zdokumentovaného formátu pro zvolený režim.

• Definice dat JSON elektroměru IAMMETER

7) Modbus TCP

Elektroměry IAMMETER podporují Modbus TCP pro přímou integraci do sítě LAN s kompatibilními klienty.

Typickými klienty jsou:

• Home Assistant
• PLC
• Systémy SCADA
• Průmyslové brány (gateway)
• Vlastní aplikace Modbus

Reference:

• Přehled IAMMETER Modbus TCP
• Přehled integrace s Home Assistant

Před nasazením ověřte model elektroměru, firmware, definici registrů, interval dotazování a chování klienta.

8) Scénáře integrace

9) Přehled aktuálních rozhraní a zdroje

Další zdroje:

• Nejnovější firmware
• Poznámka k firmwaru MQTTS a vlastní port HTTPS
• Video návody
• Definice dat JSON
• Přehled Modbus TCP
• Vytvořte si vlastní systém
• Monitorování bez přístupu k internetu

Lokální API a otevřené protokoly IAMMETER umožňují začít s monitorováním v reálném čase a později přidat vlastní EMS, self-hosted dashboard nebo automatizační workflow.

10) Starší stránky firmwaru a způsoby konfigurace

Následující materiál je zachován pouze pro elektroměry, které stále běží na starším firmwaru, nebo pro uživatele spravující stávající integraci. U nové instalace aktualizujte na nejnovější firmware a použijte aktuální WebUI všude, kde je požadovaná možnost dostupná.

10.1 Stará stránka režimů provozu

Starší firmware používal následující stránku pro výběr režimu provozu:

Rozložení a názvy možností nemusí odpovídat aktuálnímu WebUI zobrazenému výše v této příručce.

10.2 Stará stránka TCP/TLS

Integrace se starším firmwarem se mohou odkazovat na tuto stránku konfigurace TCP/TLS a související příručku:

• Starý průvodce integrací se serverem třetí strany
• Staré video s nahráváním na server

10.3 Stará stránka MQTT

Starší dokumentace MQTT používala toto konfigurační rozhraní:

Pro aktuální postup použijte instrukce pro aktuální WebUI uvedené výše v tomto článku a aktualizovaný Průvodce integrací MQTT.

10.4 Stará stránka HTTP/HTTPS

Starší firmware používal následující stránku cíle HTTP/HTTPS:

Starý průvodce integrací je zachován na stránce Nahrávání přes HTTP/HTTPS.

V tomto starším postupu bylo HTTPS spojeno s výchozím portem 443 a nevyžadovalo předponu https://. Aktuální firmware místo toho používá předponu https:// pro výběr HTTPS a podporuje buď výchozí port 443, nebo explicitně zadaný vlastní port.

10.5 Stará konfigurační API

Následující lokální volání API se objevovala v dřívějších konfiguračních postupech. V aktuálním firmwaru by měla být odpovídající nastavení obvykle konfigurována přes WebUI, pokud je daná možnost dostupná.

/api/uploadinterval?x=<seconds>

Starší metoda pro nastavení intervalu nahrávání mimo Cloud.

/api/mqtt

Starší metoda pro konfiguraci přihlašovacích údajů MQTT.

/api/netmetring

Starší metoda pro povolení nebo zakázání režimu Net Energy Metering.

• Reference Net Energy Metering

/api/ctcratio

Starší metoda pro použití zdokumentovaného násobitele fáze C ve specifických scénářích split-phase nebo vyvážených scénářích.

• Reference CTC Ratio

/api/reactive

Starší metoda pro povolení nebo zakázání měření jalového výkonu a jalové energie u podporovaného firmwaru/modelů.

• Reference jalového výkonu

/api/ratio — pouze WEM3046T

WEM3046T používá externí měřicí transformátory proudu (CT) se sekundárními výstupy 5 A. Starší pokyny ke konfiguraci nastavovaly poměr CT příkazem:

/api/ratio?x={ct_ratio}

Příklad:

/api/ratio?x=400

Tento koncový bod je specifický pro WEM3046T a u jiných modelů IAMMETER je neplatný. U aktuálního firmwaru použijte konfiguraci WebUI daného modelu, pokud je dostupná.

Starý materiál je zachován pro zpětnou referenci; aktuální instalace by měly používat nejnovější firmware a WebUI.