Erstelle Dein IoT-Gateway für die HomeMatic
Mit dem HildeIO Gateway kannst du mit wenigen Codeanpassungen die Zustandsänderungen deiner HomeMatic-Aktoren an Google Firebase übertragen.
Steuere deine HomeMatic-Aktoren aus dem Internet. Das HildeIO Gateway überträgt die Änderungen in Echtzeit an die HomeMatic CCU.
 
 
HildeIO Technologie-Stack
APACHE
TOMCAT
Das HildeIO Gateway wird auf dem Applikationsserver Apache Tomcat ausgeführt.

Für die Entwicklung wird der integrierte Tomcat-Server verwendet.
Produktdetails
Version 10
Apache-Lizenz
Community Support
 
JAVA
SPRING BOOT
Die Codebasis des HildeIO Gateway basiert auf Java Spring Boot. Event-Datenobjekte sind im JSON-Format.

Events werden in Echtzeit an das Zielsysteme übertragen.
Produktdetails
Java Runtime
REST-API
Apache-Lizenz
 
MARIADB
DBMS
Das Loggingkonzept enthält Informationen zu den Events, Exceptions und den Datenobjekten.

Der Datenbankserver wird im LAN-Netzwerk betrieben.
Produktdetails
Relational
Datatables
GPLv2-Lizenz
Das HildeIO Gateway unterstützt folgende Betriebssysteme:
 
 
Das HildeIO Ecosystem
Für die Events von der HomeMatic CCU stellt das HildeIO Gateway eine REST-API bereit.
Die REST-Services sind eine Referenzimplementierung und können auf individuelle Anforderungen angepasst werden.

Ankommende Events aus der Google Firebase werden dem EventHub bereitgestellt.
Das HildeIO Gateway erhält Events von allen abbonierten Firestore Database Collections.
HOMEMATIC CCU
HomeMatic-Programme übertragen bei einem Event das aktuelle Datenobjekt im JSON-Format. Die Übertragung erfolgt über HTTP-Reqeusts.

Änderungen in der Firebase werden der HomeMatic mittels JSON-RPC bereitgestellt.
 
HILDEIO GATEWAY
Das HildeIO Gateway übernimmt die Orchestrierung der Events.

Im Controller-Modul werden die REST-Services für die HomeMatic CCU bereitgestellt.

Im Service-Modul werden die Datenobjekte als Dokument in der Google Firestore Database persistiert.

Dokumentänderungen in der Google Firestore Database werden vom EventHub abboniert. Der HmEventManager überträgt die Änderungen an die HomeMatic CCU.
 
GOOGLE FIREBASE
Die Dokumente aus dem HildeIO Gateway werden in der Google Firestore Database in der jeweiligen Firestore Collection persistiert.

Jede Firestore Collection wird im Listener des HildeIO Gateway EventHubs registiert. Bei einer Dokumentänderung wird dem EventHub das aktuelle Dokument bereitgestellt.
Weitere Produkte im HildeIO Ecosystem:
Java Spring Boot
Apache Maven
Apache Tomcat 10
MariaDB/MySQL
Swagger/OpenAPI
Google FCM
Apache Webserver
PhpMyAdmin
 
 
HildeIO Event-Lifecycles
Das HildeIO Gateway unterscheidet zwischen zwei Event-Lifecycles. Beim ersten Lifecycle wird ein Event in der HomeMatic CCU ausgelöst und an die Google Firestore Database übertragen. Im zweiten Lifecycle wird ein Event in einem Dokument in der Google Firestore Database ausgelöst und wird an die HomeMatic CCU übertragen.
Event-Lifecycle 1
Referenzimplementierung: Eine Zustandsänderung am HomeMatic Schaltaktor
wird an die Firestore Collection "ioSchaltaktor" übetragen.
HomeMatic Schaltaktor
In dem Referenzbeispiel hat ein Schaltaktor hat den Ausgangszustand "ausgeschaltet". Der Schaltaktor kann vom BidCos oder HomeMaticIP-Aktor sein. Durch das Einschalten des Schaltaktors ändert sich sein Zustand.
HomeMatic Programm
Ein HomeMatic Programm wird durch das Event der Zustandsänderung gestartet. Es ermittelt die aktuellen Werte des Schaltaktors für das Datenobjekt. Das Datenobjekt wird über einen HTTP-Request an den REST-Service des HildeIO Gatways übermittelt.
 
HildeIO Schaltaktor-API
Das HildeIO Gateway stellt für Schaltaktoren einen REST-Service bereit. Dieser erwartet das neue Datenobjekt des Schaltaktors aus der HomeMatic CCU. Für das Datenobjekt des Schalktators existiert im HildeIO Gateway eine eigene Model-Klasse.
 
