User Tools

Site Tools


actionctrl-en

Action Control

Description

Action controls trigger actions when the states of Rocrail objects change. An action control is therefore not part of an action but can control one. An action control is part of the object that is used to trigger the action (eg sensor, switch, route)

The button for setting up an action control (trigger) is mostly found on the General tab of the Rocrail object to be used to control the action.

It is possible to have several actions controlled by the state change of one action control object It is possible to have one action triggered by the state change of several different action control objects

Before an action control can be set up , the action that is to be controlled must first be defined in Action Setup

Setup


The list contains the actions that are to be triggered.

UP/Down

Move the selected action control up or down in the list.

Copy

Copy the selected action control(s) to the clipboard as XML text.
This can also be pasted in a text editor for expert viewing. It can be manually modified and re-copied to the clipboard.

The listbox is multi selectable to enable copying of more then one action control.

Paste

Add the action control(s) from the clipboard to the list.

ID

An action ID can be selected from a dropdown list of all previously defined actions in Action Setup.

State

The state value entered here is the state that the action control object (trigger) has to change to for the action to be triggered.

Depending on the action control object being used, only the states available for that object will be presented in the dropdown field as listed below:
The field can be edited with additional parameters (count, track number etc.) if necessary.


Object State Remark
Sensor on, off, true, false,<count>3,shorton,longon4,regval
Output on, active, off,shorton,longon4, longclick Output objects do not contain loco information.
Switch turnout, straight, left, right, none, lock, unlock Use "none" if the action should not activated by left-clicking on the accessory (switch) object, but only from it's command menu.
Signal red, yellow, green, white, blank, blockstate, aspect number
Loco home, forwards, reverse, diesel, steam, electric, battery, min, mid, cruise, max, fon, foff, +, -, #, x, light, lightgoods, local, goods, post, ice, mixed, regional, shunting, cleaning, none, service, commuter, class, schedule:, idle, wait, auto, run, manual, automatic, stop, stall, f1-f28, eventtimeout, eventtimeoutreset Substate for energy: high, middle and low.
Block ghost, enter, occupied, reserved, free, closed, open, depart¹, acceptident2, exit(unexpected), codemismatch occupied is triggered at in
Staging block ghost, enter, occupied, reserved, free, closed, depart1, exit, section, timeout, timeoutreset "exit" is performed, if the exit event will follow on the in event. Requirement: Exit sensor
In case of "section" the sub state must be set to the wanted section ID or to *.
Route go, lock, unlock "lock" is performed when the route is set (the Route is reserved but the switches are not yet set).
"unlock" is performed when the Route is released.
Schedule leave blank
Turntable goto <tracknumber>, next, prev, turn180, lighton, lightoff, calibrate, atposition <tracknumber> When goto is used without tracknumber, the action is triggered for every goto command, when goto <tracknumber> is used, the action is triggered only with a command to go to that particular track.
"atposition" is triggered by the Position Sensor in the Interface Tab or in the Turntable Add Track Dialog, without a track number for every message, with a track number only if the platform is on the corresponding track.
System go-cmd, go-event, stop-cmd, stop-event, stoplocs, save, shutdown, analyse, reset, ebreak, init, initready, short-circuit, on-auto, off-auto, stagetimeout, stagetimeoutreset, exception-xxxx, eventtimeout, eventtimeoutreset, error System actions are located in the Rocview Table Menu
The init event is fired after all Command Station libraries has been loaded.
For processing exception-xxxx the Check trace actions must be activated on the Rocrail Automatic Tab.
Text leave blank the action is raised when dynamic text is updated
Booster load, short circuit
MVTrack in
Variable See Action status.
Weather sunrise, noon, sunset
Location scheduleupdate, occupdate occupdate: callertext=LocoList, calleruserdata=actocc:minocc

1) Depart for a departing train (not for a train running through!) is triggered at the same moment the route to the next destination is set.
2) Accept a new ident in auto mode.
3) The sensor counts the 'on' states. The action will be triggered if the count set in the state field match the counter of the sensor.
4) The short-/longon states are used for two different actions with the same sensor/output. The action is executed at off. Advised is not to combine short-/longon with other states.
:!: All state values are case sensitive.


Sub state

The sub state is used in combination with:

  • Staging block and "section" state.
  • Loco function "on" / "off".
  • Car function "on" / "off".
  • Loco energy "high, middle, low".


Duration

In 100ms units
If set greater then zero this value will overwrite the duration in the action setup.

Timer

In milliseconds
If set greater then zero this value will overwrite the timer in the action setup.

Locomotive

Can be use to set the loco ID for specific objects which do not have any loco information like outputs.
Usually left blank for most action control definitions.

  • Block objects overwrite this value with the loco ID which has reserved it.
  • Sensor objects overwrite this value with the identifier if detected. (RFID, Railcom…)

Note: This field may show the last value used for this action after a restart of Rocrail.

Description

Optional description for use in the Accessory Switch type popup menu.

Parameter

2.1.982+
Optional parameter(s), CSV, for XMLScript actions.
Variable naming for the parameter(s) are "%param1%…%paramN%".
actionctrl-param-en.jpg

Reset

Reset the counter in case of a sensor object.
If this option is not set, the counter will continue and actions defined for a higher counter value can be triggered. For the action to be triggered with the highest counter value this option must be set otherwise actions requiring a lower counter value will not be triggered.


All conditions must be true

At default all defined conditions of this action control must be all true.
By disabling this option only one of the conditions must be true.


At Command/Event

For switch, outputs and signal objects to define if actions will be checked at a command and/or at an event.
Events are usually generated by the command station.
If both options are enabled, and the command station also generates events after commands, the actions will be checked twice.


Mode

Automatic

The action will only be triggered in automatic mode

Manually

The action will only be triggered in manual mode

Both

The action will be triggered in both automatic and manual modes

Buttons

Add

The selected type and ID will be added to the list

Delete

The object selected in the list will be deleted

Modify

Changes to an object must be confirmed with this button.


System-Actions

In Roview Table Menu→ System-Actions Actions can be set, which are triggered by Rocrail system events
The same actions and conditions can be used as in objects.
System events = system states: see table above System -> State
The typical use-case for system actions is to set actions to a defined state when starting a Rocrail session.

Some Examples:

  • set all buttons in the plan on "red" when "init" (initializing Rocrail)
  • start a XML-script with the event "on-auto" bzw. "off-auto" (auto-mode on, auto-mode off)
  • set a output if "short-circuit" to trigger a external alarm
  • ….

Common Buttons

actionctrl-en.txt · Last modified: 2023/10/20 08:14 by rjversluis