brutella / hkknx-public

hkknx is a HomeKit KNX bridge for KNX.
https://hochgatterer.me/hkknx
103 stars 6 forks source link
homekit knx

hkknx-public

In diesem Repository werden Releases von hkknx veröffentlicht, und über Issues diskutiert.

Was ist hkknx?

hkknx ist eine HomeKit KNX Brücke um KNX Geräte über HomeKit zu steuern. Dabei wird eine direkte IP Verbindung zu einem KNX IP-Gateway aufgebaut. knxd wird nicht benötigt.

hkknx ist als Binärdatei für die verschiedenste Platformen und Betriebssystemen (macOS, linux) verfügbar.

Was ist HomeKit?

HomeKit ist ein Protokoll entwickelt von Apple und wird in verschiedenen Smart Home Geräten unterstützt. Privatsphäre und Verschlüsselung sind voll in dem Standard integriert. Geräte die HomeKit unterstützen können komfortable mit Apple Geräten (iPhone, iPad, Apple Watch, Mac) gesteuert werden.

Warum möchte ich KNX über HomeKit steuern?

Die Steuerung von KNX Geräten über HomeKit ist deshalb so interessant, weil HomeKit so gut in das Apple Ecosystem integriert ist.

Hier ein paar Vorteile.

Was benötige ich um hkknx zu testen?

Um hkknx verwenden zu können, benötigst du

Lade die aktuellste Releaseversion herunter. Entpacke die Datei und lese die Anleitung in der INSTALLATION.md Datei durch.

Ist hkknx kostenlos verfügbar?

~~Während der Betaphase ist hkknx kostenlos verfügbar. Womöglich wird es nach der Betaphase eine kostenpflichtige Version geben.~~

Die Betaphase ist seit 18. Mai 2020 beendet.

Hinweis: Beta-Versionen sind 90 Tage ab Veröffentlichung gültig. Danach muss auf die aktuellste Version geupdated werden.

Benötigt hkknx eine Internetverbindung?

Nein. hkknx hat eine eingebaute Weboberfläche zum Konfigurieren der KNX Brücke. Die Verbindung zu dem KNX IP-Gateway wird über dein lokales Netzwerk hergestellt.

(Zum Installieren von Updates wird jedoch eine Internetverbindung benötigt.)

Muss Multicast im Netzwerk erlaubt sein?

Ja. 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.

Welche Ports müssen offen sein?

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

Releases

Es stehen Packages für macOS, Linux and Raspberry Pi unter Releases zur Verfügung.

Platform Package
M1 Mac hkknx-x.x.x_darwin_arm64
Mac 64-bit hkknx-x.x.x_darwin_amd64
Linux 64-bit hkknx-x.x.x_linux_amd64
Linux 32-bit hkknx-x.x.x_linux_386
Raspberry Pi 32-bit hkknx-x.x.x_linux_arm

Für Docker gibt es auch das offizielle Image brutella/hkknx