Table of Contents


Rocrail Automatic Tab

A restart of the server is required in order the changes to take effect!

Left Column

Switch Time

Switches (turnouts, points) are powered for the time (in milliseconds) given here. The value depends one the kind of switches in use. Short times should be preferred but it has to be made sure that the switches are still reliable.

Hardware command stations mostly use the switch time set within the command station itself, thus it is not possible to alter the actual switch time with this option. The switch time, however, should be set to at least the value of the command station. This ensures the switch is set before a train can start.

Min Block - Train length

Length (in mm or other units, see Locomotives: General) a Block has to be equal or longer than the train (+ Min Block - Train length) in order to allow the train to enter the block.

Ignore events within...

Enter-events are filtered out if they are in the same time frame as specified in the field. (field value x 10ms)

Init field pause

Time (in milliseconds) between the commands during init field.
The value is often set to the one of the switch time (see above) or higher to allow switches to be set correctly and to avoid sending too many commands in a short period of time.

Init field power on

By default the rail power is switched on before starting to initialize the switches.
In case of 2-Rail systems, with polarized electro frogs, it is preferable to leave power off to avoid a short circuit in case a train is on a switch…

Switch safe position timer

Timer (in seconds) to reset the switches to their Safe Switch Position.

Event timeout

Timer (in seconds) to wait for a sensor event.
A warning message will appear in the Rocview server panel.
Default set to zero: Not used.
This option can be useful for none visible trains in tunnels or at backstage.
In case of an event timeout the state eventtimeout of the loco in question can be used to trigger an action that in turn may, e.g., switch on an optical or acoustical warning or switches off track power.
Event timeouts occur:

  1. When a loco driving out of a block does not trigger the next expected event enter in the next block within the defined time.
  2. When a loco driving into a block (event enter) does not trigger the next expected event in in the same block within the defined time.

Reset signal

Timer (in seconds) to wait for resetting signals of current block to red.

If the distance between the signal and the next block enter event is very long it make sense to set this timer. The event which comes first will reset the signals: enter of next block or end of Reset signal timer.
Default set to zero: Not used.

Route switch time

Time (in milliseconds) between switch commands in routes.
Default is 10ms, max. 10000ms.

If a train is sent on a route and for this route switch commands have been defined these are executed first in the interval specified here. The successive commands to the train are thereby delayed until all switches reached their end positions.

When using switches without position sensors Rocrail does not know when the switches are in the correct position and when it is safe to start the train. This holds true especially for servo driven switches which might take some time to reach their final position. That is, the Route switch time should not fall below the time needed by one individual switch to reach its end position.

Semaphore time

Time (in seconds) to wait for a semaphore to get from red into green/yellow position. Default 1s.

This option prevents trains starting before the signal is showing the correct aspect. This value can, in addition, be increased to simulate the reaction time of the engine driver.

Note: This option is only effective on signals linked with a block.

Signal time

Time (in seconds) to wait for a signal to show another aspect. Default 1s.

This option prevents trains starting before the signal is showing the correct aspect. This value can, in addition, be increased to simulate the reaction time of the engine driver.

Note: This option is only effective on signals linked with a block.

Loco start gap

Time (in seconds) between loco starts in auto mode. Default 1s.

This function is meant to delay consecutive loco starts in auto mode when using the commands start all locs and resume all locs. Problems arising when too many trains start and too many switch commands are sent at the same time can be avoided using this option.

Block init pause

The pause time(in milliseconds) is used if the auto mode is activated; Every block will be called to initialize itself which will most likely send signal commands.
This pause time is mainly used to prevent too many commands in a short period of time.
Default 0ms.

Route synchronizer timeout

When the option Synchronize routes is active, Rocrail will wait with setting a second route, but only for the timeout time specified. When the timeout time has expired the route will be set, regardless whether or not the setting of the first route has finished.

Virtual timer

Time in seconds between the enter2in events for the Virtual Automatic.
Range: 2-60 seconds.

Middle Column

Reserve second next block

Also known as “Look a head” feature.

