Release Notes for JMRI 4.5.5 release
Date: October 17, 2016
From: Bob Jacobsen
Subject: Test version 4.5.5 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 next in a series of test versions. We expect this series to end in the next JMRI production release around the end of 2016. (See the tentative release schedule)
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.
Known problems with this release
See the complete list of current Issues.
- The TMCC throttle support does not work; it did work in JMRI 4.4, so please stay with that release if you use TMCC.
- There may be problems dragging and dropping to and from tables if the table has been sorted or had its columns reordered. Some parts of this are known to be fixed, but there might be others left. If you encounter this, please let us know.
- The Signal Mast table doesn't properly show default (initial) aspects and it's not possible to set Aspects directly from the Signal Mast Table. Setting signals via Logix or Panels is not affected.
New warnings for this version:
- Apple has released a new "Sierra" version of macOS (formerly known as OS X) which has enhanced security for downloaded programs. We're providing a new form of signed download to work with this, see below. Just in case that new form doesn't work with older Macs, we've also made the older format available. We'd be interested to hear whether the new form of download works on older OS versions, so that we can just release this new form without having to provide separate downloads.
Older warningsSee 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.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):
- 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.
- Run the command
/Applications/JMRI/PanelPro.app/Contents/Resources/uninstall-java6.shIt 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\ HDIt can take up to a half hour to complete. Wait for the message Removed Apple Java SE6.
- 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:
- The decodeJmriFilename() function is no longer available by default. Use the FileUtil.getExternalFilename() method instead.
- The simple propertyListener object is no longer available by default. Create your own, following the examples provided in the jython folder in the JMRI distribution.
- jmri_defaults.py included in the JMRI distribution is no longer executed by default, but will be executed before any other Jython scipts if included in your User Files location.
- The default behavior of python.cachedir.skip is now true. If using a custom python.properties file, include "python.cachedir.skip=false" in that file.
- Certain Python scripts are too large to be evaluated in Jython. If a script fails with the
java.io.IOException: Mark invaliderror, set "jython.exec=true" in a custom python.properties file or rewrite the script to be less than 100,000 characters per file. Note that when using "jython.exec=true" it may be desirable to run the included script jmri_bindings.py as a startup action to emulate the evaluation environment used when jython.exec=false.
(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 group for help converting them, or just drop them and use the current definitions.
Please use these links for downloading:
macOS (Sierra) and OS X: https://sourceforge.net/projects/jmri/files/test%20files/JMRI.4.5.5-R5a99fdd-signed.dmg/download
sha256: a9b17a2ebfb3cbb902dab0b09b98621be56e18c88ae1a9536ab544c9c46382ae (This is the new "signed" form)
Older OS X: https://sourceforge.net/projects/jmri/files/test%20files/JMRI.4.5.5-R5a99fdd.dmg/download
sha256: b2e41f9de2c4b34cecd283d5e84dfcb2e11286094f8120bea230cf6666ec4dab (This is an older form, use it if the signed image above doesn't work and then please let us know)
Changes since test release 4.5.4:The list of included commits is available from our GitHub code repository.
- Fix issues with Speedo systems in recent versions of JMRI (#2027).
- DCS240 OpSw31 description corrected in LocoNet Command Station Configuration tool where English language has been used.
Where the tool provides non-English language text, the translation may not have been completed.
When DCS240 OpSw31 is "C" (closed), "metering of switch messages" is disabled, and LocoNet switch messages are sent to the DCC track signal as quickly as possible. When DCS240 OpSw31 is "T" (thrown), the command station may slowly send switch request messages to the DCC track signal.
- Enable function keys on Sprog in programmer mode (#2027).
- The JMRI Digi XBee support now uses the official Digi XBee Library.
- Keywords for localization of Operations have been grouped to prevent duplicate work. Translators please check your earlier work from a fresh repo.
- German translation of Operations has been expanded.
- Fix errors preventing editing of sensor state labels (#2028).
Control Panel Editor Palette
- No longer throws cast exception when a dragged item is dropped outside of a panel.
- No longer will hang when displaying a warning during a Drag and Drop.
- Inactive buttons removed from SignalMast panel. Panel displays icons when the mast row is selected.
- Text and item Attribute panels now show changes to margin, border, fixed width and fixed height in the preview panel