Passa al contenuto principale

Modulo TRDP "trdp"

Descrizione​

Il modulo trdp riceve tramite un'interfaccia di rete i telegrammi del Train Real-time Data Protocol (TRDP) secondo IEC 61375-2-3. Elabora esclusivamente messaggi di tipo Process Data (PD) e ne mette a disposizione i dati utili, tramite il Fast Message Dispatcher (FMD), al modulo fmproducer per l'ulteriore estrazione dei segnali.

Il modulo opera esclusivamente come subscriber TRDP (sink): legge passivamente i dati di processo ciclici e non invia esso stesso alcun telegramma TRDP. In questo modo il traffico dati tra le unità di controllo del veicolo (ad es. controlli porte, impianti di climatizzazione, controlli di trazione) può essere utilizzato per il monitoraggio dello stato e la diagnostica, senza interferire con la comunicazione del veicolo.

L'acquisizione dei pacchetti avviene direttamente a livello 2 tramite PcapPlusPlus, in modo che i gruppi multicast TRDP possano essere ascoltati su qualsiasi interfaccia di rete. Dall'header TRDP viene estratto il ComID, che viene passato al dispatcher come messageKey. L'fmproducer può così sottoscrivere in modo mirato messaggi di determinati ComID ed estrarre singoli segnali dall'area dei dati utili.

Flusso dei dati dalla rete del veicolo, attraverso il modulo trdp, fino ai canali smartCORE

La porta UDP standard per i TRDP Process Data (PD) è 17224 (secondo IEC 61375-2-3).

Collegamento di rete​

Il percorso standard è il collegamento diretto di smartCORE alla rete del veicolo o del convoglio, sulla quale il modulo riceve i telegrammi TRDP come normale partecipante di rete. Se invece si desidera osservare una singola connessione in modo fisicamente non intrusivo e con isolamento galvanico, senza che smartCORE stesso compaia come partecipante di rete, è possibile anteporre facoltativamente un TAP Ethernet smartIO. In entrambi i casi il modulo trdp elabora i telegrammi letti in modo identico.

note

