Release Notes for JMRI 4.3.3 release

Date: Feb 15, 2016

From: Bob Jacobsen

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

Notes:

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 middle 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.

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.3.4, due out in the first half of March, or pick up a development build installer from Jenkins.

New warnings for this version:

Older warnings

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

The internals of the Layout Editor have been reworked a bit. Please keep an eye out for any changed behaviors.

The code for handling Panel Editor / Control Panel Editor icons has changed to better deal with rotating icons. This has changed how opaque vs transparent icon backgrounds are handled. Please check your panels to make sure we haven't inadvertently caused a problem, particularly if you've got rotated icons and/or use have custom icons with transparent backgrounds. If there are any problems, please send in a copy of your panel file so we can recreate the problem and fix it.

The configuration is now stored in multiple files within a directory named profile inside a Configuration Profile instead of within the file ProfileConfig.xml. PanelPro and DecoderPro both should migrate from the old configuration to the new configuration seamlessly. See JMRI Issue #69 for more details. Please report any issues at our GitHub project.

The XML schema for decoder files has been made more precise. This shouldn't effect people who just use the JMRI decoder definitions as distributed, because they all work with this more precise version. But if you have decoder definitions of your own, you may have to update them. Ask for help on JMRIusers if you have trouble. Specifically, the decoder file verification will now reject a few things that it didn't catch before, even though they didn't really work:

As a side effect of checking this, the qualifier elements inside a variable now have to be at the front of the contents, and the label, comment and tooltip elements have to be at the back. You can't just sprinkle them around and hope the code finds them (because sometimes in the past the program would miss one; now we require an order we're sure the code will understand).

Mac OS X 10.11 El Capitan requires signed drivers for USB adapters. If you've upgraded from an earlier version, your drivers may not work. That will cause JMRI to throw errors when it doesn't find communications links. To fix this, go to the web site for your adapter manufacturer, find the drivers that are listed to work with Mac OS X 10.9 or later, download, and install, then retry JMRI again.

Jython has been upgraded to version 2.7.0 with the following potentially breaking changes:

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.

The OpenLCB 0.6.4 library in this version has a bug in its alias calculations which prevents JMRI from communicating occasionally. A patch has been submitted to the OpenLCB group, but as they seem no longer interested in maintaining that code, it's not known when this will be fixed. In the meantime, the workaround is to restart JMRI and/or the hardware node(s) and try again; that might allocate different alias values.

Download links:

Please use these links for downloading:

Mac OS X: https://sourceforge.net/projects/jmri/files/test%20files/JMRI.4.3.3-R965a469.dmg/download
sha256: 8d63a2beafb2db5a6a18d298d258aa2b06212566c2f368c61d2fc7d4acaab0d5

Windows: https://sourceforge.net/projects/jmri/files/test%20files/JMRI.4.3.3-R965a469.exe/download
sha256: 3247ea32ed03521da86b0c04e03ed6e9a68cee3e8de61c452c1a179f96543168

Linux: https://sourceforge.net/projects/jmri/files/test%20files/JMRI.4.3.3-R965a469.tgz/download
sha256: 59cb0f69f1eff78798c4949af3d11a7b8e4a12731b61663812e30d831477becf

Changes since test release 4.3.2:

The list of included commits is available from our GitHub code repository.

Hardware Support

Help for setting up JMRI with your OS and Java version as well as setting general preferences is available as Setup Help, including a short FAQ section, so application help pages can focus on the functions in each part.

LocoNet
SPROG

Signals

Signal Systems

New / Updated decoder definitions

BLI
Digitrax
NCE
QSI
RR-CirKits
SoundTraxx
ZIMO

Operations

Warrants

Preferences

Panel Editors

Layout Editor

Scripting

Miscellaneous