Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

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.

...

  1. Export: Öffnen Sie die ETS, klicken Sie das entsprechende Projekt an und betätigen Sie die Schaltfläche für “Projekt exportieren”.

  2. 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.

  3. Ü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.

Info

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.

...

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.

0.6

1

TWS V 3.5.1

TWS V 4.0

Panel
panelIconIdatlassian-light_bulb_on
panelIcon:light_bulb_on:
panelIconText:light_bulb_on:
bgColor#FFFAE6

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.

Warning

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.

  1. 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.

  2. 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).

  3. Die eigentlich gewünschten KNX Konfigurationsinformationen sind in der ETS Projektdatei (die ein ZIP-Container ist) als einzelne ZIP-Dateien enthalten.

  4. Beim Import einer ETS Projektdatei in den Timberwolf Server werden alle darin enthaltenen ZIP-Dateien dekomprimiert und alle gefundenen XML Dateien eingelesen.

  5. 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.

...

Wird ein solches - mit einem Passwort geschütztes - ETS Projekt exportiert, dann wird die entstehende .knxproj-Datei mit dem selben Passwort auf der Basis dieses Passwortes verschlüsselt.

Import verschlüsselter ETS 5 Projekte

...

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.

...

Ein Import von verschlüsselten ETS 6 Projekten in den Timberwolf Server wird erst mit der künftigen Firmware V 4 möglich sein. Der Grund dafür ist, dass die ETS 6 ein anderes Verschlüsselungsformat verwendet als die ETS 5 und zunächst Erweiterungen des Betriebssystems notwendig sind, die erst mit der Firmware ab V4 bereitgestellt werden können. Wenn Sie zeitnah über die Verfügbarkeit informiert sein möchten, dann abonnieren Sie bitte unseren Newsletter und / oder treten dem Telegram Kanal für Insider beiab 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.

...