Table of Contents
Options en ligne de commande
- Moniteur serveur | Mode console mode | Plusieurs centrales numériques | Options en ligne de commande
Rocrail peut être démarré à partir d'une ligne de commande, par exemple pour le faire fonctionner sur une machine serveur tandis que les clients Rocview connectés à lui fonctionnent sur d'autres machines à l'intérieur du réseau domestique. Voir également la section Exemples à la fin de cette page.
Aide en ligne
Quant Rocrail démarre avec l'option en ligne de commande
--help
il affiche:
---------------------------------------------------------------------- Rocrail commandline options: -------------------------+-------------------------------------------- --help or -? | Affiche cette aide et quitte. -version | Affiche l'information sur la version et quitte. -doc | Écrit la documentation dans Rocrail.html. -------------------------+-------------------------------------------- -debug | Bascule vers le niveau de suivi debug. -byte | Bascule vers le niveau de suivi byte. -parse | Bascule vers le niveau de suivi analyseur xml. -monitor | Bascule vers le niveau de suivi moniteur contrôleur. -info | Bascule vers le niveau de suivi information. -------------------------+-------------------------------------------- -console | Lire l'entrée de la console. -nocom | Arrêter la communication. -pwr | Mise sous tension. -auto | Alimentation et mode auto en marche. -run | Démarrer toutes les locomotives. -resume | Démarrer les locomotives précédentes. -w [workdir] | Changer le répertoire des programmes en cours. -l [libdir] | Répertoire de la bibliothèque. -img [imgdir] | Répertoire Images. -p [portnr] | Port du service pour les clients. [8051] -i [inifile] | Fichier Ini. [rocrail.ini]. -t [tracefile] | Fichier suivi. [rocrail]. -x [planfile] | Fichier Plan. [plan.xml]. -f | Champ Init. -sod | Début de journée: Interrogation des capteurs. -stress | Active le fonctionnement en mode stress pour le test de communication. -virtual | Utilisé pour tous les digints définis la Centrale numérique virtuelle. -lic | Chemin et nom du fichier de la clé de contribution. -------------------------+--------------------------------------------
Une option en ligne de commande remplacera l'équivalent trouvé dans le fichier rocrail.ini.
- Toutes les options en ligne de commande n'ont pas d'équivalent dans le fichier rocrail.ini.
Version
Vérifier la version du serveur pour être sûr que c'est la bonne:
Rocrail 14415 [7de033fd0c355b405c5b4438abc2129b5860ee7a][LOCAL] Build: Oct 1 2018 08:06:37 librocs 2.0-0 build Sep 30 2018 16:39:48 processid = 70520 mac = 00005CF938A62F88 guid = 00005CF938A620181001081017060000
Documentation
La commande -doc
écrira la même documentation que celle trouvée en ligne:
http://www.rocrail.net/doc/rocrail-wrappers/wrapper-en.html
Mais si vous en avez besoin et que vous n'avez pas une connexion à Internet sous la main…
Niveaux de débogages
debug
A utiliser avec précaution; pour le traçage des bugs par les développeurs. (Demande beaucoup de temps CPU.)
byte
Utile quand on a des problèmes de connexion avec la centrale numérique.
parse
A utiliser avec précaution; pour le traçage des bugs par les développeurs. (Demande beaucoup de temps CPU.)
monitor
Montre toutes les informations venant de la(des) centrale(s) numérique.
info
Normalement déjà actif, mais pratique si ce niveau est mis à false dans le fichier rocrail.ini.
Console
Seulement ce mode accepte les commandes en console.
Rocview sera renseigné à la connexion à propos de ce mode et désactivera l'élément du menu "Arrêter le serveur".
Nocom
L'option -nocom
peut être utilisé pour faire un démarrage à sec; il n'y aura aucune communication entre Rocrail et la(les) centrale(s) numérique.
Répertoire de travail
Utilisation d'un autre répertoire de travail autre que celui avec lequel Rocrail est démarré utiliser l'option -w [chemin]
.
Assurez-vous que Rocrail puisse trouver les bibliothèques, il peut être nécessaire de fixer l'option -l [chemin]
également.
Répertoire des bibliothèques
Rocrail cherche dans le répertoire de travail les bibliothèques. Si elles sont dans un autre répertoire cela peut être fixé en utilisant l'option -l [chemin]
.
Port Client
Si le port par défaut est déjà utilisé par un autre processus cela peut être changé en utilisant -p [port#]
.
Champ Init
Cette option a le même effet que celle trouvée dans Rocview:
- Actionne tous les aiguillages pour synchroniser Rocrail avec le réseau.
- Il sera envoyé une commande à tous les signaux avec le dernier état connu, ou 'ROUGE' si aucun état n'est disponible.
SOD
Start Of Day (Début de Journée).
Interroge tous les capteurs si la centrale numérique connectée le supporte.
Stress
Certaines bibliothèques ont le support pour des tests de stress de communication:
- Loconet
- BiDiB
- CBUS
- Virtual
- Dinamo
Exemples
La commande complète exacte ne dépends pas seulement du type de système d'exploitation (Windows, Linux, Mac, …) mais également de sa version et parfois de la langue.
Dans ces exemples
- "My_Name" a été remplacé par le nom d'utilisateur.
- La commande -w spécifie le répertoire de travail contenant le plan et les fichiers .ini
- Dans le mode -console le serveur ne peut pas être arrêté accidentellement par le client
Une commande de démarrage valide peut ressembler à cela:
Windows 7
S'applique à toutes les langues.
Démarrer Rocrail.exe à partir de la ligne de commande window (quelque soit le répertoire actuel):
c:\"program files (x86)"\rocrail\rocrail.exe -w c:\users\My_Name\documents\rocrail -console
Comme un fichier de commandes:
cd c:\"program files (x86)"\rocrail rocrail.exe -w c:\users\My_Name\documents\rocrail -console
Windows XP
Version langue allemande.
c:\Programme\Rocrail\rocrail.exe -w "c:\Dokumente und Einstellungen\My_Name\Eigene Dateien\Rocrail" -console