Configuration des Actions

SommaireObjetsActions


Onglet Index

Entêtes de colonne du tableau

Identifiant: Identifiant unique de l'action
Description: C'est un texte libre pour décrire l'action plus clairement.
Type: L'abréviation du type (voir tableau ci-dessous). Le type est configuré dans l'onglet Définition.

Double clic

Un double clic ouvrira l'Editeur Xml si l'action sélectionnée est un script Xml.

Nouveau

Ajoute une nouvelle action à la liste.
Change l'identifiant
L'identifiant et la description d'une action peuvent être changés en sélectionnant la ligne dans la liste puis en écrivant le texte requis dans les champs respectifs. Il est conseillé d'utiliser des identifiants explicites.

Copier

Copie l'action sélectionnée. C'est une aide pour définir des actions du même genre.

Supprimer

Supprime l'action sélectionnée.

Documentation

Ouvre le navigateur WEB par défaut avec toutes les actions dans un format imprimable.

Test

Test inconditionnel de l'action sélectionnée.
Toutes les variables sont configurées comme dans le cas du mode automatique.


Définition

Type & Identifiant

Ces deux champs définissent l'objet qui pourrait réaliser l'action. Le Type peut être sélectionné dans la liste déroulante (voir tableau ci-dessous). L'identifiant d'un objet existant de la catégorie du Type peut être sélectionné dans la liste déroulante, sinon il est laissé vide.

Pour les types Locomotive et fonction l'identifiant d'une locomotive existante sera disponible pour la sélection.

Le champ Identifiant pour les types locomotive et fonction peut être laissé vide si les objets suivants sont utilisés pour déclencher l'action:

  • Capteur
  • Itinéraire
  • Aiguillage
  • Horaire

Dans ce cas le Contrôle d'Action de ces objets remettra automatiquement l'identifiant de la locomotive qui déclenche l'action à l'action elle-même.
Cela rend possible de définir des actions pour les locomotives et leurs fonctions qui s'appliquent à n'importe quelle locomotive qui à ce moment se trouve sur cet itinéraire/capteur/aiguillage/horaire, sans avoir à définir une nouvelle action pour chaque locomotive.
Par exemple: Les feux peuvent être allumés (fonction F0) quand un itinéraire particulier est emprunté ou qu'un sifflet est actionné avant d'entrer dans un tunnel.
Il est aussi possible de déclencher telle action en utilisant les conditions.

Sous-Identifiant

A utiliser uniquement avec les Variables.

Commande

La commande qui sera réalisée par l'objet dans le champ Type est sélectionnée ici. Seules les commandes pouvant être réalisées par le Type sélectionné sont disponibles dans la sélection (voir tableau ci-dessous)

Bouton trois points (...)

Peut être utilisé pour sélectionner le chemin vers un programme externe ou un script de type Externe. (Voir note sur Externe ci-dessous.)

Double guillemet

Optionnel si le serveur Rocrail fonctionne sous Windows pour ajouter un guillemet supplémentaire:

""c:\programs\test\speak.exe" "Hello World""

Sans cette option la commande serait comme suit:

"c:\programs\test\speak.exe" "Hello World"

Asynchrone

Le programme externe, script externe ou script XML sera exécuté de façon asynchrone pour empêcher le blocage des objets appelants.
Dans certains cas il est préférable d'attendre jusqu'à ce que le process externe soit terminé. (Par exemple: WebCam)

Paramètre

Quelques commandes requièrent un paramètre supplémentaire (voir tableau ci-dessous).

Types, Commandes & Paramètres

