|
|
|
# Installation und Anbindung von RaspberryMatic / Homematic CCU3
|
|
|
|
|
|
|
|
Eine umfassende Anleitung zur Installation und Konfiguration von IOBroker-Adaptern für die
|
|
|
|
Anbindung einer existierenden RaspberryMatic oder HomeMatic CCU3-Installation besteht aus
|
|
|
|
mehreren Schritten. Diese Anleitung führt Sie durch den Prozess der Installation der
|
|
|
|
notwendigen Adapter "hm-rega" und "hm-rpc" und deren Konfiguration.
|
|
|
|
|
|
|
|
## Voraussetzungen
|
|
|
|
- Eine laufende IOBroker-Installation
|
|
|
|
- Zugang zur IOBroker-Weboberfläche
|
|
|
|
- Eine funktionierende RaspberryMatic oder HomeMatic CCU3-Installation
|
|
|
|
|
|
|
|
## Vorwort zu den Adaptern `hm-rega` und `hm-rpc`
|
|
|
|
|
|
|
|
Die Adapters hm-rega und hm-rpc in ioBroker dienen zur Integration von HomeMatic- und
|
|
|
|
Homematic IP-Geräten in das ioBroker-System, unterscheiden sich jedoch grundlegend in ihrer
|
|
|
|
Funktionsweise und ihrem Einsatzbereich. Hier sind die Hauptunterschiede zwischen den beiden:
|
|
|
|
|
|
|
|
### `hm-rpc` Adapter
|
|
|
|
- **Funktion:** Der hm-rpc Adapter (Remote Procedure Call) dient der direkten Kommunikation
|
|
|
|
mit den HomeMatic- und Homematic IP-Geräten über die CCU (Central Control Unit) bzw.
|
|
|
|
RaspberryMatic. Er ist verantwortlich für das Senden von Befehlen an die Geräte (z.B. Ein-
|
|
|
|
/Ausschalten, Temperatur einstellen) und das Empfangen von Statusupdates von diesen Geräten.
|
|
|
|
- **Kommunikation:** Nutzt die RPC-Schnittstelle (Remote Procedure Call) für die Kommunikation
|
|
|
|
mit der CCU. Es gibt verschiedene Varianten der RPC-Schnittstelle (Bin-RPC, XML-RPC), die je
|
|
|
|
nach Typ der Geräte (RF, Wired, IP) und der verwendeten CCU-Version ausgewählt werden können.
|
|
|
|
- **Anwendungsbereich:** Der Adapter ist hauptsächlich für die Steuerung und Überwachung von
|
|
|
|
Gerätefunktionen gedacht. Er ist unerlässlich, wenn direkte Interaktionen mit den Geräten
|
|
|
|
erforderlich sind.
|
|
|
|
|
|
|
|
### `hm-rega` Adapter
|
|
|
|
- **Funktion:** Der hm-rega Adapter dient der Kommunikation mit der CCU auf einer höheren
|
|
|
|
Ebene durch die Nutzung der ReGaHSS (HomeMatic Script Engine). Er wird hauptsächlich verwendet,
|
|
|
|
um Logikverknüpfungen, Systemvariablen, Programme und andere in der CCU definierte Einstellungen zu lesen und zu steuern.
|
|
|
|
- **Kommunikation:** Nutzt die ReGaHSS Script Engine der CCU für die Kommunikation. Dies
|
|
|
|
ermöglicht es dem Adapter, auf eine Vielzahl von Konfigurationen und Informationen zuzugreifen,
|
|
|
|
die nicht direkt über die RPC-Schnittstelle verfügbar sind.
|
|
|
|
- **Anwendungsbereich:** Der Adapter ist vor allem für die Integration von Systemvariablen,
|
|
|
|
Programmen und anderen in der CCU definierten Einstellungen in ioBroker gedacht. Er ermöglicht die Nutzung dieser Elemente für erweiterte Automatisierungsszenarien innerhalb von ioBroker.
|
|
|
|
|
|
|
|
### Zusammenfassung
|
|
|
|
- **`hm-rpc`:** Direkte Kommunikation mit Geräten für die Steuerung und den Statusabgleich.
|
|
|
|
- **`hm-rega`:** Zugriff auf Systemvariablen, Programme und Logikverknüpfungen in der CCU für
|
|
|
|
erweiterte Automatisierungsmöglichkeiten.
|
|
|
|
|
|
|
|
Beide Adapter ergänzen sich in einem HomeMatic-basierten Smart Home System, indem sie
|
|
|
|
unterschiedliche Aspekte der Geräte- und Systemintegration in ioBroker abdecken. Für eine
|
|
|
|
umfassende Integration einer HomeMatic- oder Homematic IP-Umgebung in ioBroker ist in der
|
|
|
|
Regel die Verwendung beider Adapter erforderlich.
|
|
|
|
|
|
|
|
## Anleitung
|
|
|
|
|
|
|
|
### Schritt 1: Installation der `hm-rpc` und `hm-rega` Adapter
|
|
|
|
1. Öffnen Sie die IOBroker-Weboberfläche in Ihrem Browser.
|
|
|
|
2. Gehen Sie zum Bereich "Adapter", der sich in der Seitenleiste befindet.
|
|
|
|
3. Geben Sie in das Suchfeld "HomeMatic" ein und drücken Sie die Enter-Taste.
|
|
|
|
4. Klicken Sie auf das "+"-Symbol neben dem `hm-rpc` und `hm-rega` Adapter, um die Installation zu starten.
|
|
|
|
5. _Optional: Der `hm-rpc`-Adapter muss dabei je nach angeschlossenen Geräten an die CCU bis zu
|
|
|
|
zwei Mal als einzelne Instanz installiert werden. Ein Adapter kann mehrfach installiert werden,
|
|
|
|
jede Installation nennt man Instanz. Das hat den Hintergrund, dass einige Geräte von HomeMatic
|
|
|
|
über verschiedene Ports und Protokolle erreichbar sind. Dazu mehr in Schritt 2._
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
### Schritt 2: Konfiguration der `hm-rpc` Adapter
|
|
|
|
Nach der Installation der "hm-rpc" Adapter müssen Sie diese konfigurieren,
|
|
|
|
um eine Verbindung zu Ihrer HomeMatic CCU herzustellen. Wenn sich das Konfigurationsfenster
|
|
|
|
nicht selbstständig öffnet, dann wechseln Sie zum Tab "Instanzen".
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
1. Klicken Sie auf das Konfigurationssymbol mit dem Schraubenschlüssel, um die Einstellungen
|
|
|
|
des Adapters zu setzen.
|
|
|
|
2. Wählen Sie den Kommunikationstyp, der zu Ihrer Installation passt (meistens "XML-RPC"
|
|
|
|
oder "Bin-RPC").
|
|
|
|
3. Geben Sie die IP-Adresse oder Hostname Ihrer RaspberryMatic oder HomeMatic CCU3 ein.
|
|
|
|
4. Stellen Sie sicher, dass der Daemon richtig ausgewählt ist (z.B. "HM-RF" für Funkkomponenten
|
|
|
|
oder "HM-IP" für Homematic IP Komponenten). Wenn an der CCU beide Arten von Funkkomponenten
|
|
|
|
angeschlossen sind, muss dafür die zweite Adapterinstanz konfiguriert werden.
|
|
|
|
5. Aktivieren Sie das Häkchen bei "Geräte neu einlesen (einmalig)", wenn Sie entweder diesen
|
|
|
|
Adapter das erste Mal konfigurieren oder seit der letzten Installation ein neues Gerät zu
|
|
|
|
HomeMatic hinzugefügt haben.
|
|
|
|
|
|
|
|
6. Wechsel zu "Zusätzliche Einstellungen", um die Callback Adresse zu konfigurieren.
|
|
|
|
Die "Adapter Callback Adresse" ist die IP-Adresse oder Hostname des IOBrokers, bzw. der
|
|
|
|
IOBroker Node, auf dem diese `hm-rpc`-Instanz installiert ist. Achtung: Befindet sich der
|
|
|
|
IOBroker in einem Docker-Container, der nicht direkt im Hostnetzwerk hängt, muss auf das
|
|
|
|
Routing geachtet werden.
|
|
|
|
|
|
|
|
7. Klicken Sie auf "Speichern und Schließen".
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
### Schritt 3: Installation des hm-rega Adapters
|
|
|
|
1. Wiederholen Sie den Vorgang wie bei der Installation des "hm-rpc" Adapters, suchen Sie diesmal jedoch nach "hm-rega" und installieren Sie diesen Adapter.
|
|
|
|
|
|
|
|
*(Platz für Bild: Installation des hm-rega Adapters in IOBroker)*
|
|
|
|
|
|
|
|
### Schritt 4: Konfiguration des hm-rega Adapters
|
|
|
|
Auch der "hm-rega" Adapter muss nach der Installation konfiguriert werden, um die Verbindung zur CCU herzustellen.
|
|
|
|
1. Öffnen Sie die Konfiguration des "hm-rega" Adapters über das Schraubenschlüssel-Symbol in den Instanzen.
|
|
|
|
2. Geben Sie die IP-Adresse Ihrer RaspberryMatic oder HomeMatic CCU3 ein.
|
|
|
|
3. Wählen Sie, ob Sie SSL verwenden möchten (abhängig von Ihrer CCU-Konfiguration).
|
|
|
|
4. Geben Sie bei Bedarf Benutzername und Passwort ein, falls Ihre CCU mit Authentifizierung konfiguriert ist.
|
|
|
|
5. Klicken Sie auf "Speichern und Schließen".
|
|
|
|
|
|
|
|
*(Platz für Bild: Konfiguration des hm-rega Adapters in IOBroker)*
|
|
|
|
|
|
|
|
### Schritt 5: Geräte in IOBroker übernehmen
|
|
|
|
Nach der erfolgreichen Konfiguration der Adapter sollten Ihre Geräte automatisch in IOBroker erscheinen. Überprüfen Sie die Geräteliste und Objekte, um sicherzustellen, dass alles korrekt importiert wurde.
|
|
|
|
|
|
|
|
### Schritt 6: Überprüfung der Funktion
|
|
|
|
1. Testen Sie einige Geräte durch Schalten von Funktionen direkt aus IOBroker heraus, um sicherzustellen, dass die Kommunikation mit der CCU funktioniert.
|
|
|
|
2. Überprüfen Sie das Log auf eventuelle Fehlermeldungen und beheben Sie diese gegebenenfalls.
|
|
|
|
|
|
|
|
## Abschluss
|
|
|
|
Nachdem Sie diese Schritte durchgeführt haben, ist die Anbindung Ihrer RaspberryMatic oder HomeMatic CCU3 an IOBroker erfolgreich abgeschlossen. Sie können nun die umfangreichen Automatisierungsfunktionen von IOBroker nutzen, um Ihr Smart Home noch intelligenter zu gestalten. |
|
|
\ No newline at end of file |
