IEC 61375-2-5 (TTDP)

Glossary

  • CN - Consist Network
  • ECN - Ethernet Consist Network
  • ECSC - ETB Control Service Client 1
  • ECSP - ETB Control Service Provider 1
  • ETB - Ethernet Train Backbone
  • ETBN - Ethernet Train Backbone Node
  • TCMS - Train Control and Management System
  • UUID - Universally Unique IDentifier 2

Introduction

Train Topology Discovery Protocol (TTDP) is part of the IEC 61375 series of protocols.

In short, TTDP dynamically discovers the backbone routers (ETBNs) and consist networks (ECNs) in the train, and the way that they are connected. Furthermore, TTDP assigns IP addresses to the ETBNs and ECNs, and establishes routing and NAT entries in ETBNs based on these IP assignments. TTDP is designed to accomplish this as a distributed protocol running on the ETBNs.

Overview

TTDP is managing train backbone inauguration (ETB inauguration) in train networks adopting the IEC 61375 train topology model. TTDP is a distributed protocol running on the train router nodes, here referred to as ETB nodes or simply ETBNs.

The TTDP protocol provides a wide range of services listed below.

TTDP acts as a link aggregation control protocol on the train backbone, thereby replacing LACP for link aggregation for IEC 61375 backbone networks.

Discovery of train topology

With TTDP, ETBNs will discover other ETBNs present on the backbone and exchange information. This TTDP signalling in turn allows each ETBN to gather information about:

  • Consists: The identity of present consists (Consist Universally Unique Identifier, or simply CstUUID) and their order/position in the train backbone.

  • ETBNs: The identity (ETBN MAC address) and order of the ETBNs on the backbone, and also the consist where each of the ETBNs reside. The ETBNs even learn the position of “missing” ETBNs (known, but currently down); this is true as long as at least one ETBN in each consist is up and running.

  • ECNs: Every ETBN advertises information about the consist networks (ECNs) present in its consist. Thereby, each ETBN is able to gather information on all ETBNs and ECNs, and how they are interconnected.

IP Address assignment

TTDP is capable of assigning IP addresses dynamically based on the discovered topology. Addresses are allocated from a range defined in IEC 61375-2-5, and concern:

  • ETBN addresses on the ETB subnet: An IP address is allocated to each ETBN on the ETB subnet.

  • Train-wide IP subnet allocation for ECN subnets: ECNs typically make use of local (private) addresses in range 10.0.0.0/18. TTDP allocates a train-wide/18-subnet to each of the discovered ECNs.

    NOTE: In cases where multiple ETB’s are configured, ECN addresses are usually in the 10.0.0.0/21 range.

  • Virtual addresses on ETB subnet: In topologies where ECNs are connected to two or more ETBNs for redundancy, TTDP allocates a virtual IP address to be shared between the ETBNs on the ETB subnet. A virtual IP address is assigned for each ECN with redundant ETBNs.

      .---------------------------.
     /           CstUUID           \ cst1
     '-----------------------------'
        .-------.    .-------.
      --+       +----+       +--
  <-dir1| etbn1 |    | etbn2 |dir2->
      --+       +----+       +--
        '-+--+--'    '-------'
          |  |          |  |
        --+----------------+-- CN1
             |          |
          ---+----------+-------- CN2

Figure 1: A single consist with two consist nets managed by two redundant ETB nodes.

External interfaces

The canonical interface used for control, status, and diagnostics between the ETBNs and devices on the ECNs consists of the TRDP telegrams defined in IEC61375-2-3 Annex E.

Usage recommendations

Inauguration Inhibition

Inauguration must be inhibited on all ETBNs/ECSPs by means of ECSC_Control TRDP messages (or other means) once the train composition is correct.

Additionally, it is preferred that communication on the ETB be disabled until the above has been performed, in order to prevent data sent over the ETB from being used before the train length and composition have been verified by the train application.

Nodes not having Inauguration Inhibition locally set can re-inaugurate as a new train composition, and become lost from the remainder of the train, in cases of ETB instability, malfunction or overload. This will lead to loss of connectivity between these nodes and the remainder of the train.

This gets indicated with a lengthening indication in the train with Inhibit still active and can be resolved by all nodes by removing Inhibition to allow the lost nodes back in again. Having Inauguration Inhibition set locally on every node prevents this from occurring.

Remote inhibition

When using the “remote inhibition” functionality as mentioned in IEC61375-2-5:2014 section 8.7.6, there are different options available for how the value should be reported to the ECSC and other applications. The inhibit-report-option setting, described below, controls the semantics of the etbInhibit field in the ECSP_STATUS telegram, which can be used for this purpose.

ETB sink/source data handling

All ETB data should be verified based on the current etbTopoCnt value to make sure no data from previous inauguration is sent or received by end devices.

