Zum Hauptinhalt springen

MVB smartCORE Modul

Beschreibung​

Das "mvb" Modul ließt Daten von duagon MVB Schnittstellen und produziert diese in smartCHANNELs. Zu den unterstützten Schnittstellen zählen

  • die D503 MVB to Ethernet Box (extern via UDP)
  • die generische Übertragung von MVB Ports via UDP

Verwendete Schnittstellen & Protokolle​

  • Multifunctional Vehicle Bus (MVB)

JSON-Konfiguration​

Im folgenden Abschnitt soll die gesamte JSON-Konfiguration des Moduls beschrieben und die einzelnen Parameter erläutert werden.

Beispielkonfiguration (minimal / UDP)​

Im Folgenden sei eine MVB Beispielkonfiguration mit einem UDP Interface dargestellt:

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

Beispielkonfiguration (maximal / UDP)​

Im Folgenden sei eine MVB Beispielkonfiguration mit einem UDP Interface dargestellt:

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

Globale Modulparameter​

ParameternameErforderlichDatentypsinnvoller WertebereichDefaultBeschreibung
rtPriorityNeinINT1 - 8080Prioriät des Lesethreads
outBufferSizeNeinINT1 -1024Puffergröße der angelegten Kanäle
channelPrefixNeinSTRINGKanal Präfix (sinnvoll, wenn mehrere DBC Module verwendet werden und die DBC Dateien überlappende Kanalnamen besitzen)
namespaceNeinARRAY [ STRING ]Kanal Präfix in Form hierarchisch verketteter Namespaces
readFreshDataOnlyNeinBOOLtrueLesen nur aktueller Daten vom MVB Bus
produceOnChangeOnlyNeinBOOLtrueProduktion nur bei Datenveränderung
udpInterfacesJAJSON ArrayKonfiguration der UDP Schnittstellen (siehe unten)
channelsJAJSON ArrayKonfiguration der smartCHANNELs (siehe unten)

Konfiguration UDP Schnittstellen​

ParameternameErforderlichDatentypsinnvoller WertebereichDefaultBeschreibung
nameJASTRINGName der MVB Schnittstelle
typeJASTRING"generic"Typ der MVB Schnittstelle
udpDestinationPortJAINT0 - 65535Port für MVB UDP Paketempfang
mvbPortsJAJSON ArraySpezifikation der zu empfangenden MVB Ports

Konfiguration MVB Ports​

ParameternameErforderlichDatentypsinnvoller WertebereichDefaultBeschreibung
addressJAUINT160 - 65535MVB Port Adresse
sizeJAUINT81 - 32MVB Port Größe in Bytes
cycleTimeJAUINT160 - 65535MVB Zykluszeit in Millisekunden

Konfiguration Channels​

ParameternameErforderlichDatentypsinnvoller WertebereichDefaultBeschreibung
nameJASTRINGeindeutiger KanalnameKanalname
dataTypeJASTRINGgültiger Kanaldatentyp(Ziel-)Datentyp (siehe unten)
outBufferSizeNeinINT1 -1024Puffergröße des angelegten Kanals
physicalDimensionNeinSTRINGPhysikalische Größe
physicalUnitNeinSTRINGPhysikalische Einheit
scaleNeinFLOAT> 0.01.0Wertskalierung
offsetNeinFLOAT0.0Wertoffset
mvbPortJAINT0 - 4095MVB Port
bitOffsetJAINT0 -Offset des Wertes im MVB Port
bitLengthJAINT1 -Länge des Wertes im MVB Port (0 bei variabler Länge, z.B. bytearray oder string))
imageTypeJASTRINGgültiger Quelldatentypsiehe unten

Quelldatentypen "imageType"​

Folgende Datentypen können aus dem MVB Port extrahiert werden.

BezeichnungBeschreibung
signedvorzeichenbehaftete Ganzzahl der Länge von "bitLength" BITS
unsignedvorzeichenlose Ganzzahl der Länge von "bitLength" BITS, Boole'sche Werte können als "unsigned" der Länge von 1 Bit betrachtet werden
floatFließkommazahl entweder einfacher ("bitLength==32") oder doppelter Genauigkeit ("bitLength==64")
bytearraybinäre Daten der Länge "bitLength"
stringZeichenketten der Länge "bitLength"
timedate48MVB-spezifischer TIMEDATE48 Zeitstempel
time64MVB-spezifischer TIME64 Zeitstempel
unipolar<<M>>.<<N>>MVB-spezifischer UNIPOLAR<<M>>.<<N>> Datentyp, wobei <<M>> und <<N>> Ganzzahlen sind
bipolar<<M>>.<<N>>MVB-spezifischer BIPOLAR<<M>>.<<N>> Datentyp, wobei <<M>> und <<N>> Ganzzahlen sind

Kanaldatentypen "dataType"​

Folgende Kanaldatentypen (Zieldatentypen) werden unterstützt

BezeichnungBeschreibung
bytearraybinäre Daten beliebiger vorgegebener Länge
stringNUL terminierter String beliebieger Länge als UTF-8 kodiert
boolBoole'scher Wert
doubleFließkommazahl doppelter Genauigkeit der Gesamtlänge von 64-bit
floatFließkommazahl einfacher Genauigkeit der Gesamtlänge von 32-bit
int64vorzeichenbehaftete Ganzzahl der Länge von 64-bit
int32vorzeichenbehaftete Ganzzahl der Länge von 32-bit
int16vorzeichenbehaftete Ganzzahl der Länge von 16-bit
int8vorzeichenbehaftete Ganzzahl der Länge von 8-bit
uint64vorzeichenlose Ganzzahl der Länge von 64-bit
uint32vorzeichenlose Ganzzahl der Länge von 32-bit
uint16vorzeichenlose Ganzzahl der Länge von 16-bit
uint8vorzeichenlose Ganzzahl der Länge von 8-bit

Modul-Informationen​

InformationWert
AutorenoptiMEAS Measurement and Automation Systems GmbH
seit smartCORE0.2
ModultypProducer
Abhängigkeitenunterstützter MVB Adapter