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

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

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

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

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

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.