Entwickeln Sie Ihr eigenes Energieüberwachungssystem mit IAMMETER

Entwickeln Sie Ihr eigenes Energieüberwachungssystem mit IAMMETER

Die Wi-Fi-Energiezähler von IAMMETER bieten offene Datenschnittstellen für Entwickler, Systemintegratoren und Kunden, die ihre eigene Energieüberwachungssoftware entwickeln möchten.

Sie können Messwerte direkt vom Zähler abrufen, den Zähler Daten auf Ihren Server hochladen lassen, einen IAMMETER Self-hosted-Dienst bereitstellen oder eine Anwendung auf Basis der IAMMETER-Cloud-APIs erstellen.

Diese Seite dient als Entwickler-Navigationsleitfaden für die Auswahl einer Architektur. Sie verlinkt auf die aktuellen Protokolldefinitionen und Implementierungsdokumente, anstatt jeden API-Parameter zu duplizieren.

Wenn Ihre erste Frage ist, ob ein IAMMETER-Zähler ohne Internetzugang oder IAMMETER-Cloud funktionieren kann, beginnen Sie mit Verwendung eines Wi-Fi-Energiezählers ohne Internet oder Cloud. Für einen plattformorientierten Vergleich siehe Self-hosted und Open-Source-Integration.

1. Wählen Sie Ihre Systemarchitektur

Es gibt vier Hauptwege, IAMMETER-Daten in Ihrer eigenen Anwendung zu nutzen.

Architektur	Datenfluss	Am besten geeignet für	IAMMETER-Cloud erforderlich?
Zähler lokal auslesen	Anwendung → Zähler	LAN-Dashboards, Automatisierung, SPS und SCADA	Nein
Zähler Daten hochladen lassen	Zähler → Kundenserver oder -broker	Benutzerdefinierte Cloud, EMS, BMS und IoT-Backends	Nein
IAMMETER Self-hosted-Software bereitstellen	Zähler → IAMMETER-Docker oder IAMMETER-Central → Anwendung	Benutzer, die Speicher und APIs ohne vollständiges Backend wünschen	Nein
Auf IAMMETER-Cloud-APIs aufbauen	Zähler → IAMMETER-Cloud → Anwendung	Anwendungen, die IAMMETER-Cloud-Daten und -Dienste wiederverwenden möchten	Ja

Die richtige Wahl hängt davon ab, wo Daten gespeichert werden sollen, ob das Projekt internetunabhängig arbeiten muss, welche Aktualisierungsrate erforderlich ist und wie viel Backend-Entwicklung Sie betreiben möchten.

2. Daten direkt vom Zähler auslesen

Wählen Sie diese Architektur, wenn sich die Anwendung und der Zähler im selben lokalen Netzwerk befinden.

IAMMETER-Zähler ← Lokale HTTP-API oder Modbus TCP ← Ihre Anwendung

Ihre Anwendung steuert das Abfrageintervall und speichert alle benötigten Verlaufsdaten. Für den lokalen Datenpfad ist kein IAMMETER-Cloud-Dienst erforderlich.

2.1 Lokale HTTP-API

Der Zähler stellt lokale HTTP-Endpunkte zum Abrufen von Messwerten wie Spannung, Strom, Wirkleistung, importierter Energie und exportierter Energie bereit.

Häufige Messwert-Endpunkte umfassen:

• /api/monitorjson
• /api/monitor

Der lokale HTTP-API-Zugriff ist ein praktischer Ausgangspunkt für:

• benutzerdefinierte Dashboards;
• Skripte, die auf einem PC, NAS oder Raspberry Pi ausgeführt werden;
• Low-Code-Integrationen;
• lokale Anwendungen, die keine Ein-Sekunden-Abfrage benötigen.

Siehe IAMMETER Local API und Open Interface Guide für aktuelle Endpunktdefinitionen und Beispiele.

2.2 Modbus TCP

Verwenden Sie Modbus TCP, wenn das Projekt Folgendes erfordert:

• lokale Ein-Sekunden-Abfrage;
• SPS- oder SCADA-Integration;
• Echtzeit-Leistungssteuerung;
• Integration mit einem industriellen EMS oder BMS;
• ein standardisiertes Register-basiertes Protokoll.

