Vyvíjejte si vlastní systém monitorování energie pomocí IAMMETER

Vyvíjejte si vlastní systém monitorování energie pomocí IAMMETER

Měřidla energie IAMMETER Wi-Fi poskytují otevřená datová rozhraní pro vývojáře, systémové integrátory a zákazníky, kteří si budují vlastní software pro monitorování energie.

Naměřené hodnoty můžete získávat přímo z měřidla, nechat měřidlo odesílat data na váš vlastní server, nasadit samoobslužnou (self-hosted) službu IAMMETER nebo vytvořit aplikaci nad API IAMMETER-Cloud.

Tato stránka je průvodcem pro vývojáře, který pomáhá zvolit architekturu systému. Odkazuje na aktuální definice protokolů a implementační dokumenty, místo aby duplikovala všechny parametry API.

Pokud je vaší první otázkou, zda měřidlo IAMMETER může fungovat bez přístupu k internetu nebo bez IAMMETER-Cloud, začněte článkem Použití Wi-Fi měřidla energie bez internetu nebo cloudu. Pro srovnání z pohledu platforem viz Integrace self-hosted a open-source.

1. Zvolte architekturu svého systému

Existují čtyři hlavní způsoby, jak využít data IAMMETER ve vlastní aplikaci.

Architektura	Tok dat	Nejvhodnější pro	Vyžaduje IAMMETER-Cloud?
Lokální čtení z měřidla	Aplikace → měřidlo	LAN dashboardy, automatizace, PLC a SCADA	Ne
Odesílání dat měřidlem	Měřidlo → zákaznický server nebo broker	Vlastní cloud, EMS, BMS a IoT back-endy	Ne
Nasazení self-hosted softwaru IAMMETER	Měřidlo → IAMMETER-Docker nebo IAMMETER-Central → aplikace	Uživatelé, kteří chtějí úložiště a API bez budování kompletního back-endu	Ne
Stavba na API IAMMETER-Cloud	Měřidlo → IAMMETER-Cloud → aplikace	Aplikace, které chtějí znovu využít data a služby IAMMETER-Cloud	Ano

Správná volba závisí na tom, kde mají být data ukládána, zda projekt potřebuje provoz nezávislý na internetu, na požadované rychlosti obnovování a na tom, kolik vývoje back-endu chcete udržovat.

2. Čtení dat přímo z měřidla

Tuto architekturu zvolte, když jsou aplikace a měřidlo ve stejné lokální síti.

IAMMETER meter ← Local HTTP API or Modbus TCP ← Your application

Vaše aplikace řídí interval dotazování a ukládá si veškerou historii, kterou potřebuje. Pro místní datovou cestu není vyžadována žádná cloudová služba IAMMETER.

2.1 Lokální HTTP API

Měřidlo poskytuje lokální HTTP koncové body pro získávání naměřených hodnot, jako je napětí, proud, činný výkon, odebraná energie a dodaná energie.

Mezi běžné měřicí koncové body patří:

• /api/monitorjson
• /api/monitor

Přístup přes lokální HTTP API je praktickým výchozím bodem pro:

• vlastní dashboardy;
• skripty běžící na PC, NAS nebo Raspberry Pi;
• integrace s nízkým množstvím kódu;
• lokální aplikace, které nevyžadují dotazování každou sekundu.

Aktuální definice koncových bodů a příklady najdete v Průvodci lokálním API a otevřenými rozhraními IAMMETER.

2.2 Modbus TCP

Použijte Modbus TCP, když projekt vyžaduje:

• lokální dotazování každou sekundu;
• integraci s PLC nebo SCADA;
• řízení výkonu v reálném čase;
• integraci s průmyslovým EMS nebo BMS;
• standardní protokol založený na registrech.

Viz Průvodce registrem Modbus TCP a integrací IAMMETER.

2.3 Co musí vaše aplikace zajistit

Přímé lokální čtení vrací naměřené hodnoty měřidla. Vaše aplikace zůstává odpovědná za všechny další funkce, které vyžaduje, včetně:

• ukládání dat;
• hodinové, denní a měsíční agregace;
• dashboardů a sestav;
• uživatelů a oprávnění;
• alarmů a logiky automatizace;
• záloh a uchovávání dat.

Pokud nechcete tyto back-endové funkce budovat od začátku, zvažte IAMMETER-Docker nebo IAMMETER-Central.

3. Odesílání dat měřidla přímo na váš server

Tuto architekturu zvolte, když má měřidlo navázat spojení a odesílat data na koncový bod, který spravujete vy.

IAMMETER meter → MQTT/MQTTS, HTTP/HTTPS or TCP/TLS → Your server

Současný firmware IAMMETER podporuje několik rozhraní pro odesílání dat:

Rozhraní	Součást na straně zákazníka	Typické použití
MQTT / MQTTS	MQTT broker a odběratel	IoT platformy, automatizace a datová potrubí
HTTP / HTTPS	HTTP koncový bod	REST back-end, cloudová služba nebo vlastní EMS
TCP / TLS	TCP server	Vlastní sběrač dat a integrace na úrovni protokolu

Měřidlo a váš server používají konzistentní strukturu JSON měření IAMMETER napříč všemi podporovanými způsoby odesílání. Před implementací vlastního parseru si prostudujte definici dat.

Zdroje pro implementaci:

• Publikování dat IAMMETER do vašeho MQTT brokera
• Odesílání dat IAMMETER na server třetí strany
• Definice JSON měření IAMMETER
• Aktuální firmware, lokální API a otevřená rozhraní
• Nejnovější firmware IAMMETER a informace o aktualizaci

