Aller au contenu principal

Module Fast Message Producer « fmproducer »

Description​

Presque toutes les sources de données de la technique des procédés transmettent les données dans des champs de données d'octets empaquetés. Le contenu et éventuellement aussi la longueur de ces paquets sont identifiables au moyen d'un messageKey (ou « ID »). Le tableau suivant en donne des exemples.

ProtocoleMessage KeyLongueur de la clé
CAN-BusCAN-ID11 ou 29 bit
MVB-BusNuméro de port12 bit
ProfiBusSlave-Node ID7 bit
ModbusRegister, Coil, Input, Status2 + 16-bit

Différents plug-ins smartCORE (par exemple fmudp, canbus, smartmvb) réalisent le raccordement du matériel via des interfaces dédiées, reçoivent ou envoient des paquets de données et alimentent, avec les paquets reçus, le Fast Message Dispatcher (FMD). Celui-ci fournit dans le smartCORE une technologie efficace pour extraire de sources de données quelconques, selon un schéma toujours identique, des données de mesure et des informations d'état et les produire dans des canaux smartCORE individuels (d'où le nom « fm Producer »).

Les modules d'interface créent au moins une instance d'un FMD sous leur propre nom. Celle-ci est raccordée dans le fmProducer via la propriété fmd.

fm Producer

Les paquets reçus contiennent, outre le MessageID et un horodatage, les données dans un champ de données d'octets. Pour un canal, les données s'y trouvent à partir d'un bitOffset donné, avec une bitLength définie. L'ordre des octets byteOrder dans le tampon joue également un rôle, de même que (malheureusement) l'addressSpec(ification), qui définit comment les bits sont comptés dans le tampon.

Une fois les octets de données brutes remis dans le bon ordre, la valeur correctement décalée et masquée, l'interprétation s'effectue via l'imageType. Le nombre est-il signé ou non ? Faut-il le lire comme BCD (Binary Coded Decimal) ou comme valeur polaire (virgule fixe) ? Entier, virgule flottante, ou même texte ?

Après une mise à l'échelle optionnelle vers une grandeur de mesure physique (scale, offset, physicalUnit) selon

yphys=yraw⋅scale+offsety_{phys} = y_{raw} \cdot \rm{scale} + \rm{offset}

la valeur de donnée est produite dans le canal smartCORE avec l'horodatage (de réception) également transmis par le module d'interface.

Interfaces et protocoles utilisés​

  • Fast Message Dispatching

Configuration JSON​

La section suivante décrit l'ensemble de la configuration JSON du module et explique chacun des paramètres.

Exemple de configuration (minimale)​

{
"module":"FmProducer",
"factory":"fmproducer",
"config":{
"fmd":"FastMessageDispatcher",
"channels":[
{
"name":"Channel",
"messageKey":42,
"bitOffset":0,
"bitLength":32,
"imageType":"float"
},

[...]

]
}
}

Exemple de configuration (maximale)​

{
"module":"FmProducerSmartMVB",
"factory":"fmproducer",
"config":{
"fmd":"smartmvb0",
"bufferSize":1024,
"namespace":["directory","subDirectory"],
"channelPrefix":"SmartMVB",
"addressSpec": "EN61375_MVB",
"byteOrder": "bigEndian",
"channels":[
{
"name":"SmartMVBmessageData",
"bufferSize":1024,
"scale":3.14,
"offset":2.72,
"physicalDimension":"Length",
"physicalUnit":"m",
"messageKey":10012,
"bitOffset":0,
"bitLength":20,
"imageType":"unsigned",
"addressSpec": "AscendingFirstBit",
"byteOrder": "littleEndian",
"absoluteTolerance":0.5
},

[...]

]
}
}

Paramètres globaux du module​

Nom du paramètreRequisType de donnéesPlage de valeurs pertinenteDéfautDescription
fmdOUISTRINGFast Message Dispatcher du module émetteur
bufferSizeNon1INT1 -1024(par défaut) Taille de tampon des canaux créés
channelPrefixNonSTRINGPréfixe de canal (utile lorsque plusieurs modules fmproducer sont utilisés et que les configurations comportent des noms de canaux qui se chevauchent)
namespaceNonARRAY [STRING]Préfixe de canal sous forme de namespaces enchaînés hiérarchiquement
addressSpecNonSTRING"EN61375_MVB"Schéma d'adressage par défaut
byteOrderNonSTRING"BigEndian"Ordre des octets par défaut
channelsOUIJSON ArrayListe d'objets JSON des canaux configurés

