Homekit

RedMatic HomeKit

Bitte einen Issue anlegen falls ein Gerät nicht unterstützt wird und gewünscht ist. Die bereits unterstützen Geräte sind hier ersichtlich: https://github.com/hobbyquaker/RedMatic-HomeKit/tree/master/homematic-devices

Inhalt

• Einrichtung
• Nutzungshinweise
• Homematic Fernbedienungen/Tasten in HomeKit nutzen
• Sytemvariablen
• CCU Programme starten
• Universelles Accessory, Einbinden von nicht-Homematic Geräten
• HomeKit Reset

Einrichtung

Den Node RedMatic HomeKit - Homematic per Drag&Drop einem Flow hinzufügen

Die Konfiguration des neu hinzugefügten Node per Doppelklick öffnen, den Button mit dem Bleistift-Icon anklicken um eine neue Bridge hinzuzufügen

Die Standardeinstellungen können beibehalten werden, mit einem Klick auf den Button Add wird die Bridge angelegt

Die Konfiguration des RedMatic HomeKit - Homematic mit klick auf Done verlassen und dann den Button Deploy anklicken

Nochmals die Konfiguration des RedMatic HomeKit - Homematic Node per Doppelklick öffnen und nochmal über den Bleistift-Button die Bridge-Konfiguration öffnen

Bei einer erfolgreich aktivierten Bridge wird in dem Bridge Konfigurationsdialog nun ein QR-Code angezeigt

In der Home App oben rechts über den Plus-Button ein neues Gerät hinzufügen, den QR-Code vom Bildschirm abscannen

Die Sicherheitswarnung bestätigen

Nun sollten alle unterstützen Geräte der CCU in der Home App erscheinen.

Nutzungshinweise

Nicht alle Änderungen an den in HomeKit bereitgestellten Accessories werden bei einem Deploy in Node-RED übernommen. Bestimmte Änderungen erfordern nach dem Deploy einen Neustart von RedMatic:

• Entfernen von Geräten
• Umbenennen von Geräten
• Konfigurationsänderung an Geräten (z.B. entfernen des Boost Switch bei Thermostaten)
• Ändern der Anzahl der Tasten des Event Nodes
• Die konfigurierten Services eines "Universellen Accessory" ändern

Tasten

Zum Auslösen von Aktionen in HomeKit über Homematic Fernbedienungen/Taster kann der Node RedMatic HomeKit - Event genutzt werden. Er erwartet an seinem Eingang eine Message die in msg.topic die zu drückende Taste und die Art des Tastendrucks (kurz/lang) enthält, z.B. 1/PRESS_LONG für einen langen Tastendruck auf Taste 1. Dieses Topic kann direkt vom RPC Event Node erzeugt werden in dem man die Topic-Konfiguration auf ${channelIndex}/${datapoint} setzt und den Datenpunkt mit dem regulären Ausdruck PRESS_SHORT|PRESS_LONG filtert:

Sytemvariablen

(Boolsche) Systemvariablen können über den Redmatic HomeKit - Switch Node in HomeKit bereitgestellt werden. Hierzu werden die Ein- und Ausgänge eines CCU Sysvar Nodes über kreuz mit dem Redmatic HomeKit - Switch Node verbunden

Programme

Leider werden bisher von der Home App und Siri keine Taster unterstützt die einen Einmaligen Event erzeugen. Als Workaround steht mit dem redmatic homekit - button Node ein Schalter zur Verfügung der sich automatisch nach dem Anschalten zurücksetzt und so als "Pseudobutton" genutzt werden kann.

Dieser kann einfach mit einem ccu - program Node verbunden werden, als Payload wird timestamp ausgewählt:

Universal Accessory

Mit dem Universal Accessory ist es möglich beliebige HomeKit-Geräte zu erzeugen, z.B. um damit auch Geräte abseits von Homematic einzubinden.

Dem Accessory können beliebig viele Services hinzugefügt werden.

Verfügbare Services sowie die dafür benötigten und optionalen Characteristiken sind in dieser Datei ersichtlich: https://github.com/KhaosT/HAP-NodeJS/blob/master/lib/gen/HomeKitTypes.js

