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 Projekten aus der ETS4:
Der Projektimport im Timberwolf Server wurde mit der aktuellsten Versionen der ETS 5 und ETS 6 getestet, die zum Zeitpunkt der Softwareentwicklung allgemein verfügbar war.
Ein Import von ETS4 Projekten wird vom Timberwolf Server nicht direkt unterstützt, auch wenn die Programmierung aus der ETS4 möglich sein kann. Falls Sie Projekte aus der ETS 4 einlesen möchten und dies nicht gelingt, suchen Sie bitte auf der Webseite der KNX Association nach „ETS-Projekt-Exportassistent“. Dies ist eine kostenfreie Windows Software, die alle Datenstrukturen von ETS 1 bis ETS 4 in das aktuellste ETS Format konvertiert. Dieses Format sollten Sie dann in den Timberwolf Server importieren können.
Keine zusätzlichen Projektdateien im ETS Projekt speichern
Bitte speichern Sie keine zusätzlichen Daten wie Zeichnungen, Home Server Projekte, PDF-Listen usw. in der ETS, da diese Fremddateien beim Export aus der ETS mit ausgegeben werden und der Timberwolf Server beim anschließenden Import mit Fehler abbrechen kann.
Die ETS erlaubt zusätzlich das Speichern beliebiger Dateien im ETS Projekt unter dem Reiter “Projektdateien”. Dies können z.B. Zeichnungen, Auftragsbestätigungen, Rechnungen und Zip-Archive mit anderen Daten sein. Diese Fremddateien werden nicht benötigt und stören den Import in andere Systeme.
Erklärung im Detail.
Bei einem Export des Projektes schreibt die ETS neben den eigentlich gewünschten KNX Konfigurationsinformationen auch vormals als Projektdateien hinzugefügte Daten mit in die auszugebende Projektdatei.
Eine ETS Projektdatei ist tatsächlich eine Datei im ZIP-Format, die als Container für viele einzelne Daten, auch wiederum gezippte Daten, dient (mit einem Dekompressionsprogramm kann man die Bestandteile der ETS Projektdatei prüfen).
Die eigentlich gewünschten KNX Konfigurationsinformationen sind in der ETS Projektdatei (die ein ZIP-Container ist) als einzelne ZIP-Dateien enthalten.
Beim Import einer ETS Projektdatei in den Timberwolf Server werden alle darin enthaltenen ZIP-Dateien dekomprimiert und alle gefundenen XML Dateien eingelesen.
Zum Beispiel sind Homeserver Projekte ebenfalls XML-Dateien und wenn solche als ZIP in den Projektdateien nun ein Bestandteil des ETS Projektes sind, dann werden diese beim Import in den Timberwolf Server als ZIP gefunden, entpackt und weil es eine XML Struktur ist, versucht zu importieren. Da es sich um ein unbekanntes Dateiformat hat, gibt der Import einen Fehler aus.
Bitte entfernen Sie daher alle zusätzlichen Projektdateien aus dem ETS Projekt vor dem Export zum Timberwolf Server, so dass diese nur noch die ETS Informationen enthalten.
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.
Sicherheit verschlüsselter ETS Projekte und des Passwortes im Timberwolf Server
Das eingegebene Projekt Passwort wird verschlüsselt vom Browser zum Timberwolf Server übertragen und dort nur für den Entschlüsselungsvorgang im RAM gehalten. Es erfolgt keine dauerhafte Speicherung des Projekt Passwortes.
Das zum Timberwolf Server hochgeladene KNX Projekt wird nur temporär entschlüsselt. Nach dem erfolgten Import einzelner Daten (PAs, GAs, DPT, Linien, Bezeichnungen, Beschreibungen) werden die verschlüsselten XML-Datensätze verworfen.
Der Timberwolf Server speichert alle hochgeladenen KNX Projekte in seinem KNX Projektspeicher für eine spätere Nutzung. Hier wird nur die original hochgeladene Datei gespeichert, also bei verschlüsselten Projektdateien auch nur diese verschlüsselte Version. Dies kann Ihnen als Backup Ihres wertvollen KNX Projektes dienen. Der Timberwolf Server benötigt diese ETS Projekte nach dem Import nicht wieder, Sie können daher diese Datei auch gleich nach dem Import wieder löschen.
Die aus dem Projekt extrahierten Daten werden in den internen Datenbanken des Timberwolf Servers gespeichert. Diese Datenbanken sind auf dem Massenspeicher (“SSD”) des Timberwolf Servers gespeichert, der selbst komplett online verschlüsselt ist. Damit sind alle Daten vor fremden Zugriff geschützt. Die Verschlüsselung des Massenspeichers basiert auf Schlüsseln, die vom lokalen Crypto-Chip des Timberwolf Servers generiert werden.
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.
Warnhinweis zum Löschen einer ETS Projektdatei aus dem KNX Projektspeicher
Der KNX Projektspeicher enthält ETS Projekte, die in der Vergangenheit in den Timberwolf Server importiert wurden und dabei im Projektspeicher gesichert wurden.
Das Löschen einer ETS Projektdatei ist zwar ohne Folgen für den damit durchgeführten vormaligen Import (die importierten Daten bleiben in der Datenbank des Timberwolf Servers erhalten), jedoch kann die Löschung einer solchen Datei nicht wieder einfach rückgängig gemacht werden.
Zwar ist der ETS Projektspeicher auch Bestandteil des Timberwolf Backups, jedoch kann daraus nicht eine einzelne Datei restauriert werden, sondern immer nur der gesamte Datenbestand des Timberwolf Servers, was einem Rücksetzen auf einen früheren Zeitpunkt gleich kommt.
ETS Projekte enthalten die gesamte Parametrisierung der KNX Anlage. Sie sollten daher ganz sicher sein, dass Sie dieses ETS Projekt an anderer Stelle verfügbar haben oder mittlerweile eine aktuellere Version nutzen.
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.
Kommentar hinzufügen