Download and install JMRI®
JMRI Setup and Installation
JMRI environments...
Release Notes
Supported Hardware
Devices, command stations, networks, and protocols:
Source Code

JMRI Help:

Contents Index
Glossary FAQ

Donate to JMRI Donate to

Release Notes for JMRI 2.3.7 release

Date: Dcember 4, 2008

From: Bob Jacobsen

Subject: Test version 2.3.7 of JMRI/DecoderPro is available for download.


This is a test release. Please post a note if you encounter any new or old bugs! And please back up your JMRI files before installing this, in case you want to go back to an earlier version.

This is the seventh in a series of test versions. It contains many new features, including:

along with lots of other changes. See the complete list below.

Some of the changes involved are quite extensive. They may require a certain amount of experience before they are working well. Therefore, this test version should be considered experimental.

JMRI is now only available under the GNU General Public License. For more information, please see our copyright and licensing page.

New warnings for this version:


Warnings from older versions:

Windows desktop shortcuts have been restructured to make them more reliable. If you have custom shortcuts (ones you made), you may have to update them. The JMRI-created ones will be updated automatically. Users of Mac OS X and Linux will not be effected by this change.

Starting with the 2.3.4 test release, by default JMRI is allowed to use up to 200MB of memory (up from a limit of 60MB or 64MB previously). If this is more memory than you have available, and you notice JMRI slowing down a lot, please let us know so we can provide a work-around.

Staring with the 2.3.3 test release, JMRI builds the classpath (the list of .jar libraries used by the program) dynamically on Windows. We'll use this in the future for plug-ins and other features, and other platforms have been doing this for a while. If you have added any .jar files to your JMRI program directory, they may cause problems when the program is starting. Also, if originally installed a very old version of JMRI, there might still be files around that can cause this problems. If so, you can fix it by moving aside those extra .jar files from the JMRI program directory, or by asking Windows to un-install JMRI, before rerunning the installer. For more information on this, please see this discussion on the JMRi Users group.

JMRI is moving toward requiring Java 1.5 or later. Certain new features may not work if you are using an earlier version of Java. To see JMRI's future plans for this and other compatibility issues, please see the JMRI technology roadmap.

JMRI no longer supports NCE AIU broadcasts. This change was needed so that JMRI could reliably read certain CV values. We recommend that if you use NCE AIUs, that you upgrade the command station EPROM to version 2007 or newer and turn off AIU broadcasts. Code has been added to detect if AIU broadcasts are enabled, and if so a warning message will appear at startup requesting that AIU broadcasts be turned off for proper operation of the JMRI programs.

Indexed CVs will not be included in any printouts for this release.

QSI CV 56.129 Engine ID Access is not supported in this release.

While programming QSI decoders in Ops mode, it is necessary to disable CV 62 QSI Control (Verbal Acknowledgement), otherwise the writes will fail.

QSI CV 64 CV Numeric Verbal Readout currently does not work for indexed CVs.

Download links:

Please use these links for downloading, including the "?download" at the end. That adds to SourceForge's advertising statistics, which makes them happy to host our stuff.

Mac OS X:



Changes since test version 2.3.6:

David Duchamp fixed a bug that would occasionally cause errors when adding Transits.

Giorgio Terdina and David Duchamp improved the Window menu.

Previously, when you opened a locomotive entry in DecoderPro it would use your selected programming mode if it was available in your DCC system and the decoder; if not, it would select the fastest available mode. Now, it will always select the fastest available mode, even if you've already selected a workable mode.

Operations reports now have several selectable levels of detail. Also, train arrival times have been added for switchlists.

CAN bus connections can now handle extended frames.

A problem with some of the operations help link was fixed by Dan Boudreau.

Panel files viewed in web browser now show comments for Turnouts, Sensors, etc; some resizing to fit page better; better display of Logix and Simple Signal Logic options.

"Report Context" now reports screen resolution to help with certain setup problems.

Fixed a problem loading and storing throttle layouts when not using a standard Java GUI appearance.

Simple Signal Logic elements now have a comment field, for your convenience in documenting your configuration.

Initial support for Maple Systems control panels is now available.

Fixed a problem with the panel file DTDs that caused errors for panel files written with JMRI 2.3.3 or later. This is a read-side error, so earlier JMRI versions will continue to get the error message.

Dan Boudreau added backup and restore capabilities to operations.

Dan Boudreau customized the operations code for UK terminology. To use this, set the language of your computer to "en_GB", or use the JMRI advanced preferences to set the language to "English (United Kingdom)".

Paul Bender updated the XPressNet support for sending raw DCC packets to use the user-provided check byte. This makes the XPressNet code act like other systems.

Mike Mosher updated the QSI Diesel version 7 decoder definition.

Nigel Cliffe updated the CT Elektronik DCX decoder definitions.