Difference between revisions of "XpressNet"

From Train Control Systems Documentation
Jump to navigation Jump to search
 
(2 intermediate revisions by one other user not shown)
Line 1: Line 1:
XpressNet<sup>TM</sup> is the name given to the throttle network created by Lenz and also implemented by other model railway electronics manufacturers. Electrically, XpressNet<sup>TM</sup> is based around half duplex RS-485 and is a polled network running at 62.5 Kbaud. The CS-105 provides hardware support for this bus protocol through the RJ12 port labeled "Auxiliary". Software support is in development. A beta version is available, contact TCS for more information.
+
XpressNet<sup>TM</sup> is the name given to the throttle network created by Lenz and also implemented by other model railway electronics manufacturers. Electrically, XpressNet<sup>TM</sup> is based around half duplex RS-485 and is a polled network running at 62.5 Kbaud. The [[CS-105]] provides hardware support for this bus protocol through the RJ12 port labeled AUX Cabs. Software support is now available starting with CS-105 software version 2.0. Hardware and software support is also available on the AUX Cabs port of the [[LCC WiFi Panel]].
  
 
==Unsupported Features==
 
==Unsupported Features==
 
Some of the unsupported features are due to intrinsic limitations of translation between LCC and XpressNet. Support for some of the unsupported features may be added as time and development resources permit, and will be prioritized based on customer feedback. Only commands starting with XpressNet 3.0 and beyond are supported. X-Bus V1 and V2 commands are not supported.
 
Some of the unsupported features are due to intrinsic limitations of translation between LCC and XpressNet. Support for some of the unsupported features may be added as time and development resources permit, and will be prioritized based on customer feedback. Only commands starting with XpressNet 3.0 and beyond are supported. X-Bus V1 and V2 commands are not supported.
  
===Locomotive Addresses===
+
===Locomotive Long Addresses Less than 100===
 
Locomotive addresses 1-99 are always DCC short addresses. Locomotive Addresses 100-9999 are always DCC long addresses.
 
Locomotive addresses 1-99 are always DCC short addresses. Locomotive Addresses 100-9999 are always DCC long addresses.
  
===Locomotive Speed Step mode===
+
===Locomotive 28 Speed Step Mode===
 
Locomotives are always controlled in 128 speed step mode. If an XpressNet device requests 14, 27, or 28 speed step mode, the CS-105 will emulate the speed step mode and automatically translate an interpolated 128 speed step to the locomotive.
 
Locomotives are always controlled in 128 speed step mode. If an XpressNet device requests 14, 27, or 28 speed step mode, the CS-105 will emulate the speed step mode and automatically translate an interpolated 128 speed step to the locomotive.
  
 
===Locomotive Functions===
 
===Locomotive Functions===
Function 2 is hard-coded to momentary. All other functions are hard-coded to latching. Function momentary or latching mode setup is not supported. Functions 29 through 68 are not supported.
+
By default, function 2 is hard-coded to momentary. All other functions are hard-coded to latching. Function momentary or latching mode can be customized in the command stations database and is loaded from the command station database if available. Function momentary or latching mode setup from an XpressNet device is not supported. Functions 29 through 68 are not currently supported.
 +
{| class="wikitable"
 +
|''NOTE: Some throttles, such as the Lenz LH200 do not support momentary functions. On these throttles, F2 and other momentary functions will always be latching.''
 +
|}
  
 
===Locomotive Consisting===
 
===Locomotive Consisting===
Line 17: Line 20:
  
 
===Locomotive Real-Time Updates===
 
===Locomotive Real-Time Updates===
No indication is provided if the locomotive is also under the control of another device, and no real-time speed and function updates from other devices are provided.
+
If the locomotive is also under the control of another device, the XpresssNet throttle is notified. This is often indicated by a flashing display. However, unsolicited real-time speed and function updates are not provided due to the XpressNet protocol not supporting this feature..
  
 
===Programming===
 
===Programming===
Program Track and Program on the Main is not supported.
+
Program Track and Program on the Main are not supported.
  
===Model Time===
+
===Model Time (Fast Clock)===
 
Model Time (Fast Clock) is not currently supported.
 
Model Time (Fast Clock) is not currently supported.
  
===Accessory Activation and Feedback===
+
===Accessory Activation and Feedback >2044===
 
