Das Apple HomeKit-Modul ermöglicht die Steuerung von Geräten durch Apple Siri. Dies beinhaltet insbesondere die Sprachsteuerung über HomePods, iPads und iPhones.
Um HomeKit über das Internet außerhalb des eigenen WLANs verwenden zu können ist ein dauerhaft eingeschalteter HomePod oder AppleTV notwendig. Theoretisch kann auch ein dauerhaft eingeschaltetes iPad dazu verwendet werden - dies scheint jedoch aktuell eher zu Problemen zu führen und wird nicht empfohlen.
Um HomeKit korrekt mit Docker verwenden zu können, muss das Netzwerk des Containers im Host-Modus konfiguriert sein. Im standardmäßig ausgewählten Bridge-Modus hat der Container ansonsten keine korrekt im internen Netzwerk erreichbare IP-Adresse (sondern nur eine hinter dem Docker NAT) und somit werden die notwendigen Bonjour/DNS-SD Pakete nicht empfangen. Soll IP-Symcon mit Docker auf Synology/QNAP verwendet werden, so ist zusätzlich darauf zu achten, dass Bonjour/DNS-SD auf dem NAS deaktiviert ist, sodass der notwendige Port für den Docker Container zur Verfügung steht.
Damit das Apple HomeKit-Modul verwendet werden kann, muss es zuerst über das Module Control installiert werden. Hierfür muss das Module Control geöffnet werden. Dies befindet sich unter der Hauptkategorie "Kern Instanzen" im Objektbaum oder kann direkt über das Widget "Aktualisierungen" geöffnet werden. Zur Installation im Module Control den Hinzufügen-Button unten rechts betätigen. Im sich öffnenden Dialog die URL https://github.com/paresy/HomeKit eingeben und mit "OK" bestätigen.
Als nächstes eine Instanz vom Apple HomeKit-Modul erstellen. Zuerst den Objektbaum öffnen. Hier den Hinzufügen-Button unten rechts betätigen und Instanz auswählen.
In der Modulliste das Gerät "HomeKit Bridge" vom Hersteller "Apple" auswählen. Der Ort sollte nicht verändert werden, der Name kann beliebig gewählt werden. Abschließend mit "OK" bestätigen.
Im folgenden Dialog muss der Schalter auf Aktiv umgestellt und ebenfalls mit "OK" bestätigt werden.
Nach der Erstellung der Apple HomeKit-Instanz öffnet sich diese automatisch und kann eingerichtet werden.
Das Modul bietet verschiedene Gerätetypen an, welche verwendet werden können. Um ein entsprechendes Gerät einzurichten, wird das dazugehörige Panel ausgeklappt und in der entsprechenden Liste durch einen Klick auf "Hinzufügen" ein neuer Eintrag erstellt.
Jeder Eintrag erfordert einen Namen unter welchem das Gerät bei Apple HomeKit bekannt sein wird. Weitere Parameter hängen vom jeweiligen Gerätetyp ab und können den dazugehörigen Seiten der Dokumentation entnommen werden. Nachdem alle Parameter gesetzt sind, wird das Gerät mit "OK" bestätigt.
- Lampe (Schaltbar)
- Lampe (Dimmbar)
- Lampe (Farbig)
- Lampe (Experte)
- Bewegungsmelder
- Fenster (Position)
- Fenster (Hoch/Runter)
- Feuchtigkeitssensor
- Lüfter
- Garagentor
- Helligkeitssensor
- Kontaktsensor
- Kohlendioxid Sensor
- Kohlenmonoxid Sensor
- Lautsprecher
- Leckagesensor
- Luftgütesensor
- Rauchmelder
- Rollladen/Jalousie (Position)
- Rollladen/Jalousie (Hoch/Runter)
- Schloss
- Temperatursensor
- Thermostat
- Zwischenstecker
- Expertenoptionen
- Sicherheitssystem
- Zustandsloser programmierbarer Schalter
Nachdem alle Geräte eingerichtet sind, werden diese mit einem Klick auf "Änderungen übernehmen" bestätigt.
Nach dem Übernehmen sollte sichergestellt werden, dass bei allen Geräten "OK" in der Spalte "Status" steht. Ist dies nicht der Fall, so enthält die Spalte eine Fehlermeldung, welche über die Komplikation informiert.
Abschließend muss IP-Symcon noch mit Apple HomeKit verknüpft werden, damit die eingerichteten Geräte in in HomeKit verfügbar sind. Hierfür muss IP-Symcon als HomeKit Bridge in der Home-App hinzugefügt werden. Dazu in der Home-App den "Hinzufügen" Button drücken.
Tipp: Wenn Ihr z.B. ein Ferienhaus besitzt, könnte Ihr in der Home-App auch weitere Häuser hinzufügen
Bitte "Code fehlt bzw. kann nicht gescannt werden?" auswählen.
Im folgenden Dialog sollte bei "Geräte in der Nähe" ein Eintrag "Symcon" erscheinen. Diesen anklicken, um mit der Einrichtung fortzufahren.
Tipp: Erscheint das Gerät nicht so sollten die Firewall Einstellung geprüft werden. Außerdem muss die Einrichtung im selben WLAN wie der IP-Symcon Server geschehen. Sofern Docker verwendet wird muss der Host-Modus genutzt werden. Aktuell scheint es insbesondere auf Synology NAS Probleme bei der Einrichtung zu geben.
Die Abfrage "Nicht zertifiziertes Gerät" muss mit "Trotzdem hinzufügen" bestätigt werden.
Der notwendige Code kann in der Konfiguration der HomeKit-Bridge Instanz angefordert werden. Der dann angezeigte Code kann in der Home-App eingegeben werden.
Den Raum der Bridge auswählen und mit "Weiter" fortfahren.
Namen ggf. ändern und mit "Weiter" bestätigen.
Mit "Weiter" die Einrichtung der Bridge bestätigen.
Mit "Weiter" bestätigen, um das Licht hinzuzufügen.
Den Raum des Lichts auswählen und mit "Weiter" fortfahren.
Namen ggf. ändern und mit "Weiter" bestätigen.
Mit "Fertig" die Einrichtung abschließen.
In der Home-App sind nun einige der eingerichteten Geräte sichtbar. Der Rest wird standardmäßig im Standardraum angezeigt.