When an inauguration occurs, all end devices shall disable ETB traffic until the ETBN again is in state inaugurated and a new etbTopoCnt value is available and stable. This is recommended even for traffic sent with a etbTopoCnt value of 0, intended for intra-consist communication.

Multicast streams

When setting up and sending/receiving multicast streams that is not TRDP related, it is highly recommended to not use TRDP ports 17224 and 17225, since the TRDP stack will attempt to parse data coming in through these ports, leading to reduced performance.

Additionally, it is highly recommended to not use the TRDP related multicast group 239.193.0.1, unless the traffic is meant for all ECSPs.

Also, please ensure that the train backbone can handle the loads of all multicast streams being sent/received from/to the consist networks.

Configuration

TTDP can be activated from the top-level configuration context in the CLI.

example:/#> configure
example:/config/#> ttdp
Activating TTDP with default settings.
DNS Server activated
example:/config/ttdp/#>

Note

TTDP will be enabled by default when entering the configuration context.

For configuration examples, see

Syntax

[no] enable

Enable TTDP.

Note

Simply entering the TTDP config context will enable TTDP when leaving the TTDP context or config context.

no

Disable TTDP. The current configuration is saved, for when you re-enable the service again.

Note

The TTDP configuration can be completely removed from the config context using no ttdp.

[no] uuid <UUID-STRING>

Set the consist UUID. Each ETBN belonging to the same consist must use the exact same UUID, and no two consists may have the same UUIDs. Thus, the UUID is what defines individual consists.

UUID-STRING

One of the following:

  • A literal UUID string, in the RFC 4122 format. This is the preferred method of setting the consist UUID.

    etbn1:/config/ttdp/#> uuid 11111111-1111-1111-1111-111111111111

  • The string “auto-string”, followed by a seed string used to generate the UUID automatically. In this case, the seed string is used to generate the UUID using the algorithm in RFC 4122 chapter 4.3 (“Name-Based UUID”). Devices configured to use the same seed string will generate the same consist UUID.

    etbn1:/config/ttdp/#> uuid auto-string “uic948002343044”

  • The string “auto-mac”. In this case, the UUID is generated, using the same algorithm as above, based on the base MAC address of the device. Different devices will generate different UUIDs.

     etbn1:/config/ttdp/#> uuid auto-mac 

no
Reset UUID to all zeros.
[no] node ETBN_NB ecn ECN_ID[,ECN_ID]

Add ECN(s) to an ETBN to describe the consist topology.

ETBN_NB
The static relative position of an ETBN in the consist. Not to be confused with ETBN id which is assigned to the ETBN during inauguration and depends on the train composition. Valid range: 1-32.
ECN_ID
The consist net id.
no
Remove ECN from ETBN_NB.
[no] ecn ECN_ID IFΑCE

Map ECN with ECN_ID to interface IFACE.

ECN_ID

ECN id. Valid range: 1-32.

Note

ECN_ID must fulfill the following criterias:

  1. Each CN must have a unique number
  2. There must be one and only one CN with the number 1
  3. There can be no gaps in the sequence of assigned numbers
IFACE
The interface used for the ECN_ID.
no

Remove the ECN_ID’s interface mapping.

Note

This does not remove the ECN itself, just the interface’s mapping to that ECN.

[no] dir1 PORT[,PORT]

Set ETBN backbone port(s) for direction 1.

PORT

The port(s) to be added to aggregate in direction 1.

Note

Limited to max 2 ports per direction.

no
Remove all ports from dir1’s aggregate.
[no] dir2 PORT[,PORT]

Set ETBN backbone port(s) for direction 2.

PORT

The port(s) to be added to aggregate in direction 2.

Note

Limited to max 2 ports per direction.

no
Remove all ports from dir2’s aggregate.
[no] local-id ETBN_NB

Set this ETBN’s static position within the consist.

ETBN_NB

The static relative position of an ETBN in the consist. Not to be confused with ETBN id which is assigned to the ETBN during inauguration and depends on the train composition. Valid range: 1-32.

Note

ETBN_NB must fulfill the following criterias:

  • Each node must have a unique number

  • There must be one and only one node with the number 1

  • There can be no gaps in the sequence of assigned numbers

no
Set to 0.
[no] backbone-id <ID>

Set backbone id to ID.

Note

When multiple ETBs are configured, this must match the correct ID of a correctly configured ETB. See ETB instances and the config option etb below.

Note

In systems with only one ETB, backbone-id must be id 0 (TCMS).

ID

Value of backbone id. Default: 0 (TCMS).

Valid values:

  • 0 or tcms
    Operational backbone (TCMS)

  • 1, multimedia or mm
    Multimedia backbone

Note

Backbone id 2 and 3 is not supported.

no
Reset to defalut 0 (TCMS)
[no] backbone-iface <IFACE>

Set VLAN used for TTDP signalling on the ETB. Default: vlan2.