Activation and Feedback is available for DCC accessory decoder addresses 1 - 2044. Addresses above 2044 are not supported. Lenz feedback input modules are not supported.
 
Activation and Feedback is available for DCC accessory decoder addresses 1 - 2044. Addresses above 2044 are not supported. Lenz feedback input modules are not supported.
  
 
==Supported and Unsupported Command Summary==
 
==Supported and Unsupported Command Summary==
 
Please see the [https://www.lenz-elektronik.de/src/pdf/Lenz_XpressNet_Doku.pdf XpressNet Documentation] for additional information about the XpressNet protocol.
 
Please see the [https://www.lenz-elektronik.de/src/pdf/Lenz_XpressNet_Doku.pdf XpressNet Documentation] for additional information about the XpressNet protocol.
{| class="wikitable"
+
{| class="wikitable mw-collapsible"
 
|+Commands from CS-105 to XpressNet Device
 
|+Commands from CS-105 to XpressNet Device
 
!Supported
 
!Supported
Line 625: Line 628:
  
 
<sup>3</sup> Support for Command Station Busy is unnecessary because the CS-105 is always able to respond and never needs to report that it is busy.
 
<sup>3</sup> Support for Command Station Busy is unnecessary because the CS-105 is always able to respond and never needs to report that it is busy.
{| class="wikitable"
+
{| class="wikitable mw-collapsible"
 
|+Commands from XpressNet Device to CS-105
 
|+Commands from XpressNet Device to CS-105
 
!Supported
 
!Supported

Latest revision as of 03:24, 9 February 2024

XpressNetTM is the name given to the throttle network created by Lenz and also implemented by other model railway electronics manufacturers. Electrically, XpressNetTM is based around half duplex RS-485 and is a polled network running at 62.5 Kbaud. The CS-105 provides hardware support for this bus protocol through the RJ12 port labeled AUX Cabs. Software support is now available starting with CS-105 software version 2.0. Hardware and software support is also available on the AUX Cabs port of the LCC WiFi Panel.

Unsupported Features

Some of the unsupported features are due to intrinsic limitations of translation between LCC and XpressNet. Support for some of the unsupported features may be added as time and development resources permit, and will be prioritized based on customer feedback. Only commands starting with XpressNet 3.0 and beyond are supported. X-Bus V1 and V2 commands are not supported.

Locomotive Long Addresses Less than 100

Locomotive addresses 1-99 are always DCC short addresses. Locomotive Addresses 100-9999 are always DCC long addresses.

Locomotive 28 Speed Step Mode

Locomotives are always controlled in 128 speed step mode. If an XpressNet device requests 14, 27, or 28 speed step mode, the CS-105 will emulate the speed step mode and automatically translate an interpolated 128 speed step to the locomotive.

Locomotive Functions

By default, function 2 is hard-coded to momentary. All other functions are hard-coded to latching. Function momentary or latching mode can be customized in the command stations database and is loaded from the command station database if available. Function momentary or latching mode setup from an XpressNet device is not supported. Functions 29 through 68 are not currently supported.

NOTE: Some throttles, such as the Lenz LH200 do not support momentary functions. On these throttles, F2 and other momentary functions will always be latching.

Locomotive Consisting

Consist setup is not supported. Consists setup on a native LCC throttle (such as the UWT-100 or UWT-50) will operate from an XpressNet device using any of the consist members' addresses. The XpressNet throttle does not indicate consist membership.

Locomotive Real-Time Updates

If the locomotive is also under the control of another device, the XpresssNet throttle is notified. This is often indicated by a flashing display. However, unsolicited real-time speed and function updates are not provided due to the XpressNet protocol not supporting this feature..

Programming

Program Track and Program on the Main are not supported.

Model Time (Fast Clock)

Model Time (Fast Clock) is not currently supported.

Accessory Activation and Feedback >2044

Activation and Feedback is available for DCC accessory decoder addresses 1 - 2044. Addresses above 2044 are not supported. Lenz feedback input modules are not supported.

Supported and Unsupported Command Summary

Please see the XpressNet Documentation for additional information about the XpressNet protocol.

Commands from CS-105 to XpressNet Device
Supported XNET Version Command Call Byte Header Data 1 Data 2 Data 3 Data 4 Data 5 Data 6 Data 7
Yes V3 Normal Inquery P+0x40+
Yes V3 Request Acknowledgement P+0x00+
Yes V3 Broadcast Normal Operation Resume 0x60 0x61 0x01 0x60
Yes V3 Broadcast Emergency Off 0x60 0x61 0x00 0x61
Yes V3 Broadcast Emergency Stop 0x60 0x81 0x00 0x81
No V3 Broadcast Service Mode Entry 0x60 0x61 0x02 0x63
Yes V3 Broadcast Accessory Feedback1 0xA0 0x40+N ADR_1 DAT_1 ADR_2 DAT_2 ... ... X-OR
Yes V3.8 Broadcast Accessory Feedback from 1025 0xA0 0x43 ADRH ADRL DAT X-OR
No V3.8 Broadcast Model Time 0x60 0x63 0x03 Hour&DoW Min&Stop X-OR
No V3 Program Info Short Circuit P+0x60+ 0x61 0x12 X-OR
No V3 Program Info No Response P+0x60+ 0x61 0x13 X-OR
No V3 Program Info Busy P+0x60+ 0x61 0x1F X-OR
No V3 Program Info Ready P+0x60+ 0x61 0x11 X-OR
No V3 Program Info Register and Paged P+0x60+ 0x63 0x10 CV# DAT X-OR
No V3.6 Program Info Direct CV1 - 255 & 1024 P+0x60+ 0x63 0x14 CV# DAT X-OR
No V3.6 Program Info Direct CV256 - 511 P+0x60+ 0x63 0x15 CV# DAT X-OR
No V3.6 Program Info Direct CV512 - 767 P+0x60+ 0x63 0x16 CV# DAT X-OR
No V3.6 Program Info Direct CV768 - 1023 P+0x60+ 0x63 0x17 CV# DAT X-OR
No V3.8 Report Service Variable P+0x60+ 0x63 0x20 SV# DAT X-OR
Yes V3 Command Station Version 3.0+2 P+0x60+ 0x63 0x21 DAT_1 DAT_2 X-OR
Yes V3 Command Station Status P+0x60+ 0x62 0x22 DAT X-OR
No V3.8 Command Station Advanced Version P+0x60+ 0x67 0x23 Build_H Build_L Ver Build_H Build_L Ver X-OR
No V3.8 Program on the Main Result P+0x60+ 0x64 0x24 ADRH ADRL DAT X-OR
No V3.8 Model Time P+0x60+ 0x64 0x25 Hour&DoW Min&Stop Factor X-OR
Yes V3 Transmission Error P+0x60+ 0x61 0x80 X-OR
No V3 Command Station Busy3 P+0x60+ 0x61 0x81 X-OR
Yes V3 Command Not Supported P+0x60+ 0x61 0x82 X-OR
Yes V3 Accessory Feedback P+0x60+ 0x42 ADR DAT X-OR
Yes V3.8 Accessory Feedback from 1025 P+0x60+ 0x43 ADRH ADRL DAT X-OR
Yes V3 Locomotive Information Normal P+0x60+ 0xE4 Mode Speed F0-F4 F5-F12 X-OR
Yes V3.6 Function Info Response F13 - F28 P+0x60+ 0xE3 0x52 F13-F20 F21-F28 X-OR
No V4.0 Function Info Response F29 - F68 P+0x60+ 0xE6 0x%3 F29-F36 F37-F44 F45-F52 F53-F60 F61-F68 X-OR
No V3 Locomotive Information Consist Member P+0x60+ 0xE5 Mode Speed F0-F4 F5-F12 MTR X-OR
No V3 Locomotive Information Consist P+0x60+ 0xE2 Mode Speed X-OR
No V3 Locomotive Information Double Header P+0x60+ 0xE6 Mode Speed F0-F4 F5-F12 ADRH ADRL X-OR
No V3 Locomotive Operated by Another Device P+0x60+ 0xE3 0x40 ADRH ADRL X-OR
Yes V3 Function Status Response P+0x60+ 0xE3 0x50 F0-F4 F5-F12 X-OR
Yes V3.6 Function Status Response F13 - F28 P+0x60+ 0xE4 0x51 F13-F20 F21-F28 Refresh X-OR
No V4.0 Function Status Response F29 - F68 P+0x60+ 0xE6 0x54 F29-F36 F37-F44 F45-F52 F53-F60 F61-F68 X-OR
No V3 Locomotive Search Result P+0x60+ 0xE3 0x30+K ADRH ADRL X-OR
No V3 Error Message P+0x60+ 0xE1 0x80+F X-OR

1 Only supports Broadcast Feedback for one address (pair) at a time.

2 The CS-105 reports version 3.6. It does support some version 3.8 commands.

3 Support for Command Station Busy is unnecessary because the CS-105 is always able to respond and never needs to report that it is busy.

Commands from XpressNet Device to CS-105
Supported XNET Version Command Header ID Data 1 Data 2 Data 3 Data 4 Data 5 Data 6
Yes V3 Acknowledgement Reponse 0x20 0x20
Yes V3 Resume Operations Request 0x21 0x81 0xA0
Yes V3 Emergency Stop Request 0x80 0x80
Yes V3 Emergency Off Request 0x21 0x80 0xA1
Yes V3 Emergency Stop Locomotive Request 0x92 ADRH ADRL X-OR
No V3 Program Register Mode Read 0x22 0x11 Reg X-OR
No V3.6 Program Direct Mode Read CV1 - 256 & 1024 0x22 0x18 CV# X-OR
No V3.6 Program Direct Mode Read CV257 - 511 0x22 0x19 CV# X-OR
No V3.6 Program Direct Mode Read CV512 - 767 0x22 0x1A CV# X-OR
No V3.6 Program Direct Mode Read CV768 - 1023 0x22 0x1B CV# X-OR
No V3 Program Paged Mode Read 0x22 0x14 CV# X-OR
No V3 Program Results Request 0x21 0x10 0x31
No V3 Program Register Mode Write 0x23 0x12 Reg DAT X-OR
No V3.6 Program Direct Mode Write CV1 - 256 & 1024 0x23 0x1C CV# DAT X-OR
No V3.6 Program Direct Mode Write CV257 - 511 0x23 0x1D CV# DAT X-OR
No V3.6 Program Direct Mode Write CV512 - 767 0x23 0x1E CV# DAT X-OR
No V3.6 Program Direct Mode Write CV768 - 1023 0x23 0x1F CV# DAT X-OR
No V3 Program Paged Mode Write 0x23 0x17 CV# DAT X-OR
Yes V3 Command Station Version Request 0x21 0x21 0x00
No V3.8 Command Station Advanced Version Request 0x21 0x23 0x02
Yes V3 Command Station Status Request 0x21 0x24 0x05
No V3 Command Station Startup Mode Request 0x22 0x22 Mode X-OR
No V3.8 Service Variable Read 0x22 0x25 SV# X-OR
No V3.8 Service Variable Write 0x23 0x26 SV# DAT X-OR
No V3.8 Program on Main Result Request 0x21 0x27 0x06
No V3.8 Command Station Reset Trigger 0x21 0x28 0x09
No V4.0 Device Version info 0x24 0x29 Ver Level Type X-OR
No V3.8 Model Time Request 0x21 0x2A 0x0B
No V3.8 Model Time Set 0x24 0x2B Hour&DoW Min Factor X-OR
No V4.0 Model Time Stop 0x21 0x2D 0x0C
No V4.0 Model Time Start 0x21 0x2C 0x0D
Yes V3 Accessory Feedback Request 0x42 ADR Nibble X-OR
Yes V3.8 Accessory Feedback Request up to 2048 0x43 ADRH ADRL Nibble X-OR
Yes V3 Accessory Operation Request 0x52 ADR DAT X-OR
Yes V3.8 Accessory Operation Request up to 2048 0x53 ADRH ADRL DAT X-OR
Yes V3 Locomotive Information Request 0xE3 0x00 ADRH ADRL X-OR
Yes V3 Locomotive Function Status Request 0xE3 0x07 ADRH ADRL X-OR
Yes V3.6 Locomotive Function Status F13 - F28 0xE3 0x08 ADRH ADRL X-OR
No V4.0 Locomotive Function Status F29 - F68 0xE3 0x0A ADRH ADRL X-OR
Yes V3 Locomotive Speed and Direction 14SS 0xE4 0x10 ADRH ADRL Velocity X-OR
Yes V3 Locomotive Speed and Direction 27SS 0xE4 0x11 ADRH ADRL Velocity X-OR
Yes V3 Locomotive Speed and Direction 28SS 0xE4 0x12 ADRH ADRL Velocity X-OR
Yes V3 Locomotive Speed and Direction 128SS 0xE4 0x13 ADRH ADRL Velocity X-OR
Yes V3 Locomotive Function Operation Group 1 0xE4 0x20 ADRH ADRL F0-F4 X-OR
Yes V3 Locomotive Function Operation Group 2 0xE4 0x21 ADRH ADRL F5-F8 X-OR
Yes V3 Locomotive Function Operation Group 3 0xE4 0x22 ADRH ADRL F9-F12 X-OR
Yes V3.6 Locomotive Function Operation Group 4 0xE4 0x23 ADRH ADRL F13-F20 X-OR
Yes V3.6 Locomotive Function Operation Group 5 0xE4 0x28 ADRH ADRL F21-F28 X-OR
No V4.0 Locomotive Function Operation Group 6 0xE4 0x29 ADRH ADRL F29-F36 X-OR
No V4.0 Locomotive Function Operation Group 7 0xE4 0x2A ADRH ADRL F37-F44 X-OR
No V4.0 Locomotive Function Operation Group 8 0xE4 0x2B ADRH ADRL F45-F52 X-OR
No V4.0 Locomotive Function Operation Group 9 0xE4 0x50 ADRH ADRL F53-F60 X-OR
No V4.0 Locomotive Function Operation Group 10 0xE4 0x51 ADRH ADRL F61-F68 X-OR
No V4.0 Locomotive Function Operation Binary Short 0xE4 0x5E ADRH ADRL D&F29-F127 X-OR
No V4.0 Locomotive Function Operation Binary Long 0xE4 0x5F ADRH ADRL D&F_low F_high X-OR
No V3 Locomotive Function Status Set Group 1 0xE4 0x24 ADRH ADRL F0-F4 X-OR
No V3 Locomotive Function Status Set Group 2 0xE4 0x25 ADRH ADRL F5-F8 X-OR
No V3 Locomotive Function Status Set Group 3 0xE4 0x26 ADRH ADRL F9-F12 X-OR
No V3.6 Locomotive Function Status Set Group 4 0xE4 0x27 ADRH ADRL F13-F20 X-OR
No V3.6 Locomotive Function Status Set Group 5 0xE4 0x2C ADRH ADRL F21-F28 X-OR
No V4.0 Locomotive Function Status Set Group 6 0xE4 0x2D ADRH ADRL F29-F36 X-OR
No V4.0 Locomotive Function Status Set Group 7 0xE4 0x2E ADRH ADRL F37-F44 X-OR
No V4.0 Locomotive Function Status Set Group 8 0xE4 0x52 ADRH ADRL F45-F52 X-OR
No V4.0 Locomotive Function Status Set Group 9 0xE4 0x53 ADRH ADRL F53-F60 X-OR
No V4.0 Locomotive Function Status Set Group 10 0xE4 0x54 ADRH ADRL F61-F68 X-OR
No V3.6 Locomotive Function Refresh Mode 0xE4 0x2F ADRH ADRL RF X-OR
No V3 Double header Create 0xE5 0x43 ADR1H ADR1L ADR2H ADR2L X-OR
No V3 Double Header Disolve 0xE5 0x43 ADR1H ADR1L 0x00 0x00 X-OR
No V3 Consist Add Locomotive 0xE4 0x40+R ADRH ADRL MTR X-OR
No V3 Consist Remove Locomotive 0xE4 0x42 ADRH ADRL MTR X-OR
No V3 Program on the Main Write 0xE6 0x30 ADRH ADRL 0xEC+C CV DAT X-OR
No V3.6 Program on the Main Read 0xE6 0x30 ADRH ADRL 0xE4+C CV 0x00 X-OR
No V3.6 Program on the Main Write Bit 0xE6 0x30 ADRH ADRL 0x7C+C CV DAT X-OR
No V3 Consist Member Inquiry 0xE4 0x01+R MTR ADRH ADRL X-OR
No V3 Consist Address Inquiry 0xE2 0x03+R MTR X-OR
No V3 Command Station Locomotive Stack Inquiry 0xE3 0x05+R ADRH ADRL X-OR
No V3 Command Station Locomotive Stack Delete 0xE3 0x44 ADRH ADRL X-OR

Copyright & Trademarks

Copyright © Train Control Systems, Inc 2022. XpressNetTM is a trademark of Lenz Elektronik GmbH. Any unattributed copyrights and trademarks are unintentional and should be brought to the attention of Train Control Systems, Inc for correction.