Configuration d'un canal (objet JSON)​

Nom du paramètreRequisType de donnéesPlage de valeurs pertinenteDéfautDescription
Filter
messageKeyNon2UINTID du message reçu (par exemple CAN-Bus Message ID, MVB Port, ...)
Process Image
addressSpecNonSTRING(valeur du réglage global)Schéma d'adressage, voir la description ci-après
byteOrderNonSTRING"BigEndian", "LittleEndian",
"[A-Z]+"
(valeur du réglage global)Ordre des octets de la valeur stockée, voir la description ci-après
imageTypeOUISTRINGtype de données source pris en charge de la valeur stockée (voir ci-dessous)
bitOffsetOUIUINTDécalage en bits de la valeur stockée dans le message
bitLengthNon3UINTLongueur en bits de la valeur stockée dans le message
stringHintNon4STRINGIndication pour déterminer la longueur de la chaîne (voir ci-dessous)
stringEncoding5Non4STRINGnom IANA, p. ex. "UTF-8", "windows-1252"6Codage des caractères de la chaîne dans le paquet de données (voir ci-dessous)
timeFix5Non7STRING"RFC4330", "RFC5905""RFC4330"Traitement du débordement de time64 en 2036 (voir ci-dessous)
scaleNon8FLOAT1Facteur d'échelle de la valeur produite
offsetNon8FLOAT0Offset additif de la valeur produite
smartCORE
nameOUISTRINGNom du canal
dataTypeNon9STRINGType de données du canal
bufferSizeNon1INT1 -1024Taille de tampon du canal créé
physicalDimensionNonSTRINGgrandeur physique
physicalUnitNonSTRINGunité physique
noFilterNonBOOLfalseDésactive le filtre DataReduction
absoluteToleranceNonFLOAT0.0Tolérance absolue pour le filtre DataReduction
cacheSizeNon10INT0Nombre d'échantillons de données stockés dans un cache local du canal avant d'être publiés pour d'autres modules.
Réservé
debugNonBOOLfalseActive les sorties de débogage pour le canal.
numElementsNonINT1Longueur d'un champ de données en multiples de l'élément de base

Spécifications d'adresse 'addressSpec'​

Pourquoi un schéma d'adressage doit-il être défini ?​

Le fmproducer décompose le paquet de données reçu d'un appareil externe. Et la spécification de cet appareil et de l'interface utilisée détermine comment localiser les différents canaux de données dans le flux de données. Il existe malheureusement ici de nombreuses variantes, car malgré la normalisation, il existe encore suffisamment d'implémentations propriétaires dans certains domaines.

La spécification d'adresse addressSpec définit selon quel mode de comptage le MSBit ou le LSBit est indiqué dans le bitOffset. Pour des raisons historiques (le fmProducer a d'abord été développé pour le MVB), le réglage EN61375_MVB est aussi le réglage par défaut.

Valeurs réglables​

Sauf indication contraire, c'est chaque fois la position du premier bit (Msb/Lsb selon le byteOrder) qui est adressée. L'indication de l'addressSpec est sans effet lorsqu'un mappage libre est choisi comme byteOrder.

EnumAliasDescription
EN61375_MVBMVB
EN61375
RevNum
ReversedNum
ReversedForMsbNumerics
Suit strictement la EN61375 en ce qui concerne ByteOrder, types de données, alignement et comptage des bits.
- Le bitOffset est byteOffset * 8 + rightShift
- Les configurations non conformes sont rejetées.
ReversedForMsbRev
Reversed
11 Pour tous les signaux, les bits sont comptés dans l'ordre inverse (Motorola).
AscendingFirstBitDBCPour tous les signaux, les bits sont comptés par poids croissant.
AscendingLSBitpositionLsbPour tous les signaux, les bits sont comptés par poids croissant.
C'est toujours la position du LSBit qui est adressée.
AscendingMSBitpositionMsbPour tous les signaux, les bits sont comptés par poids croissant.
C'est toujours la position du MSBit qui est adressée.

