Der HomeMatic Treiber ist eine unsichtbare Serverkomponente. Alle HomeMatic Komponenten müssen in der CCU eingelernt und konfiguriert werden.
Voraussetzung für die Verbindung ist die Installation der XML-API in der CCU. Siehe hierzu auch die Homematic-Homepage. Zum Test der Installation , kann über http://<IP-DER-CCU>/config/xmlapi/devicelist.cgi der Abruf getestet werden. In den Systemeinstellungen der Homatic CCU unter Firewall konfigurieren muss die Richtlinie Homatic XML-RPC API auf Vollzugriff gestellt werden.
HomeMatic XML-API V2:
Bei der Version 2 wird zusätzlich zur IP der CCU ein Token benötigt. Dieser steht bei dem Web UI Aufruf in der URL:
Diese SID in den Eigenschaften der Komponente eintragen und ggf (EMPFOHLEN!!!) einen neuen Token generieren lassen. Damit erhält der EisBaer einen eigenen registrierten Token für das System.
Datenpunkte der Komponente
Name |
Typ |
Funktion |
|---|---|---|
Aktualisieren |
Eingang |
Durch ein beliebiges Signal kann eine Aktualisierung der Treiberdatenpunkte ausgelöst werden. |
Diagnose [Text] |
Ausgang |
Hier werden Fehlertexte ausgegeben. Diese können z.B. mit der Komponente "Protokollfenster" angezeigt werden. Achtung: Diagnose oder Debug - Ausgängen sind nur für den Fehlerfall vorgesehen. Bitte nur mit Rücksprache mit dem Supportteam verwenden! Diese können bei Verwendung die Leistung des Dienstes erheblich beeinträchtigen |
Erweiterte Diagnose |
Eingang |
(De)Aktiviert die erweiterte Debug-Ausgabe. Achtung: Diagnose oder Debug - Ausgängen sind nur für den Fehlerfall vorgesehen. Bitte nur mit Rücksprache mit dem Supportteam verwenden! Diese können bei Verwendung die Leistung des Dienstes erheblich beeinträchtigen |
Dynamisch |
Ordner |
In diesem Ordner Befinden sich die importierten Geräte und deren Anschlüsse. |
Systemmeldungen |
Ordner |
Dieser Ordner beinhaltet die Datenpunkte für alle Meldungen und die letzte Meldung. Der Datenpunkt Löschen, entfernt alle Meldungen. |
Treiber An/Aus |
Bidirektional |
(De)Aktivieren der Komponente |
Update läuft |
Ausgang |
Wird ein Update ausgeführt, wird an diesem Datenpunkt ein true ausgegeben. |
Update-Dauer [ms] |
Ausgang |
Ausgabe der letzten Updatedauer in Millisekunden. |
Verbindungsstatus |
Ausgang |
Boolische Ausgabe vom Verbindungsstatus. |
Dynamische Datenpunkte
Für jedes importierte Gerät werden Unterordner mit dem Gerätenamen und deren Datenpunkte angelegt. Systembedingt gibt es (je nach Gerät) mehrere Unterordner pro Gerät:
Ordner 0: beinhaltet gerätespezifische Datenpunkte
Ordner 1: Status-Ausgänge
Ordner 2: Eingänge zum Beschalten/Einstellen
Ordner 3 - x: Spezielle Funktionen wie Grenzwert, Sperrfunktion, etc.
Eigenschaften der Komponente
Name |
Standard |
Funktion |
|---|---|---|
Verbindung |
... |
Einstellung der CCU Verbindung (IP-Adresse) und Port (80). Bei verwendung der Version 2 muss zusätzlich noch der SID Token eingefügt werden. |
Geräte |
0 |
Hier können die eingelernten Geräte importiert werden. |
Programme |
0 |
Wenn selbst angelegte Programme (Szenen) vorhanden sind, können diese hier importiert werden. |
Systemvariablen |
0 |
Wenn selbst angelegte System variablen vorhanden sind, können diese hier importiert werden. |
Abfrage zyklisch - Pause (Systemvariablen) [s] |
1 |
Einstellung für die Pause zwischen den Aktualisierungen. |
Abfrage zyklisch - Pause (Zustände) [s] |
10 |
Einstellung für die Verzögerung zwischen Aktualisierungen für die Systemzustände. (Das kann einige Sekunden dauern) |
Abfrage zyklisch - Pause (zusätzliche Daten) [s] |
10 |
Einstellung für die Verzögerung zwischen Updates für zusätzliche Daten wie Systembenachrichtigung, RSSI und Programmstatus. |
Masterwerte lesen |
|
Aktivieren Sie dieses Kontrollkästchen, wenn Sie alle Masterwerte lesen möchten. Ist dies markiert, können Sie die Masterwerte über "Geräte importieren" importieren (kann einige Sekunden dauern). |
Abfrage zyklisch - Pause (Masterwerte) [s] |
10 |
Einstellung für die Verzögerung zwischen Aktualisierungen der Masterwerte. (Siehe auch die Einstellung unter "Geräte") |
Masterwerte gemeinsam lesen |
|
Aktivieren Sie diese Option, um alle Geräte in einer einzelnen Anforderung zu aktualisieren. Wenn die Anforderung fehlschlägt, deaktivieren Sie diese Option. (Siehe auch die Einstellung unter "Geräte") |
Treiber An/Aus |
|
(De)Aktivieren der Komponente. |