Siehe IAMMETER Modbus TCP Register und Integrationsleitfaden.

2.3 Was Ihre Anwendung bereitstellen muss

Der direkte lokale Lesezugriff liefert Zählermesswerte. Ihre Anwendung bleibt verantwortlich für alle zusätzlichen Funktionen, die sie benötigt, einschließlich:

• Datenspeicherung;
• stündliche, tägliche und monatliche Aggregation;
• Dashboards und Berichte;
• Benutzer und Berechtigungen;
• Alarme und Automatisierungslogik;
• Backups und Datenaufbewahrung.

Wenn Sie diese Backend-Funktionen nicht von Anfang an aufbauen möchten, ziehen Sie IAMMETER-Docker oder IAMMETER-Central in Betracht.

3. Zählerdaten direkt an Ihren Server hochladen

Wählen Sie diese Architektur, wenn der Zähler die Verbindung initiieren und Daten an einen von Ihnen verwalteten Endpunkt senden soll.

IAMMETER-Zähler → MQTT/MQTTS, HTTP/HTTPS oder TCP/TLS → Ihr Server

Die aktuelle IAMMETER-Firmware unterstützt mehrere Upload-Schnittstellen:

Schnittstelle	Kundenseitige Komponente	Typische Anwendung
MQTT / MQTTS	MQTT-Broker und -Abonnent	IoT-Plattformen, Automatisierung und Nachrichtenpipelines
HTTP / HTTPS	HTTP-Endpunkt	REST-Backend, Cloud-Dienst oder benutzerdefiniertes EMS
TCP / TLS	TCP-Server	Benutzerdefinierter Collector und Protokoll-Level-Integration

Der Zähler und Ihr Server verwenden eine konsistente IAMMETER-Messdaten-JSON-Struktur über alle unterstützten Upload-Methoden hinweg. Überprüfen Sie die Datendefinition, bevor Sie Ihren Parser implementieren.

Implementierungsressourcen:

• IAMMETER-Daten an Ihren MQTT-Broker veröffentlichen
• IAMMETER-Daten an einen Drittanbieter-Server hochladen
• IAMMETER-Messdaten-JSON-Definition
• Aktuelle Firmware, lokale APIs und offene Schnittstellen
• Neueste IAMMETER-Firmware und Upgrade-Informationen

Ein Server im selben LAN kann ohne Internetzugang betrieben werden. Ein entfernter Endpunkt erfordert weiterhin einen funktionierenden Pfad über das Internet, ein privates WAN oder ein VPN.

4. IAMMETER Self-hosted-Software verwenden

IAMMETER bietet zwei Self-hosted-Optionen für Benutzer, die eine private Datenbereitstellung wünschen, ohne jede Backend-Komponente selbst implementieren zu müssen.

4.1 IAMMETER-Docker

IAMMETER-Docker ist ein quelloffenes, selbst gehostetes Energieüberwachungssystem. Es bietet lokale Datenerfassung, grundlegende Überwachungsfunktionen, Diagramme und APIs.

Es ist im Allgemeinen geeignet für:

• Einzelpersonen und Entwickler;
• Raspberry Pi, Mini-PC und NAS-Bereitstellungen;
• Heimenergie- oder Solarüberwachung in einem privaten Netzwerk;
• Projekte, die sowohl eine funktionierende Oberfläche als auch APIs benötigen;
• Benutzer, die eine benutzerdefinierte Benutzeroberfläche auf Basis eines fertigen Backends entwickeln möchten.

Fahren Sie fort mit:

• IAMMETER-Docker bereitstellen
• IAMMETER-Docker Erweiterte Funktionen
• Offline-Datenlogger-Modus

4.2 IAMMETER-Central

IAMMETER-Central ist selbst gehostete Daten-Middleware für Unternehmensbenutzer, Installateure und Systemintegratoren.

Sie konzentriert sich auf:

• Registrieren und Verwalten von IAMMETER-Geräten;
• Speichern von Zählermesswerten in einer kundengesteuerten Datenbank;
• Bereitstellen standardisierter APIs für eine Kundenanwendung;
• Trennen der Geräte-Datenerfassung vom ERP, EMS, BMS oder Frontend des Kunden.

