Fertigstellung: Anleitung Installation HomeMatic Adapter authored by Ulf Tietze's avatar Ulf Tietze
......@@ -31,12 +31,14 @@ 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.
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.
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.
......@@ -54,7 +56,8 @@ Regel die Verwendung beider Adapter erforderlich.
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.
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
......@@ -65,7 +68,12 @@ jede Installation nennt man Instanz. Das hat den Hintergrund, dass einige Gerät
### 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".
nicht selbstständig öffnet, dann wechseln Sie zum Tab "Instanzen". Lassen Sie sich nicht von
der Nummerierung hinter den Adapterinstanzen verunsichern. Diese werden je nach Instanz
inkrementiert. Auf dem System, auf dem die Screenshots erstellt wurden, wurde eine initiale
`hm-rpc` Instanz installiert um im Anschluss wieder geklöscht. Das verursacht den folgenden
Screenshot, auf dem gut zu erkennen ist, dass die `hm-rpc` Nummerierung erst mit der Nummer
`hm-rpc.2` beginnt.
![Screenshot 2024-02-04 at 19.43.58.png](Bilder%2FAnbindungHomeMatic%2FScreenshot%202024-02-04%20at%2019.43.58.png)
......@@ -77,11 +85,10 @@ oder "Bin-RPC").
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
5. (Optional) 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.
![Screenshot 2024-02-04 at 20.02.46.png](Bilder%2FAnbindungHomeMatic%2FScreenshot%202024-02-04%20at%2020.02.46.png)
![Screenshot 2024-02-04 at 20.20.53.png](..%2F..%2F..%2F..%2F..%2F..%2Fvar%2Ffolders%2F38%2Frfcqjr4s6h1glzmc33l_90w00000gn%2FT%2FTemporaryItems%2FNSIRD_screencaptureui_vqkAaW%2FScreenshot%202024-02-04%20at%2020.20.53.png)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
......@@ -92,26 +99,36 @@ Routing geachtet werden.
### 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.
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)*
![Screenshot 2024-02-01 at 13.49.18.png](Bilder%2FAnbindungHomeMatic%2FScreenshot%202024-02-01%20at%2013.49.18.png)
### 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.
2. Geben Sie die IP-Adresse Ihrer RaspberryMatic oder HomeMatic CCU3 ein.![Screenshot 2024-02-01 at 14.00.04.png](Bilder%2FAnbindungHomeMatic%2FScreenshot%202024-02-01%20at%2014.00.04.png)
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)*
5. Klicken Sie auf "Speichern und Schließen". ![Screenshot 2024-02-01 at 14.00.14.png](Bilder%2FAnbindungHomeMatic%2FScreenshot%202024-02-01%20at%2014.00.14.png)
### 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.
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.
![Screenshot 2024-02-01 at 14.01.48.png](Bilder%2FAnbindungHomeMatic%2FScreenshot%202024-02-01%20at%2014.01.48.png)
### 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.
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.
![Screenshot 2024-02-01 at 14.02.29.png](Bilder%2FAnbindungHomeMatic%2FScreenshot%202024-02-01%20at%2014.02.29.png)
## 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
Nachdem Sie diese Schritte durchgeführt haben, ist die Anbindung Ihrer RaspberryMatic oder
HomeMatic CCU3 an IOBroker erfolgreich abgeschlossen. Basierend auf der
Adapter-Instanzkonfiguration und den entsprechend angelegten Objekte in der Datenbank können
jetzt verschiedene Algorithmen oder Dashboards verknüpft werden. Der Adapter selbst sorgt dafür,
dass die Daten über die verschiedenen Systeme synchronisiert werden - sei es HomeMaticIP oder
RasperryMatic.
\ No newline at end of file