Gli offset di bit nell'fmproducer devono essere indicati relativamente all'inizio dei dati utili (dopo l'header TRDP di 40 byte), non all'inizio dell'intero telegramma.

Interfacce e protocolli utilizzati​

  • Train Real-time Data Protocol (TRDP), IEC 61375-2-3 — Process Data (PD)
  • Fast Message Dispatching

Configurazione JSON​

La sezione seguente descrive la configurazione JSON del modulo.

Configurazione di esempio (minima)​

{
"module": "TRDP",
"factory": "trdp",
"config": {
"networkInterface": "eth0",
"trafficFilter": [
{ "port": 17224, "groupAddress": "239.255.0.1" }
]
}
}

Configurazione di esempio (con fmproducer, più gruppi multicast)​

Il modulo trdp funge da sorgente di dati per l'fmproducer. Nel parametro fmd dell'fmproducer viene inserito il nome del dispatcher a cui il modulo TRDP fornisce i dati. Se non diversamente impostato, si tratta del nome dell'istanza del modulo TRDP (qui: "TRDP"). Come messageKey serve in ogni caso il ComID dall'header TRDP.

{
"plugins": ["trdp", "fmproducer"],
"modules": [
{
"module": "TRDP",
"factory": "trdp",
"config": {
"networkInterface": "eth0",
"trafficFilter": [
{ "port": 17224, "groupAddress": "192.168.0.6", "joinGroup": true },
{ "port": 17224, "groupAddress": "192.168.0.5" }
]
}
},
{
"module": "fmproducer_trdp",
"factory": "fmproducer",
"config": {
"fmd": "TRDP",
"byteOrder": "BigEndian",
"channels": [
{
"name": "trdp.speed",
"messageKey": 45056,
"bitOffset": 144,
"bitLength": 16,
"imageType": "unsigned",
"scale": 1.0,
"offset": 0.0,
"physicalUnit": "km/h"
},
{
"name": "trdp.speed_scaled",
"messageKey": 45056,
"bitOffset": 144,
"bitLength": 16,
"imageType": "unsigned",
"scale": 0.1,
"offset": 2.2,
"physicalUnit": "km/h"
}
]
}
}
]
}

Parametri globali del modulo​

Nome del parametroObbligatorioTipo di datiIntervallo di valoriDefaultDescrizione
networkInterfaceNoSTRING"eth0"Nome dell'interfaccia di rete per l'acquisizione dei pacchetti
pollingIntervalMsNoINT100 – 20001000Intervallo del timer in millisecondi
trafficFilterNo1ARRAYElenco di coppie porta/indirizzo multicast (consigliato)
portNo1INT0 – 65535Obsoleto — porta UDP; utilizzare trafficFilter
groupAddressNo1STRINGObsoleto — indirizzo multicast IPv4; utilizzare trafficFilter
fmdNoSTRINGNome dell'istanza del moduloNome del dispatcher predefinito a cui vengono passati i dati utili
dispatchersNoARRAYDispatcher aggiuntivi, selezionati in base all'indirizzo IP del mittente (a partire da smartCORE 2.12, vedi sotto)

Configurazione di una voce trafficFilter​

Nome del parametroObbligatorioTipo di datiDefaultDescrizione
portSÌINTPorta UDP di destinazione del flusso multicast TRDP (standard secondo IEC 61375-2-3: 17224)
groupAddressSÌSTRINGIndirizzo multicast IPv4 del flusso TRDP
joinGroupNoBOOLfalseAderire attivamente al gruppo multicast tramite IGMP (vedere sotto)

Per impostazione predefinita il modulo filtra soltanto il traffico che comunque arriva sull'interfaccia di rete: non invia esso stesso alcun IGMP join. Ciò è sufficiente se lo switch inonda di traffico multicast oppure se l'interfaccia legge il traffico tramite una mirror port o un TAP Ethernet. Se invece lo switch è configurato con IGMP snooping, inoltra il gruppo multicast solo alle interfacce che vi hanno aderito attivamente: in questo caso impostare joinGroup: true per la relativa voce trafficFilter, in modo che smartCORE venga registrato come ricevitore tramite IGMP.

Dispatcher in base all'indirizzo del mittente​

informazioni

Il supporto per dispatchers è disponibile ufficialmente solo a partire da smartCORE 2.12.

Per impostazione predefinita il modulo passa tutti i telegrammi ricevuti a un unico dispatcher: il dispatcher predefinito, il cui nome corrisponde al nome dell'istanza del modulo o al valore di fmd. Se più centraline utilizzano gli stessi ComID, i loro telegrammi non possono più essere distinti.

Con dispatchers si configurano dispatcher aggiuntivi con nome, ciascuno associato a un indirizzo IP del mittente. Ogni telegramma viene consegnato a esattamente un dispatcher, in base all'indirizzo IPv4 del mittente del relativo pacchetto UDP:

  • Se l'indirizzo del mittente corrisponde a una voce sourceIp, il telegramma viene inviato al dispatcher name di tale voce.
  • Tutti gli altri telegrammi vengono inviati, come in precedenza, al dispatcher predefinito.

Per ogni dispatcher si configura un modulo fmproducer separato, il cui parametro fmd contiene il nome del dispatcher. In questo modo gli stessi ComID di centraline diverse possono essere assegnati a canali separati, senza creare un'istanza del modulo trdp per ogni centralina.

Configurazione di una voce dispatchers​

Nome del parametroObbligatorioTipo di datiDefaultDescrizione
nameSÌSTRINGNome del dispatcher; va inserito nel parametro fmd dell'fmproducer associato
sourceIpSÌSTRINGIndirizzo IPv4 del mittente dei telegrammi inviati a questo dispatcher
note
  • Un telegramma viene sempre consegnato a un solo dispatcher. Un fmproducer collegato al dispatcher predefinito non riceve più i telegrammi dei mittenti elencati in dispatchers.
  • Se la stessa sourceIp è indicata più volte, vale la prima voce corrispondente.
  • Più voci possono utilizzare lo stesso name; i telegrammi di questi mittenti confluiscono allora nello stesso dispatcher.
  • Le voci senza name o con una sourceIp non valida vengono ignorate con un avviso nel log.
  • Vengono valutati solo gli indirizzi IPv4 del mittente.

Configurazione di esempio (due centraline con ComID identici)​

Due centraline inviano ciascuna la velocità con il ComID 45056. dispatchers separa i loro telegrammi e due moduli fmproducer li assegnano a canali propri.

{
"plugins": ["trdp", "fmproducer"],
"modules": [
{
"module": "TRDP",
"factory": "trdp",
"config": {
"networkInterface": "eth0",
"trafficFilter": [
{ "port": 17224, "groupAddress": "239.255.0.1" }
],
"dispatchers": [
{ "name": "TRDP_ECU1", "sourceIp": "192.168.1.23" },
{ "name": "TRDP_ECU2", "sourceIp": "192.168.2.23" }
]
}
},
{
"module": "fmproducer_ecu1",
"factory": "fmproducer",
"config": {
"fmd": "TRDP_ECU1",
"byteOrder": "BigEndian",
"channels": [
{
"name": "trdp.ecu1.speed",
"messageKey": 45056,
"bitOffset": 144,
"bitLength": 16,
"imageType": "unsigned",
"physicalUnit": "km/h"
}
]
}
},
{
"module": "fmproducer_ecu2",
"factory": "fmproducer",
"config": {
"fmd": "TRDP_ECU2",
"byteOrder": "BigEndian",
"channels": [
{
"name": "trdp.ecu2.speed",
"messageKey": 45056,
"bitOffset": 144,
"bitLength": 16,
"imageType": "unsigned",
"physicalUnit": "km/h"
}
]
}
}
]
}

I telegrammi di altri mittenti continuano ad essere inviati al dispatcher predefinito "TRDP" e possono essere elaborati da un ulteriore fmproducer con "fmd": "TRDP".

Note sulla configurazione di fmproducer​

I telegrammi TRDP vengono sempre trasmessi in formato Big-Endian. Nell'fmproducer corrispondente occorre quindi impostare globalmente "byteOrder": "BigEndian".

Il ComID dell'header TRDP serve come messageKey nell'fmproducer. Gli offset di bit (bitOffset) si riferiscono all'inizio dell'area dei dati utili (dopo l'header TRDP di 40 byte).

Decodifica del ComID: dal telegramma TRDP, tramite il ComID come messageKey, ai canali denominati nell'fmproducer

Ulteriori informazioni sull'estrazione dei canali (imageType, bitOffset, bitLength, addressSpec ecc.) sono descritte nella documentazione di fmproducer.

Informazioni sul modulo​

InformazioneValore
AutorioptiMEAS GmbH
da smartCORE2.11
Tipo di moduloProducer (Dispatcher)
Dipendenzefmproducer

Footnotes​

  1. Se trafficFilter, port e groupAddress vengono tutti omessi, il modulo acquisisce l'intero traffico di rete sull'interfaccia e inoltra tutti i pacchetti al parser. Ciò aumenta notevolmente l'onere di elaborazione e dovrebbe essere utilizzato solo a scopo diagnostico. Per il funzionamento in produzione si raccomanda di indicare almeno una voce trafficFilter. ↩ ↩2 ↩3