Définition de la position d'image pour EN61375_MVB​

La norme EN 61375-2-1 contient, à partir du §6.4.2, diverses indications sur la manière dont les données doivent être transmises sur le MVB. Certains cas sont ainsi exclus d'emblée. À partir de smartCORE 2.10.1, les canaux dont la configuration n'est pas conforme sont signalés comme erreur dans le fichier journal par le fmproducer et bloqués pour le traitement.

  • bitLength=2k\text{bitLength} = 2^k (hypothèse et zone grise)12 La norme ne définit pas de types de données dont la longueur n'est pas une puissance de 2 exacte. Une valeur numérique d'une autre bitLength est traitée, mais signalée au démarrage par un avertissement dans le fichier journal. Sont exceptés les imageTypes dont la longueur est définie par le type lui-même (p. ex. timedate48).

  • bitOffset=byteOffset⋅8+rightShift\text{bitOffset}=\text{byteOffset} \cdot 8 + \text{rightShift} Ainsi, le bitOffset ne renvoie pas de manière cohérente au MSBit ou au LSBit d'une variable, mais soit au premier octet (entier), soit au LSbit dans un octet pour bitLength<8\text{bitLength} < 8

  • La représentation est toujours BigEndian. Les agencements LittleEndian sont ainsi exclus.

  • La position d'image doit toujours être alignée sur un multiple de sa taille dans le tampon de données. Les types de données de 1, 2 ou 4 bits ne peuvent donc se trouver qu'à l'intérieur d'un octet. Tous les autres, de longueur 8, 16, 32, 64 bits, doivent impérativement être alignés sur un octet. Un décalage de l'image n'est pas autorisé ! => rightShift:=0\text{rightShift} := 0 à partir de bitLength≥8\text{bitLength} \geq 8.

  • Une valeur de moins de 8 bits commence et se termine dans le même octet. Cela vaut aussi pour une bitLength qui n'est pas une puissance de 2 : une valeur de 3 bits avec rightShift=6\text{rightShift} = 6 franchit la limite d'octet et est rejetée.

Comportement modifié à partir de smartCORE 2.12

Une valeur de moins de 8 bits qui franchit la limite d'octet est rejetée. Une bitLength qui n'est pas une puissance de 2 est signalée.

astuce

Si un décodage avec ce schéma EN61375_MVB n'est pas possible, l'un des autres schémas peut toujours être choisi pour un canal individuel, et un décalage et un réalignement des bits et des octets peuvent alors aussi être essayés.

Comptage de la position des bits​

La distinction la plus importante pour tous les autres schémas est d'abord l'ordre dans lequel les bits sont comptés.

Avec les réglages Ascending*, les bits sont comptés selon le poids croissant. C'est typique des configurations CANbus ou Profibus et cela correspond aussi aux implémentations dans les langages de programmation.

Avec le réglage ReversedForMsb, les bits sont comptés strictement de gauche à droite pour le byteOrder BigEndian (Motorola, MSB, Network). Cela correspond au comptage au niveau physique dans les protocoles de transmission de données série, comme par exemple CANbus, SPI ou aussi MVB.

Le graphique montre les différents modes de comptage pour 3 octets à titre d'exemple.

Mode de comptage des bits

Définition du bit d'ancrage pour la position d'image​

Dans les réglages Ascending*, on distingue quel bit de la valeur de donnée est adressé avec bitOffset. Il s'agit généralement du premier bit (AscendingFirstBit), donc du MSBit pour le byteOrder bigEndian et du LSBit pour littleEndian. Il existe toutefois aussi des exceptions où, indépendamment du byteOrder, c'est toujours le MSBit ou le LSBit qui est adressé.

Dans le diagramme suivant, deux valeurs entières de 18 bits sont extraites d'un télégramme de données avec comptage Ascending*, transmises une fois avec le byteOrder littleEndian et une fois avec bigEndian.

Décodage d&#39;une valeur numérique Ascending

Et ce diagramme ajoute une valeur entière de 18 bits avec comptage ReversedForMsb :

Décodage d&#39;une valeur numérique Reversed

Le tableau donne des variantes d'adressage possibles pour les valeurs int18 présentées ci-dessus.

