Die ETS kann mit zusätzlichen Befehlszeilenargumenten gestartet werden. Mit diesen Argumenten kann ein Anwender Aktionen festlegen, die nach dem Start der ETS auszuführen sind.
Unterstützte Aktionen
Folgende Aktionen werden unterstützt:
Die Befehlszeilenparameter berücksichtigen Groß- und Kleinschreibung!
- Ein Projekt öffnen
- Ein Projekt erstellen
- Ein Projekt löschen
- Prüfen ob Projekt existiert
- Ein Projekt importieren
- Eine ETS Apps installieren
- ETS App öffnen
- Gruppen-Monitor starten
- Bus-Monitor starten
- Assistent zur Projekterstellung starten
- ETS beenden
- Hilfe
- Version
Ein Projekt öffnen
--openProject "Name des Projekts"
oder
-o "Name des Projekts"
- Öffnet ein bestehendes Projekt unmittelbar nach dem Start des ETS.
- Der "Name des Projekts" soll der tatsächliche Projektname sein
- Wenn das Projekt ein Passwort benötigt, wird der 'Passwort-Dialog' angezeigt.
- Es kann mit dem Parameter --password kombiniert werden, um ein passwortgeschütztes Projekt zu öffnen. Ist das Projektpasswort falsch, wird der 'Passwort-Dialog' angezeigt, um das richtige Passwort einzugeben.
Beispiel
--openProject "Mein Heimprojekt" --password "Passwort123@#"
oder
-o "Mein Heimprojekt" --password "Passwort123@#"
Ein Projekt erstellen
--createProject "Name des Projekts" oder -c "Name des Projekts"
- Erstellt ein neues Projekt (dieselbe Funktion wie im Standardprojekt-Erstellungsdialog), mit folgenden Standardeinstellungen:
- Backbone-Medium: IP
- Topologie: Linie 1.1 erstellen mit Medientyp TP
- Gruppenadress-Struktur: 3 Ebenen
- Es kann mit dem Parameter --password kombiniert werden, um ein passwortgeschütztes Projekt zu öffnen.
Beispiel
--createProject "Mein Heimprojekt" --password "Passwort123@#"
oder
-c "Mein Heimprojekt" --password "Passwort123@#"
Ein Projekt löschen
--deleteProject "Name des Projekts" oder -d "Name des Projekts"
Löscht ein vorhandenes Projekt aus dem Projektspeicher. Der Rückgabewert verweist auf Folgendes:
- Erfolgreich gelöscht: Rückgabewert = 0
- Löschen fehlgeschlagen: Rückgabewert = -2
Beispiel
--deleteProject "Mein Heimprojekt"
oder
-d "Mein Heimprojekt"
Prüfen, ob ein Projekt existiert
--existsProject "Name des Projekts" oder -e "Name des Projekts"
- Prüft, ob es ein existierendes Projekt mit dem angegebenen Namen im Projektspeicher gibt.
- Der Rückgabewert verweist auf Folgendes:
- Projekt vorhanden: Rückgabewert = 1
- Projekt nicht vorhanden: Rückgabewert = 0
- Danach wird ETS automatisch geschlossen, es ist also nicht notwendig, das --quit Argument hinzuzufügen.
Beispiel
--existsProject "Mein Heimprojekt"
oder
-e "Mein Heimprojekt"
Ein Projekt importieren
--importProject "Dateipfad zur Projektdatei" oder -i "Dateipfad zur Projektdatei"
- Importiert eine bestimmte Projektdatei (entweder im "knxproj" oder "pr" Format) in den Projektspeicher.
- Beim Importieren eines passwortgeschützten Projekts dann wird der 'Passwort-Dialog' angezeigt, um dieses manuell einzugeben.
Beispiel
--importProject "C:\MeineProjekte\MeinHeimprojekt.knxproj"
oder
-i "C:\MeineProjekte\MeinHeimprojekt.knxproj"
Eine ETS Apps installieren
--installApp "Dateipfad zur App-Datei" oder -ein "Dateipfad zur App-Datei"
- Installiert eine ETS App, die durch die angegebene *.etsapp-Datei repräsentiert wird.
Beispiel
--installApp "C:\MeineProjekte\MeineApp.etsapp"
oder
-a "C:\MeineProjekte\MeineApp.etsapp"
Eine ETS App öffnen
--openApp "AppId"
- Öffnet eine ETS App mit einem -spezifischen App-Identifikator innerhalb eines Projekts und setzt daher auch voraus, dass ein bestehendes Projekt über den --openProject Befehl spezifiziert wird.
- Der vorherige Arbeitsbereich wird verworfen und ein neuer Arbeitsbereich mit nur einem Fenster, Tab und Panel erstellt und das Panel wird die angeforderte App enthalten.
- Der Rückgabewert verweist auf Folgendes:
- "40", wenn die AppId nicht gesetzt ist
- "41", wenn die angegebene AppId ungültig ist
- "42", wenn keine ETS-App mit der angegebenen AppId gefunden werden kann
- "43", wenn die angeforderte ETS App nativen Modus erfordert, aber die ETS im Kompatibilitätsmodus läuft
- "44" wenn die angeforderte ETS App Kompatibilitätsmodus erfordert, aber die ETS im nativen Modus läuft
- "45" wenn die angeforderte ETS App nicht gestartet werden kann
- "46", wenn die angeforderte ETS App nicht lizenziert ist
Beispiel
--openProject "Name des Projekts" --OpenApp "M00FA-A0005"
Gruppen-Monitor starten
--groupmon "Name des Projekts" oder -g "Name des Projekts"
-
Dieser Befehl startet den Gruppenmonitor in einem Projekt.
Beispiel
--groupmon "Mein Heimprojekt"
oder
-g "Mein Heimprojekt"
Bus-Monitor starten
--busmon "Name des Projekts" oder -b "Name des Projekts"
-
Dieser Befehl startet den Busmonitor in einem Projekt.
Beispiel
--busmon "Mein Heimprojekt"
oder
-b "Mein Heimprojekt"
Assistent zur Projekterstellung starten
--Wizard oder -w
-
Dieser Befehl startet den Assistenten zur Erstellung von Projekten.
ETS beenden
--quit oder -q
- Schließt ETS nach der Ausführung aller anderen Befehlszeilenargumente.
- Die ETS wird trotz des --quit Arguments jedoch nicht schließen, wenn mindestens eines der anderen Kommandozeilenargumente einen Fehler verursachte, der den ETS Fehler/WarnungmeldungenDialogen resultierte.
Hilfe
--help
-
Dieser Befehl zeigt die Hilfe in der Konsole an.
Version
--version
-
Dieser Befehl zeigt die aktuelle ETS-Version in der Konsole an.
Kombination von Befehlszeilenargumenten
Die einzigen möglichen Kombinationen von Befehlszeilenargumenten sind
- --openProject und --importProject
- --password kann mit --openProject und --createProject kombiniert werden
- --quit kann zusammen mit einem anderen Parameter verwendet werden
- --openApp benötigt immer --openProject (und ein -Passwort, falls erforderlich)
Sobald der ETS6-Prozess gestartet wurde, sind die einzigen akzeptierten Befehle --createProject, --wizard und -importProject - sie werden für die ETS Windows Taskbar Befehle benötigt.
OpenProject wird das neueste aktive ETS6-Fenster verwenden und - falls nötig - einen neuen Dashboard-Tab öffnen. Jeder andere Befehl, der nach dem Start von ETS6 gestartet wird, wird nicht bearbeitet, sondern nur die ETS6 nach vorne bringen.
Fehlerbehandlung
Bei Fehlern oder fehlerhaften Befehlen protokolliert die ETS die Nachrichten im ETS-Log unter %LOCALAPPDATA%\Knx\ETS6\Log\ETS6.log
Rückgabe-Codes
Für einige Kommandozeilenargumente (z.B. --existsProject) gibt die ETS einen Exitcode zurück. Exit Codes werden nicht auf die Konsole ausgegeben, aber die Variable 'errorlevel' erhält den Exit Code Wert.
Um den Exit-Code auszuwerten kann ein Batch-Skript das IF ERRORLEVEL
-Konstrukt oder Variablen-Erweiterung verwenden, wie in echo %errorlevel%
. Wenn die ETS direkt von der Kommandozeile aufgerufen wird (und nicht von einem .bat oder .cmd script), dann muss es entweder mit cmd /c ETS6.exe aufgerufen werden ...
oder starten /wait ETS6.exe ...
Häufige Rückgabecodes
Übliche Rückgabecodes sind Rückgabewerte, die bei jedem Befehl gesetzt werden können:
- -1, wenn Parametersyntax/-optionen nicht korrekt sind
- -2 wenn der Vorgang fehlgeschlagen ist, z.B. Projekt konnte aufgrund eines Fehlers nicht geöffnet, gelöscht, importiert oder erstellt werden (aber befehlsspezifische Rückgabewerte gelten nicht)