Skip to main content

Utiliser l'interface de ligne de commande

Tu peux CODESYS.exe à partir de la ligne de commande, en spécifiant les options et les arguments décrits ci-dessous.

Syntaxe:

<installation folder>CODESYS.exe --<Option>

Note

Si vous avez utilisé le CODESYS Installer pour installer plusieurs CODESYS instances sur votre ordinateur, vous devez alors utiliser le --additionalfolder option pour spécifier l’instance à lancer.

Astuce

Les chemins ou les paramètres d'option contenant des espaces, des signes moins ou des barres obliques doivent être placés entre guillemets simples.

Option : --dossier supplémentaire

S'applique uniquement aux installations réalisées avec le CODESYS Installer:

Si vous avez installé plusieurs instances d'un CODESYS version et que vous souhaitez démarrer l'une des instances à partir de la ligne de commande, alors ce qui suit s'applique : En plus du profil, vous devez également spécifier le chemin absolu du AddionalFolder/<instance name> avec le --additionalfolder option.

Contexte : Le CODESYS Installer crée un AdditionalFolders sous-dossier dans le répertoire d'installation dans le CODESYS dossier. Dans ce dossier, il y a un sous-dossier distinct pour chaque CODESYS instance avec les fichiers individuels pour le profil, les plug-ins et PackageDB. Pour la première instance installée, le sous-dossier est nommé Default. Les instances supplémentaires reçoivent le nom d'installation attribué lors de l'installation.

Vous pouvez voir le chemin absolu à spécifier pour --additionalfolder dans CODESYS Installer lorsque vous cliquez sur le Changement dans la vignette de l'instance concernée. Il est enregistré comme le Emplacement.

Syntaxe:

--additionalfolder=<AdditionalFolders\<instance installation name>>
Exemple 44. Exemple

Deux cas de CODESYS 3.5.18.20 ont été installés sur votre ordinateur avec le CODESYS Installer: un pour les techniciens de service, un pour les développeurs. Vous souhaitez exécuter le Service exemple via un StartServiceScript.py script à partir de la ligne de commande. Pour ce faire, spécifiez l'option --additionalfolder après l'option --profile sur la ligne de commande comme suit :

"C:\Program Files (x86)\CODESYS3.5.18.20\CODESYS\Common\CODESYS.exe" --profile="CODESYS V3.5 SP18 --additionalfolder="C:\Program Files\CODESYS 3.5.18.20\CODESYS\AdditionalFolders\Service"  --runscript="D:\Dokumente\Scripting\StartServiceScript.py"--scriptargs:'username password 3.14 "path=\"C:\temp\\\""'–noUI