addressSpecbyteOrderbitOffsetbitLength
ReversedForMsb
AscendingFirstBit
AscendingLSBit
LittleEndian1118
AscendingMSBitLittleEndian2818
(sans effet)"CBA"111318
ReversedForMsbBigEndian1318
AscendingFirstBit
AscendingMSBit
BigEndian3418
AscendingLSBitBigEndian4918
(sans effet)"ABC"331418

Signaux booléens​

Enfin, pour les signaux booléens, seul le sens de comptage détermine le bit sélectionné :

Décodage d&#39;un booléen

addressSpecbyteOrderbitOffsetbitLength
ReversedForMsbBigEndian131
(tous les autres)BigEndian
LittleEndian
101
(sans effet)"A"10151

Ordre des octets 'byteOrder'​

EnumAliasDescription
BigEndianBig, MSB, Motorola, NetworkL'octet contenant le bit de poids le plus fort (MSBit) se trouve en premier dans le paquet de données transmis
LittleEndianLittle, LSB, IntelL'octet contenant le bit de poids le plus faible (LSBit) se trouve en premier dans le paquet de données transmis
Suite de A-ZSi une chaîne de mappage est utilisée, les octets peuvent être remis dans le bon ordre à partir d'un agencement mélangé de manière quelconque.
addressSpec est alors sans effet.

Utilisation d'une chaîne de mappage​

Les octets du tampon de réception sont indexés par ordre croissant en commençant par 'A', à partir de bitOffset / 8. L'ordre des octets par poids décroissant est défini par la chaîne. bitOffset MODULO 8 détermine de combien de bits la valeur extraite doit être décalée vers la droite pour que le bit de poids le plus faible (LSBit) se trouve à la position 202^0.

Avec ce mappage libre, on peut en général interpréter tous les télégrammes ayant parcouru un long chemin depuis une borne de mesure, via des coupleurs de bus, des automates, des passerelles, etc., et ayant subi au passage différents réordonnancements et interprétations de l'ordre des octets. Chaque système offre ses propres possibilités de réglage, et elles sont largement utilisées. Cela pourrait être si simple...

Exemple :

bytes: 0_______ 1_______ 2_______ 3_______ 4_______ 5_______ 6_______
bits: 76543210 76543210 76543210 76543210 76543210 76543210 76543210
bitOffset: --------------------->|
Indizierung: A B C D E ...

Extraktion für "CDBA"
value = ((((byte[4] << 8) // alias 'C' (bitOffset / 8) + 2
| byte[5] << 8) // alias 'D' (bitOffset / 8) + 3
| byte[3] << 8) // alias 'B' (bitOffset / 8) + 1
| byte[2]) // alias 'A' (bitOffset / 8) + 0
>> (bitOffset % 8);

Types de données source 'imageType'​

EnumAliasDescription
boolbooleanbitLength fixe de 1 et dataType Bool.
unsignedEntier non signé avec bitLength 2..64.
Peut être combiné avec scale et offset pour obtenir une grandeur physique mise à l'échelle.
antivalent, antivalent2=> unsigned avec bitLength = 2, utilisé le plus souvent dans le contexte MVB pour des valeurs booléennes sécurisées :
0 : ERROR
1 : FALSE
2 : TRUE
3 : UNDEFINED
signedEntier signé avec bitLength 2..64, le bit de poids le plus fort est le bit de signe.
Peut être combiné avec scale et offset pour obtenir une grandeur physique mise à l'échelle.
bcdNombres décimaux codés en binaire,
4 bits chacun pour représenter un chiffre 0..9
float16 bitLength fixe de 32, IEEE 754
double16 bitLength fixe de 64, IEEE 754
timedate48bitLength fixe de 48,
EN 61375-2-1 §6.4.6.2 (TCN, WTB, MVB), voir Horodatages
time64bitLength fixe de 64, RFC 1305, voir Horodatages
bytearrayD'autres propriétés définissent comment la longueur du tableau est calculée
stringD'autres propriétés définissent comment la longueur de la chaîne est calculée
UniPolar<M>.<N>Nombre à virgule fixe non signé avec <M> bits entiers et une bitLength fixe de <N> bits.
Peut être combiné avec scale et offset pour obtenir une grandeur physique mise à l'échelle.
EN 61375-2-1 §6.4.3.7 (TCN, WTB, MVB)
BiPolar<M>.<N>Nombre à virgule fixe signé avec <M> bits entiers (signe inclus) et une bitLength fixe de <N> bits.
Peut être combiné avec scale et offset pour obtenir une grandeur physique mise à l'échelle.
EN 61375-2-1 §6.4.3.8 (TCN, WTB, MVB)