IFACE

Interface to be used on ETB.

Note

Ensure that IGMP snooping is disabled on IFACE.

no
Reset to default (vlan2).
[no] ecsp-addr <IP-ADDRESS>

Local ECSP address. Should be set to a local address of the ecsp-iface interface, on which the CN-facing ECSP service runs.

IP-ADDRESS
Local ECSP address. Default 10.0.0.1.
no
Reset to default (10.0.0.1).
[no] ecsc-addr IP-ADDRESS

ECSC address. Telegrams to the local ECSC will be sent to this address.

IP
ECSC address. Default 10.0.0.99.
no
Reset to default (10.0.0.99).
[no] ecsp-leader-addr <IP-ADDRESS>

To enable sync of ttdb set this to the virtual IP address for the CN that governs ECSP Master/Backup mode.

Note

Only set this when using redundant ETBN’s in a consist. That is, when VRRP instance(s) for TTDP redundancy have been configured in this consist.

IP-ADDRESS
ECSP leader address. Default 0 (disabled)
no
Disable sync of ttdb between Master/Backup ECSP.
[no] ecsp-iface <IFACE>

Local ECSP interface. The CN-facing ECSP service will run on this interface.

IFACE
Local ECSP interface. Default: vlan1.
no
Reset to default (vlan1).
[no] mroute group <MULTICAST_GROUP> out <NET_ID[,NET_ID]>

Configure custom IEC 61375 multicast routes.

The specified MULTICAST_GROUP will be routed to NET_ID from every other connected ECN as well as from the local ETB.

MULTICAST_GROUP
Must be a valid multicast group (RFC2365) that is not within the reserved IEC61375-2-5- group range 239.192.0.0/24.
NET_ID
NET_ID can be a numeric ECN_ID or the special value “etb”, which maps to the ETB that the local ETBN is connected to. In this case the multicast group will be routed from all local CNs to the ETB.
no
Removes all configured multicast routes.

Note

This setting needs to be configured on all the potential source and receiver ETBNs.

[no] recovery-mode <default|wait IP-ADDRESS>

Specifiy how to handle recovery of a lost node.

wait <IP-ADDRESS>
The IP-Address as listening address in wait/deferred mode
no
Reset to default recovery mode.

Note

In wait mode, the node will wait until it receives ECSP_CTRL data on the multicast address IP-ADDRESS, and positively reads that inhibition is not set from that data, before activating the bypass relays (i.e. joining the ETB) and starting to transmit TOPOLOGY frames. Thus, an ECSC must be up and running, signaling ECSP_CTRL inhibit off (0), before the node will function properly.

[no] cn-bitmask-endianness <little|big>

Select CN bit mask endianness little (default) or big.

no
Reset to default CN bit mask endianness (little).

Note

This setting is only useful for interoperability.

[no] dns-lookup-mode <local|global>

Set the (TCN-)DNS lookup preference mode to “local scope first” or “global scope always”.

no
Reset to default lookup order, i.e. Static Consist Info
local
Sets the lookup order to try the local scope before the global scope
global
Sets the lookup to always use the global scope
[no] inhibit-report-mode <mode>

Choose how the etbInhibit field of the ECSP_STATUS telegram should be populated.

The semantics of this field are specified in IEC61375-2-3 Annex E, though not very clearly. As an additional limitation of the service interface specified in Annex E, there is no way for the ECSC or any other ECN device to read the global “remote inhibition” flag. To resolve this, this configuration option makes it possible to alter the behaviour of the etbInhibit field in the periodic ECSP_STATUS telegram to allow it to be used for that purpose.

The following options are available:

0

Normal behaviour. As specified in IEC61375-2-3 Annex E

  • 0: n/a
  • 1: inhibit not requested on ETB
  • 2: inhibit set on local ETBN
  • 3: inhibit set on remote ETBN
  • 4: inhibit set on local and remote ETBN

“Remote ETBN” only considers ETBNs in the local train composition. This is the default.

1
As mode 0, but “remote ETBN” now means “non-local ETBN in the local, or the remote, train composition”.
2

Bitfield mode. The etbInhibit field is now a bitmask containing the following bits:

  • 1: local ETBN
  • 2: remote ETBN in local train composition
  • 4: remote ETBN in remote train composition
  • 3: As mode 0, but “ETBN” now means “train composition”.
[no] ecsp-inhibit-sync

Enable or Disable synchronisation of inauguration inhibition between redundant ETBNs (ECSPs).

When enabled, and this node is a backup ECSP (i.e. backup VRRP router) for the ECN with local CN ID 1, it will attempt to copy the local inauguration inhibition value from the master ECSP in the local consist. The master node will have had its local value set by the ECSC or some other external agent. This copying is performed by passively monitoring the TTDP TOPOLOGY frames from the local consist.

