Release Notes for JMRI 4.17.2 release
Date: July 26, 2019
From: Bob Jacobsen
Subject: Test Release 4.17.2 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 releases.
We expect this series to end in the next JMRI production release late in 2019.
(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 release should be considered experimental.
JMRI is now only available under the
GNU General Public License. For more information, please
copyright and licensing page.
Update From Older JMRI Versions
If you are currently using JMRI 4.11.9 or earlier, we strongly recommend that you update to
JMRI 4.12 and make sure that's running OK before
updating to this test release. Once you have JMRI 4.12 running OK,
store your configuration and panel files and use those from then on.
There have been a number of
changes in serial port support, panel file format and configuration options since those earlier releases,
and moving to the stable JMRI 4.12 release
is a good way to work through any possible problems.
If you are currently using JMRI 4.7.3 or earlier on Linux or macOS (Windows doesn't need this),
update to JMRI 4.12 and
carrying out the migration process described in the JMRI 4.12 release note
before updating to this release.
Known problems with this release
- LocoNet connections - New and updated LocoNet connections with this release might
end up with the wrong baud rate, which will cause them to not function.
This is resolved in
New warnings for this release:
See the JMRI 4.16 release note for more warnings predating the 4.17
development series. These may be relevant to you if you're updating from an earlier version.
- Since JMRI 4.15.6
Remembering the location and size of layout panels created and maintained
using Layout Editor, Panel Editor, Control Panel Editor, and Switchboard
Editor is no longer dependent on saving the panel. The location and size
values are retained using the same processes used by other JMRI windows. This
makes the window management behavior consistent. To continue using the
old behavior, go to Preferences >> Display and enable
Use old location and size logic for editor panels.
- Since JMRI 4.15.6
Starting in JMRI 4.15.6, Memories
must have valid system names of the form "IM" folllowed by something.
"IM123" and "IMEAST" are both valid.
The system name "IM", all by itself, has never been valid, but JMRI
will now be enforcing that:
JMRI needs to start enforcing this in preparation for some
future code that will appear later this year.
- You won't be able to create a memory with that name via
the Memory table or scripts
- If you have that name in a panel file, an error will be
logged and the panel file won't load. You'll have to
remove it from he file or rename it in the file
before loading it.
- Since JMRI 4.15.5
The handling of Turnout system names has been updated
to be (more, hopefully completely) consistent with the
Specifically, case now (generally) matters in system names:
This should not require any migration for stored configurations or
panel files, as they have been automatically been being kept consistent
since JMRI 4.8. But you might have case errors in i.e. scripts which
will fixing inconsistent references in your scripts.
Of course, bugs are always possible. If you find a place where
names seem to be handled inconsistently, please let us know!
- You can now have an internal turnout named "ITsome lower case name".
- But note you can no longer refer to "ITSOME LOWER CASE NAME" or
"ITSome LoWeR cAse Name" and get the same one.
- Since JMRI 4.15.4
The calculation of Turnout Addresses for the
Direct DCC Accessory Command ("a" command) mode
has been fixed (commands are now sent to the correct accessory address rather
than 4 less than the nominated hardware address). For pre-existing panels,
changes will need to be made to either the actual decoder address or the panel.
If help is required, ask on the
- Since JMRI 4.15.3
The prefix that identifies a layout connection should be a single letter, like "N" or "L",
or a letter and some digits, like "K2" or "D3". Some older systems used to have
longer "legacy system prefixes" like "DX", "DCCPP", "DP", "MR", "MC", "PI", and "TM".
Those legacy system prefixes
will now cause JMRI to issues a warning at startup. In this release, JMRI will
still work with those prefixes, but they will need to be migrated to the proper form soon;
JMRI 4.17.1 and later will require that this have been fixed.
Therefore, this warning can't be suppressed
without migrating the prefix in the connection configuration (and any associated
panel files and scripts).
If you're getting this warning and therefore need to do that migration,
- Since JMRI 4.11.4
There are issues with the Pi-SPROG One command station operation. A number of workarounds should be applied:
Pi-SPROG One with version 2.4 or earlier firmware will cause a timeout after a track short circuit. A dialog box will
open to inform the user of this. The track power will be turned off and must be turned on again using the power control.
- Do not turn on the track power until the power supply to the Pi-SPROG ONE is turned on
- Do not enable extra debugging through default.lcf, nor open the system console window
- Do not open the SPROG console window
- Disable power conversion (CV 29) in all locos
- If connecting via VNC (or similar), setup the screen layout before turning on the track power
Please note that the download links in this and future JMRI releases link to
People are welcome to distribute the download files further via other websites, etc.
If you want to check that you've received original, unmodified versions, please
check the files against the checksums shown below.
The list of included commits
is available from our
GitHub code repository
- Fixed issue with Throttle Direction Changes ( while moving ) not being sent to Command Station
Turnouts, Lights, Sensors and other elements
- JMRI no longer modifies "system names" as provided by the user.
There may be cases where a script or panel file is creating an
object with a system name that is slightly different than a system
name used elsewhere, and JMRI used to change these to be the same.
Users may have to modify scripts and panel files to ensure system
names match in all places.
- Layout Editor combo boxes have been changed to support the migration
from JmriBeanComboBox to NamedBeanComboBox. The affects the Toolbar,
the Edit context menu, Set Signal Heads, Set Signal Masts, and Set Sensors.
- Typing a name into the combo box field no longer works. The
items have to be selected from the combo box drop down.
- Typing a letter or two will position the selection.
- Positioning is based on both the user name and the system name.
For example, typing i will select items with user names starting
with the letter i/I as well as internal items using the system name which starts with i/I.
- With this release, it is not possible to create new Block entries
using the Edit context item.
- If a block is selected that does not have a user name, a
dialog will prompt for a user name.
- We "deprecate" certain methods and members in the Java code when they're
no longer recommended for use. After some time, we then remove them.
This version of JMRI removes all deprecated methods and members up
through JMRI 4.10, which was released in December 2017.
If you still have code or scripts that reference these, please
the code in JMRI 4.16
for suggestions on what to substitute.