Options en ligne de commande

Sommaire Serveur Rocrail



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.
-nodevcheck              | Désactiver la vérification pour les dispositifs série au démarrage.
-devcheck                | Active la vérification pour les dispositifs série au démarrage.
-stress                  | Active le fonctionnement en mode stress pour le test de communication.
-------------------------+--------------------------------------------
-installservice          | Installer Rocrail comme service Windows.
-deleteservice           | Désinstaller Rocrail comme service Windows.
-------------------------+--------------------------------------------


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 6919 [e9994c79ce3f34404ec811df05de71aec2688faf]
 Build: Mar  5 2014 08:31:54
 librocs 2.0-0 build Mar  5 2014 08:31:47
 processid = 70833
       mac = 001A92FC0D5D0000


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.

Service Windows

Ce sujet est expliqué dans Fonctionnement comme service Windows.


Désactiver/Activer la vérification pour les périphériques série au démarrage

Désactiver/Activer la vérification pour les périphériques série au démarrage.
Les deux options de ligne de commande sont mutuellement exclusifs; Aucun changement si les deux sont fixés.
La vérification du périphérique peut être la cause sous Windows de plantage au démarrage. Dans ce cas elle doit être désactivée.
Elle peut être également désactivée/activée dans la configuration du Contrôleur Rocrail.


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 

Personal Tools