|Output||Output||on, off, flip, active, value||0…65535||The value command is only supported in the SRCP and BiDiB library.|
|Sensor||Sensor||on, off, reset, setcounterval|| New counter value; Relative if prefixed with a sign. |
The calculated counter value is reset to zero if its negative.
|The sensor will be turned on or off, or the counter of the sensor will be reset to 0 when the action is executed|
|External||-||A script, program or record 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
|Switch||Switch||straight, turnout, left, right||force|
|Route||Route||set, lockset, lock, unlock, open, closed||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||-||stoplocs, stop, go, shutdown, resume, on, off, ebreak, v0locos, resetfx||-|| “on/off” is for switching the automode.
“v0locos” sets the velocity to ZERO for all locos.
“resetfx” sets the selected function group 0…7 to OFF for all locos. (only ONE parameter allowed: 0 = f0-f4, 1 = f5-f8 …)
|Signal||Signal||red, yellow, green, white, aspect||Aspect number in the range of 0…31.|
|Block||Block||schedule, tour, unlock, white, yellow, green, red, setloco, event, open, closed, acceptident, dispatch, go||schedule/tour ID, loco ID, sensor ID||The color commands will set the main forward signal defined for this block.|
|Staging block||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||Locomotive||go, stop, velocity, percent dispatch, swap, carcount, min, mid, cruise, max, consist, assigntrain, releasetrain|| go: schedule, location or block ID|
velocity¹: percentage of current set velocity¹
carcount: number of cars or reset to 0
|Leave the parameter field empty to reset a consist.|
|on, off, flip|| function number (just the number, like 1, not f1 for function 1) or the function text (4435+ and Case sensitive).|
A function csv list like “1,2,3”: 4664+
|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.|
|Turntable||Turntable||goto, 180, on, off, lighton, lightoff||track number (goto) or function (on/off)|
|Fiddle Yard||Fiddle Yard||goto||track number|
|Text||Text||update||Dynamic text: %lcid%, %lcdest%, %lcnr%, %frombkid%, %bkloc%, %frombkloc%, %bkid%, %counter%, %carcount%, %countedcars% and %wheelcount% will be replaced with real values.|
|Sound||-||play, straigh, turnout||Sound file name.||Set the sound player device in the interface tab.|
¹ 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.
Execute an external program or script. The path should exist on the server, so if you use the TrippleDot button on another computer than the one the server is running on it will probably not match.
The program or script will run in the same process as Rocrail, so if it does nasty things it will take the Rocrail server down…
Alternatively a program can be started in its own process running a Unix system. (myprog.sh &)
Optional if the Rocrail server runs under Windows to add a surrounding quotation:
""c:\programs\test\speak.exe" "Hello World""
Without this option the command would be like this:
"c:\programs\test\speak.exe" "Hello World"
A record file, *.txt, can also be selected as external command to play back.
See: Command Recorder
Extra parameters are ignored.
The locoID can be left empty for the following trigger objects:
The ID is handed over to the action automatically in case the locoID in the action is left empty. This only applies to action types that expect a locoID (type Locomotive and type Function).
This makes it possible to define actions for locomotives and locomotive functions that apply to any particular locomotive that at that moments is on that route/sensor/switch/schedule. For example,defining this action to activate function F0 (lights on) with the ID empty and linking this action to route will have the effect that any loc that is started on that route will turn on its lights. It is also possible to trigger such an action conditionally by using the action conditions.
The duration of the action in seconds. Time unlimited in case of zero.
Only used for function commands.
Number of ms to wait before executing this action.
This action will be executed, if Use is checked, when the Rocrail clock equals the hour and minute.
If the Action timer 60 sec. option is set the seconds value is also evaluated.
This action will be executed every hour + minutes after it has been enabled by an action control with state “on”.
It can be disabled by an action control with state “off”.
This action will be executed at a random interval.
The random activation time is relative between 1 minute and the activation time specified. The resolution is in scale minutes.
The Use must be checked to activate the random timer.
This tab lists all other objects, “ID (type)”, using the selected action on the index tab.
A double click on an object in the list will open the Action Control dialog.
The address of the sound player device/port.
If the sound command is straight or turnout a switch command is generated.1)
If the sound command is play an action command is generated which is supported by: