Aller au contenu principal

Module TRDP « trdp »

Description​

Le module trdp reçoit, via une interface réseau, des télégrammes du Train Real-time Data Protocol (TRDP) conformément à IEC 61375-2-3. Il ne traite que les messages de type Process Data (PD) et met leurs données utiles à la disposition du module fmproducer via le Fast Message Dispatcher (FMD) en vue de l'extraction ultérieure des signaux.

Le module fonctionne exclusivement en tant que subscriber TRDP (sink) : il écoute passivement les données de processus cycliques et n'envoie lui-même aucun télégramme TRDP. Le trafic de données entre les calculateurs du véhicule (p. ex. commandes de portes, climatisation, commandes de traction) peut ainsi être exploité pour la surveillance d'état et le diagnostic, sans intervenir dans la communication du véhicule.

La capture des paquets s'effectue directement au niveau de la couche 2 au moyen de PcapPlusPlus, de sorte que les groupes multicast TRDP peuvent être écoutés sur n'importe quelle interface réseau. La ComID est extraite de l'en-tête TRDP et transmise au dispatcher comme messageKey. Le fmproducer peut ainsi s'abonner de manière ciblée aux messages de certaines ComID et extraire des signaux individuels de la zone de données utiles.

Flux de données du réseau du véhicule, via le module trdp, jusqu'aux canaux smartCORE

Le port UDP standard pour TRDP Process Data (PD) est 17224 (conformément à IEC 61375-2-3).

Connexion réseau​

La voie standard est le raccordement direct de smartCORE au réseau du véhicule ou du train, sur lequel le module reçoit les télégrammes TRDP en tant que participant réseau ordinaire. Si une connexion individuelle doit au contraire être observée sans aucune rétroaction physique et avec isolation galvanique, sans que smartCORE apparaisse lui-même comme participant réseau, un TAP Ethernet smartIO peut être intercalé en option. Dans les deux cas, le module trdp traite les télégrammes écoutés de manière identique.

remarque

Les décalages en bits (bit offsets) dans le fmproducer doivent être indiqués par rapport au début des données utiles (après l'en-tête TRDP de 40 octets), et non par rapport au début de l'ensemble du télégramme.

Interfaces et protocoles utilisés​

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

Configuration JSON​

La section suivante décrit la configuration JSON du module.

Exemple de configuration (minimale)​

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

Exemple de configuration (avec fmproducer, plusieurs groupes multicast)​

Le module trdp sert de source de données pour le fmproducer. Dans le paramètre fmd du fmproducer, on indique le nom du dispatcher auquel le module TRDP transmet les données. Sauf indication contraire, il s'agit du nom de l'instance du module TRDP (ici : "TRDP"). La ComID de l'en-tête TRDP sert à chaque fois de messageKey.

{
"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"
}
]
}
}
]
}

Paramètres globaux du module​

Nom du paramètreObligatoireType de donnéesPlage de valeursDéfautDescription
networkInterfaceNonSTRING"eth0"Nom de l'interface réseau pour la capture des paquets
pollingIntervalMsNonINT100 – 20001000Intervalle du timer en millisecondes
trafficFilterNon1ARRAYListe de paires port/adresse multicast (recommandé)
portNon1INT0 – 65535Obsolète — port UDP ; utiliser trafficFilter
groupAddressNon1STRINGObsolète — adresse multicast IPv4 ; utiliser trafficFilter
fmdNonSTRINGNom de l'instance du moduleNom du dispatcher par défaut auquel les données utiles sont transmises
dispatchersNonARRAYDispatchers supplémentaires, sélectionnés selon l'adresse IP de l'expéditeur (à partir de smartCORE 2.12, voir ci-dessous)

Configuration d'une entrée trafficFilter​

Nom du paramètreObligatoireType de donnéesDéfautDescription
portOUIINTPort UDP de destination du flux multicast TRDP (standard selon IEC 61375-2-3 : 17224)
groupAddressOUISTRINGAdresse multicast IPv4 du flux TRDP
joinGroupNonBOOLfalseRejoindre activement le groupe multicast par IGMP (voir ci-dessous)

