Skip to main content
This table contains a list of all Turnouts that exist for this Panel. From this table you can change the state of a Turnout, change the feedback mode, enter Sensors for feedback, invert, lock, and delete it.
Contents of the Turnout Table are displayed by selecting it under Tools ⇒ Tables. As with all JMRI tool tables, you can add or remove columns from the display by right-clicking anywhere in the column header and selecting or deselecting the desired columns from the menu that appears (see picture at right). You can change the order of the columns by dragging their titles, change the width of columns by dragging the vertical line between columns, and sort the rows by clicking the column title (a triangle will appear indicating the direction of the sort).
Note that this doesn't remove the Turnout from any files you've saved that contain it. If you load one of those files, perhaps when you restart the program, the Turnout will reappear. You should use one of the "Store to file" options in the "File" menu to save new versions of any files that contain this Turnout.
Currently the program only supports lock mode for NCE revision C and CVP accessory
decoders. CVP decoders support one or two pushbutton operation. Select the number of
pushbuttons used to operate that specific turnout.
CVP_AD4_1B means one
CVP_AD4_2B means two buttons. We recommend that you enter all
four CVP Turnouts per decoder into the Turnout Table, even if you're only locking one.
You do not need to specify the number of pushbuttons for NCE. Unfortunately, NCE
revisions A and B accessory decoders do not support pushbutton lockout.
In the drop down list, you are presented a set of named fixed speeds that have been
predefined in the
signalSpeed.xml file, in addition to a global and use
block speed options.
In addition it is also possible to enter a numerical value to represent a speed.
The global value is set via the Speeds menu option.
When "Use Block Speed" is selected this in effect tells any automation tool to ignore the speed setting through this Turnout; the tool should then only consider speeds that are set on Blocks.
The Forget button will set the Commanded Turnout state to Unknown. For Turnouts using Feedback Sensors, the feedback state is unaffected, whereas for Direct and Delayed Mode the Turnout feedback state will also be Unknown.
For some system types, the Query button can poll the Sensor to obtain the current status. There is also a LogixNG Action to Query All Sensors for a particular connection.
Along the bottom of the Turnout Table pane are buttons and checkboxes that control its operation.
Model railroaders want different things when it comes to knowing the status of the turnouts on their layout. Some are quite happy to say "I told it to move, that's good enough for me". These people don't worry about whether a turnout on their layout actually moved when they told it to. Those people can just ignore this page, and leave the JMRI settings at their default.
But some modelers want to have better information about the status of the turnouts on their layout, and so use some form of "feedback" to indicate turnout position. This could be as complicated as two microswitches, adjusted to only close when the turnout is properly seated in either position. Or it could be something simpler.
In the JMRI program, Turnout objects actually know about two different states: "Commanded" state and "Known" state. The commanded state is "This is what was asked for last". The known state is "This is what's happening on the layout as far as I know".
Built into NCE, LocoNet and XPressNet systems are limited abilities to monitor what is happening on their networks. This allows JMRI to capture messages or poll the system concerning Turnout state changes. All the other protocols normally use a "you told it to change, so it did" logic. In other words, when something in the code (the Turnout Control Tool or a script) commands a state change from closed to thrown, the default is for both both the commanded state and the known state to change to "Thrown".
But it is also possible to control this in more detail if you have wired your layout to allow it.
The whole question of Turnout feedback is then "How do we configure the program to understand the known state properly, given my layout hardware?"
In the Turnouts pane (Tools -> Tables -> Turnouts) click on the box near the bottom that is labeled "Show feedback information". To the right of the Turnouts pane you'll find four extra columns associated with feedback:
Available Feedback modes are:
|Sensor 1||Feedback (known) State|
|Unknown||Inconsistent since 4.21.5|
|Inconsistent||Inconsistent since 4.21.5|
|Sensor 1||Sensor 2||Feedback (known) State|
|Inactive||Inactive||Inconsistent||Typical condition for a Turnout mid-throw|
|Unknown||Unknown||Unknown||Typical startup condition|
|Active||Inconsistent||Inconsistent||Changed from Unknown > Inconsistent 4.21.5|
|Inconsistent||Unknown||Inconsistent||Changed from Unknown > Inconsistent 4.21.5|
|Inconsistent||Inconsistent||Inconsistent||Changed from Unknown > Inconsistent 4.21.5|
JMRI can watch a Turnout and automate certain operations on it. This was originally added to handle the case of "I usually have to click that turnout a couple times to get it to throw over", but it can be used for other things too.
The three forms are:
Normally, turnouts are only thrown once, which is the "Off" setting under "Automation". You can set a Turnout to use "No Feedback" automation by selecting it in the Automation column for the individual Turnout. If there are feedback Sensors defined, you can also select the "Sensor" method there.
You can customize the automation by clicking "Edit Auto" for an individual Turnout.
It's also possible to set global Retry Automation defaults, and some Turnouts use those. Use the Retry Automation -> Edit... menu to access those defaults.
The Turnout Lock feature allows you to selectively disable accessory (Turnout) commands from cabs and/or locally-wired pushbuttons. The Lock can be set (Locked) or unset (Unlocked) from a checkbox in the Turnout Table, from a Route or Logix, or from scripts.
To use this feature with an NCE command station, you must select MONITORING as the feedback mode for the Turnout and the NCE command station must have the 2007 or newer EPROM.
Copyright © 1997 - 2023 JMRI Community. JMRI®, DecoderPro®, PanelPro™, DispatcherPro™, OperationsPro™, SignalPro™, SoundPro™, TrainPro™, Logix™, LogixNG™ and associated logos are our trademarks. Additional information on copyright, trademarks and licenses is linked here.