Option --culture (langue locale de l'interface utilisateur)

CODESYS est lancé dans la langue nationale spécifiée.

Syntaxe:

--culture=<Culture>

<Culture>: Abréviation usuelle de la langue nationale souhaitée, par exemple de, en, fr, it, es, zh-CHS.

Exemple 45. Exemple

Commencer à partir de CODESYS avec interface utilisateur en anglais :

CODESYS.exe --culture=en


option --profile (CODESYS-Profil)

CODESYS est lancé directement avec le profil spécifié. Si vous CODESYS démarrez sans cette spécification, vous obtenez la boîte de dialogue Choisissez un profil.

Syntaxe:

--profile="<profile name>"

<profile name>: Vous devez spécifier le nom du profil exactement tel qu'il apparaît dans la boîte de dialogue Aide → Informations du système de développement ou dans le menu démarrer de votre ordinateur.

Exemple 46. Exemple
CODESYS.exe --culture=de --profile="CODESYS V3.6"


Option --compare (déclencher la comparaison de projets)

Après être parti de CODESYS devient immédiatement la comparaison de deux CODESYS-Projets réalisés. Entrez d'abord le "projet actuel" puis le "projet de comparaison" comme arguments derrière l'option. CODESYS démarre et ouvre la vue Comparaison de projets - différences.

Syntaxe:

--compare="<path of project file>" "<path of reference project file>"
Exemple 47. Exemple
CODESYS.exe --compare  "D:\proj\project1.project"  "D:\proj\project2.project"


Options --project (CODESYS-projet ouvert)

CODESYS est démarré et le projet spécifié est ouvert.

Syntaxe:

--project="<path of project file>"

<path of project file>: Chemin du fichier du projet

Exemple 48. Exemple

Ouvrir le projet test:

CODESYS.exe --culture=de --project="D:\projects\test.project"


Options --projectarchive (CODESYS- archive de projet ouverte)

CODESYS démarre, extrait le référentiel spécifié et ouvre le projet.

Syntaxe:

--projectarchive="<path of projectarchive file>"

<path of project archive file>: chemin du fichier de référentiel

Exemple 49. Exemple

Extraction de l'archive du projet test.projectarchive et ouvrir le projet dans le système de programmation :

CODESYS.exe --projectarchive="D:\projects\test.projectarchive"


Option --runscript (exécuter le script)

Le fichier de script spécifié est exécuté par CODESYS réalisé.

Tableau 8. Options de ligne de commande pour --runscript

--runscript="<scriptfile>.py"

CODESYS exécute le fichier de script <scriptfile>.py éteint au démarrage.

Vous devez spécifier le chemin d'accès complet du fichier de script.

--scriptargs:'<arg1> <arg2> ... <argn>'

Utilisez l'option avec l'option --runscript. Il provoque le passage des arguments <arg1> … <argn> au script. Les arguments sont passés à la variable Python sys.argv transmis.

--noUI

Utilisez l'option avec l'option --runscript.

la CODESYS L'interface utilisateur ne s'ouvre pas. CODESYS affiche toutes les erreurs, avertissements, messages du compilateur et messages générés par le script sur la ligne de commande. Les messages de script (1 : Severity Text) peuvent être séparés des autres messages (2 : Severity FatalError, Error, Warning, Information) avec l'opérateur > être séparés.

--enablescripttracing

Utilisez l'option avec l'option --runscript. Il fait apparaître chaque commande du fichier de script dans la sortie.

--textPrompts

Utilisez l'option avec l'option --noUI. Il entraîne la sortie des méthodes de service de messagerie et des boîtes de dialogue standard sur la ligne de commande afin que l'entrée de l'utilisateur puisse avoir lieu.

Si vous --textPrompts S'il n'est pas spécifié, toutes les invites du service de messagerie reçoivent automatiquement la valeur par défaut.

scriptdebugger {="<debugger>"}

Utilisez l'option avec l'option --runscript. Il met IronPython en mode débogage afin que des débogueurs externes puissent être utilisés pour déboguer les scripts Python. Les valeurs suivantes sont définies pour <debugger>, qui ne sont pas sensibles à la casse :

  • auto: Détecte automatiquement si un débogueur est attaché au processus en cours à chaque lancement de script. Actuellement, seuls les débogueurs basés sur .NET peuvent être détectés automatiquement. Un débogueur détecté remplace l'indicateur --enablescripttracing.

  • .NET: active le débogage pour les débogueurs basés sur .NET tels que les outils Python pour Visual Studio (PTVS) et SharpDevelop. Contrairement à "auto", un débogueur peut également être attaché à des scripts déjà en cours d'exécution avec cette option.

    Remarque : il s'agit actuellement de la valeur par défaut si --scriptdebugger est utilisé sans spécifier de valeur.

  • disabled: désactive le débogage et la détection automatique.

  • script: met le moteur de script IronPython en mode débogage pour activer le débogage pour les débogueurs basés sur settrace. Le script lui-même doit se connecter et se déconnecter du débogueur.

  • tracing: Active l'opération intégrée simple de "traçage de script" et désactive la détection automatique. Équivalent à l'option --scripttracing.

  • $absolute_path.py$: chemin absolu vers un script Python qui initialise la connexion à un débogueur basé sur Python. Le moteur de script IronPython est passé en mode débogage pour activer le débogage pour les débogueurs basés sur settrace. Ce script sera exécuté une fois lors de l'initialisation et il doit définir les fonctions sans paramètres suivantes :

    scriptdebuggersetup est exécuté juste avant l'exécution du script utilisateur afin d'établir la connexion au débogueur.

    scriptdebuggershutdown est appelée immédiatement après l'exécution du script utilisateur ou lorsque le moteur de script est arrêté, et doit se déconnecter du débogueur.



Exemple 50. Exemples d'utilisation de paramètres de transfert dans des fichiers de script à l'aide de sys.argv
start /b /wait CODESYS.exe
--runscript="D:\Script\ArgvAnd__main__Test.py"
--scriptargs:'username password 3.14 "path=\"C:\temp\\"'

Fichier de script ArgvAnd__main__Test.py

from __future__ import print_function
import sys
print("sys.argv: ", len(sys.argv), " elements:")

for arg in sys.argv:
    print(" - ", arg)
print()
print("__name__: ", __name__)

résultat de sortie stdout:

sys.argv: 6 elements:
- D:\TestScripts\ArgvAnd__main__Test.py
- username
- password
- 3.14
- path= "C:temp"
__name__: __main__

En savoir plus sur la variable globale __name__ voir la documentation Python.



Exemple 51. Exemples de sortie de message
start /b /wait CODESYS.exe --runscript="D:\Script\AmpelTest.py" --noUI 1>ScriptMessages.txt

Toutes les notifications générées par le script sont acheminées CODESYS dans le dossier ScriptMessages.txt environ. Les autres messages sont affichés dans la ligne de commande.

start /b /wait CODESYS.exe --runscript="D:\Script\AmpelTest.py" --noUI 2>NUL

CODESYS supprime tous les messages à l'exception des messages de script. Les messages de script sont affichés dans la ligne de commande.



Exemple 52. Exemple utilisant l'option –scriptdebugger

Le script suivant initdebug.py a réussi avec pydevddes débogueurs basés sur PyDev / LiClipse ou PyCharm. Pour utiliser ce script, lancez CODESYS avec la ligne de commande suivante :

--profile="Fanta Development Build" --scriptdebugger="D:\test\charmdebug\initdebug.py"

déposerinitdebug.py:

from _future_ import print_function
from _future_ import unicode_literals
import sys
sys.path.append(r"D:\test\Env2\Lib\site-packages\pycharm-debug.egg")
import pydevd
def scriptdebuggersetup():
pydevd.settrace('localhost', port=51234, stdoutToServer=True, stderrToServer=True)
def scriptdebuggershutdown():
pydevd.stoptrace()


Pour plus d'informations, consultez : Utiliser des scripts et http://docs.python.org/tutorial/modules.html

Option : --ignorewhitespace (ignorer les espaces lors de la comparaison de projets)

Si vous mettez cette option derrière l'option --compare <project1> <project2> ajouter, les espaces ne sont pas pris en compte dans la comparaison de projets. Remarque : les espaces sémantiquement pertinents, comme dans STRING-les littéraux sont toujours pris en compte dans tous les cas.

syntaxe

--compare="<path of project file>" "<path of reference project file>" --ignorewhitespace="true"|"false"
Exemple 53. Exemple
CODESYS.exe --compare "D:\proj\project1.project" "D:\proj\project2.project" --ignorewhitespace="true"


Option: --ignorecomments (Ignorer les commentaires lors de la comparaison de projets)

Si vous mettez cette option derrière l'option --compare <project1> <project2> ajouter, les commentaires ne sont pas pris en compte dans la comparaison de projets.

Syntaxe:

--compare="<path of project file>" "<path of reference project file>" --ignorecomments="true"|"false"
Exemple 54. Exemple
CODESYS.exe --compare "D:\proj\project1.project" "D:\proj\project2.project" --ignorecomments="true"


Option: --ignoreproperties (Ignorer les propriétés de l'objet lors de la comparaison de projets)

Si vous mettez cette option derrière l'option --compare <project1> <project2> add, les propriétés des objets (droits d'accès, paramètres de traduction, répertoires, bitmaps, etc.) ne sont pas prises en compte dans la comparaison de projets.

Syntaxe:

--compare="<path of project file>" "<path of reference project file>" --ignoreproperties="true"|"false"
Exemple 55. Exemple
CODESYS.exe --compare "D:\proj\project1.project" "D:\proj\project2.project" --ignoreproperties="true"


Option: --skipunlicensedplugins (ne charge pas les composants sans licence)

CODESYS a démarré. La question de savoir si les composants sans licence doivent néanmoins être chargés est ignorée. Dans ce cas charge CODESYS implicitement ces composants ne pas.

Exemple 56. Exemple
CODESYS.exe –skipunlicensedplugins


Option: --signaturethumbprint (empreinte du certificat utilisé pour signer les bibliothèques traduites)

Si vous mettez cette option derrière l'option --project="<path of project file>" ajouter, le projet sera ouvert en passant l'empreinte du certificat pour la signature des bibliothèques traduites.

Syntaxe:

--signaturethumbprint="<thumbprint of digital signature>"
Exemple 57. Exemple
CODESYS.exe --project="D:\projects\test.project" signaturethumbprint="3E96C9B61010CBDC3186021A1CAA64946DDCAAF3"


Option : --enforcesignedcompiledlibraries (applique la signature des bibliothèques compilées)

Si vous mettez cette option derrière l'option --project="<path of project file>" add apparaîtra dans le projet dans le écran de sécurité sur l'onglet utilisateur l'option Appliquer la signature des bibliothèques traduites activé.

Important

Si la écran de sécurité est ouvert et refermé, les paramètres actuels sont appliqués aux options utilisateur, même si aucune modification active n'a été apportée.

Syntaxe:

--enforcesignedcompiledlibraries
Exemple 58. Exemple
CODESYS.exe --project="D:\projects\test.library" --enforcesignedcompiledlibraries


Option: --timestampingserverurl (définir l'adresse du serveur d'horodatage)

Si vous mettez cette option derrière l'option --project="<path of project file>" add apparaîtra dans le projet dans le écran de sécurité sur onglet utilisateur l'adresse Internet du serveur d'horodatage RFC-3161 (Serveur d'horodatage) ensemble.