Horodatages 'timedate48' et 'time64'​

Comportement modifié à partir de smartCORE 2.12

time64 est compté à partir de 1900, comme le définit la RFC 1305 ; auparavant, la valeur était décalée de 70 ans. Un horodatage 0 est transmis comme 0.

Les deux imageTypes sont produits en nanosecondes depuis le 01.01.1970 (UTC) avec le dataType int64. La conversion s'effectue en arithmétique entière ; la fraction de seconde est arrondie à la nanoseconde la plus proche.

imageTypeStructureRéférencevalable jusqu'au
timedate48secondes sur 32 bits (non signées) + fraction sur 16 bits en 2−162^{-16} s01.01.197007.02.2106
time64secondes sur 32 bits (non signées) + fraction sur 32 bits en 2−322^{-32} s01.01.1900voir timeFix

Un horodatage dont tous les bits valent 0 est transmis comme 0 et signale ainsi un horodatage manquant.

Débordement de time64 en 2036 'timeFix'​

Le compteur de secondes de time64 déborde le 07.02.2036 à 06:28:16 UTC. timeFix détermine à quelle ère se rapporte une valeur reçue :

timeFixProcédé
RFC4330 (défaut)RFC 4330 §3 : si le bit de poids le plus fort des secondes est positionné, l'heure se situe entre 1968 et 2036, sinon entre 2036 et 2104. Correspondance fixe, sans référence à l'heure système.
RFC5905RFC 5905 §6 : l'ère la plus proche de l'horodatage de réception s'applique. Suppose une heure système correcte.

Si un horodatage s'écarte de plus de 30 ans de l'horodatage de réception, cela est signalé une seule fois par canal dans le fichier journal, avec les deux instants. Une cause typique est un correspondant qui envoie des secondes depuis 1970 au lieu de 1900.

Indications pour déterminer la longueur d'une chaîne 'stringHint' et 'numElements'​

Comportement modifié à partir de smartCORE 2.12
  • Toute chaîne se termine au premier caractère nul, quel que soit le stringHint.
  • bitOffset et bitLength des string et bytearray doivent être des multiples de 8 ; addressSpec et byteOrder sont sans effet sur eux.
  • Sans addressSpec (défaut EN61375_MVB), les chaînes sont lues en ISO-8859-1. "stringEncoding": "UTF-8" rétablit le comportement antérieur.

Les chaînes et les champs de données (imageType string et bytearray) se trouvent toujours octet par octet dans le paquet de données :

  • bitOffset et bitLength doivent être des multiples de 8. Sinon, le canal est bloqué au démarrage avec un message dans le fichier journal.

  • bitOffset est la position de l'octet × 8. addressSpec et byteOrder sont sans effet ; byteOrder ne détermine que l'ordre des octets d'un champ de longueur (voir ci-dessous).

La zone réservée à la chaîne dans le tampon de données résulte

  • de la bitLength,

  • de numElements × bitLength si numElements est indiqué. bitLength est alors la largeur d'un caractère (8 bits par défaut, 16 bits pour U8WLength à U32WLength et S7WLength), ou

  • en l'absence des deux, du reste du message à partir de bitOffset.

Quel que soit le stringHint, toute chaîne se termine au premier caractère nul (U+0000) après décodage. Ce qui suit dans la zone réservée est ignoré. Si tous les octets sont nécessaires, utiliser l'imageType bytearray.

EnumAliasDescription
FixedLengthInBitsbitLength(défaut) La chaîne remplit la zone réservée.
NullTerminatedÉquivalent à FixedLengthInBits, conservé pour des raisons de compatibilité
FixedLengthnumElements définit le nombre de caractères de la chaîne.
U8LengthUn uint8 placé avant le texte indique sa longueur en octets.
U16LengthUn uint16 placé avant le texte indique sa longueur en octets.
U32LengthUn uint32 placé avant le texte indique sa longueur en octets.
U8WLength5Un uint8 placé avant le texte indique sa longueur en mots (2 octets, p. ex. UTF-16).
U16WLength5Un uint16 placé avant le texte indique sa longueur en mots.
U32WLength5Un uint32 placé avant le texte indique sa longueur en mots.
S7Length5SIMATIC STRING, voir ci-dessous
S7WLength5SIMATIC WSTRING, voir ci-dessous
EndOfMessageLa chaîne s'étend toujours jusqu'à la fin du message.

Chaînes avec champ de longueur​

Avec U8Length à U32WLength, un champ de longueur précède le texte à partir de bitOffset. La largeur réservée issue de bitLength ou de numElements s'applique au texte ; le champ de longueur s'y ajoute. Un champ de longueur de 2 ou 4 octets est lu en little endian avec byteOrder LittleEndian, sinon en big endian.

Si le champ de longueur indique plus que ce que contiennent la zone réservée ou le message, le texte est tronqué et cela est signalé une seule fois par canal dans le fichier journal. Si le champ de longueur manque dans le message, aucune valeur n'est produite.

Exemple U16Length, byteOrder BigEndian, bitOffset 0 :

00 02 41 42 43 → "AB"

Chaînes SIMATIC 'S7Length' et 'S7WLength'​

Les automates SIMATIC enregistrent les chaînes avec un en-tête composé de la longueur maximale déclarée et de la longueur actuelle. Les deux comptent des caractères. Seuls les caractères de la longueur actuelle sont lus ; ce qui suit dans la zone réservée est sans importance.

stringHintType SIMATICEn-têteCaractèrestringEncoding par défautLongueur maximale
S7LengthSTRING[n]1 octet longueur maximale, 1 octet longueur actuelle1 octetwindows-1252254
S7WLengthWSTRING[n]2 octets longueur maximale, 2 octets longueur actuelle, big endian2 octetsUTF-16BE16382

numElements correspond à la déclaration n et est optionnel ; sans indication, le reste du message s'applique. L'en-tête de S7WLength est toujours en big endian, indépendamment de byteOrder.

Si la longueur actuelle dépasse la longueur maximale, elle est ramenée à la longueur maximale. Ce cas, ainsi qu'une longueur maximale supérieure à la limite ou différente de numElements, est signalé une seule fois par canal dans le fichier journal ; la valeur est tout de même lue.

Exemple STRING[10] := 'abcdef' avec numElements 10 :

0A 06 61 62 63 64 65 66 xx xx xx xx → "abcdef"

Codage des caractères 'stringEncoding'​

En interne, smartCORE traite toutes les chaînes en Unicode. stringEncoding indique le codage des octets dans le paquet de données. Sans indication, "windows-1252" s'applique pour S7Length, "UTF-16BE" pour S7WLength, "ISO-8859-1" (Latin-1) pour l'addressSpec EN61375_MVB, sinon "UTF-8".

Sont admis les noms et alias du registre IANA "Character Sets". La casse n'a pas d'importance. Les alias avec le préfixe cs (p. ex. csUTF8) ne sont pas pris en charge. Un nom inconnu est signalé au démarrage dans le fichier journal et le canal est bloqué.

Codages fréquemment utilisés et octets de quelques caractères :

stringEncodingäÄ߀°µ²
UTF-8C3 A4C3 84C3 9FE2 82 ACC2 B0C2 B5C2 B2
ISO-8859-1 (Latin-1)E4C4DF–B0B5B2
ISO-8859-15 (Latin-9)E4C4DFA4B0B5B2
windows-1252E4C4DF80B0B5B2
IBM437 (cp437)848EE1–F8E6FD
UTF-16BE (MVB UNICODE16)00 E400 C400 DF20 AC00 B000 B500 B2
US-ASCII–––––––

US-ASCII ne connaît que les octets 00 à 7F. Un caractère absent du codage, ou une suite d'octets invalide, apparaît dans le canal sous forme du caractère de remplacement « � » (U+FFFD).

Chaque message est décodé indépendamment. Une suite d'octets tronquée à la fin de la zone de données n'est pas complétée par le message suivant, mais également restituée sous forme de « � ».

Erreurs typiques en cas de mauvais réglage :

