User Tools

Site Tools


actions-fr

Configuration des Actions

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.

1)
L'état actif de sortie est uniquement virtuel et ne peut pas être visualisé avec des I/O réels .
2)
Le nom du fichier est ignoré.
actions-fr.txt · Last modified: 2023/11/20 10:33 by phil45