SPS-Anwendungen automatisch erstellen
logi.CAD 3 bietet ein Werkzeug für das automatisierte Erstellen von SPS-Anwendungen.
Voraussetzung für die Verwendung dieses Werkzeugs: Sie haben die erforderliche Lizenz bereits installiert (siehe "Vorbereitungen", Schritt 2).
Das Werkzeug ist zur Verwendung durch einen fortgeschrittenen Anwender von
logi.CAD 3 vorgesehen.
Bedingung für die erfolgreiche Verwendung des Werkzeugs sind Kenntnisse über die durchzuführende Aktion, wie sie in der grafischen Benutzeroberläche von logi.CAD 3 ausgeführt werden würde.
Die Ausgaben des Werkzeugs erfolgen nur in englischer Sprache.
Vorbereitungen
Stellen Sie sicher, dass logi.CAD 3 installiert ist. Halten Sie die folgenden Informationen bereit:
der Pfad zum Installationsverzeichnis von logi.CAD 3
der Pfad zu einem Verzeichnis, das als Arbeitsbereich verwendet wird
Falls das Verzeichnis nicht existiert, wird es vom Werkzeug erstellt. Falls der optionale Parameter -checkEmptyWorkspace verwendet wird (siehe die Beschreibung dieses Parameters weiter unten), muss das Verzeichnis leer sein.der Pfad zum Projekt, das erstellt werden soll
Das Projekt darf keine Syntaxfehler enthalten. Alle Einstellungen (z.B. erforderliche Compiler-Einstellungen) müssen für das Zielsystem vorhanden sein (so wie es erforderlich ist, wenn die Anwendung innerhalb der grafischen Benutzeroberfläche von logi.CAD 3 erstellt wird).
der Name der →Konfiguration, die beim Erstellen verwendet werden soll (kann im SPS-Objekt des Projekts gefunden werden)
der Pfad zur Konfigurationsdatei für das Protokoll (siehe unten für weitere Informationen)
Eine Datei mit einer Beispielkonfiguration ist in der Installation von logi.CAD 3 enthalten.
Stellen Sie sicher, dass Sie über eine Lizenz verfügen, die für das automatisierte Erstellen der SPS-Anwendungen geeignet ist. Details: Siehe "Lizenz anfordern und installieren".
Öffnen Sie eine Befehlszeile: z.B. cmd.exe unter Windows und wechseln Sie in das Installationsverzeichnis von logi.CAD 3 .
Aufruf
logiCAD3c --launcher.ini logiCAD3.ini -application com.logicals.builder.lc3builder.application -noSplash -projectPath <PROJECTPATH> -configurationName <CONFIGURATIONNAME> -data <WORKSPACE> -checkEmptyWorkspace -vmargs -Dlog4j.configuration=file:<LOG-CONFIGURATION>
Der Aufruf des Werkzeugs wird nicht offiziell für Linux unterstützt. Wenn Sie dennoch versuchen wollen, das Werkzeug unter Linux aufzurufen, ersetzen Sie den Teil
logiCAD3c --launcher.ini logiCAD3.ini -application
des oben genannten Aufrufs durch
logiCAD3 -application
. Der restliche Teil des Aufrufs ist identisch mit dem oben genannten Aufruf.
Beschreibung der Parameter:
Parameter |
Beschreibung |
Beispiel |
<PROJECTPATH> |
absoluter Pfad zum Projekt
|
C:\LC3Projects\MyProject |
<CONFIGURATIONNAME> |
Name der Konfiguration |
LocalConfiguration |
<WORKSPACE> |
absoluter Pfad zu einem Arbeitsbereich, in den das Projekt importiert werden soll
|
C:\temp\LC3Workspace |
<LOG-CONFIGURATION> |
Pfad zur Konfigurationsdatei für das Protokoll |
C:\LC3LogConfig\log4j.xml |
Der Parameter -noSplash ist optional. Wird er nicht angegeben, wird der Startbildschirm von logi.CAD 3 nach dem Aufruf angezeigt.
Der Parameter -checkEmptyWorkspace ist ebenfalls optional. Geben Sie diesen Parameter an, um zu prüfen, ob der angegebene Arbeitsbereich leer ist. Das logi.CAD 3-P rojekt wird nur importiert, falls der Arbeitsbereich leer ist.
Beim Standardaufruf (wenn dieser Parameter nicht angegeben wird) wird das logi.CAD 3-P rojekt immer in den Arbeitsbereich importiert – unabhängig davon, ob der Arbeitsbereich leer ist oder nicht. Ist das logi.CAD 3-P rojekt bereits im Arbeitsbereich vorhanden, wird das logi.CAD 3-P rojekt neu importiert.Der Parameter -Dlog4j.configuration ist ebenfalls optional. logi.cals empfiehlt jedoch, diesen Parameter anzugeben, damit Protokoll-Ereignisse ausgegeben werden.
logiCAD3c --launcher.ini logiCAD3.ini -application com.logicals.builder.lc3builder.application -noSplash -projectPath C:\LC3Projects\MyProject -configurationName LocalConfiguration -data C:\temp\LC3Workspace -checkEmptyWorkspace -vmargs -Dlog4j.configuration=file:C:\LC3LogConfig\log4j.xml
logiCAD3c --launcher.ini logiCAD3.ini -application com.logicals.builder.lc3builder.application -noSplash -projectPath MyProject -configurationName LocalConfiguration -data C:\temp\LC3Workspace -vmargs -Dlog4j.configuration=file:C:\LC3LogConfig\log4j.xml
Konfigurationsdatei für das Protokoll
Diese Datei wird zur Konfiguration des log4j-Protokollierungsmechanismus benötigt. Die Datei gibt an, wie Protokoll-Ereignisse ausgegeben werden.
<?
xml
version
=
"1.0"
encoding
=
"UTF-8"
?>
<!DOCTYPE log4j:configuration SYSTEM "log4j.dtd">
<
log4j
:configuration
debug
=
"false"
xmlns:log4j
=
'http://jakarta.apache.org/log4j/'
>
<!-- This configuration logs to console. -->
<
appender
name
=
"console"
class
=
"org.apache.log4j.ConsoleAppender"
>
<
param
name
=
"target"
value
=
"System.out"
/>
<
param
name
=
"immediateFlush"
value
=
"true"
/>
<
param
name
=
"encoding"
value
=
"UTF-8"
/>
<
param
name
=
"threshold"
value
=
"info"
/>
<
layout
class
=
"org.apache.log4j.PatternLayout"
>
<
param
name
=
"ConversionPattern"
value
=
"%d{yyyy-MM-dd HH:mm:ss} %-5p: %m%n"
/>
</
layout
>
</
appender
>
<!-- This configuration logs to a file, with more information than for the console. -->
<
appender
name
=
"file"
class
=
"org.apache.log4j.DailyRollingFileAppender"
>
<
param
name
=
"file"
value
=
"C:\\temp\\logfile.log"
/>
<
layout
class
=
"org.apache.log4j.PatternLayout"
>
<
param
name
=
"ConversionPattern"
value
=
"%d{HH:mm:ss} %-5p [THREAD ID=%t] [Method:%M] %c{1}:%L - %m%n"
/>
</
layout
>
</
appender
>
<
root
>
<
level
value
=
"INFO"
/>
<
appender
-ref
ref
=
"console"
/>
<
appender
-ref
ref
=
"file"
/>
</
root
>
</
log4j
:configuration>
Fehlerbehebung
Die Datei, die in der Konfigurationsdatei für das Protokoll angegeben ist, enthält Informationen über das Erstellen. Falls das Erstellen nicht erfolgreich war, beheben Sie das Problem gemäß der folgenden Tabelle.
Rückgabe-Code |
Meldung (ausgegeben auf STDOUT oder STDERR) |
Ursache |
Lösung |
0 |
Build successful (0) |
|
|
13 |
<keine Meldung> |
Ein falscher Wert wurde für -application angegeben. |
Rufen Sie das Werkzeug wie oben angegeben auf. |
-1 |
Build failed (Parameter Error, -1): Name |
Ein Argument oder Parameter fehlt. |
Rufen Sie das Werkzeug wie oben angegeben auf. |
-2 |
Build failed (-2): Project not found |
Das angegebene Projekt existiert nicht. |
Geben Sie ein vorhandenes Projekt an. Oder rufen Sie das Werkzeug mit dem absoluten Pfad für das Projekt auf . |
-3 |
Build failed (-3): Configuration "Name" not found |
Die angegebene Konfiguration existiert nicht. |
Geben Sie eine vorhandene Konfiguration an. |
-4 |
Build failed (-4): Message |
Das Code-Image konnte nicht erstellt werden. |
|
-5 |
Build failed (-5): Project contains errors |
Das Projekt enthält Syntaxfehler. |
Öffnen Sie das Projekt in logi.CAD 3 und beheben Sie die Fehler, die in der Sicht Fehler angezeigt werden. |
-6 |
Build failed (-6): Workspace not empty |
Der Arbeitsbereich enthält bereits Daten (z.B. ein oder mehrere logi.CAD 3 -Projekte). |
Verwenden Sie einen leeren Arbeitsbereich oder entfernen Sie alle vorhandenen Daten aus dem aktuellen Arbeitsbereich.
|
-127 |
Build (Details: exception message) |
Ein unerwarteter Fehler ist aufgetreten. |
Kontaktieren Sie logi.cals. |
200 |
License for automated builds of PLC applications could not be found... |
Keine Lizenz verfügbar. |
Stellen Sie sicher, dass eine Lizenz für das Werkzeug vorhanden ist und/oder dass der aktuelle Rechner entsprechend eingerichtet wurde. Rufen Sie das Werkzeug erneut auf. |