Skip to main content
The screen is split into two sections: on the left hand side is a list of the Preference groups that can be set. Clicking on each item will then populate the right hand side with the various options that can be configured for that Tab.
Perhaps the most important control is at the bottom of this section: The Save button!
Be sure to click "Save" when leaving this window. Your changes to the Preferences don't take effect until the program is stopped and restarted, so the program will prompt you to do that after saving the Preferences.
Each connection has its own unique tab. To get started, first select your DCC System Manufacturer, followed by the type of Connection that you are using. You will then be presented with a series of most commonly required settings that need to be set. If you need to change some of the more advanced settings then connection then check the "Additional Connection Settings" box and this will provide you with further details.
To add an additional layout Connection, in the Connections pane click on the tab with a "+", this will then present you with a fresh connection tab. To remove a Connection, in the System Manufacturer drop down list, select (none selected) to just clear your present choices and enter new ones, or click on the small "x" in the Tab name to delete the Connection.
For more information on how to configure this for your particular hardware, see the Hardware Help pages.
Remember to press Save!
If you are using multiple connections, e.g. a LocoNet Connection and a MERG Connection, the Defaults pane lets you select which connection you want to use for a particular purpose.
The Internal connection is the default connection, however, since this
is almost always undesirable, JMRI applications will notify you if the
Internal connection is the default for every purpose. To silence this
notification, edit the profile properties, setting the property
jmri-managers.allInternalDefaults to true.
Note that when changing the "User Files Location" this will also change the default location for where the following are stored:
There's a separate Help page with information on sharing files between computers using Dropbox.
Start Up preferences allow windows and files to be opened, scripts to be run, and additional buttons to be placed on the main window when the application starts.
Click the Add ▾ button and select the type of start up action to add. The new action will be added last.
Start up action order is important. In most cases, scripts should be the last items in the start up order. Start up order can be changed by selecting a start up item and moving it up or down in the list.
There are five types of start up actions:
This section also has checkboxes for options:
More detail: A single bad write with this option off trashes one CV; writing a bad index with this option off trashes the CV that was supposed to be written and the wrong one addressed by the bad write, but the write to the next CV in the sequence is OK due to the redundant next write of the index; writing a bad index with this option on leaves that badly-written index value in place, so writes a sequence of bad CV values. Bottom line: If working with a complicated decoder with lots of CVs, you need a reliable programming connection, see next option.
If you're having intermittent trouble writing to a decoder, this may improve reliability. If DecoderPro is never able to properly write, this won't help; it only helps if the problem is occasional, and retrying will get it right more often than not.
Some DCC systems will check for a "write acknowledge pulse" from the decoder before declaring the write a success. Those are almost as reliable as this, and much faster. So if you're using one of those DCC systems, this might not be needed. On the other hand, if you're using a DCC system that "writes blind", with no check, this might be really useful. To tell if you have one of those, try writing CVs with the locomotive off the track. If DecoderPro thinks the write succeeded, then the DCC system is writing blindly, without checking.
This doesn't help (but doesn't hurt) if you can't read back the decoder. Most DCC systems can't read during ops mode programming, for example. Some command stations (Digitrax DB150) can't read from the decoder. In those cases, this option just asks the command station to write without reading back.
To configure it, click the "Set..." button and follow the directions.
The "Reset" button restores it to the default location. Note that this just changes where the program looks. If you've stored roster information elsewhere and want it back in the default location, you have to move the files there yourself.
You can also enter a default value for the "Owner" field in DecoderPro roster entries here. This fills in the value for new entries, which can save you a little bit of typing. It has no effect on existing entries, even if changed.
This Preference pane tab lets you select whether the extended Throttle features are available, and which ones can be used.
The chosen time is approximate; the response may be a few seconds earlier or later.
JMRI Configuration Profiles make it easy to set up your JMRI applications to work with different setups. Each profile specifies one set of Preferences. You can then select which one to use.
For more information, see the Configuration Profiles help page.
The JMRI JSON server is used by applications on other computers, including tablets and phones, to connect to JMRI to operate your railroad.
On this pane you can specify the port for the connection (usually left at default) and how often the server checks for whether the connection has failed via a heartbeat message.
The Railroad Name tab lets you specify the name of your model railroad (module), as it is used by several server protocols.
The JMRI Web Server lets you connect to JMRI from a web browser on your computer, tablet or phone and work with your railroad.
This tab lets you control what the web server provides. For more information, see the Web Server Preferences pane page.
The JMRI SRCP server is a standard way of connecting "client" user programs to a "server".
On this pane you can specify the port for the connection (usually left at default).
JMRI Simple Server is part of JMRIClient, a method to remotely connecting one JMRI program to another.
On this pane you can specify the port for the connection (usually left at default).
This tab sets parameters used in computing routes and speed changes for Warrants and for controlling the events that warranted trains may encounter.
When an automatically running train encounters a Signal aspect that calls for a speed change, the speed map table provides the information of what the speed change should be. Other parameters control the way the speed change is made.
The Aspect Speed Name Table maps the speed names found in the aspects definition of a signal system to a value. It is important that all the speed names used in your signal system be listed in the Speed Map Table. Rows can be added or deleted to conform to the Signal System aspects.
The value associated with a speed name can be interpreted in four different ways and there are four radio buttons for you to choose the meaning of the value.
Choosing the interpretation is a matter of what you want to happen when a warranted train reaches a signal or block aspect. Percent Normal will always make the train change speed and Percent Throttle most likely will also. The last two choices are the most prototypical, but if the train is already within the speed limit called for, no speed change will occur.
The Head Appearance Table is used when Signal Heads are used as signals. It maps signal head appearance names to aspect speed name which in turn are mapped by the Aspect Speed Name table to values that interpret speed limits.
It is important that the correct Layout Scale is
chosen since it is needed to convert throttle settings
and track speeds to and from scale speeds.
The Max Number of Blocks in Route is the depth to which JMRI will search for a route when defining a warrant. This is a global value that can be overridden when creating a warrant.
You should experiment by watching how NXWarrants start and end or by issuing "Stop" and "Resume" commands to a recorded warrant.
The value of Throttle Setting/Speed Factor along with Layout Scale adjusts a throttle setting to be a layout track speed. The Throttle Factor set here is a global default.
For more information on Warrant speed parameters, see Modifying Warrant Speeds and follow its links.
In Release 4.9.2 Warrant compute a track speed when traversing a path with known length and known throttle setting. These measurements are made for each address that is rub under a warrant and are kept for the entire layout session. When JMRI is quit, at shutdown. These Session Speed Profiles can be merged into their Roster Speed Profiles. The following choices are available at shutdown.
Thanks and congratulations to all who contributed!
Copyright © 1997 - 2017 JMRI Community.
JMRI®, DecoderPro®, PanelPro™, SignalPro™, TrainPro™, DispatcherPro™, OperationsPro™ and associated logos are our trademarks.