OpenKNX-Toolbox

OpenKNX-Toolbox

Die OpenKNX-Toolbox vereinfacht das Generieren der Produktdatenbank (.knxprod) sowie das Aufspielen der Firmware auf die Hardware. Ein manuelles Ausführen von Skripten oder das Aktivieren von Entwicklungseinstellungen ist damit nicht mehr nötig. Die OpenKNX-Toolbox ersetzt somit für Endnutzer unseren OpenKNX-Producer, der jedoch weiterhin verwendet werden kann.

Die OpenKNX-Toolbox ist noch recht neu, und viele Funktionen fehlen noch. Zukünftig soll die Toolbox den Zugriff auf die Gerätekonsole ermöglichen und Updates über das Netzwerk unterstützen. Weitere Informationen finden Sie auf der folgenden Seite:
Wie installiere ich eine Applikation?

Installation

Lade hier die neueste Version der OpenKNX-Toolbox herunter. Eine Installation ist nicht nötig, da das Programm direkt gestartet werden kann. Der Windows-SmartScreen wird eine Warnung anzeigen, da die Software keine digitale Signatur enthält. Man muss dann auf „Weitere Informationen“ klicken und anschließend „Trotzdem starten“ auswählen.

Nutzung

Nach dem Starten der OpenKNX-Toolbox öffnet sich das Fenster der Anwendung.

image-20241011-115736.png

1. Release hinzufügen

Links findet ihr die Auswahl der Projekte, aus denen ihr ein Release herunterladen könnt. Dafür müsst ihr zunächst auf „Aktualisieren“ klicken. Die Toolbox sucht dann automatisch nach allen Projekten mit verfügbaren Releases. Anschließend könnt ihr das gewünschte Projekt inklusive Release auswählen.

Ihr könnt jedoch auch Releases direkt aus einer ZIP-Datei importieren. Dies kann erforderlich sein, wenn das Projekt noch nicht öffentlich ist.

Mit der Funktion „Im Browser öffnen“ könnt ihr direkt zur GitHub-Seite des ausgewählten Projekts gelangen, um beispielsweise weitere Informationen zu erhalten.

Aufgrund der GitHub-API-Beschränkungen kann es vorkommen, dass das Abfragelimit erreicht wird. Dieses setzt sich allerdings nach einer Stunde automatisch zurück.

Alternativ kann ein eigenes GitHub-Token erstellt werden. Dieses muss dann als Umgebungsvariable mit dem Namen „GITHUB_TOKEN“ gespeichert werden.

2. Release auswählen (Lokale Releases)

image-20241011-122810.png

Rechts werden nun alle heruntergeladenen bzw. importierten Releases aufgelistet. Ihr habt die Möglichkeit, die passende Version für eure Hardware auszuwählen. Nicht mehr benötigte Releases können ebenfalls gelöscht werden. Sobald ihr ein Release ausgewählt habt, geht es unten links weiter.

Die lokalen Releases werden im Ordner „Storage/[ReleaseName]“ abgelegt. Dieser Ordner wird im selben Verzeichnis wie die Toolbox angelegt und dort gesucht.

3. Produktdatenband generieren

image-20241011-121058.png

Nun könnt ihr die passende Produktdatenbank (.knxprod-Datei) generieren lassen. Klickt dafür auf „KnxProd erstellen“. Diese müsst ihr anschließend in die ETS-Produktkatalog importieren und eurem Projekt hinzufügen (siehe auch Produktdatenbank).

4. Firmware auf das Gerät aufspielen

image-20241011-121341.png

Direkt darunter könnt ihr als letzten Schritt die Geräte-Firmware aufspielen. Je nachdem, wann ihr das Gerät angeschlossen habt, müsst ihr eventuell nochmals auf „Aktualisieren“ klicken.

Die Toolbox kann nur RP2040 Geräte im Bootloadermodus erkennen, wenn diese den Standardtreiber verwenden und im Gerätemanager mit einem COM-Port aufgelistet werden.