This is the global flag to enable this for all locomotives and will try to reserve two blocks ahead at enter or initial go.

To set this option for individual locos, leaving this option unset, it will bring more diversity to the running locomotives: Locomotive Details

Note:: This option can not prevent deadlocks, critical sections and block groups should be used to avoid them.
Note:: This option is necessary if three-aspect signals are to show the correct aspects in some configurations.

Enable Switch Feedback

Default set to true.

If testing with the Virtual CS, and if there are switch position feedbacks defined, it is sometimes desirable to ignore them to be able to set routes.

No speed change for switches

If the route contains thrown switches the signal will be set to white (yellow with three aspects signals) and the loco velocity will set to V_mid.

The feature is disabled by setting this checkbox.

Green aspect if next is red

To disable the yellow aspect in case the next block signal is red.

Skip switch commands in routes if already set

If the used switches are reliable, and not connected to position sensors, the route switching time could be reduced using this option.

Skip signal commands if already set

No command is send to the Command Station if the signal (seemingly) shows the wanted aspect.

The “InitField” command should be used to synchronize signals at startup.

Use Bi-Directional Communication

Enable BiDi for evaluating the ident reported.

Create guest on BiDi

A guest loco is created if a BiDi Ident did not match with an existing Loco.

20130714.155617.330 r9999I bidibrea OBiDiB   2743 BM port 5 reports loco 323
20130714.155617.360 r9999c bidibrea OBiDiB   1289 sensor bus=68000004 addr=6 state=occ ident=323 type=loco-addr-fwd
20130714.155617.361 r9999I bidibrea OBlock   0426 ident = 323
20130714.155617.361 r9999I bidibrea OModel   2493 try to find loco by addres [323]
20130714.155617.361 r9999I bidibrea OModel   2499 generating a loco for addres [323]
20130714.155617.361 r9999I bidibrea OModel   0667 adding lc 323...
20130714.155617.361 r9999I bidibrea OLcDrive 0606 LcDriver 2.0.0 loaded for 323
20130714.155617.361 r9999I bidibrea OLoc     3482 loco [323] enterside=[+]
20130714.155617.362 r9999a bidibrea OBlock   0513 set loco 323 in block 601
20130714.155617.362 r9999I bidibrea OBlock   2175 block 601 set locid=323
20130714.155617.864 r9999I 323      OLoc     1647 Runner for "323" started.

Use BiDi direction

Use the direction reported by a BiDi sensor in case the loco is not in automatic mode.
Default off.
:!: Use with care because the reported direction could mangle the logical direction in Rocrail.

Use Code to set in block

Depends on: Use Bi-Directional Communication
If this option is set empty blocks will accept the the Loco with this code.
If the Loco is already in another block it will be moved if it is not in automatic mode.
Use this option only if the used system reports 100% reliable.

Power off at ident mismatch

If a block has an ident sensor and the reported ident code does not match the expected locomotive one it will power off the booster.

Power off at ghost train

If a block encounters an unexpected event, in case "Accept ghost trains" is disabled, it will power off the booster.
If the Power manager is used, and a block is listed at one of the boosters, only this booster will get a power off command.
Security is decreased by disabling this option…

Auto mode off at ghost train

If a block encounters an unexpected event, in case "Accept ghost trains" is disabled, it will switch off the auto mode.

EBreak at ghost train

If a block encounters an unexpected event, in case "Accept ghost trains" is disabled, it will send an emergency break command to the CS.

Keep ghost state

Keep the ghost state until it is manually reset.

The ghost state disappears if the block is no longer electrically occupied if this option is not set.

Disable steal loco control

This option prevents stealing a loco from another throttle.

The throttle in charge must explicitly release the loco to give it free for other throttles.

Power off at automatic reset

Global track power is turned off before resetting the automatic mode.

Allow zero Throttle ID

Broadcast also loco events coming from unknown throttles (zero or blank ID).

Normally those events are disregarded to avoid broadcasting echo packets to clients.

