Installation

Die Software für die HomeKit Brücke für KNX ist als Binärdatei verfügbar und kann auf allen gängigen Betriebssystemen installiert werden. Die Installation erfolgt entweder über ein vorgefertiges Raspberry Pi Disk Image, der Kommandozeile oder Docker (brutella/hkknx).

Herunterladen

Die Software steht für macOS, und Linux und Raspberry Pi OS unter GitHub → Releases als Download zur Verfügung.

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

Raspberry Pi Image

In dieser Anleitung wird ein vorgefertiges Raspberry Pi Image installiert. Dieses Disk Image beinhaltet eine vorkonfigurierte Installation der Software. Es muss nur noch auf eine SD-Karte kopiert, der Raspberry Pi damit gestartet und über Ethernet mit dem Netzwerk verbunden werden.

Das Disk-Image basiert auf einer abgespeckten Version von Linux – das heißt, es verbraucht weniger Strom, läuft schneller und benötigt weniger Speicherplatz als alle vorherigen Versionen.

Dies bedeutet auch, dass

• SSH nicht verfügbar ist
• WLAN nur über die Weboberfläche unter Einstellungen → Mehr → WLAN-Einstellungen öffnen aktiviert werden kann. Du musst ein Ethernet-Kabel anschließen, um WLAN zu aktivieren. Es wird weiterhin empfohlen, nur Ethernet zu verwenden.

Raspberry Pi Imager

In dieser Anleitung wird der Raspberry Pi Imager verwendet.

Führe folgende Schritte aus um das Disk Image auf die SD-Karte zu kopieren.

1. Aktuelles Disk Image hkknx-{version}_rpi.zip von der Projektseite unter Releases herunterladen und entpacken.
2. Raspberry Pi Imager starten
3. Betriebssystem auswählen
   • Choose OS
   • Use Custom
   • Disk Image auswählen
4. SD-Karte auswählen (Choose Storage) → Next
5. Would you like to apply OS customisation settings? → Nein
6. All existing data on ‘…’ will be erased. Are you sure you want to continue? → Ja
7. Wenn der Kopiervorgang abgeschlossen wurde, die SD-Karte in den Raspberry Pi geben und dann Ethernet-Kabel und Netzteil anschließen.
8. 1 Minuten warten und dann http://hkknx.local:8080 im Browser aufrufen oder die IP-Adresse über den Router/Switch herausfinden und http://{IP-Addresse}:8080 aufrufen.

WLAN

WLAN ist standardmäßig deaktiviert. Um das WLAN zu aktivieren, müssen folgende Schritten ausgeführt werden.

1. Raspberry Pi per Ethernet mit dem Netzwerk verbinden
2. In der Weboberfläche gehe zu Einstellungen → Mehr → WLAN-Einstellungen öffnen
3. Gib die WLAN-Anmeldeinformationen ein und speichere diese

1# /etc/wpa_supplicant/wpa_supplicant.conf
2ctrl_interface=DIR=/var/run/wpa_supplicant GROUP=netdev
3update_config=1
4
5network={
6ssid="<SSID>"
7psk="<Passwort>"
8}

Internetverbindung

Für die Verwendung von hkknx muss die Systemzeit auf dem jeweiligen Computer korrekt sein.

Da der Raspberry Pi nicht über eine Echtzeituhr verfügt, muss die Uhrzeit bei jedem Neutsart mittels NTP aktualisiert werden. Das geschieht automatisch, sobald eine Internetverbindung besteht. Es wird empfohlen den Raspberry Pi vor dem Start über Ethernet mit dem Heimnetzerk zu verbinden. Bei der Verwendung von hkknx auf einem Rasbperry Pi wird daher eine Internetverbindung vorausgesetzt.

Auf anderen Systemen (Linux Server, Mac) wird keine Internetverbindung benötigt, solange die Systemzeit korrekt ist.

Kommandozeile

Bei der Installation über die Kommandozeile, werden die benötigten Dateien manuell heruntergeladen und installiert. Im folgenden Beispiel wird die Software auf einem Mac-Computer mit Apple-Chip über die Kommandozeile installiert.

Lade die aktuellste Version von der Projektseite unter Releases herunter. Im Falle des Macs’s wird das Archiv mit der Endung ..._darwin_arm64.tar.gz heruntergeladen und entpackt.

1wget https://github.com/brutella/hkknx-public/releases/download/3.1.0/hkknx-3.1.0_darwin_arm64.tar.gz
2tar -xzf hkknx-3.1.0_darwin_arm64.tar.gz
3ls
4# INSTALLATION.md  hkknx  hkknx-3.1.0_darwin_arm64.tar.gz

Installation

Nach dem Herunterladen und Entpacken des Archives wird die Datei hkknx mit der Option --db=./database ausgeführt. Die Option db gibt an, in welchem Ordern die Daten gespeichert werden. Zum Testen nehmen wird den Ordern database im aktuellen Arbeitsverzeichnis.

1./hkknx --db=./database

Weitere nützliche Optionen sind

• --port gibt den Port der Weboberfläche an (standardmäßig 8080)
• -–verbose aktiviert die Debug-Ausgaben im Systemprotokoll

Updates

Neuere Versionen der Software können bequem über die Weboberfläche installiert werden. Klicke dazu in der Fußzeile auf die Versionsnummer und wähle “Nach Updates suchen”. Wähle dann eine Version aus und klicke auf “Installieren”.

Kommandozeile

Neben der Weboberfläche können Updates auch über die Kommandozeile heruntergeladen und installiert werden. Welche Version du für dein Betriebssystem benötigst, findest du unter Download.

Die aktuellste Version findest du unter GitHub → Releases.

Im folgenden Beispiel wird eine Version heruntergeladen und entpackt.

1wget https://github.com/brutella/hkknx-public/releases/download/3.1.0/hkknx-3.1.0_darwin_arm64.tar.gz
2tar -xzf hkknx-3.1.0_darwin_arm64.tar.gz
3ls
4# INSTALLATION.md  hkknx  hkknx-3.1.0_darwin_arm64.tar.gz

Nun muss die alte Binärdatei mit der neuen ersetzt werden.

Wenn du nicht weisst, wo sich auf deinem System die alte Binärdatei befindet, dass kannst du das mit dem Befehl which hkknx herausfinden.

Vorabveröffentlichungen

Neben den getesteten Updates, kannst du auch Vorabveröffentlichungen installieren. Diese Versionen enthalten die neuesten Änderungen und Funktionen.