Affiché dans le canalCause
ä au lieu de äLes données sont en UTF-8, le réglage est ISO-8859-1 ou windows-1252.
� au lieu de äLes données sont en ISO-8859-1 ou windows-1252, le réglage est UTF-8.
„ au lieu de äLes données sont en IBM437, le réglage est windows-1252.

Indications pour déterminer la longueur d'un champ de données 'numElements'​

L'alignement sur l'octet de bitOffset et de bitLength s'applique également aux champs de données (voir ci-dessus).

attention

imageType : ByteArray
La fonction de décodage des champs de données n'est pas encore vérifiée. À n'utiliser qu'après concertation !

Types de données de canal (types de données cibles) 'dataType'​

Le dataType est toujours déterminé automatiquement à partir de l'imageType s'il n'est pas spécifié. Un format cible est alors choisi, qui évite toute perte d'information avec le besoin en mémoire le plus faible possible.

EnumAliasPlage de valeursApplication
Booleanboolfalse/trueSignaux d'état/de commande
Floatjusqu'à 3.40⋅10383.40\cdot10^{38}Données de mesure
Doublejusqu'à 1.80⋅103081.80\cdot10^{308}
Integer8int8−27…27−1-2^{7}\dots2^{7}-1
Integer16int16−215…215−1-2^{15}\dots2^{15}-1
Integer32int32−231…231−1-2^{31}\dots2^{31}-1
Integer64int64−263…263−1-2^{63}\dots2^{63}-1Horodatage
UnsignedInteger8uint80…28−10\dots2^{8}-1Codes d'état
UnsignedInteger16uint160…216−10\dots2^{16}-1
UnsignedInteger32uint320…232−10\dots2^{32}-1
UnsignedInteger64uint640…264−10\dots2^{64}-1
ByteArray
StringTexte

Types de données imposés :​

Si la bitLength == 1 ou l'imageType == bool, le dataType est lui aussi toujours automatiquement bool.

Pour imageType == string ou bytearray, le dataType est lui aussi toujours string ou bytearray.

Les imageTypes time64 ou timedate48 imposent int64 comme dataType, afin de pouvoir convertir les horodatages correctement et intégralement en nanosecondes depuis le 01.01.1970.

Une indication de numElements > 1 impose le dataType ByteArray, sauf si un imageType String est réglé.

Un imageType numérique ne peut pas alimenter un dataType String, ByteArray ou GpsLocation ; un tel canal est désactivé au démarrage avec un message indiquant les deux types.5

Types de données automatiques :​

Les formats à virgule flottante float et double ont alors la priorité, dès que l'un des critères suivants est rempli :

  • la source de données fournit déjà, via l'imagetype (float, double, unipolar, bipolar), une valeur à virgule flottante ou fixe,
  • scale≠1.0\text{scale} \neq 1.0 ou offset≠0.0\text{offset} \neq 0.0,
  • une physicalUnit est spécifiée.

Si bitLength≤24\text{bitLength} \leq 24, un float suffit pour une conversion sans perte.

Les formats entiers sont également choisis, via la bitLength et la présence d'un signe (signed) dans l'imageType, pour la plus petite plage de données possible :

  • (Unsigned)Integer8 pour bitLength≤8\text{bitLength} \leq 8
  • (Unsigned)Integer16 pour bitLength≤16\text{bitLength} \leq 16
  • (Unsigned)Integer32 pour bitLength≤32\text{bitLength} \leq 32
  • (Unsigned)Integer64 pour bitLength≤64\text{bitLength} \leq 64

Le signe optionnel est complété, à partir du bit de poids le plus fort de l'image, jusqu'à la largeur du dataType.

Types de données manuels et conversion :​

attention

La sélection manuelle du dataType peut entraîner une perte de précision, de résolution ou une restriction significative de la plage de valeurs disponible et doit donc en règle générale être évitée !

Si la source de données fournit un nombre à virgule flottante selon les règles précitées, la conversion vers un dataType entier se fait par arrondi : à partir de .50, à la valeur entière supérieure suivante.

Dans tous les cas, les plages de valeurs des types entiers choisis sont prises en compte. Si la valeur de l'image se situe en dehors de la plage disponible, elle est remplacée par le minimum ou le maximum représentable et un message est écrit dans le fichier journal.