HildeIO Schaltaktor-Service
Die Logik und Datenmanipulation des Schaltaktor-Models erfolgt in der Serive-Klasse. Das finale Schaltaktor-Model wird als Dokument in der Firestore Database Collection persistiert.
Firestore Collection ioSchaltaktor
In der Google Firebase werden die Dokumente in der Firestore Database persistiert. Für jedes Gewerk existiert eine eigene Collection. Schaltaktoren werden in der Collection ioSchalktaktoren gespeichert. Je Schaltaktor gibt es ein Dokument, das bei einer Änderung aktualisiert wird.
Event-Lifecycle 2
Referenzimplementierung: Eine Zustandsänderung in der Firestore Collection "ioSchaltaktor"
wird an den HomeMatic Schaltaktor übertragen.
Firestore Collection ioSchaltaktor
Ausgangszustand ist der eingeschaltete Schaltaktor aus dem Lifecycle-1. Dieser soll ausgeschaltet werden. In der Firestore Database Collection ioSchaltaktoren wird der Zustand im Dokument des Schaltaktors auf "ausgeschaltet" gesetzt. Die Änderung am Dokument löst ein Event aus.
HildeIO EventHub
Der EventHub des HildeIO Gateways hat Events in der Firestore Database Collection ioSchaltaktoren abboniert. Mit der Änderung am Dokument wird dem EventHub die aktuelle Version dieses Dokuments bereitgestellt.
HildeIO Schaltaktor-Service
Der Service-Klasse wird das aktuelle Dokument vom EventHub bereitgestellt. Die Konvertierung des Schaltaktor-Dokuments in die Model-Klasse erfolgt in der Serive-Klasse.
HildeIO EventManager
Der EventManager führt die Authentifizierung an der HomeMatic CCU durch. Der Versand des aktuellen Datenobjekts an die JSON-RPC-Methode erfolgt mittels HTTP-Request.
HomeMatic JSON-RPC
Die HomeMatic CCU stellt die JSON-RPC-API zur Verfügung. Um den Schaltaktor auszuschalten ist die Methode Interface.setValue zu verwenden. Die erforderlichen Parameter wurden vom EventManager auf Basis des Schaltaktoren-Models bereitgestellt.
HomeMatic Schaltaktor
Der geänderte Zustand des Schaltaktors wurde über JSON-RPC übermittelt. Der Schaltaktor hat sich ausgeschaltet.
alle verwendeten Produkte enthalten eine Open Source-Lizenz
individuelle Erweiterung der HildeIO-Codebasis
praxisorientierts Tutorial (DE) zur Installation und Konfiguration
plattformunabhängig unter Raspberry OS, Ubuntu und Windows
 
Starte jetzt mit dem HildeIO Gateway
Erstelle Dein HomeMatic IoT-Gateway.
 
Erstelle Dein
IoT-Gateway für die HomeMatic
Mit dem HildeIO Gateway kannst du mit wenigen Codeanpassungen die Zustandsänderungen deiner HomeMatic-Aktoren an Google Firebase übertragen.
Steuere deine HomeMatic-Aktoren aus dem Internet. HildeIO Gateway überträgt die Änderungen in Echtzeit an die HomeMatic CCU.
Tutorial
Developer
 
 
HildeIO Technologie-Stack
APACHE TOMCAT
Das HildeIO Gateway wird auf dem Applikationsserver Apache Tomcat (ab Version 10) ausgeführt.

Für die Entwicklung wird der integrierte Tomcat-Server verwendet.
Version 10
Apache-Lizenz
Community Support
Technische Produktdetails
JAVA SPRING BOOT
Die Codebasis des HildeIO Gateway basiert auf Java Spring Boot. Event-Datenobjekte sind im JSON-Format.

Events werden in Echtzeit an das Zielsysteme übertragen.
Java Runtime
REST-API
Apache-Lizenz
Technische Produktdetails
MARIADB
Das Loggingkonzept enthält Informationen zu den Events, Exceptions und den Datenobjekten.

Der Datenbankserver wird im LAN-Netzwerk betrieben.
Relational
Datatables
GPLv2-Lizenz
Technische Produktdetails
Das HildeIO Gateway unterstützt
die folgenden Betriebssysteme:
 
 
Das HildeIO Ecosystem
Für die Events von der HomeMatic CCU stellt das HildeIO Gateway eine REST-API bereit. Die REST-Services sind eine Referenzimplementierung und können auf individuelle Anforderungen angepasst werden.

Ankommende Events aus der Google Firebase werden dem EventHub bereitgestellt. Das HildeIO Gateway erhält Events von allen abbonierten Firestore Database Collections.
HOMEMATIC CCU
HomeMatic-Programme übertragen bei einem Event das aktuelle Datenobjekt im JSON-Format. Die Übertragung erfolgt über HTTP-Reqeusts.

Änderungen in der Firebase werden der HomeMatic mittels JSON-RPC bereitgestellt.
HILDEIO FRAMEWORK
Das HildeIO Gateway übernimmt die Orchestrierung der Events.

Im Controller-Modul werden die REST-Services für die HomeMatic CCU bereitgestellt.

Im Service-Modul werden die Datenobjekte als Dokument in der Google Firestore Database persistiert.