Server ve stejné síti LAN může fungovat bez přístupu k internetu. Vzdálený koncový bod stále vyžaduje funkční cestu přes internet, soukromou WAN nebo VPN.

4. Použití self-hosted softwaru IAMMETER

IAMMETER poskytuje dvě možnosti self-hosted provozu pro uživatele, kteří chtějí soukromé nasazení dat bez implementace všech back-endových komponent sami.

4.1 IAMMETER-Docker

IAMMETER-Docker je open-source, self-hosted systém pro monitorování energie. Poskytuje lokální sběr dat, základní monitorovací funkce, grafy a API.

Obecně je vhodný pro:

• jednotlivce a vývojáře;
• nasazení na Raspberry Pi, mini PC a NAS;
• monitorování domácí nebo solární energie v soukromé síti;
• projekty, které potřebují funkční rozhraní i API;
• uživatele, kteří chtějí vyvíjet vlastní uživatelské rozhraní nad hotovým back-endem.

Pokračujte s:

• Nasazení IAMMETER-Docker
• Pokročilé funkce IAMMETER-Docker
• Režim offline dataloggeru

4.2 IAMMETER-Central

IAMMETER-Central je self-hosted datové middleware pro podnikové uživatele, instalační techniky a systémové integrátory.

Zaměřuje se na:

• registraci a správu zařízení IAMMETER;
• ukládání měření měřidel do databáze řízené zákazníkem;
• poskytování standardizovaných API pro zákaznickou aplikaci;
• oddělení příjmu dat ze zařízení od ERP, EMS, BMS nebo front-endu zákazníka.

IAMMETER-Central se nepokouší poskytovat kompletní business logiku aplikace pro správu energie. Je užitečný, když zákazník chce udržovanou datovou middlewarovou vrstvu a vlastní uživatelské rozhraní nebo obchodní funkce si vytvoří sám.

Srovnání IAMMETER-Docker, IAMMETER-Central, open-source platforem a přímé serverové integrace najdete v přehledu Možnosti self-hostingu IAMMETER.

5. Stavba na API IAMMETER-Cloud

Použití IAMMETER-Cloud je další způsob, jak vyvinout vlastní dashboard nebo aplikaci. V této architektuře měřidlo odesílá data do IAMMETER-Cloud a vaše aplikace získává data vystavená API IAMMETER-Cloud.

IAMMETER meter → IAMMETER-Cloud → Cloud API → Your application

Tato možnost může snížit množství vývoje na straně zařízení a při příjmu dat, ale není to offline ani na cloudu nezávislá architektura.

Je vhodná, když:

• měřidlo již odesílá data do IAMMETER-Cloud;
• vaše aplikace chce znovu využívat data hostovaná v cloudu;
• je k dispozici přístup k internetu;
• není nutné udržovat celé datové potrubí v lokální síti.

Podporované operace API a požadavky na ověřování najdete v Dokumentaci API IAMMETER-Cloud.

6. Integrace se stávající open-source platformou

Než začnete budovat kompletní monitorovací systém, ověřte, zda stávající platforma již neposkytuje funkce úložiště, dashboardů a automatizace, které potřebujete.

IAMMETER lze integrovat s:

• Home Assistant
• Node-RED
• OpenHAB
• ioBroker
• Zabbix
• ThingsBoard

Tyto stránky specifické pro jednotlivé platformy jsou implementačními průvodci. Pro širší srovnání použijte Přehled integrace self-hosted a open-source.

7. Výběr nejlepšího výchozího bodu

Požadavek projektu	Doporučený výchozí bod
Jednoduchý LAN skript nebo dashboard	Lokální HTTP API
Lokální data každou sekundu nebo průmyslové řízení	Modbus TCP
Stávající infrastruktura MQTT	Odesílání MQTT nebo MQTTS
Stávající webový back-end	Odesílání HTTP nebo HTTPS
Vlastní socketový sběrač	Odesílání TCP nebo TLS
Okamžitě použitelné soukromé monitorování pro jednotlivého uživatele	IAMMETER-Docker
Podnikové middleware pro ERP, EMS nebo BMS	IAMMETER-Central
Dashboard a automatizace chytré domácnosti	Home Assistant
Aplikace postavená na stávajících datech IAMMETER-Cloud	API IAMMETER-Cloud

8. Kontrolní seznam pro vývoj

Před implementací ověřte:

1. která měření a fáze vybrané měřidlo poskytuje;
2. zda budou data dotazována nebo odesílána;
3. požadovaný interval aktualizace;
4. zda systém musí fungovat během výpadku internetu;
5. kde budou ukládána historická data;
6. zda je vyžadován přenos chráněný TLS;
7. jak bude aplikace ověřovat uživatele a zařízení;
8. zda má IAMMETER-Cloud zůstat součástí architektury;
9. verzi firmwaru použitou pro validaci;
10. jak budou zálohovány konfigurace, protokoly a data.

9. Související dokumentace

• Použití IAMMETER bez internetu nebo IAMMETER-Cloud
• Lokální API a otevřená rozhraní IAMMETER
• Přehled integrace self-hosted a open-source
• Odesílání dat na server třetí strany
• Integrace měřidla energie MQTT
• Integrace měřidla energie Modbus TCP
• Možnosti self-hostingu IAMMETER

Poslední aktualizace: 16. července 2026