Filtre de réduction de données​

Un filtre de réduction de données est configuré pour chaque canal. Dans le réglage de base, il fait en sorte que de nouveaux enregistrements ne soient écrits dans le canal que lorsque le contenu des données change (OnChange). L'horodatage de réception des données continue en revanche d'être mis à jour à chaque enregistrement traité, de sorte que le traitement des données (constantes) dans d'autres plug-ins reste possible jusqu'à l'instant le plus récent.

L'option absoluteTolerance place une bande de tolérance autour de la dernière valeur écrite. Un nouvel enregistrement n'est publié que lorsque l'écart par rapport à la dernière valeur écrite dépasse cette bande de tolérance. Ce réglage est utile pour les signaux fortement bruités, afin de réduire significativement la quantité de données.

Si l'option noFilter est mise à true, aucun filtre de réduction de données n'est créé. Ce réglage est judicieux pour les données rapides qui ne doivent pas être réduites, parce que, par exemple pour des signaux de vibrations, une analyse dans le domaine fréquentiel suit.

Informations sur le module​

InformationValeur
AuteursoptiMEAS GmbH
depuis smartCORE0.103
Type de moduleFast Message Receiver, Producer
DépendancesModule émetteur Fast Message (par exemple fmudp, canbus, smartmvb, rawplayback, ...)

Footnotes​

  1. L'indication de la bufferSize détermine combien d'échantillons sont conservés dans le canal smartCORE pour être utilisés par d'autres modules. Elle doit être choisie de manière à pouvoir mettre en tampon environ 5 .. 10 secondes. Des lacunes périodiques dans les données OSF indiquent une bufferSize trop petite. ↩ ↩2

  2. Si le "messageKey" n'est pas configuré, les données de tous les messages sont traitées (ce qui est utile, par exemple, pour CAN RAW et les applications de débogage). ↩

  3. Si la "bitLength" n'est pas configurée, elle est déterminée à partir de l'imageType. Pour les imageType string et bytearray, la valeur s'étend alors jusqu'à la fin du message. ↩

  4. Uniquement pour l'imageType string, sans effet pour les autres imageTypes. ↩ ↩2

  5. Disponible à partir de smartCORE 2.12. ↩ ↩2 ↩3 ↩4 ↩5 ↩6 ↩7 ↩8

  6. "windows-1252" pour S7Length, "UTF-16BE" pour S7WLength, "ISO-8859-1" pour l'addressSpec EN61375_MVB, sinon "UTF-8". ↩

  7. Uniquement pour l'imageType time64, sans effet pour les autres imageTypes. ↩

  8. L'indication de scale != 1 ou offset != 0 conduit, avec un imageType numérique, à une sortie avec le dataType float ou double. ↩ ↩2

  9. En règle générale, il convient d'omettre l'indication du type de données, car celui-ci est alors déterminé de manière optimisée à partir de l'imageType et de la bitLength. Pour certaines combinaisons, le type de données est imposé de façon impérative par le module. ↩

  10. L'indication d'une cacheSize réduit la charge CPU pour les sources de données très rapides (>100Hz> 100 Hz), car les nouveaux enregistrements sont d'abord mis en cache et ne sont publiés pour d'autres modules qu'une fois le cache entièrement rempli. L'indication doit être choisie de manière à obtenir une publication à une cadence de 55 à 20Hz20 Hz. ↩

  11. S'applique explicitement uniquement au byteOrder bigEndian. Pour le byteOrder littleEndian, le comptage suit le schéma AscendingFirstBit. ↩

  12. Bien que dans la EN la longueur d'un type de données# avec (# = any unsigned integer) soit laissée ouverte à certains endroits, toutes les explications explicites sont toujours données en puissances entières de 2 (ENUM4, ENUM8, INTEGER8, INTEGER16, ...). Rien n'indique comment procéder pour l'alignement avec des longueurs de bits en dehors de cette trame. ↩

  13. byte 1 * 8 + rightShift 3 = 11 ↩

  14. byte 4 * 8 + rightShift 1 = 33 ↩

  15. byte 1 * 8 + rightShift 2 = 10 ↩

  16. Si la source de données fournit une valeur NAN ou INF, celle-ci n'est explicitement pas produite dans le canal smartCORE. ↩ ↩2