Exécuter des scripts

Vous pouvez contrôler e!COCKPIT à l'aide de scripts Python.

Remarque

Informations générales et références au langage de script Python

Littérature/Internet
Des informations générales et des références au langage de script Python sont disponibles dans la littérature appropriée et sur Internet.

CODESYS l’aide en ligne
Vous trouverez également de brèves instructions d'utilisation dans l'aide en ligne de CODESYS (mot-clé « Python »).

Référence API des commandes Python
En savoir plus sur la référence API des commandes Python :
Le fichier d'aide « ScriptEngine.chm » des commandes de script n'est pas implémenté dans l'aide en ligne, mais est disponible dans le répertoire d'installation de CODESYS (« …\WAGO Software\e!COCKPIT\3S CODESYS\CODESYS\Online Help\de\ »).
Le fichier d'aide contient la référence Python de CODESYS, qui a été étendue par une référence spécifique à e!COCKPIT. Si vous utilisez Python, utilisez les commandes spécifiques à e!COCKPIT. S'il n'existe pas de commande spécifique à e!COCKPIT pour une fonction souhaitée, utilisez les commandes standard CODESYS. Les deux commandes sont décrites dans la référence de l'API.

Exemples de scripts
Dans le mode Backstage, page « Aide » > [Raccourcis] > [Exemples de projets], vous trouverez des exemples de scripts pour divers cas d'utilisation dans e!COCKPIT.
Une brève description des scripts d'exemple se trouve après les étapes ci-après.

Exécutez les scripts Python à partir de la ligne de commande ou de l'interface utilisateur.

Ligne de commande

  1. Ouvrez la ligne de commande Windows :
    Cliquez sur le menu Démarrer ([Démarrer]) ou alternativement sur [Touche Windows] + [R].
  2. Entrez « cmd » dans le champ de saisie.
  3. La ligne de commande est ouverte.
  4. Les scripts Python sont appelés selon le modèle suivant :
    e!COCKPIT.exe --runscript=“<scriptfile>.py“ --scriptargs:‘<arg1> <arg2> ... <argn>‘ –enablescripttracing
    Les deux paramètres suivants sont facultatifs :
    --scriptargs:'argument1 argument2' : transfert des arguments au script
    --enablescripttracing : le traçage de script est activé
  5. Exécuter des scripts Python, par ex. :
    „e!COCKPIT.exe“ --runscript=“C:\CTemp\test.py“ –enablescripttracing

Interface utilisateur e!COCKPIT

  1. Ouvrez l'onglet « FICHIER » dans l'interface utilisateur e!COCKPIT.
  2. Ouvrez la page « Script ».
  3. Pour sélectionner et exécuter un fichier de script Python (* .py) sur votre PC, cliquez sur [Exécuter le fichier de script].
  4. Pour générer toutes les commandes d'un script Python dans le panneau de commande « Messages » et les enregistrer dans le fichier log du script Python, cliquez sur [Activer le suivi de script]. La description sur le bouton devient « Désactiver le suivi de script ». Cliquez à nouveau sur le bouton pour arrêter la fonction de traçage.
  5. Pour ouvrir le fichier log du script Python, cliquez sur [Ouvrir le fichier log de script].

Utiliser des exemples de script

e!COCKPIT propose des scripts d'exemple via la vue backstage. Accès aux scripts soit via la page « Aide » > [Liens] > [Exemples de projets] > Python Scripting, soit via la page « Ouvrir » > [Exemples d'applications] > Python Scripting.

Vue des exemples de script

vue des scripts d'exemple Python

Dossier/fichier

Description

Device Related

 

 

 

 

 

 

 

access_device_catalog.py

Ouvrir l'appareil à partir du catalogue et lire les caractéristiques

add_delete_device.py

Ajouter/supprimer des appareils

create_delete_logical_connection.py

Établir/supprimer la connexion logique

export_import_element.py

Exporter/importer des éléments de programme

import_application.py

Importer l'application

set_ip_address.py

Attribuer l'adresse IP

update_device.py

Effectuer une mise à jour des appareils

Module Related

 

 

 

 

 

 

 

add_delete_device.py

Ajouter/supprimer des modules

export_io_mapping.py

Exporter l'image E/S

get_module.py

Appeler le module

import_io_mapping.py

Importer l'image E/S

read_write_module_parameter.py

Lire/écrire les paramètres de module

set_io_mapping.py

Représenter les entrées/sorties

Online Operation

 

 

 

 

 

 

 

 

connect_disconnect_device.py

Établir/terminer la connexion avec l'appareil

create_boot_application_offline.py

Créer hors ligne l'application d'amorçage

create_boot_application_online.py

Créer en ligne l'application d'amorçage

print_paramter_list.py

Émettre la liste de paramètres

read_variable_online.py

Lire les variable en ligne

read_write_parameter.py

Lire/écrire les variables

simulate_application.py

Simuler une application

Project Related

 

 

 

 

 

 

 

 

 

create_project_from_template.py

Créer un projet à partir d'un modèle

create_save_project.py

Créer et enregistrer le projet

get_device_in_project.py

Interroger/appeler l'appareil dans le projet

get_set_compiler_version.py

Interroger/appeler la version de compilateur

get_set_visualization_profile.py

Interroger/appeler le profil de visualisation

open_and_update_project.py

Ouvrir le projet et effectuer la mise à jour

open_archive.py

Ouvrir l’archive

save_archive.py

Enregistrer l’archive

update_project.py

Effectuer la mise à jour du projet

System Related

 

 

close_ecockpit.py

Fermer e!COCKPIT

Vous trouverez de plus amples informations sous :