After the value is copied, the backup ECSP will behave as if the value had been set locally on itself, until a ECSP masterhood change takes place. In case there are several backup ECSPs, all backups that have this setting enabled will copy the value from the master ECSP as described above.

The purpose of this function is to allow for seamless master router/ECSP failover without losing the global inauguration inhibition state, in case it is only set in one consist. The function performs best if used on relatively simple consist ECN configurations, and will in certain more complex cases not work, if the local master ECSP cannot be unambiguously identified.

When disabled, no special action is taken when this node is a backup router/ECSP. The inauguration inhibition value will not be copied from the master ECSP.

[no] tcp

Enable/disable TCP support for certain TRDP telegrams.

This setting affects the following telegrams:

ComID Name
102/103 Train directory info
104/105 Static consist information
106/107 Train network directory
108/109 Operational train directory
110/111 Read complete TTDB
122/123 Confirm/correction
140/141 TCN DNS

If Reduced Mode is enabled this setting has no effect.

[no] etb <ID>

Configure ETB backbone instance with id ID.

See ETB instances below.

ID

The id of the ETB instance.

Valid values:

0 or tcms
Operational backbone (TCMS)

1, multimedia or mm
Multimedia backbone

no
Remove ETB instance ID.
[no] reduced-mode

Enable or disable reduced mode, disabling all ECSP functions.

When enabled, all functions related to IEC61375-2-3, specifically the ECSP functionality, is turned off for this node. The node will not read the static consist information 1, take part in the exchange of CSTINFO messages, transmit or receive TRDP messages, and so on. This applies regardless of any other settings related to the ECSP functionality described herein.

Note

This also disables the “Annex E” status and command interfaces via TRDP.

When disabled, the node will run the ECSP functions as normal.

[no] optimized-vrrp-failover

Enable/disable optimization for VRRP failover.

This will reduce the VRRP failover time for single ECN consists. If more than one ECN is configured for the consist this option has no effect. This feature is not supported for multiple ETB.

show
Show a summary of ttdp settings

ETB Instances

When configuring multiple ETB’s, you need to create one ETB instance for the TCMS backbone (ETB ID 0) and one ETB instance for the Multimedia backbone (ETB ID 1)

ETB instances are configured from the ttdp configuration context. See the example snippet below in which the multimedia backbone instance (ETB ID 1) is configured.

etbn1:/config/ttdp/#> etb multimedia
etbn1:/config/ttdp/etb-mm/#> cn-network 10.0.8.0/21
etbn1:/config/ttdp/etb-mm/#> gw-addr 10.0.8.200
etbn1:/config/ttdp/etb-mm/#> req-addr 10.0.0.1
etbn1:/config/ttdp/etb-mm/#> end

Syntax

[no] cn-network <IP-ADDRESS/LEN>

Set this ETB instance’s CN subnet address

This is an Ethernet Consist Network. The subnet mask must be calculated according to number of subnets or ETBs.

IP-ADDRESS/LEN
The CN subnet of the ETB instance.
no
Unset CN subnet address.
[no] gw-addr <IP-ADDRESS>

Set the address of the gateway connecting this ETB instance with the other ETB instance. Must be within the CN subnet range.

IP-ADDRESS
Gateway that is used to reach other ETB instance.
no
Unset gateway IP address.
[no] req-addr <IP-ADDRESS>

Set request address. This is mandatory for all ETBs whose ETB ID is not 0. That is any non-TCMS ETB must set this address.

IP-ADDRESS
Address to the ETBN which has the ECSP with role master on ETB0 (TCMS).
no
Unset request address.
show
Show an overview of the settings for this ETB instance.

Status

To see the current status of TTDP, run the show ttdp command in Admin context, like so:

example:/#> show ttdp
TTDP NODE                                                                     
backbone-id  : 0 (tcms)
etbn-id      : 1
etbn-ip      : 10.128.0.1
local-id     : 1
own-mac      : 0c:40:79:45:55:00
uuid         : 11111111-1111-1111-1111-111111111111
connTableCnt : 0x7af91a80
EtbTopoCnt   : 0xec518201
Inauguration : INAUGURATED
Inhibition   : Self: Off,  Others: Off,  Train: Off

CST-NET  IFACE     IP              CONNECTED ETBNs                            
   1     vlan1     10.0.0.1/21     1

NODE ID      MAC ADDRESS            ORIENTATION                               
      1      0c:40:79:45:55:00      Direct
      2      0c:40:79:71:03:00      Direct



CONSIST                               NODES   DIRECTION  NETWORKS             
11111111-1111-1111-1111-111111111111  1       Direct     10.128.64.0/18
22222222-2222-2222-2222-222222222222  2       Direct     10.128.128.0/18

Custom multicast routes

See a simple multicast example on how to configure custom multicast routes.


  1. See communication profile 

  2. See RFC 4122