Tip: With certain command stations (e. g. Intellibox, ECoS, CS1, CS2) changes of loco velocities and / or loco functions by means of a command station throttle are not displayed in Rocview. Activating the option will correct this behavior.
Tip2: Reboot Rocrail und command station.

Stop none commuter in terminal

Stop the auto mode of none commuter trains after the IN event in a terminal station to be able to manually run around the locomotive to the other side of the consist.

Synchronize routes

Force setting one route at a time, regarding the Route synchronizer timeout, to reduce power consumption and switch decoder overload with multiple outputs.

Timed sensors

Enables the option for delayed off sensor event.

Enable analyser

Special option to disable the analyser for a demo server.

Force unlock at EBreak

All routes and switches will be forced unlocked after an Emergency Break.

Release loco on idle

Release the loco from the Command Stations refresh stack to make room for new activated locos.

The loco will be released after it has been set from automatic into idle/stop and the speed equals zero.
Supported Libraries:

Close block on ghost

If the block does not accept ghosts, and it is electrically occupied, it will close on the first attempt to reserve this block.

Use Finder for destination path

If this option is activated, the Finder will be used to find the shortest/longest/random path to the Destination.
If deactivated, the Route selection is random (“Aquarium mode”).

Timer events

:!: Use with care; This could overload the Rocrail clients if many locomotives are running in auto mode.

If a locomotive is in the wait status every second the time left to wait are broadcasted to the clients.

Mode events

Surpress all Loco Mode messages to the clients to save CPU resources.

Signal events

Experimental; WIP.
Shows a red dot in the left upper corner of the speed field of the throttle in case the current block has a red signal.

In Rocweb the background color of direction button will be set to red.

Right Column

Check if all decoders are online

This will prevent switching on the automatic mode before all defined Decoders are reported online.
Supported Systems:

Allow swap destination

This option can be used for relocating Automobiles which have gone to another destination because of mal functioning turnouts and/or sensors.
It can only work if the RFID detecting system is 100% reliable.

No Forum support.

Reset schedule on stop auto mode

Schedules not re-started after the auto mode is stopped.

Use only the first code

Railcom section can detect multiple decoders.
Check this option to use only the first one reported to identify a locomotive.

Action timer 60 sec.

Use a 60 second interval for evaluating action timers.
A one second interval is used when this option is not set. This will use extra CPU resources.

Restore schedule

Restore the last used schedule at startup.

Select shortest block

If train and block length are set this option will choose the shortest block available for that train.
This option will decrease the random variation. In some cases it may be, that ever the same block will be the target.

Close on no events

Close blocks if there are no events defined for running in auto mode.

Disable block wait for half automatic mode

Set this option to avoid waiting in manual mode.

Stop at IN for half automatic mode

Automatically send a stop command to the manually controlled loco at IN in case no next destination is found.

Send zero speed command at power on

To trigger Railcom decoders to use channel 2 which is needed when two or more are in the same detection section.
This command is only send if the loco speed is already zero.

Default Signal Aspect

The default signal aspect used for an unoccupied block.

Reset speed and functions

Reset at startup loco speed to zero and all functions to off.

Process signal events

Accessory events which are no sensors or switches will be regarded as signal events.

Remark: Enable this option so that from a CS manually operated signals are displayed correctly in Rocrail.

Use random block rate

Blocks can be given a random rate to be able to influence the randomly selected block if more then one destination is possible.

Not activated

With a random number, in range of the size of the list of available destination blocks, a selection is made.


All available destination blocks are sorted by the Random rate.
All those rates are added together to determine the random range.
The bigger the block its random rate, the higher is the change it will be randomly selected; But it remains random and therefore unpredictable.

Block Rate Random hit
b1 10 0…10
b2 40 11…50
b3 50 51…100

Redirect slave commands to master loco

If a loco is a member of a consist the commands send to the slave loco will be redirected to the consist master.


Activate the Weather control.

V 0 on emergency break

Send a zero speed command to all locos in case of an emergency break to the Command Station.

Check trace actions

Enable triggering actions by trace ID in combination with system actions.

Personal Tools