IAMMETER-Central versucht nicht, die vollständige Geschäftslogik einer Energiemanagementanwendung bereitzustellen. Sie ist nützlich, wenn der Kunde eine gewartete Daten-Middleware-Schicht wünscht und seine eigene Benutzeroberfläche oder Geschäftsfunktionen erstellen wird.

Siehe IAMMETER Self-hosting-Optionen für einen Vergleich von IAMMETER-Docker, IAMMETER-Central, Open-Source-Plattformen und direkter Server-Integration.

5. Auf IAMMETER-Cloud-APIs aufbauen

Die Verwendung von IAMMETER-Cloud ist ein weiterer Weg, ein benutzerdefiniertes Dashboard oder eine Anwendung zu entwickeln. In dieser Architektur lädt der Zähler Daten in die IAMMETER-Cloud hoch, und Ihre Anwendung ruft die von den IAMMETER-Cloud-APIs bereitgestellten Daten ab.

IAMMETER-Zähler → IAMMETER-Cloud → Cloud-API → Ihre Anwendung

Diese Option kann die geräteseitige und Datenerfassungs-Entwicklung reduzieren, ist jedoch keine Offline- oder Cloud-unabhängige Architektur.

Sie ist geeignet, wenn:

• der Zähler bereits Daten an die IAMMETER-Cloud meldet;
• Ihre Anwendung Cloud-gehostete Daten wiederverwenden möchte;
• Internetzugang verfügbar ist;
• die vollständige Datenpipeline nicht im lokalen Netzwerk bleiben muss.

Siehe die IAMMETER-Cloud-API-Dokumentation für unterstützte API-Operationen und Authentifizierungsanforderungen.

6. Integration mit einer bestehenden Open-Source-Plattform

Bevor Sie ein vollständiges Überwachungssystem aufbauen, prüfen Sie, ob eine bestehende Plattform bereits die benötigten Speicher-, Dashboard- und Automatisierungsfunktionen bietet.

IAMMETER kann integriert werden mit:

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

Diese plattformspezifischen Seiten sind die Implementierungsleitfäden. Für einen breiteren Vergleich verwenden Sie die Self-hosted und Open-Source-Integrationsübersicht.

7. Wählen Sie den besten Ausgangspunkt

Projektanforderung	Empfohlener Ausgangspunkt
Einfaches LAN-Skript oder Dashboard	Lokale HTTP-API
Lokale Ein-Sekunden-Daten oder industrielle Steuerung	Modbus TCP
Vorhandene MQTT-Infrastruktur	MQTT- oder MQTTS-Upload
Vorhandenes Web-Backend	HTTP- oder HTTPS-Upload
Benutzerdefinierter Socket-Collector	TCP- oder TLS-Upload
Einsatzbereite private Überwachung für Einzelbenutzer	IAMMETER-Docker
Unternehmens-Middleware für ERP, EMS oder BMS	IAMMETER-Central
Smart-Home-Dashboard und Automatisierung	Home Assistant
Anwendung auf Basis vorhandener IAMMETER-Cloud-Daten	IAMMETER-Cloud-API

8. Entwicklungs-Checkliste

Bestätigen Sie vor der Implementierung:

1. welche Messwerte und Phasen der ausgewählte Zähler bereitstellt;
2. ob Daten abgefragt oder gepusht werden;
3. das erforderliche Aktualisierungsintervall;
4. ob das System bei einem Internetausfall betriebsfähig sein muss;
5. wo historische Daten gespeichert werden;
6. ob TLS-geschützte Übertragung erforderlich ist;
7. wie die Anwendung Benutzer und Geräte authentifiziert;
8. ob IAMMETER-Cloud Teil der Architektur bleiben soll;
9. die für die Validierung verwendete Firmware-Version;
10. wie Konfiguration, Protokolle und Daten gesichert werden.

9. Verwandte Dokumentation

• IAMMETER ohne Internet oder IAMMETER-Cloud verwenden
• IAMMETER Lokale APIs und offene Schnittstellen
• Self-hosted und Open-Source-Integrationsübersicht
• Daten an einen Drittanbieter-Server hochladen
• MQTT-Energiezähler-Integration
• Modbus-TCP-Energiezähler-Integration
• IAMMETER Self-hosting-Optionen

Zuletzt aktualisiert: 16. Juli 2026