Dokumentänderungen in der Google Firestore Database werden vom EventHub abboniert. Der HmEventManager überträgt die Änderungen an die HomeMatic CCU.
GOOGLE FIREBASE
Die Dokumente aus dem HildeIO Gateway werden in der Google Firestore Database in der jeweiligen Firestore Collection persistiert.

Jede Firestore Collection wird im Listener des HildeIO Gateway EventHubs registiert. Bei einer Dokumentänderung wird dem EventHub das aktuelle Dokument bereitgestellt.
Weitere Produkte im HildeIO Ecosystem:
Java Spring Boot
Apache Maven
Apache Tomcat 10
MariaDB/MySQL
Swagger/OpenAPI
Google FCM
Apache Webserver
PhpMydmin
 
 
HildeIO Event-Lifecycles
Das HildeIO Gateway unterscheidet zwischen zwei Event-Lifecycles. Beim ersten Lifecycle wird ein Event in der HomeMatic CCU ausgelöst und an die Google Firestore Database übertragen. Im zweiten Lifecycle wird ein Event in einem Dokument in der Google Firestore Database ausgelöst und wird an die HomeMatic CCU übertragen.
Event-Lifecycle 1
Referenzimplementierung: Eine Zustandsänderung am HomeMatic Schaltaktor wird an die Firestore Collection "ioSchaltaktor" übetragen.
HomeMatic Schaltaktor
In dem Referenzbeispiel hat ein Schaltaktor hat den Ausgangszustand "ausgeschaltet". Der Schaltaktor kann vom BidCos oder HomeMaticIP-Aktor sein. Durch das Einschalten des Schaltaktors ändert sich sein Zustand.
HomeMatic Programm
Ein HomeMatic Programm wird durch das Event der Zustandsänderung gestartet. Es ermittelt die aktuellen Werte des Schaltaktors für das Datenobjekt. Das Datenobjekt wird über einen HTTP-Request an den REST-Service des HildeIO Gatways übermittelt.
HildeIO Schaltaktor-API
Das HildeIO Gateway stellt für Schaltaktoren einen REST-Service bereit. Dieser erwartet das neue Datenobjekt des Schaltaktors aus der HomeMatic CCU. Für das Datenobjekt des Schalktators existiert im HildeIO Gateway eine eigene Model-Klasse.
HildeIO Schaltaktor-Service
Die Logik und Datenmanipulation des Schaltaktor-Models erfolgt in der Serive-Klasse. Das finale Schaltaktor-Model wird als Dokument in der Firestore Database Collection persistiert.
Firestore Collection ioSchaltaktor
In der Google Firebase werden die Dokumente in der Firestore Database persistiert. Für jedes Gewerk existiert eine eigene Collection. Schaltaktoren werden in der Collection ioSchalktaktoren gespeichert. Je Schaltaktor gibt es ein Dokument, das bei einer Änderung aktualisiert wird.
Event-Lifecycle 2
Referenzimplementierung: Eine Zustandsänderung in der Firestore Collection "ioSchaltaktor" wird an den HomeMatic Schaltaktor übetragen.
Firestore Collection ioSchaltaktor
Ausgangszustand ist der eingeschaltete Schaltaktor aus dem Lifecycle-1. Dieser soll ausgeschaltet werden. In der Firestore Database Collection ioSchaltaktoren wird der Zustand im Dokument des Schaltaktors auf "ausgeschaltet" gesetzt. Die Änderung am Dokument löst ein Event aus.
HildeIO EventHub
Der EventHub des HildeIO Gateways hat Events in der Firestore Database Collection ioSchaltaktoren abboniert. Mit der Änderung am Dokument wird dem EventHub die aktuelle Version dieses Dokuments bereitgestellt.
HildeIO Schaltaktor-Service
Der Service-Klasse wird das aktuelle Dokument vom EventHub bereitgestellt. Die Konvertierung des Schaltaktor-Dokuments in die Model-Klasse erfolgt in der Serive-Klasse.
HildeIO EventManager
Der EventManager führt die Authentifizierung an der HomeMatic CCU durch. Der Versand des aktuellen Datenobjekts an die JSON-RPC-Methode erfolgt mittels HTTP-Request.
HomeMatic JSON-RPC
Die HomeMatic CCU stellt die JSON-RPC-API zur Verfügung. Um den Schaltaktor auszuschalten ist die Methode Interface.setValue zu verwenden. Die erforderlichen Parameter wurden vom EventManager auf Basis des Schaltaktoren-Models bereitgestellt.
HomeMatic Schaltaktor
Der geänderte Zustand des Schaltaktors wurde über JSON-RPC übermittelt. Der Schaltaktor hat sich ausgeschaltet.
alle verwendeten Produkte
enthalten eine Open Source-Lizenz
individuelle Erweiterung
der HildeIO-Codebasis
praxisorientierts Tutorial (DE)
zur Installation und Konfiguration
plattformunabhängig unter
Raspberry OS, Ubuntu und Windows
 
Starte jetzt mit dem
HildeIO Gateway
Erstelle Dein HomeMatic IoT-Gateway.