Werkzeug für Windows

Zurück in die ETS. Mit deiner eigenen ETS.

KNX Atlas für ETS ist ein kleines Windows-Programm. Es lässt deine installierte, lizenzierte ETS 6 ein von KNX Atlas geschriebenes Projekt importieren und mit ihrem eigenen Exporter neu schreiben. Heraus kommt ein normaler, von der ETS signierter Export.

Warum es dieses Programm gibt

Die ETS prüft beim Import die Signatur einer Projektdatei. Ein von KNX Atlas geschriebenes Projekt lehnt sie mit „Projektdatei hat keine gültige Signatur“ ab.

Die Signatur verwendet einen Schlüssel, der Teil der ETS ist. KNX Atlas liest ihn nicht aus und verwendet ihn nicht. Deshalb übernimmt deine eigene ETS diesen Schritt: Sie importiert die Datei im Hintergrund in einen isolierten, temporären Projektspeicher und exportiert sie mit ihrem eigenen Exporter, der die Signaturen schreibt.

In fünf Schritten zurück

  1. 1

    Datei wählen

    Die .knxproj-Datei ins Fenster ziehen oder auswählen. Unten zeigt das Programm die gefundene ETS und ob ihre Version getestet ist.

    Zurück in die ETS. Mit deiner eigenen ETS. – Datei wählen
  2. 2

    Passwort eingeben

    Nur bei geschützten Projekten. Das Passwort geht nur im Speicher an die ETS; die neue Datei ist mit demselben Passwort geschützt.

    Zurück in die ETS. Mit deiner eigenen ETS. – Passwort eingeben
  3. 3

    Ziel festlegen

    Die neue Datei heißt „<Name> (ETS).knxproj“ und liegt neben dem Original. Eine vorhandene Datei wird nur nach deiner Bestätigung ersetzt.

    Zurück in die ETS. Mit deiner eigenen ETS. – Ziel festlegen
  4. 4

    Die ETS arbeiten lassen

    Die ETS importiert das Projekt, exportiert und signiert es, danach werden die Signaturen geprüft. Bei großen Projekten dauert das einige Minuten.

    Zurück in die ETS. Mit deiner eigenen ETS. – Die ETS arbeiten lassen
  5. 5

    Ergebnis prüfen und importieren

    Geräte, Zertifikat, Signaturprüfung und die Meldungen der ETS auf einen Blick. Danach importierst du die Datei in der ETS 6 über Datei › Projekt importieren.

    Zurück in die ETS. Mit deiner eigenen ETS. – Ergebnis prüfen und importieren

Die Abbildungen zeigen das Programmfenster mit Demodaten.

Was es tut – und was nicht

  • Es nutzt die ETS-eigenen Funktionen für Import und Export.
  • Es arbeitet in einem isolierten, temporären Projektspeicher, der danach gelöscht wird.
  • Es prüft die neue Datei mit der Signaturprüfung der ETS und vergleicht die Geräteanzahl.
  • Es zeigt Warnungen und Fehler der ETS beim Import lesbar an.
  • Es signiert nichts selbst und liest keinen Schlüssel aus der ETS.
  • Es verändert weder die Originaldatei noch deine ETS-Projekte, Produkte oder Caches.
  • Es überschreibt keine Datei ohne deine ausdrückliche Wahl.
  • Es greift nicht auf das Netzwerk zu und sendet keine Telemetrie.

Zertifikat und Lizenz

Die ETS schreibt ein Zertifikat in die Datei, wenn ihr Exporter eine Lizenz erhält. Das Programm wählt sie wie der Export der ETS selbst. Starte die ETS 6 vorher einmal, damit sie deine Lizenz sicher findet.

Ohne Zertifikat importiert eine ETS ohne Support-Lizenz höchstens fünf Geräte der Datei – das Ergebnisfenster sagt es deutlich. Ein Projekt mit mehr Geräten, als deine Lizenz pro Projekt erlaubt, wird abgelehnt, so wie die ETS es selbst nicht öffnen würde.

Wann das Programm nichts schreibt

Hat die ETS beim Import Geräte verworfen, fehlt der Topologie die Backbone- oder Hauptlinie oder lehnt die ETS das Passwort ab, entsteht keine Ausgabedatei. Das Programm erklärt den Grund und führt zurück zum passenden Schritt.

Die Datei, die herauskommt, enthält denselben Projektinhalt, ist aber nicht Byte für Byte gleich: Die ETS schreibt sie mit ihrem eigenen Serialisierer und legt wie bei jedem Export die benötigten Stamm- und Produktdaten bei.

Auch auf der Kommandozeile

Dieselbe Funktion steht für Skripte zur Verfügung. Das Passwort wird nur aus einer Umgebungsvariablen gelesen, nie aus der Befehlszeile. Der Rückgabecode 0 bedeutet: geschrieben und von der ETS-Signaturprüfung akzeptiert.

KnxAtlasEtsExport.exe --input Haus.knxproj [--output "Haus (ETS).knxproj"]
                      [--password-env NAME] [--result-file ergebnis.json]
KnxAtlasEtsExport.exe --detect-ets

Häufige Fragen

Brauche ich dafür eine ETS-Lizenz?

Ja. Das Programm nutzt deine installierte, lizenzierte ETS 6 und liefert selbst keine ETS-Dateien mit. Ohne passende Lizenz schreibt die ETS kein Zertifikat; dann importiert eine ETS ohne Support-Lizenz höchstens fünf Geräte.

Läuft das Programm auch auf dem Mac?

Nein. Es braucht Windows 10 oder 11 mit einer dort installierten ETS 6, denn es arbeitet mit genau dieser ETS.

Warum warnt Windows beim ersten Start?

Das Programm ist nicht codesigniert, deshalb kennt Windows SmartScreen den Herausgeber nicht. Vergleiche die SHA-256-Prüfsumme der ZIP-Datei mit der auf dieser Seite; über „Weitere Informationen“ lässt sich das Programm dann starten.

Funktioniert das mit jeder ETS-6-Version?

Getestet ist ETS 6.4.8718. Findet das Programm einen anderen 6.x-Stand, läuft es erst nach deiner ausdrücklichen Bestätigung. ETS 5 und ältere Versionen werden nicht unterstützt.

ETS ist ein Produkt der KNX Association. Das Programm nutzt deine installierte ETS über deren Programmierschnittstellen; es besteht keine Verbindung zur oder Billigung durch die KNX Association.