Konfiguration

Die Konfiguration der HomeKit Brücke für KNX erfolgt über die eingebaute Weboberfläche. Diese ist unter der IP Adresse oder dem Hostnamen des Computers, und Port 8080 erreichbar.

Im Falle des vorgefertigen Raspberry Pi Disk Images ist die Weboberfläche unter http://hkknx.local:8080 erreichbar.

Projekt erstellen

Als ersten Schritt ist es erforderlich ein Projekt zu erstellen. Es wird empfohlen dazu ein ETS Projekt zu importieren, welches für die Parameterierung der KNX Geräte verwendet wurde.

Bei jedem Import werden die Gruppenadressen, Kommunikationsobjekte und Geräte aus dem ETS Projekts lokal gespeichert. Wenn ein ETS Projekt gelöscht wird, werden alle Gruppenadressen, Kommunikationsobjekte und Geräte aus diesem Projekt gelöscht.

Wenn ein ETS Projekt zweimal importiert wird, werden alle Objekte auch zweimal gespeichert. Es enstehen daher Duplikate – zB eine Gruppenadresse taucht zweimal auf. Wird eines der beiden Projekte wieder gelöscht, bleiben die Gruppenadressen des anderen Projekts bestehen.

HomeKit Geräte werden beim Löschen eines ETS Projekts nicht verändert – alle Referenzen zu den Gruppenadressen bleiben bestehen.

KNX Verbindung

Unter Einstellungen wird die Verbindung zu KNX konfiguriert. Die HomeKit Brücke für KNX baut eine IP-Tunneling Verbindung zu der KNX Installation auf. Dafür wird ein KNXnet/IP Gateway benötigt.

Standardmäßig wird die IP-Adresse des Gateway automatisch ermittelt. Falls dies aus irgendwelchen Gründen nicht möglich ist, kann die IP-Adresse des Gateways auch festgelegt werden.

Mit einem Klick auf Verbindung überprüfen kann der Verbindungsstatus ermittelt werden.

Netzwerkanforderungen

Damit die HomeKit Brücke eine Verbindung mit HomeKit aufbauen kann, muss Multicast (für mDNS) im Netzwerk erlaubt sein. Verwendet werden dafür die Multicast Adressen 224.0.0.251 (IPv4) und ff02::fb (IPv6), sowie Port 5353.

Multicast wird außerdem noch für die Automatische Suche des KNX IP Gateways benötigt. Dafür wird die Multicast Adresse 224.0.23.12 und Port 3671 verwendet.

Das Netzwerk muss IPv4 Adressen unterstützen. HomeKit funktioniert mit IPv6-only Netzwerken nicht.

Ports

Es werden die Ports 5353 und 3671 für Multicast Anfragen verwendet. Falls nicht weiters in den Einstellungen konfiguriert, kommuniziert die Brücke mit HomeKit auf einem zufälligen Port. Dieser Port kann aber in den Einstellungen festgelegt werden.

Secure Tunneling

Seit Version 2.4 wird KNX Secure Tunneling unterstützt um eine sichere Verbindung zwischen der HomeKit Brücke und dem KNX Gateways aufzubauen. Dazu muss Secure Tunneling über die ETS konfiguriert werden und eine kompatibles KNX Gateway zur Verfügung stehen.

In der HomeKit Brücke unter Einstellungen → KNX Gateway → Sichere Verbindung werden die Verbindungsdaten angegeben.

Authentifizierungscode

Der Authentifizierungscode findet man in der ETS unter den Eigenschaften des KNX IP Gateways.

Kanal & Passwort

KNX Gateways stellen ein oder mehrere Secure Tunnel-Verbindungen zur Verfügung. Jedem Kanal ist eine Nummer und ein Passwort zugewiesen. Die Passwörter findest du in der ETS unter den Details des KNX Gateways.

Bei einem MDT IP Interface mit Secure sieht das so aus.

Wählt man einen Kanal aus, sieht man in den Eigenschaften das dazugehörige Passwort.

HomeKit Verbindung

KNX

 

Um die Geräte über HomeKit zu steuern, muss die Brücke zu HomeKit hinzugefügt werden. Dazu muss die Option “Brücke aktivieren” unter Einstellungen aktiv sein.

Außerdem ist es notwendig, dass eine Verbindung zu dem KNX IP-Gateway besteht. Solange keine Verbindung besteht, ist die Brücke für HomeKit nicht verfügbar.

Mit der Home-App kann die Brücke wie folgt zu HomeKit hinzugefügt werden.

1. Home-App öffen
2. antippen
3. Gerät hinzufügen
4. QR-Code scannen oder Pin eingeben (siehe Einstellungen → HomeKit Brücke)

Gibt es Verbindungsprobleme?

Passwortschutz

Unter Einstellungen → Passwortschutz kann der Zugriff auf die die Weboberfläche mit einem Passwort geschützt werden. Dieses Passwort wird verschlüsselt in der lokalen Datenbank gespeichert.

Sperrnachricht festlegen

Die Sperrnachricht wird angezeigt, wenn der Benutzer aufgefordert wird das Passwort einzugeben. Für die Formatierung kann die Markdown-Schreibweise verwendet werden. Somit können auch Links und Bilder ganz einfach in der Sperrnachricht eingebettet werden.

Hier ein Beispiel einer Sperrnachricht.

1**Zugriff nicht erlaubt**
2
3Dieses Projekt ist mit einem Passwort geschützt. Gib ein Passwort ein um fortzufahren.
4
5---
6
7Bei Problemen bitte Herrn Hochgatterer unter [+43 660 1234567](tel:+436601234567) anrufen oder eine E-Mail an [hkknx@hochgatterer.me](mailto:hkknx@hochgatterer.me) senden.

Diese Nachricht wird bei der Passworteingabe wie folgt dargestellt.

Datensicherung

Nachdem die Bücke in Betrieb genommen wurde, ist es sinnvoll eine Datensicherung zu erstellen. Eine Datensicherung enthält alle Einstellungen und Geräte der Brücke in einer .backup Datei. Bei einem Datenverlust kann eine Datensicherung wieder importiert werden. Dadurch werden alle Einstellungen und Geräte wiederhergestellt.

Um eine Datensicherung zu erstellen, gehe zu Einstellungen → Mehr → Datensicherung erstellen. Zum Wiederherstellen einer Datensicherung wähle “Datensicherung importieren…”.

Lizenz

Um die Software im vollen Umfang nutzen zu können, muss in der Weboberfläche unter Einstellungen → Lizenz eine Lizenz gekauft werden. Nach erfolgreichem Kauf wird ein Lizenzschlüssel generiert, der nur auf einem Computer verwendet werden kann.

Eine Lizenz kostet aktuell € 299.

Wenn du eine Lizenz auf einem anderen Computer übertragen möchtest, musst du die Lizenz vorher über die Weboberfläche entfernen.

Die Eingabe des Lizenzschlüssel erfolgt dann über die Weboberfläche unter Einstellungen → Lizenz → Lizenz eingeben.

Ist beim Kauf ein Fehler aufgetreten? Hilfe →