Import des ETS Projektes
- Stefan Werner (Org-Admin)
Grundlagen
Ein KNX Projekt innerhalb der ETS enthält alle technischen Informationen zu Linien, den KNX Geräten, den verwendeten Physikalischen Adressen, Objekten, Parametern, Gruppenadressen, Datenpunkttypen, den Schlüsseln sowie alle Bezeichnungen und Beschreibungen.
Was mit der Programmierung von der ETS zum Timberwolf Server übertragen wird
Mit der Programmierung aus der ETS erhält der Timberwolf Server folgendes:
die jeweils aktivierten Universalobjekte und deren Datenpunkttyp,
die Parametrierung der Applikationsobjekte,
die mit diesen Objekten jeweils assoziierten Gruppenadressen
sowie die Physikalischen Adressen (“PA”) der KNX Applikation (“Stack”) selbst und die PAs aller aktivierten KNXnet/IP Tunnel.
Nicht bei Programmierung übertragen: Somit werden mit einer ETS Programmierung KEINE Informationen über alle weiteren im Projekt verwendeten Gruppenadressen und deren Datenpunkttyp (“DPT”) übertragen und auch nicht die vom Einrichter eingegebenen Bezeichnungen und Beschreibungen.
Sinnvolle Informationen aus dem Projekt: Der im Timberwolf Server enthaltene KNX Busmonitor sowie die Funktion der permanenten Aufzeichnung aller KNX Telegramme benötigen für die Dekodierung der KNX Bus Telegramme die jeweiligen Datenpunkttypen (“DPT”) sämtlicher in der gesamten KNX Anlage vorkommender Gruppenadressen und - für eine bessere Anzeige - die in der ETS vergebenen Bezeichnungen und Beschreibungen für Geräte, Objekte, Adressen. Alle diese Informationen werden dem Timberwolf Server erst mit dem Import des KNX Projekts zugänglich. Dieser Import wird folgend beschrieben.
Kurzanleitung ETS Projekt Import
Der Import ist sehr einfach, bitte gehen Sie nach folgender Liste vor:
Export: Öffnen Sie die ETS, klicken Sie das entsprechende Projekt an und betätigen Sie die Schaltfläche für “Projekt exportieren”.
Import: Wechseln Sie auf die Web-APP des Timberwolf Server und wählen im Menu mit KNX → ETS Projektdatei das Funktionsmodul ETS Projektverwaltung. In der Box “ETS Projekt importieren und sichern” klicken Sie auf [Auswählen] und wählen anschließend die zuvor exportierte ETS Projektdatei aus.
Überprüfung: Der Timberwolf Server führt beim Import eine Plausibilitätsprüfung durch. Hierbei wird insbesondere auf inkonsistente Parametrisierung der KNX Objekte und der Gruppenadressen hinsichtlich der Datenpunktypen geprüft. Überprüfen Sie das Importlog auf Fehler. Falls Fehler gefunden werden, beheben Sie diese bitte zunächst in Ihrem ETS Projekt und nehmen den Export / Import erneut vor.
ETS Projekt Import sinnvoll - nicht notwendig
Der Import des ETS Projektes ist für die Kernfunktion des KNX Systems des Timberwolf Servers NICHT notwendig. Alle für die Funktionalität elementaren Einstellungen erfolgen durch die Programmierung aus der ETS.
Der Import ermöglicht jedoch eine erweiterte Benutzerführung, weil damit die Suche und Anzeige der vergebenen Bezeichnungen für Haupt- und Mittelgruppe, Gruppenadresse und die Gerätebezeichnungen zur Verfügung steht.
Zudem erfolgt beim Import eine umfangreiche Konsistenzprüfung. Diese macht Sie insbesondere auf Unterschiede gegenüber der Programmierung des Timberwolf Servers mit der ETS und auf Inkonsistenzen bei der Definition der Datenpunkttypen zwischen Gruppenadressen und KNX Objekten aufmerksam.
Nicht zuletzt ermöglicht erst der ETS Projektimport die Kenntnis aller in der ETS angelegten Datenpunkttypen aller Gruppenadressen und damit die Dekodierung der Telegramme beim Logging und im KNX Busmonitor.
Empfohlene Vorgehensweise
Sie müssen keinesfalls nach jeder Programmierung mit der ETS anschließend jeweils einen Export aus der ETS und anschließenden Import am Timberwolf Server durchführen.
Insbesondere wenn Sie zunächst mit nur wenigen KNX Objekten und deren Einstellungen von DPT und Flags experimentieren, wäre dies nicht sehr effizient.
Unser Tipp: Importieren Sie das ETS Projekt immer erst nach größeren Umstellungen in der ETS, zum Beispiel wenn Sie die ETS Konfiguration für diesen Tag beenden, quasi als Tagesabschluss.
Importierbare Formate
Bei einem Export des Projektes durch die ETS wird die interne Datenstruktur in viele einzelne XML-Dateien exportiert, die zusammen in einer Container-Datei mit der Endung “.knxproj” ausgegeben werden. Dies ist ein komplexes Dateiformat und hat viele Veränderungen über die Jahre erfahren. Wir testen jeweils mit der neuesten verfügbaren ETS Version und raten Ihnen, diese für Ihr Projekt ebenfalls zu verwenden
Der Timberwolf Server unterstützt den Import folgender Formate in den jeweils angegebenen Firmware Versionen:
ETS Version | Kein Projekt Passwort | Mit Projekt Passwort |
|---|---|---|
Export aus ETS 5.7.7 | TWS V 2.0 | TWS V 3.5.1 |
Export aus ETS 6.1 | TWS V 3.5.1 | TWS V 4.0 |
Import von verschlüsselten Projekten mit Projekt Passwort
In der ETS kann für jedes Projekt ein Passwort vergeben werden. Bei Einbeziehung von KNX Secure Komponenten in ein Projekt ist die Verwendung eines Passwortes in der ETS verpflichtend.
Wird ein solches - mit einem Passwort geschütztes - ETS Projekt exportiert, dann wird die entstehende .knxproj-Datei auf der Basis dieses Passwortes verschlüsselt.
Import verschlüsselter ETS 5 Projekte
Der Timberwolf Server unterstützt den Import von verschlüsselten ETS 5 Projekten ab Firmware 2.0.
Bitte geben Sie bei solchen gesicherten Projekten zusätzlich das Projekt Passwort in die entsprechende Dialogbox ein.
Import verschlüsselter ETS 6 Projekte
Ein Import von verschlüsselten ETS 6 Projekten in den Timberwolf Server wird ab Firmware V 4 unterstützt.
Hinweis: Der Import unverschlüsselter ETS 6 Projekte wird vom Timberwolf Server ab Version 3.5.1 unterstützt. Soweit möglich, schalten Sie vor dem Export des ETS Projektes zunächst das Projektpasswort aus, damit eine unverschlüsselter Export möglich ist.
ETS Projektspeicher im Timberwolf Server
Alle importierten ETS Projekte werden im internen Projektspeicher des Timberwolf Servers abgelegt.
Dieser ETS Projektspeicher befindet sich auf dem voll verschlüsselten internen Massenspeicher (“SSD”) und kann maximal 25 importierte ETS Projekte zusammen mit dem jeweiligen Import-Log aufnehmen.
Falls der Projektspeicher voll ist, können keine ETS Projekte mehr importiert werden. Das Löschen älterer ETS Projekte aus dem ETS Projektspeicher ist dann zuvor manuell zu bewirken.
Alle im ETS Projektspeicher enthaltenen ETS Projekte werden ebenfalls in das verschlüsselte System-Backup mit eingeschlossen. Das Löschen eines ETS Projektes aus dem ETS Projektspeicher bewirkt nicht ein Löschen dieses ETS Projektes aus zuvor angefertigten System-Backups.
Herunterladen von ETS Projektdateien aus dem ETS Projektspeicher
Die Auflistung der im ETS Projektspeicher gespeicherten ETS Projekte sind mit Links versehen und können darüber leicht heruntergeladen werden.
Löschen von ETS Projektdateien aus dem ETS Projektspeicher
Am rechten Rand der Auflistung der im ETS Projektspeicher gespeicherten ETS Projekte wird ein Mülleimer-Symbol dargestellt. Mit Klick darauf wird eine Bestätigungsbox mit Warnung angezeigt.
Wiederaufrufen des Importlogs
Für jedes hochgeladene ETS Projekt wird einmalig ein Import gestartet. Das Log des Imports wird beim Import angezeigt (je nach Aktivierung von “Log nur bei Fehler anzeigen“) und im KNX Projektspeicher abgelegt.
Zu einem späteren Zeitpunkt kann das jeweilige Import Log zu vormals hochgeladenen ETS Projekten nachträglich erneut angezeigt werden. Klicken Sie hierzu auf das Listen-Symbol nach der Projektbezeichnung im Bereich „Gespeicherte Projekte“.
Hierdurch wird nur das Importlog erneut angezeigt, es wird kein erneuter Importvorgang durchgeführt.