Difference between revisions of "XpressNet"

From Train Control Systems Documentation
Jump to navigation Jump to search
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.
+
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.
 +
 
 +
== 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.
 +
 
 +
=== Locomotive Addresses ===
 +
Locomotive addresses 1-99 are always DCC short addresses. Locomotive Addresses 100-9999 are always DCC long addresses.
 +
 
 +
=== Locomotive Speed Step mode ===
 +
Locomotives are always controlled in 128 speed step mode. If an XpressNET device may request 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 ===
 +
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.
 +
 
 +
=== 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 use any of the consist member's address. The XpressNET throttle does not indicate consist membership.
 +
 
 +
=== 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.
 +
 
 +
=== Programming ===
 +
Program Track and Program on the Main is not supported.
 +
 
 +
=== Model Time ===
 +
Model Time (Fast Clock) is not currently supported.
 +
 
 +
=== Feedback And Accessories ===
 +
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 ==
 +
{| class="wikitable"
 +
|+Commands From XpressNET Device to CS-105
 +
!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+0x0+
 +
|
 +
|
 +
|
 +
|
 +
|
 +
|
 +
|
 +
|
 +
|
 +
|-
 +
|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 Feedback<sup>1</sup>
 +
|0xA0
 +
|0x40+N
 +
|ADR_1
 +
|DAT_1
 +
|ADR_2
 +
|DAT_2
 +
|...
 +
|...
 +
|X-OR
 +
|
 +
|-
 +
|Yes
 +
|V3.8
 +
|Broadcast 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+<sup>2</sup>
 +
|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 Busy<sup>3</sup>
 +
|P+0x60+
 +
|0x61
 +
|0x81
 +
|X-OR
 +
|
 +
|
 +
|
 +
|
 +
|
 +
|
 +
|-
 +
|Yes
 +
|V3
 +
|Command Not Supported
 +
|P+0x60+
 +
|0x61
 +
|0x82
 +
|X-OR
 +
|
 +
|
 +
|
 +
|
 +
|
 +
|
 +
|-
 +
|Yes
 +
|V3
 +
|Feedback
 +
|P+0x60+
 +
|0x42
 +
|ADR
 +
|DAT
 +
|X-OR
 +
|
 +
|
 +
|
 +
|
 +
|
 +
|-
 +
|Yes
 +
|V3.8
 +
|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
 +
|V3.6
 +
|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
 +
|
 +
|
 +
|
 +
|
 +
|
 +
|
 +
|}
 +
<sup>1</sup> Only supports Broadcast Feedback for one address (pair) at a time.
 +
 
 +
<sup>2</sup> The CS-105 reports version 3.0. It does support some version 3.6 and 3.8 commands.
 +
 
 +
<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.
  
 
==Copyright & Trademarks==
 
==Copyright & Trademarks==
 
Copyright © Train Control Systems, Inc 2022. XpressNet<sup>TM</sup> 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.
 
Copyright © Train Control Systems, Inc 2022. XpressNet<sup>TM</sup> 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.

Revision as of 03:28, 30 April 2023

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 "Auxiliary". Software support is in development. A beta version is available, contact TCS for more information.

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.

Locomotive Addresses

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

Locomotive Speed Step mode

Locomotives are always controlled in 128 speed step mode. If an XpressNET device may request 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

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.

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 use any of the consist member's address. The XpressNET throttle does not indicate consist membership.

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.

Programming

Program Track and Program on the Main is not supported.

Model Time

Model Time (Fast Clock) is not currently supported.

Feedback And Accessories

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

Commands From XpressNET Device to CS-105
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+0x0+
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 Feedback1 0xA0 0x40+N ADR_1 DAT_1 ADR_2 DAT_2 ... ... X-OR
Yes V3.8 Broadcast 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 Feedback P+0x60+ 0x42 ADR DAT X-OR
Yes V3.8 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 V3.6 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.0. It does support some version 3.6 and 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.

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.