Difference between revisions of "CS-105 Release Notes"

From Train Control Systems Documentation
Jump to navigation Jump to search
(page creation with R2.2.1 release notes)
 
(restructuring and rewording)
Line 1: Line 1:
== Release 2.2.1 ==
+
==Release 2.2.1==
  
=== New Feature Additions ===
+
===New Feature Additions===
- Adds support for XpressNet throttles in the AUX Cabs port. Enable it via the DCC System Settings >  AUX Cabs > Mode. Cab Bus and XpressNet ''cannot'' be used simultaneously. More details on the supported and unsupported features can be found here: [[XpressNet|https://docs.tcsdcc.com/wiki/XpressNet]]
 
  
- When two different throttles on the AUX Cab port in Cab Bus mode have the same locomotive selected, the screen will now update from each others’ changes. The screen will also update from macros executed.
+
* Adds support for XpressNet throttles in the AUX Cabs port. Enable it via the DCC System Settings >  AUX Cabs > Mode. Cab Bus and XpressNet ''cannot'' be used simultaneously. More details on the supported and unsupported features can be found here: [[XpressNet|https://docs.tcsdcc.com/wiki/XpressNet]]
 +
* When two different throttles on the AUX Cab port in Cab Bus mode have the same locomotive selected, the screen will now update from each others’ changes. The screen will also update from macros executed.
 +
* Adds support for backup and restore of the entire internal database of the CS-105. Use the LCC Memory Tool in JMRI (Version 5.4 or newer required) to “get” and “put” memory space 80. Get will create a backup, Put will restore a backup onto the CS-105. '''Warning:''' performing a write to this memory space will overwrite all of the consists and roster entries in your CS-105 with the backup you are restoring!
 +
* Adds support for controlling DCC extended accessories using the LCC Well-Known event identifiers 01.01.02.00.01.<addr>.<addr>.<aspect>, with the two address bytes being 0..2047 (MSB-first), and aspect being 0..255.  Example: to set Signal address 1123 (binary address 0x460) to aspect 99 (binary 0x63), send Event 01.01.02.00.01.04.60.63.
 +
* Adds Program On Main (POM) support for accessory decoders. To use this feature, currently you must perform an LCC memory config protocol write to memory space 0xf8. To compute the address, use formula 0x04C00000 + (turnout binary address (0..2047) << 10) + cv_number. This is addressed using output numbers.  Example: to program CV 515 (binary representation 0x202) for turnout 650 (binary address 0x287), use address 0x04CA2A02 (which is 80357890 in decimal).  For DCC Extended accessories, use 0x04A00000 + (accessory binary address (0..2047) << 10) + cv_number. The accessory binary address is denoted by A<sub>10</sub>A<sub>9</sub>…A<sub>1</sub>A<sub>0</sub> in the DCC and RCN standards.
 +
* Adds support for the draft LCC Stream protocol. '''This is considered experimental.'''
  
- Adds support for backup and restore of the entire internal database of the CS-105. Use the LCC Memory Tool in JMRI (Version 5.4 or newer required) to “get” and “put” memory space 80. Get will create a backup, Put will restore a backup onto the CS-105. '''Warning:''' performing a write to this memory space will overwrite all of the consists and roster entries in your CS-105 with the backup you are restoring!
+
===Bug Fixes and Misc. Changes===
  
- Adds support for controlling DCC extended accessories using the LCC Well-Known event identifiers 01.01.02.00.01.<addr>.<addr>.<aspect>, with the two address bytes being 0..2047 (MSB-first), and aspect being 0..255. Example: to set Signal address 1123 (binary address 0x460) to aspect 99 (binary 0x63), send Event 01.01.02.00.01.04.60.63.
+
* Fixes a bug in macro creation where the configuration display for “Normal” and “Reverse” on a DCC accessory turnout were mistakenly flipped. The bug fix aligns the displayed text for "Normal" and "Reverse" in the Command Station’s macro configuration with the UWT-100’s "Normal" and "Reverse" buttons, as well as the DCC & LCC standardized commands.  This is a display-only change in the configuration window. '''Stored macros''' will continue to send the same DCC packets and LCC messages, and thus '''do not need to be updated'''.
 +
* This release optimizes the roster storage in the CS-105, which fixes issues with locomotive selection after the CS-105 has been in use for an extended period of time.   Existing locomotive roster entries will be optimized when the CS-105 is first turned on after updating the software.
 +
* Adjustments have been made to the Program Track to improve the reliability when reading CVs, particularly with locomotives with large capacitance on board. These changes now better support the case when a (second) locomotive is placed on the program track when the programming track is already in operation.
 +
* To improve safety and standards compliance, the “high current” mode of the Program Track will only be in effect only until the next power cycle of the command station, at which time the setting will automatically revert to the normal 250mA limit.
 +
* Fixes issue with UWT throttles in LCC mode, where a function configured to be "Momentary" on a roster entry would not operate as momentary if the function's name was not also configured.
 +
* Shows a "[[wikipedia:Splash_screen|splash screen]]" on AUX Cabs in Cab Bus Mode. This fixes the issue where a NCE PowerCab would sometimes start up in command station mode when connected to the CS-105.
 +
* Improvements have been made to the response in Cab Bus mode when many AUX Cabs are in use.
 +
* The CS-105 will now ensure that auxiliary boosters such as the B-106 are shut down if the CS-105 encounters a software failure.
  
- Adds Program On Main (POM) support for accessory decoders. To use this feature, currently you must perform an LCC memory config protocol write to memory space 0xf8. To compute the address, use formula 0x04C00000 + (turnout binary address (0..2047) << 10) + cv_number. This is addressed using output numbers. Example: to program CV 515 (binary representation 0x202) for turnout 650 (binary address 0x287), use address 0x04CA2A02 (which is 80357890 in decimal).  For DCC Extended accessories, use 0x04A00000 + (accessory binary address (0..2047) << 10) + cv_number. The accessory binary address is denoted by A<sub>10</sub>A<sub>9</sub>…A<sub>1</sub>A<sub>0</sub> in the DCC and RCN standards.
+
==== LCC-Related Changes and Bug Fixes ====
  
- Adds support for the draft LCC Stream protocol. This is considered experimental.
+
* Changes the LCC “Custom Short Event” producer to simply indicate whether the track output is ON or OFF. Now the CS-105 produces events that indicate the reason why the track was turned off (see [[LCC Events Information]] for details).
 +
* Minor fixes for LCC standards compliance in the CDI XML: added a trailing zero, removed non-compliant empty groups, and fixed a case where min/max was not matching the map values. Updated capitalization of menu items.
 +
* Updates to the built-in LCC WiFi Hub: Adds newlines after the individual frames. Optimizes latency for memory configuration transfers.
 +
* Avoids crashes on non-compliant LCC messages that have a zero source alias.
 +
* Fixes crash when invalid Time values were entered in the fast clock configuration.
 +
* Fixes to the LCC initialization steps: removes spurious “Track voltage brownout” and “Track Fault” events at startup. Removes unneeded duplicate initialization messages at startup when the LCC cable is already plugged in. Adjusts incorrect Producer Range Identified message.
  
=== Bug Fixes and Misc. Changes: ===
+
=== Download Release 2.2.1 ===
- Fixes a bug in macro creation where the configuration display for “Normal” and “Reverse” on a DCC accessory turnout were mistakenly flipped. The bug fix aligns the displayed text for Normal/Reverse in the Command Station’s macro configuration with the UWT-100’s Normal and Reverse buttons, as well as the DCC standardized commands respectively. This is a display-only change in the configuration window. '''Stored macros''' will continue to send the same DCC packets and LCC messages, and thus '''do not need to be updated'''.
+
[https://github.com/TCSDCC/Public-Software-Resources/raw/master/LCC%20Firmware%20Files/device/CS-105/CS-105%20R2.2.1%20(06-06-2024).bin Download CS-105 R2.2.1 (06-06-2024)]
  
- This release optimizes the roster storage in the CS-105, which fixes issues with locomotive selection after the CS-105 has been in use for an extended period of time. Existing locomotive roster entries will be optimized when the CS-105 is first turned on after updating the software.
+
==Note on Downgrading to R1.X from R2.X==
 +
'''TCS does not recommend downgrading the software from Version 2+ to any earlier version. Such a downgrade, as well as any following upgrade, will cause loss or inconsistency of Consist and Roster information. A computer backup of Roster information is strongly advised.'''
  
- Adjustments to the Program Track to better support reading CVs of locomotives with large capacitance on board. Supports the case when a locomotive is placed on the program track when it is already in operation. To improve safety and standards compliance, the “high current” mode of the Program Track will be in effect only until the next power cycle of the command station.
+
For Instructions on how to back up your CS-105 database and configurations/settings [[CS-105 Database Backup|CLICK HERE]].
  
- Changes the LCC “Custom Short Event” producer to simply indicate whether the track output is on or off. Now the CS-105 produces events that indicate the reason why the track was turned off (see list below).
+
== Release 1.0.1 ==
 +
Release 1.0.1 fixes an issue with compatibility and communication with a LCC Hub when run using JMRI.  
  
- Fixes issue with UWT throttles in LCC mode, where a momentary function on a roster entry does not operate as momentary when a function name is not configured.
+
Release 1.0 is the first production release for the CS-105, including pre-orders, and should be updated to 1.0.1 to fix this issue if you encounter it.
  
<s>- Fixes rare crash upon CS startup when an XpressNet throttle plugged into the AUX cabs port auxiliary throttle is connected which is recalling a stored locomotive.</s>
+
=== Download Release 1.0.1 ===
 
+
[https://github.com/TCSDCC/Public-Software-Resources/raw/master/LCC%20Firmware%20Files/device/CS-105/CS-105%20R1.0.1%20(12-29-2022).bin Download CS-105 R1.0.1 (12-29-2022)]
- Shows a splash screen on AUX Cabs in Cab Bus Mode. This fixes the issue when an NCE PowerCab starts up in command station mode on the CS-105.
 
 
 
- Response time improvements in Cab Bus mode when many Cabs are in use.
 
 
 
- Minor fixes for LCC standards compliance in the CDI XML: added a trailing zero, removed incompliant empty groups, and fixed a case where min/max was not matching the map values. Updated capitalization of menu items.
 
 
 
- Ensures that auxiliary boosters such as the B-106 are shut down when the CS-105 encounters a software failure.
 
 
 
- Updates to the built-in LCC WiFi Hub. Adds newlines after the individual frames. Optimizes latency for memory configuration transfers.
 
 
 
- Avoids crashes on noncompliant LCC messages that have a zero source alias.
 
 
 
- Fixes crash when invalid Time values were entered in the fast clock configuration.
 
 
 
- Fixes to the LCC initialization steps: removes spurious “Track voltage brownout” and “Track Fault” events at startup. Removes unneeded duplicate initialization messages at startup when the LCC cable is already plugged in. Adjusts incorrect Producer Range Identified message.
 
 
 
== Note on Downgrading to R1.X from R2.X ==
 
TCS does not recommend downgrading the software from Version 2+ to any earlier version. Such a downgrade, as well as any following upgrade will cause loss or inconsistency of Consist and Roster information. A computer backup of Roster information is strongly advised.
 

Revision as of 23:35, 11 July 2024

Release 2.2.1

New Feature Additions

  • Adds support for XpressNet throttles in the AUX Cabs port. Enable it via the DCC System Settings >  AUX Cabs > Mode. Cab Bus and XpressNet cannot be used simultaneously. More details on the supported and unsupported features can be found here: https://docs.tcsdcc.com/wiki/XpressNet
  • When two different throttles on the AUX Cab port in Cab Bus mode have the same locomotive selected, the screen will now update from each others’ changes. The screen will also update from macros executed.
  • Adds support for backup and restore of the entire internal database of the CS-105. Use the LCC Memory Tool in JMRI (Version 5.4 or newer required) to “get” and “put” memory space 80. Get will create a backup, Put will restore a backup onto the CS-105. Warning: performing a write to this memory space will overwrite all of the consists and roster entries in your CS-105 with the backup you are restoring!
  • Adds support for controlling DCC extended accessories using the LCC Well-Known event identifiers 01.01.02.00.01.<addr>.<addr>.<aspect>, with the two address bytes being 0..2047 (MSB-first), and aspect being 0..255. Example: to set Signal address 1123 (binary address 0x460) to aspect 99 (binary 0x63), send Event 01.01.02.00.01.04.60.63.
  • Adds Program On Main (POM) support for accessory decoders. To use this feature, currently you must perform an LCC memory config protocol write to memory space 0xf8. To compute the address, use formula 0x04C00000 + (turnout binary address (0..2047) << 10) + cv_number. This is addressed using output numbers. Example: to program CV 515 (binary representation 0x202) for turnout 650 (binary address 0x287), use address 0x04CA2A02 (which is 80357890 in decimal).  For DCC Extended accessories, use 0x04A00000 + (accessory binary address (0..2047) << 10) + cv_number. The accessory binary address is denoted by A10A9…A1A0 in the DCC and RCN standards.
  • Adds support for the draft LCC Stream protocol. This is considered experimental.

Bug Fixes and Misc. Changes

  • Fixes a bug in macro creation where the configuration display for “Normal” and “Reverse” on a DCC accessory turnout were mistakenly flipped. The bug fix aligns the displayed text for "Normal" and "Reverse" in the Command Station’s macro configuration with the UWT-100’s "Normal" and "Reverse" buttons, as well as the DCC & LCC standardized commands. This is a display-only change in the configuration window. Stored macros will continue to send the same DCC packets and LCC messages, and thus do not need to be updated.
  • This release optimizes the roster storage in the CS-105, which fixes issues with locomotive selection after the CS-105 has been in use for an extended period of time. Existing locomotive roster entries will be optimized when the CS-105 is first turned on after updating the software.
  • Adjustments have been made to the Program Track to improve the reliability when reading CVs, particularly with locomotives with large capacitance on board. These changes now better support the case when a (second) locomotive is placed on the program track when the programming track is already in operation.
  • To improve safety and standards compliance, the “high current” mode of the Program Track will only be in effect only until the next power cycle of the command station, at which time the setting will automatically revert to the normal 250mA limit.
  • Fixes issue with UWT throttles in LCC mode, where a function configured to be "Momentary" on a roster entry would not operate as momentary if the function's name was not also configured.
  • Shows a "splash screen" on AUX Cabs in Cab Bus Mode. This fixes the issue where a NCE PowerCab would sometimes start up in command station mode when connected to the CS-105.
  • Improvements have been made to the response in Cab Bus mode when many AUX Cabs are in use.
  • The CS-105 will now ensure that auxiliary boosters such as the B-106 are shut down if the CS-105 encounters a software failure.

LCC-Related Changes and Bug Fixes

  • Changes the LCC “Custom Short Event” producer to simply indicate whether the track output is ON or OFF. Now the CS-105 produces events that indicate the reason why the track was turned off (see LCC Events Information for details).
  • Minor fixes for LCC standards compliance in the CDI XML: added a trailing zero, removed non-compliant empty groups, and fixed a case where min/max was not matching the map values. Updated capitalization of menu items.
  • Updates to the built-in LCC WiFi Hub: Adds newlines after the individual frames. Optimizes latency for memory configuration transfers.
  • Avoids crashes on non-compliant LCC messages that have a zero source alias.
  • Fixes crash when invalid Time values were entered in the fast clock configuration.
  • Fixes to the LCC initialization steps: removes spurious “Track voltage brownout” and “Track Fault” events at startup. Removes unneeded duplicate initialization messages at startup when the LCC cable is already plugged in. Adjusts incorrect Producer Range Identified message.

Download Release 2.2.1

Download CS-105 R2.2.1 (06-06-2024)

Note on Downgrading to R1.X from R2.X

TCS does not recommend downgrading the software from Version 2+ to any earlier version. Such a downgrade, as well as any following upgrade, will cause loss or inconsistency of Consist and Roster information. A computer backup of Roster information is strongly advised.

For Instructions on how to back up your CS-105 database and configurations/settings CLICK HERE.

Release 1.0.1

Release 1.0.1 fixes an issue with compatibility and communication with a LCC Hub when run using JMRI.

Release 1.0 is the first production release for the CS-105, including pre-orders, and should be updated to 1.0.1 to fix this issue if you encounter it.

Download Release 1.0.1

Download CS-105 R1.0.1 (12-29-2022)