Installation der OpenKNX Tools - OpenKNX/OpenKNX GitHub Wiki
Hintergrund
OpenKNX liefert Firmware-Pakete aus, welche über einfache Skripte gebaut und hochgeladen werden können. Diese Skripte werden durch die OpenKNX-Tools unterstützt, die lediglich einmalig installiert werden müssen. Manchmal ist ein Update erforderlich. Diese Seite beschreibt den Installations- und Updateprozess.
Voraussetzung
OpenKNX benutzt PowerShell-Skripte für die Installation der Tools, die Erzeugung von knxprod-Dateien und den Upload der Firmware-Pakete zu der Hardware. Dafür sollte die Ausführung von PowerShell-Skripten in Windows aktiviert sein.
Der einfachste Weg dafür geht in Windows 7/8 über Start-Menü -> Einstellungen -> Update & Sicherheit -> für Entwickler (der letzte Eintrag auf der Seite):
In Windows 10/11 kann man in der der Einstellungen-App nach "PowerShell" suchen, was einen recht schnell zur selben Option bringt.
Ein anderer Weg ist Windows PowerShell mit Administratorrechten zu öffnen. Die aktuelle Einstellung kann mit folgendem Befehl überprüft werden:
Get-ExecutionPolicy -List
Wenn die Ausführung von PowerShell-Skripten für CurrentUser zugelassen ist, sollte hier Unrestricted oder Bypass angezeigt werden.
Falls die aktuellen Einstellungen für CurrentUser als Restricted oder RemoteSigned angezeigt werden, sollte der folgende Befehl in Windows PowerShell mit Administratorrechten ausgeführt werden:
Set-ExecutionPolicy -Scope CurrentUser Bypass
Danach können die Einstellungen wieder überprüft werden:
Get-ExecutionPolicy -List
Die Einstellung Unrestricted oder Bypass erlaubt die Ausführung der erforderlichen PowerShell-Skripte.
Download OpenKNX-Tools
Die neuesten OpenKNX-Tools können von https://github.com/OpenKNX/OpenKNXproducer/releases heruntergeladen werden.
Da diese ZIP-Datei ausführbare Programme und PowerShell-Skripte beinhaltet, warnen aktuelle Browser den Nutzer, dass der Download gefährlich sein könnte. Im Bereich "Erklärungen" finden sich weitere Informationen, was die ZIP-Datei beinhaltet und was installiert wird.
Inhalt entpacken
Den Inhalt der ZIP-Datei bitte in ein beliebiges Verzeichnis entpacken.
Installation
Das Verzeichnis mit allen entpackten Dateien beinhaltet dieses PowerShell-Skript:
Install-OpenKNX-Tools.ps1
Dieses kann mit einem rechten Mausklick und dann im Kontextmenü Ausführen mit PowerShell ausgeführt werden. Dadurch werden alle erforderliche Tools installiert.
Update
Ein Update der OpenKNX-Tools erfolgt genauso wie die initiale Installation - einfach den obigen Schritten folgen.
Erklärungen
Das PowerShell-Skript kopiert alle ausführbaren Dateien in das bin-Benutzerverzeichnis. Existiert dieses bin-Verzeichnis noch nicht, wird es angelegt. Danach wird eine Erfolgsmeldung ausgegeben.
Die abgelegten ausführbaren Dateien sind:
OpenKNXproducer.exe: Ein Tool zum Erstellen einerknxprod-Datei, die in die ETS importiert werden kann. Der Quelltext ist hier verfügbar.bossac.exe: Ein Tool zum Firmware-Upload auf einen SAMD-Mikrocontroller. Der Quelltext ist hier verfügbar.
Bemerkungen
OpenKNXproducer.exe benötigt eine funktionierende ETS-Installation, die auf demselben PC im Standard-Ordner der ETS installiert ist. ETS 5.6 ist das Minimum, ETS 5.7.x und ETS 6.x werden unterstützt. Eine Demo-Lizenz ist ausreichend.
Es funktioniert nicht mit einer komplett leeren ETS-Installation. Mindestens ein (leeres) Projekt muss zuvor mit dieser ETS-Installation erstellt worden sein.