Um eine Characteristic anzulegen müssen dem Accessory beim Start Messages gesendet werden. Siehe dazu auch https://github.com/HM-RedMatic/RedMatic-HomeKit/issues/44

Beispiel:

Es soll ein Accessory mit einem ContactSensor Service angelegt werden. Die 0 vor dem Service gibt den "Subtype" an, dieser wird später benötigt um diesen Service anzusprechen.

Aus https://github.com/KhaosT/HAP-NodeJS/blob/master/lib/gen/HomeKitTypes.js ist ersichtlich dass der Service ContactSensor eine Charakteristik ContactSensorState benötigt:

In der Definition dieser Charakteristik ist ersichtlich dass diese den Wert 0 annehmen muss um einen geschlossenen Kontakt zu signalisieren und den Wert 1 um einen offenen Kontakt zu melden:

Um nun einen geschlossenen Kontakt zu melden muss dem Node ein Message geschickt werden deren msg.topic Eigenschaft sich durch den "Subtype" (siehe oben) und den Namen der Characteristik zusammensetzt: 0/ContactSensorState. msg.payload muss in diesem Fall auf die Number 0 gesetzt werden. Um diese beiden Eigenschaften der Nachricht zu setzen kann ein Change Node genutzt werden:

Flow JSON

[{"id":"f3c1ee32.c1bdf","type":"redmatic-homekit-universal","z":"e679be4e.ea888","bridgeConfig":"505f657d.84710c","name":"ContactSensor","services":[{"subtype":"0","service":"ContactSensor","name":"Test"}],"x":580,"y":240,"wires":[[]]},{"id":"26ae9d08.5d6242","type":"change","z":"e679be4e.ea888","name":"CONTACT_DETECTED","rules":[{"t":"set","p":"payload","pt":"msg","to":"0","tot":"num"},{"t":"set","p":"topic","pt":"msg","to":"0/ContactSensorState","tot":"str"}],"action":"","property":"","from":"","to":"","reg":false,"x":340,"y":220,"wires":[["f3c1ee32.c1bdf","55fcb00d.f7a66"]]},{"id":"70eea6a6.faf3f8","type":"change","z":"e679be4e.ea888","name":"CONTACT_NOT_DETECTED","rules":[{"t":"set","p":"payload","pt":"msg","to":"1","tot":"num"},{"t":"set","p":"topic","pt":"msg","to":"0/ContactSensorState","tot":"str"}],"action":"","property":"","from":"","to":"","reg":false,"x":320,"y":260,"wires":[["f3c1ee32.c1bdf","55fcb00d.f7a66"]]},{"id":"92689c97.a698c","type":"inject","z":"e679be4e.ea888","name":"","topic":"","payload":"","payloadType":"date","repeat":"","crontab":"","once":false,"onceDelay":0.1,"x":100,"y":220,"wires":[["26ae9d08.5d6242"]]},{"id":"7cbf7fe8.59d9","type":"inject","z":"e679be4e.ea888","name":"","topic":"","payload":"","payloadType":"date","repeat":"","crontab":"","once":false,"onceDelay":0.1,"x":100,"y":260,"wires":[["70eea6a6.faf3f8"]]},{"id":"55fcb00d.f7a66","type":"debug","z":"e679be4e.ea888","name":"","active":true,"tosidebar":true,"console":false,"tostatus":false,"complete":"true","x":560,"y":320,"wires":[]},{"id":"505f657d.84710c","type":"redmatic-homekit-bridge","z":"","name":"RedMatic Test Bridge","username":"CC:22:3D:00:F6:05","pincode":"964-84-514","port":"51826"}]

Reset

Um die Bridge im Fall von schwerwiegenden Problemen ("sollte" nicht passieren, aber man weiss ja nie 😉) komplett zurückzusetzen kann wie folgt vorgegangen werden:

• Bridge in iOS Home App löschen
• RedMatic stoppen
• Auf der CCU das Verzeichnis /usr/local/addons/redmatic/var/homekit mitsamt Inhalt löschen
• RedMatic starten

Hierbei gehen alle Raum-Zuordnungen sowie Umbenennungen in HomeKit verloren!