Modulo smartCORE MVB

Descrizione

Il modulo "mvb" legge i dati dalle interfacce duagon MVB e li produce in smartCHANNEL. Tra le interfacce supportate rientrano

• la D503 MVB to Ethernet Box (esterna, tramite UDP)
• la trasmissione generica di porte MVB tramite UDP

Interfacce e protocolli utilizzati

• Multifunctional Vehicle Bus (MVB)

Configurazione JSON

La sezione seguente descrive l'intera configurazione JSON del modulo e illustra i singoli parametri.

Configurazione di esempio (minima / UDP)

Di seguito è riportata una configurazione di esempio MVB con un'interfaccia UDP:

    {
      "module":"MVB",
      "factory":"mvb",
      "config":{
        "udpInterfaces":[
          {
            "name":"udp0",
            "udpDestinationPort":12345,
            "mvbPorts":[
              {
                "address":79,
                "size":32,
                "cycleTime":256
              }
            ]
          }
        ],
        "channels":[
          {
            "name":"some value",
            "mvbPort":79,
            "dataType":"uint32",
            "bitOffset":32,
            "bitLength":32,
            "imageType":"unsigned"
          }
        ]
      }
    }

Configurazione di esempio (massima / UDP)

Di seguito è riportata una configurazione di esempio MVB con un'interfaccia UDP:

    {
      "module":"MVB",
      "factory":"mvb",
      "config":{
        "namespace":["directory","subDirectory"],
        "channelPrefix":"MVB__",
        "rtPriority":80,
        "outBufferSize":1024,
        "readFreshDataOnly":true,
        "produceOnChangeOnly":true,
        "udpInterfaces":[
          {
            "name":"udp0",
            "type":"generic",
            "udpDestinationPort":12345,
            "mvbPorts":[
              {
                "address":79,
                "size":32,
                "cycleTime":256
              }
            ]
          }
        ],
        "channels":[
          {
            "name":"Laufleistung",
            "mvbPort":79,
            "dataType":"uint32",
            "bitOffset":32,
            "bitLength":32,
            "imageType":"unsigned",
            "physicalDimension":"",
            "physicalUnit":"km",
            "scale":1,
            "offset":0
          }
        ]
      }
    }

Parametri globali del modulo

Nome del parametro	Obbligatorio	Tipo di dati	Intervallo di valori consigliato	Default	Descrizione
rtPriority	No	INT	1 - 80	80	Priorità del thread di lettura
outBufferSize	No	INT	1 -	1024	Dimensione del buffer dei canali creati
channelPrefix	No	STRING			Prefisso dei canali (utile se si utilizzano più moduli DBC e i file DBC contengono nomi di canale sovrapposti)
namespace	No	ARRAY [ STRING ]			Prefisso dei canali sotto forma di namespace concatenati gerarchicamente
readFreshDataOnly	No	BOOL		true	Lettura dal bus MVB dei soli dati aggiornati
produceOnChangeOnly	No	BOOL		true	Produzione solo in caso di variazione dei dati
udpInterfaces	SÌ	JSON Array			Configurazione delle interfacce UDP (vedere sotto)
channels	SÌ	JSON Array			Configurazione degli smartCHANNEL (vedere sotto)

Configurazione delle interfacce UDP

Nome del parametro	Obbligatorio	Tipo di dati	Intervallo di valori consigliato	Default	Descrizione
name	SÌ	STRING			Nome dell'interfaccia MVB
type	SÌ	STRING	"generic"		Tipo di interfaccia MVB
udpDestinationPort	SÌ	INT	0 - 65535		Porta per la ricezione dei pacchetti UDP MVB
mvbPorts	SÌ	JSON Array			Specifica delle porte MVB da ricevere

Configurazione delle porte MVB

Nome del parametro	Obbligatorio	Tipo di dati	Intervallo di valori consigliato	Default	Descrizione
address	SÌ	UINT16	0 - 65535		Indirizzo della porta MVB
size	SÌ	UINT8	1 - 32		Dimensione della porta MVB in byte
cycleTime	SÌ	UINT16	0 - 65535		Tempo di ciclo MVB in millisecondi

Configurazione dei canali

Nome del parametro	Obbligatorio	Tipo di dati	Intervallo di valori consigliato	Default	Descrizione
name	SÌ	STRING	nome di canale univoco		Nome del canale
dataType	SÌ	STRING	tipo di dati del canale valido		Tipo di dati (di destinazione) (vedere sotto)
outBufferSize	No	INT	1 -	1024	Dimensione del buffer del canale creato
physicalDimension	No	STRING			Grandezza fisica
physicalUnit	No	STRING			Unità fisica
scale	No	FLOAT	> 0.0	1.0	Scalatura del valore
offset	No	FLOAT		0.0	Offset del valore
mvbPort	SÌ	INT	0 - 4095		Porta MVB
bitOffset	SÌ	INT	0 -		Offset del valore nella porta MVB
bitLength	SÌ	INT	1 -		Lunghezza del valore nella porta MVB (0 per lunghezza variabile, ad es. bytearray o string)
imageType	SÌ	STRING	tipo di dati sorgente valido		vedere sotto

Tipi di dati sorgente "imageType"

Dalla porta MVB possono essere estratti i seguenti tipi di dati.

Denominazione	Descrizione
signed	numero intero con segno di lunghezza pari a "bitLength" BIT
unsigned	numero intero senza segno di lunghezza pari a "bitLength" BIT; i valori booleani possono essere considerati come "unsigned" di lunghezza 1 bit
float	numero in virgola mobile a precisione singola ("bitLength==32") o doppia ("bitLength==64")
bytearray	dati binari di lunghezza "bitLength"
string	stringhe di caratteri di lunghezza "bitLength"
timedate48	timestamp TIMEDATE48 specifico di MVB
time64	timestamp TIME64 specifico di MVB
unipolar<<M>>.<<N>>	tipo di dati UNIPOLAR<<M>>.<<N>> specifico di MVB, dove <<M>> e <<N>> sono numeri interi
bipolar<<M>>.<<N>>	tipo di dati BIPOLAR<<M>>.<<N>> specifico di MVB, dove <<M>> e <<N>> sono numeri interi

Tipi di dati del canale "dataType"

Sono supportati i seguenti tipi di dati del canale (tipi di dati di destinazione)

Denominazione	Descrizione
bytearray	dati binari di qualsiasi lunghezza predefinita
string	stringa terminata da NUL di qualsiasi lunghezza, codificata in UTF-8
bool	valore booleano
double	numero in virgola mobile a precisione doppia, di lunghezza complessiva 64 bit
float	numero in virgola mobile a precisione singola, di lunghezza complessiva 32 bit
int64	numero intero con segno di lunghezza 64 bit
int32	numero intero con segno di lunghezza 32 bit
int16	numero intero con segno di lunghezza 16 bit
int8	numero intero con segno di lunghezza 8 bit
uint64	numero intero senza segno di lunghezza 64 bit
uint32	numero intero senza segno di lunghezza 32 bit
uint16	numero intero senza segno di lunghezza 16 bit
uint8	numero intero senza segno di lunghezza 8 bit

Informazioni sul modulo

Informazione	Valore
Autori	optiMEAS GmbH
da smartCORE	0.2
Tipo di modulo	Producer
Dipendenze	adattatore MVB supportato