Release Notes for JMRI 4.6 release

Date: December 17, 2016

From: Bob Jacobsen

Subject: Production version 4.6 of JMRI/DecoderPro is available for download.

We are very pleased to announce that the 4.5 series of JMRI test releases has resulted in a version that's good enough to be recommended for general use, including by new users. We're therefore making that version, "Production version 4.6" available for download today.

Notes:

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

Known problems with this release

If any of those effect you, please either wait for JMRI 4.7.1, due out shortly after this one, or (once there's a fix for the problem) pick up a development build installer from Jenkins.

New warnings for this version:

Older warnings

See the JMRI 4.4 release note for warnings predating the 4.4 development series. These may be relevant to you if you're updating from an earlier version.

(Since JMRI 4.5.6) When a Digitrax DCS240 is the command station, JMRI throttles may not be able to take control of a locomotive or consist in some cases if the DCS240 "expanded slots" (i.e. 400 slots) feature is in use. Be sure to "dispatch" or "release" locomotives and consists from throttles which use "expanded slots" before attempting to acquire the locomotive or consist via a JMRI throttle, as this may enable JMRI to acquire the locomotive or consist. This problem can affect throttles which use the JMRI WiThrottle interface and throttles controlled via the JMRI Web Server. This issue is thought to be present in all previous versions of JMRI.

(Since JMRI 4.5.6) DCC++ connections on Linux may not work.

(Since JMRI 4.5.6) As part of fixing the TMCC throttle issue, the handling of TMCC preferences was changed. If you have a TMCC connection configured, please go to the "Defaults" pane in the Preferences window and make sure that the TMCC connection is selected for the appropriate device types.

(Since JMRI 4.5.2) This and future versions of JMRI may not function on OS X if the Java SE 6 provided by Apple is installed. OS X operating system updates routinely remove this version of Java SE 6. Please raise any issues concerning this on the user's group.

To remove Java SE 6 from OS X, follow these steps (these steps assume JMRI is installed in the folder /Applications/JMRI, if not, adjust the following paths as needed):

  1. Open Terminal.app.

    El Capitan only: Reboot into Recovery Mode by restarting your Mac and pressing Cmd-R until the Apple logo appears. Once in Recovery Mode, select Terminal from the Utilities menu.

  2. Run the command /Applications/JMRI/PanelPro.app/Contents/Resources/uninstall-java6.sh It can take up to a half hour to complete. Wait for the message Removed Apple Java SE6.

    El Capitan only: Run the command bash /Volumes/Macintosh\ HD/Applications/JMRI/PanelPro.app/Contents/Resources/uninstall-java6.sh /Volumes/Macintosh\ HD It can take up to a half hour to complete. Wait for the message Removed Apple Java SE6.

  3. El Capitan only: Restart your Mac.

(Since JMRI 4.5.2) Support for directly executing AppleScript within JMRI has been removed due to changes in macOS and Java outside our control. If you require the ability to use AppleScript, you may be able to add this capability on your own by visiting JMRI AppleScript Support, but please be aware that this may not work on upcoming releases of macOS or Java.

(Since JMRI 4.5.1) LocoTools, no longer supported since JMRI 2.10, has been removed from the Linux and OS X distributions.

(Since JMRI 4.5.1) Internal turnouts and sensors need to have complete, individual system names. The names "IT" and "IS" (without any suffix) are no longer permitted: "IT12" is fine, but just "IT" is not. Most panel files that contain these should automatically migrate them to new names when saved, but in some cases you might need to manually update them.

(Since JMRI 4.3.5) When sharing a configuration between this version and JMRI 4.3.4 or older, the older version of JMRI will not reflect changes in preferences, window position, table sorting, column order, or other user interface state. This is due to changes in how user preferences and interface state are stored.

(Since JMRI 4.3.3) You can now set the order of your startup items: If you're opening panel files, running scripts, etc as the program starts up, there's a preferences pane that lets you easily set the order in which those happen. If you've set the order manually (e.g. by editing configuration files) in the past, please check this preference to make sure it's set the way you want.

(Since JMRI 4.1.2) Jython has been upgraded to version 2.7.0 with the following potentially breaking changes:

(Since JMRI 4.1.1) Decoder definitions that use the "ivariable" form are now deprecated. Definitions included with this release have been converted to the new form. If you have decoder definitions with the older "ivariable" form, they will no longer validate, but can still be used for the first couple of test releases in this series. Please ask on the JMRI users Yahoo group for help converting them, or just drop them and use the current definitions.

Download links:

Please use these links for downloading:

OS X: https://sourceforge.net/projects/jmri/files/production%20files/JMRI.4.6-R81496dc.dmg/download
sha256: 778086e641ef8d9c85d5f57f68fcccd60d721520dc3fc6eb54ed197f48f4b016

Windows: https://sourceforge.net/projects/jmri/files/production%20files/JMRI.4.6-R81496dc.exe/download
sha256: af9847a7dc9e62ec44a70fbae1cdea2c291ad8e31422c8f3c648186862c54442

Linux: https://sourceforge.net/projects/jmri/files/production%20files/JMRI.4.6-R81496dc.tgz/download
sha256: 81c642347dc1bf8c4abf93c19385845e637ce801be68ab6aaf1d5fd9a5eded37

Changes since production release 4.4:

Links to the full list of changes from JMRI test release 4.5.1, 4.5.2, 4.5.3, 4.5.4, 4.5.5, 4.5.6, 4.5.7, 4.5.8 in our GitHub code repository.

Hardware Support

Bachrus Speedo
Digitrax
Digi XBee
LocoNet
OpenLCB
Roco z21/Z21
SRCP
SPROG
TAMS
TMCC

New / Updated decoder definitions

Digirails
Digitrax
ESU
LaisDCC
RR-CirKits
SoundTraxx
TCS
ZIMO

Dispatcher

Layout Editor

Localization

Operations

Panel Editors

Control Panel Editor Palette
Control Panel Editor Shapes

Scripting

Signals

Signal Systems
Signal Mast Drivers

Tools

Tables
Routes (Logix Routes)

Warrants

Web Access

Miscellaneous