Type Type
abbr.
ID Commandes Paramètre Description
Sortie co Sortie on, off, flip, active1), value, lock, unlock 0…65535
lockid (unlockid)
La valeur de la commande est uniquement supportée par les librairies SRCP et BiDiB.
AccGroup accgroup AccGroup on, off, flip
Capteur fb Capteur on, off, flip, reset, setcounterval New counter value; Relative if prefixed with a sign.
The calculated counter value is reset to zero if its negative.
The sensor can be turned on, off or flipped. On reset the counter of the sensor will be set to 0.
Externe ext - A script, program, record or XML Script name. parameters given here will be appended to the program call² Blanks in the program path are not supported.
If its not avoidable, use a batch file with quotes for path/file.
Parameter take on in batch file with %1 %2 …
In case of an XmlScript the parameter field can be used to call just one function.
Aiguillage sw Switch straight, turnout, left, right, lock, unlock force
lockid (unlockid)
Itinéraire st Route set, lockset, lock, unlock, open, closed, class lockid (unlockid) The 'lock' commands are for manually setting routes protected by locking it and all switches. (Software CTC)
The lockid is optional and must be used also for unlock if set. The action ID is used if left empty.
The set command does not color the route in the clients.
System sys - stoplocs, stop, go, shutdown, resume, on, off, ebreak, resetfx, time, v0locos, initfield - “on/off” is for switching the automode.
“resetfx” sets the selected function group 0…7 to OFF for all locos. (only ONE parameter allowed: 0 = f0-f4, 1 = f5-f8 …)
“time” in format 00:00 Only available with 60 second action timer.
Signal sg Signal red, yellow, green, white, aspect Aspect number in the range of 0…31.
Bloc bk Bloc schedule, schedule_manual, tour, unlock, white, yellow, green, red, setloco, event, open, closed, acceptident, dispatch, go, reserve, class schedule/tour ID, loco ID, sensor ID
unlock loco ID or *
schedule_manual: Start in half automatic mode
The color commands will set the main forward signal defined for this block.
Staging block sb Staging block unlock, white, yellow, green, red, open, closed, exitopen, exitclosed, compress unlock ID The color commands will set the exit signal defined for this block.
open/closed are for enter side.
Locomotive lc Locomotive go, stop, velocity, velocity2, percent dispatch, swap, blockside, carcount, min, mid, cruise, max, consist, assigntrain, releasetrain, binstate_on, binstate_off, class, x-go, pomwrite, Vvar go: tour, schedule, location or block ID (A variable can also be used instead of a fixed name.)
velocity¹: percentage of current set velocity¹
velocity2: speed of secondary decoder
carcount: number of cars or reset to 0
consist: locoID[,locoID]…
binstate: output number
x-go: comma separated list of loco addresses or ID's hard coded or with variables.
pomwrite: cv,value
Vvar: user Velocity
Leave the parameter field empty to reset a consist.
If no loco is found and the parameter field contains a #variable a loco will be searched by address. This option disable further parameters.
In case a destination is set at the GO action: Read this!
Fonction fn Locomotive
Car
Operator³
on, off, flip function number (just the number, like 1, not f1 for function 1) or the function text (Description) (Case sensitive).
A function csv list like “1,2,3”. If the list starts with a question mark, ”?1,2,3”, it will pick randomly one function.
Only one active timed function is supported. Multiple will show unpredictable results. Flip will turn on the function when it was off and vice versa. Flip does noet support timed functions.
Plaque tournante tt Turntable goto, 180, on, off, lighton, lightoff track number (goto) or function (on/off)
Fiddle Yard seltab Fiddle Yard goto track number
Texte tx Text update, value Dynamic text: %lcid%, %lcdest%, %lcnr%, %frombkid%, %bkloc%, %frombkloc%, %bkid%, %counter%, %carcount%, %countedcars% and %wheelcount% will be replaced with real values. Variables: Syntax
Son sound - play, straigh, turnout Sound file name. Set the sound player device in the interface tab.
Variable var Variable text, value, add, subtract, min, max, random, start, stop The new value. -
Voiture car Car empty, loaded, maintenance The new car status. -
Operateur operator Operator addcar, removecar, loadcar, emptycar, class Adding, removing, loading or emptying cars. A comma separated list of car IDs.
Localité location Locality minocc, fifo, go, schedule Sets the minimal occupation in this locality.
go and schedule will start random a loco.
parameter: minocc number or 0/1 for fifo de/activation
Météo co Weather setweather, weathertheme Activates the selected weather(theme) ID. At “setweather” the parameter may be used to set the sunrise,noon,sunset time in minutes. For example: “360,720,1080[,relative/absolute]” (06:00,12:00,18:00)
Horloge clock - set divider,hour,minute The time can only be set if the divider > 1.

¹ When velocity or percent is negative the execution of the action will not only set the locomotive speed, but also change direction. Please note that only a negative value changes direction, it is not the case that negative means backwards and positive forwards.
² Hint: To debug not working external program calls; In the trace lines containing the executed command look like this OAction 0501 executing [espeak -vde eins]
³ Function commands are send to all wagons in the operator train.

Notes:

Type Externe:

Si ce type est employé pour exécuter un programme ou un script externe le chemin du programme ou script (y compris les paramètres) est écrite dans le champ de commande. Le chemin devrait exister sur le serveur, ainsi si vous utilisez le bouton Triple Point (…) sur un ordinateur autre que celui sur lequel le serveur Rocrail est installé cela ne correspondra probablement pas.
Alternativement un programme peut être démarré dans son propre process sous système Unix. (myprog.sh &)

Playback

Un fichier son, *.txt, peut aussi être sélectionné en tant que commande externe pour la diffusion.
Voir: Command Recorder
Les paramètres supplémentaires sont ignorés.

Script XML

A XML script file, *.xml, can also be selected as external command to run.
Voir: XML Scripting
Les paramètres supplémentaires sont ignorés.

Exemple: Son diffusé avec VLC

Installer VLC.
Définir une action:
Tapper: “run ext. program”
Par défaut laisser “Double guillemet” et “Asynchrone” inchangés.
Commande: “C:\Program Files (x86)\VideoLAN\VLC\vlc.exe” ou le chemin où VLC est installé.
Paramètre: “C:\sound\Aarau1_Irina.mp3 –play-and-exit –qt-start-minimized –qt-notification=0”.

Explication des paramètres: “C:\sound\Aarau1_Irina.mp3” - le titre (ici un “mp3”) qui sera joué.
”–play-and-exit” - le programme VLC est démarré, le son joué et le programme fermé.
”–qt-start-minimized” - pas d'affichage de fenêtre.
”–qt-notification=0” - Windows ne joue aucun autre son.

L'action peut être déclenchée par l'horloge ou la rétro-signalisation.

Durée

La durée de l'action est en unités de 100ms; 10 = 1s. Durée illimitée si égale à zéro.
Seulement utilisé pour les commandes de fonction.

Minuterie

Nombre de millisecondes à attendre avant d'exécuter cette action après qu'elle ait été déclenchée.

Cela peut être employé, par exemple, pour activer un sifflet avant un tunnel sans avoir à installer un capteur séparé. L'action peut être déclenchée par le dernier capteur (distant) et être réalisée après le délai juste avant le tunnel.

Un contrôle d'action peut être utilisé pour déclencher plusieurs actions au même moment mais qui peuvent être accomplies avec différents délais l'un après l'autre.

Temps d'activation

Utilisation

Si l'action doit être déclenchée à un instant particulier Utilisation sera coché et le temps nécessaire sera saisi.
La durée se réfère à l'horloge Rocrail et non à l'horloge réelle. Voilà des situations possibles dans lesquelles il est utile d'avoir l'horloge Rocrail plus rapide que l'horloge réelle, par exemple pour implémenter un contrôle jour/nuit sur 24h.
Si l'option Minuterie d'Action 60 sec. dans le serveur Rocrail est configurée, la deuxième valeur est aussi évaluée.

Tous

Cette action sera exécutée toutes les heures + minutes après qu'elle ait été validée par un contrôle d'action avec l'état “on”.
Elle peut être désactivée par un contrôle d'action avec l'état “off”.
La case Utilisation doit être cochée pour activer chaque minuterie.
La case Aléatoire doit être décochée.
L'intervalle d'exécution le plus court est de une minute.

Aléatoire

Cette action sera exécutée à intervalle aléatoire.
La durée aléatoire d'activation est respectivement entre 1 minute et la durée d'activation spécifiée. La résolution est à l'échelle des minutes.
La case Utilisation doit être cochée pour activer la minuterie aléatoire.
La case Tous est sans effet si Aléatoire est cochée.

Activé

Option de pré-activation; Aucun événement n'est nécessaire pour évaluer la durée d'activation.


Usage

Cet onglet énumère tous les autres objets, “Identifiant (Type)”, utilisant l'action sélectionnée sur l'onglet index.

Un double clic sur un objet de la liste ouvrira le Contrôle d'Action correspondant.


Interface

L'adresse de port du lecteur musical.

Si la commande de son est straight ou turnout une commande d'aiguillage est générée.2)
Si la commande de son est jouée une action est générée qui est supportée par:

  • RocNet
  • RocNetNode
  • Virtual
1) The output active state is only virtual and can not be visualised with real I/O.
2) Le nom du fichier est ignoré.

Personal Tools