Important

Si la écran de sécurité est ouvert et refermé, les paramètres actuels sont appliqués aux options utilisateur, même si aucune modification active n'a été apportée.

Syntaxe:

--timestampingserverurl="<URL of RFC-3161 timestamping server>"
Exemple 59. Exemple
CODESYS.exe --timestampingserverurl="http://timestamp.comodoca.com/rfc3161"


Option : --enableEventLog

CODESYS est démarré et toutes les exécutions de commandes sont enregistrées dans le journal des événements Windows. Les enregistrements se trouvent dans Windows Observateur d'événements sous Journaux des applications et des services → AP.

Lorsque vous utilisez cette option pour la première fois, CODESYS doit être démarré avec des autorisations d'administrateur.

Syntaxe:

--enableEventLog="CommandManager"

Option : --ForceDisconnectAfterInactivity

Pour ça CODESYS session, le temps d'inactivité après lequel la connexion au contrôleur est automatiquement interrompue est défini sur la durée spécifiée (en secondes). La valeur spécifiée dans cette option remplace la valeur définie dans le CODESYS options dans le En ligne catégorie pour ça CODESYS session.

Si la valeur est définie sur 0, la connexion au contrôleur ne sera pas automatiquement interrompue après une période d'inactivité spécifique. Pour ça CODESYS session, cela désactive l'option de déconnexion dans la CODESYS choix.

Syntaxe:

--ForceDisconnectAfterInactivity="<value in seconds>"
<value in seconds> : [10, 10800] | 0
Exemple 60. Exemple

Après 300 secondes d'inactivité, la connexion au contrôleur est automatiquement interrompue.

--ForceDisconnectAfterInactivity="300"