Table of Contents
Configuration des Actions
- Configuration des Actions | Contrôle des Actions | Actions système | Condition des Actions | Script XML | Exemple
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 1)
- 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/capteur1)/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.
1) Un capteur fournit l'identifiant de la locomotive que s'il est assignée à un bloc et sans évènement.
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 | Nouvelle valeur du compteur; Relative si préfixé avec un signe. La valeur calculé du compteur est remise à zéro si elle est négative. | Le capteur peut être tourné On, Off ou Flipped. Sur réinitialisation, le compteur du capteur sera réglé à 0. |
| Externe | ext | - | A script, program, record or XML Script name. | Les paramètres indiqués ici seront ajoutés à l'appel du programme² | Les espaces dans le chemin du programme ne sont pas autorisé. Si ce n'est pas évitable, utilisez un fichier fluide avec des guillemets " pour le chemin /fichier. Les paramètres s'effectuent dans un fichier fluide avec %1 %2 … Dans le cas d'un Script Xml le champ de paramètre peut être utilisé pour appeler une seule fonction. |
| 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) | Les commandes 'vérouillage'permettent de définir manuellement les itinéraires protégés par le vérouillage de tous les aiguillages. (Logiciel CTC) Le vérrou est optionnel et doit être également utilisé pour le dévérouillage s'il est réglé. L'ID d'action est utilisée si elle est laissée vide. L'ensemble des commandes ne colore pas l'itinéraire dans les clients clients. |
| Système | sys | - | stoplocs, stop, go, shutdown, resume, on, off, ebreak, resetfx, time, v0locos, initfield | - | "on/off" sont pour commander l'automode. "resetfx" définit le groupe de fonctions sélectionné 0…7 sur OFF pour toutes les locomotives. (seul UN paramètre est autorisé : 0 = f0-f4, 1 = f5-f8 …) "time" au format 00:00 disponible seulement avec un temps d'action de 60 secondes. |
| 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: Démarrage en mode semi-automatique | Les commandes de couleur définnissent avant le principal signal défini pour ce bloc. |
| Staging block | sb | Staging block | unlock, white, yellow, green, red, open, closed, exitopen, exitclosed, compress | unlock ID | Les commandes de couleur définissent le signal de sortie défini pour ce bloc Ouvert/Fermé sont pour le coté d'entrée. |
| Locomotive | lc | Locomotive | go, govirtual, 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, govirtual: tour, schedule, location or block ID (Une variable peut être aussi utilisée au lieu d'un nom fixe.) velocity¹: pourcentage de la vitesse sur le courant¹ velocity2: Vitesse du décodeur sendaire carcount: nombre de voitures ou de remise à 0 consist: locoID[,locoID]… binstate: nombre de sortie x-go: Liste des adresses de locomotives séparées par des virgules ou codage par ID ou par des variables. pomwrite: valeur Cv Vvar: Vitesse utilisée | Remplir le champ de paramètre pour réinitialiser une rame. Si aucune locomotive n'est trouvée et que le champ de paramètre contient une vaiable # une locomotive sera recherché par adresse. Cette option désactive les paramètres supplémentaires. Dans le cas où une destination est définie à l'action GO: lisez ceci! (EN) |
| Fonction | fn | Locomotive Car Operator³ | on, off, flip | numéro de fonction (juste le nombre, comme 1, pas f1 pour la fonction 1) ou le texte de la description de la fonction (Case sensitive). Une liste de fonction Cv comme "1,2,3". Si la liste commence par un point d'interrogation, "?1,2,3", elle choisira une fonction aléatoirement(N'incluez pas de citation dans la définition de l'action). | Une seule fonction temporisée est prise en charge. En utiliser plusieurs affichera des résultats imprévisibles. Flip active la fonction quand elle est éteinte et vice versa. Flip ne prend pas en charge les fonctions chronomètre. |
| Plaque tournante | tt | Turntable | goto, 180, on, off, lighton, lightoff | numéro de voie (goto) ou fonction (on/off) | |
| Plateau | seltab | Fiddle Yard | goto | numéro de voie | |
| Texte | tx | Text | update, valeur, on, off | Les variables de texte dynamiques seront remplacées avec les valeurs réels. Pour les variables intégrées disponibles voir ici: Variables | Variables: Syntaxe |
| Son | sound | - | play, straigh, turnout | Nom du fichier son. | Réglez le périphérique du lecteur son dans l'onglet d'interface(RocNet seulement!). |
| Variable | var | Variable | text, value, add, subtract, min, max, random, start, stop | les nouvelles valeurs. | - |
| Voiture | car | Car | empty, loaded, maintenance | Le nouveau statut du véhicule . | - |
| Opérateur | operator | Operator | addcar, removecar, loadcar, emptycar, class | Ajouter, enlever, charger ou supprimer des véhicules. | Une liste d'ID des véhicules séparée par des virgules. |
| Localisation | location | Locality | minocc, fifo, go, schedule | Définit l'occupation minimale dans cette localisation. Démarer et le calendrier démarera aléatoirement une locomotive. | parametre: numéro minocc ou 0/1 for fifo d'activation ou désactivation |
| Météo | co | Weather | setweather, weathertheme | Active l'ID sélectionné de météo (thème). | le paramètre "setweather" peut être utilisé pour régler le lever du soleil, midi,le coucher du soleil en quelques minutes. Par exemple: "360,720,1080[,relatif/absolu]" (06:00,12:00,18:00) |
| Horloge | clock | - | set | diviseur,heure, minute,seconde | Le temps ne peut être réglé que si le diviseur est > 1. |
¹ Lorsque la vitesse ou le pourcentage est négatif, l'exécution de l'action permettra non seulement de régler la vitesse de la locomotive, mais aussi de changer de direction. Notez que seule une valeur négative change de direction, ce n'est pas le cas que négatif signifie arrière et positif l'inverse.
² Astuce: pour déboguer le non fonctionnement des appels de programmes externes; Dans les lignes de saisie contenant la commande exécutée cela ressemble à OAction 0501 [espeak -vde eins]
³ Les commandes de fonctions sont envoyées à tous les wagons dans le train de l'opérateur.
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 &)
Les fichiers XMLScript doivent être configurés sans chemin, voir Chemin de XMLScript.
Playback
Un fichier son, *.txt, peut aussi être sélectionné en tant que commande externe pour la diffusion.
Voir: Enregistreur de commandes
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.
VLC
Exemple: Lecture de son 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.
Paramètres futurs:
--gain=x.xxx - volume de lecture, ici x.xxx peut être dans la plage de 0.0 à 8.0.
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.
Utilisation
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
Rapport
Un double clic ouvrira l'objet sélectionné.
Générer
Génère un rapport de toutes les actions utilisées dans tous les objets.