Skripte ausführen

Sie können e!COCKPIT mittels Python-Skripten applikativ steuern.

Hinweis

Informationen und Referenzen zur Skriptsprache „Python“

Literatur/Internet
Allgemeine Informationen und Referenzen zur Skriptsprache „Python“ finden Sie in einschlägiger Literatur sowie im Internet.

CODESYS Onlinehilfe
Eine kurze Anleitung zur Verwendung von „Python“ finden Sie in der CODESYS Onlinehilfe (Stichwort „Python“).

API-Referenz von Python-Befehle
Die Hilfedatei „ScriptEngine.chm“ zu den Skriptbefehlen ist nicht in der Onlinehilfe implementiert, liegt jedoch im CODESYS Installationsverzeichnis vor ( „…\WAGO Software\e!COCKPIT\3S CODESYS\CODESYS\Online Help\de\“). Die Hilfedatei beinhaltet die Python-Referenz von CODESYS, welche um eine e!COCKPIT-spezifischen Referenz erweitert wurde. Wenn Sie mit Python arbeiten, verwenden Sie die e!COCKPIT-spezifischen Befehle. Falls es für eine gewünschte Funktion keinen e!COCKPIT-spezifischen Befehl gibt, verwenden Sie die Standard CODESYS Befehle. Beide Befehle sind in der API-Referenz beschrieben.

Beispielprojekte
In der Backstage-Ansicht, Seite „Hilfe“ > [Verknüpfungen] > [Beispielprojekte] finden Sie Beispielskripte für verschiedene Anwendungsfälle in e!COCKPIT.
Eine Kurzbeschreibung der Beispielskripte finden im Anschluss an die folgenden Handlungsschritte.

Führen Sie Python-Skripte entweder über die Kommandozeile oder über die Bedienoberfläche aus.

Kommandozeile

  1. Öffnen Sie die Windows-Kommandozeile:
    Klicken Sie dazu auf das Startmenü ([Start]) oder alternativ auf die [Windows-Taste] + [R].
  2. Geben Sie im Eingabefeld „cmd“ ein.
  3. Die Kommandozeile wird geöffnet.
  4. Rufen Sie die Python-Skripte nach folgendem Muster auf:
    e!COCKPIT.exe --runscript=“<scriptfile>.py“ --scriptargs:‘<arg1> <arg2> ... <argn>‘ –enablescripttracing
    Folgende zwei Parameter sind dabei optional:
    --scriptargs:'argument1 argument2': Übergabe von Argumenten an das Skript
    --enablescripttracing: Script-Tracing wird eingeschaltet
  5. Führen Sie Python-Skripte aus, z. B.:
    „e!COCKPIT.exe“ --runscript=“C:\CTemp\test.py“ –enablescripttracing

e!COCKPIT-Bedienoberfläche

  1. Öffnen Sie das Register „DATEI“ in der e!COCKPIT -Bedienoberfläche.
  2. Öffnen Sie die Seite „Scripting“.
  3. Um eine Phython-Skriptdatei (*.py) auf ihrem PC auszuwählen und auszuführen, klicken Sie auf [Skript-Datei ausführen].
  4. Um alle Befehle innerhalb eines Python-Skripts im Bedienfeld „Meldungen“ auszugeben und in der Python-Skript-Log-Datei zu speichern, klicken Sie auf [Skript-Tracing aktivieren]. Die Beschriftung auf der Schaltfläche ändert sich zu „Skript-Tracing deaktivieren“. Klicken Sie die Schaltfläche erneut an, um die Trace-Funktion zu beenden.
  5. Um die Python-Skript-Log-Datei zu öffnen, klicken Sie auf [SKRIPT-Log-Datei öffnen].

Beispielskripte verwenden

e!COCKPIT stellt Beispielskripte über die Backstage-Ansicht bereit. Sie erreichen die Skripte entweder über die Seite „Hilfe“ > [Verknüpfungen] > [Beispielprojekte] > Python Scripting oder über die Seite „Öffnen“ > [Beispielapplikationen] > Python Scripting.

Übersicht der Beispielskripte

Übersicht Python-Beispielskripte

Ordner/Datei

Beschreibung

Device Related

 

 

 

 

 

 

 

access_device_catalog.py

Gerät aus Katalog öffnen und Eigenschaften lesen

add_delete_device.py

Geräte hinzufügen/entfernen

create_delete_logical_connection.py

Logische Verbindung herstellen/löschen

export_import_element.py

Programmelemente exportieren/importieren

import_application.py

Applikation importieren

set_ip_address.py

IP-Adresse zuweisen

update_device.py

Geräte-Update durchführen

Module Related

 

 

 

 

 

 

 

add_delete_device.py

Module hinzufügen/entfernen

export_io_mapping.py

E/A-Abbild exportieren

get_module.py

Modul aufrufen

import_io_mapping.py

E/A-Abbild importieren

read_write_module_parameter.py

Modulparameter lesen/schreiben

set_io_mapping.py

Ein-/Ausgänge abbilden

Online Operation

 

 

 

 

 

 

 

 

connect_disconnect_device.py

Verbindung zu Gerät herstellen/beenden

create_boot_application_offline.py

Bootapplikation offline erstellen

create_boot_application_online.py

Bootapplikation online erstellen

print_paramter_list.py

Parameterliste ausgeben

read_variable_online.py

Variablen online lesen

read_write_parameter.py

Variablen lesen/schreiben

simulate_application.py

Applikation simulieren

Project Related

 

 

 

 

 

 

 

 

 

create_project_from_template.py

Projekt aus Template erstellen

create_save_project.py

Projekt erstellen und speichern

get_device_in_project.py

Gerät im Projekt abfragen/aufrufen

get_set_compiler_version.py

Compilerversion abfragen/aufrufen

get_set_visualization_profile.py

Visualisierungsprofil abfragen/aufrufen

open_and_update_project.py

Projekt öffnen und Update durchführen

open_archive.py

Archiv öffnen

save_archive.py

Archiv speichern

update_project.py

Projekt-Update durchführen

System Related

 

 

close_ecockpit.py

e!COCKPIT schließen

Weitere Informationen finden Sie unter: