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.

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.
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ètre | Obligatoire | Type de données | Plage de valeurs | Défaut | Description |
|---|---|---|---|---|---|
| networkInterface | Non | STRING | "eth0" | Nom de l'interface réseau pour la capture des paquets | |
| pollingIntervalMs | Non | INT | 100 – 2000 | 1000 | Intervalle du timer en millisecondes |
| trafficFilter | Non1 | ARRAY | Liste de paires port/adresse multicast (recommandé) | ||
| port | Non1 | INT | 0 – 65535 | Obsolète — port UDP ; utiliser trafficFilter | |
| groupAddress | Non1 | STRING | Obsolète — adresse multicast IPv4 ; utiliser trafficFilter | ||
| fmd | Non | STRING | Nom de l'instance du module | Nom du dispatcher par défaut auquel les données utiles sont transmises | |
| dispatchers | Non | ARRAY | Dispatchers 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ètre | Obligatoire | Type de données | Défaut | Description |
|---|---|---|---|---|
| port | OUI | INT | Port UDP de destination du flux multicast TRDP (standard selon IEC 61375-2-3 : 17224) | |
| groupAddress | OUI | STRING | Adresse multicast IPv4 du flux TRDP | |
| joinGroup | Non | BOOL | false | Rejoindre 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
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 dispatchernamede 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ètre | Obligatoire | Type de données | Défaut | Description |
|---|---|---|---|---|
| name | OUI | STRING | Nom du dispatcher ; à indiquer dans le paramètre fmd du fmproducer associé | |
| sourceIp | OUI | STRING | Adresse IPv4 de l'expéditeur des télégrammes transmis à ce dispatcher |
- 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
sourceIpfigure 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
nameou avec unesourceIpinvalide 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).

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
| Information | Valeur |
|---|---|
| Auteurs | optiMEAS GmbH |
| depuis smartCORE | 2.11 |
| Type de module | Producer (Dispatcher) |
| Dépendances | fmproducer |