Par défaut, le module se contente de filtrer le trafic qui arrive de toute façon sur l'interface réseau — il n'envoie lui-même aucun IGMP Join. Cela suffit lorsque le commutateur (switch) diffuse le trafic multicast sur tous les ports ou que l'interface écoute via un port miroir / TAP Ethernet. En revanche, si le commutateur est configuré avec l'IGMP snooping, il ne transmet le groupe multicast qu'aux interfaces qui l'ont activement rejoint — dans ce cas, définir joinGroup: true pour l'entrée trafficFilter concernée, afin que smartCORE soit enregistré comme récepteur via IGMP.

Dispatchers selon l'adresse de l'expéditeur​

info

La prise en charge de dispatchers n'est officiellement disponible qu'à partir de smartCORE 2.12.

Par défaut, le module transmet tous les télégrammes reçus à un seul dispatcher : le dispatcher par défaut, dont le nom correspond au nom de l'instance du module ou à la valeur de fmd. Si plusieurs calculateurs utilisent les mêmes ComID, leurs télégrammes ne peuvent plus y être distingués.

dispatchers permet de configurer des dispatchers nommés supplémentaires, chacun étant associé à une adresse IP d'expéditeur. Chaque télégramme est remis à exactement un dispatcher, en fonction de l'adresse IPv4 de l'expéditeur de son paquet UDP :

  • Si l'adresse de l'expéditeur correspond à une entrée sourceIp, le télégramme est transmis au dispatcher name de cette entrée.
  • Tous les autres télégrammes sont transmis comme auparavant au dispatcher par défaut.

Pour chaque dispatcher, on configure un module fmproducer distinct dont le paramètre fmd contient le nom du dispatcher. Les mêmes ComID provenant de différents calculateurs peuvent ainsi être affectées à des canaux séparés, sans créer une instance du module trdp par calculateur.

Configuration d'une entrée dispatchers​

Nom du paramètreObligatoireType de donnéesDéfautDescription
nameOUISTRINGNom du dispatcher ; à indiquer dans le paramètre fmd du fmproducer associé
sourceIpOUISTRINGAdresse IPv4 de l'expéditeur des télégrammes transmis à ce dispatcher
remarque
  • Un télégramme n'est toujours remis qu'à un seul dispatcher. Un fmproducer rattaché au dispatcher par défaut ne reçoit plus les télégrammes des expéditeurs listés dans dispatchers.
  • Si la même sourceIp figure plusieurs fois, la première entrée correspondante s'applique.
  • Plusieurs entrées peuvent utiliser le même name ; les télégrammes de ces expéditeurs sont alors regroupés dans le même dispatcher.
  • Les entrées sans name ou avec une sourceIp invalide sont ignorées, avec un avertissement dans le journal.
  • Seules les adresses IPv4 d'expéditeur sont prises en compte.

Exemple de configuration (deux calculateurs avec des ComID identiques)​

Deux calculateurs envoient chacun la vitesse sous la ComID 45056. dispatchers sépare leurs télégrammes, et deux modules fmproducer les affectent à des canaux distincts.

{
"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"
}
]
}
}
]
}

Les télégrammes des autres expéditeurs continuent d'être transmis au dispatcher par défaut "TRDP" et peuvent être exploités par un autre fmproducer avec "fmd": "TRDP".

Remarques sur la configuration du fmproducer​

Les télégrammes TRDP sont toujours transmis au format Big-Endian. Dans le fmproducer associé, il convient donc de définir globalement "byteOrder": "BigEndian".

La ComID de l'en-tête TRDP sert de messageKey dans le fmproducer. Les décalages en bits (bitOffset) se rapportent au début de la zone de données utiles (après l'en-tête TRDP de 40 octets).

Décodage de la ComID : du télégramme TRDP, via la ComID comme messageKey, vers des canaux nommés dans le fmproducer

Des informations complémentaires sur l'extraction des canaux (imageType, bitOffset, bitLength, addressSpec, etc.) sont décrites dans la documentation du fmproducer.

Informations sur le module​

InformationValeur
AuteursoptiMEAS GmbH
depuis smartCORE2.11
Type de moduleProducer (Dispatcher)
Dépendancesfmproducer

Footnotes​

  1. Si trafficFilter, port et groupAddress sont tous omis, le module capture l'ensemble du trafic réseau de l'interface et transmet tous les paquets au parseur. Cela augmente considérablement la charge de traitement et ne devrait être utilisé qu'à des fins de diagnostic. Pour un fonctionnement en production, il est recommandé d'indiquer au moins une entrée trafficFilter. ↩ ↩2 ↩3