Modulo Playback "playback"

Descrizione

warning

Il modulo "playback" deve essere utilizzato esclusivamente per test di sistema e unit test. L'impiego in un ambiente di produzione non è consentito!

Serve alla produzione temporalmente corretta dei dati specificati all'interno di un file di playback. Utilizza a tal fine l'API uniforme per la configurazione dei canali di smartCORE e può quindi essere impiegato non solo per testare moduli consumatori, ma anche per testare lo stesso smartCORE (ad es. il filtraggio dei dati).

La produzione avviene per blocchi di dati completi, definiti sulla base di una griglia con precisione al microsecondo.

Interfacce e protocolli utilizzati

• NESSUNO

Configurazione JSON

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

Per la configurazione dei canali specificati all'interno di "channels" si rimanda alla documentazione sulla configurazione uniforme dei canali.

Configurazione di esempio (tipica configurazione minima)

    {
      "module":"Playback",
      "factory":"playback",
      "config":{
        "channels":[
          {
              "channelType": "timestamped",
              "name": "Some Speed",
              "physicalUnit": "km/h",
              "dataType": "float",
              "bufferSize": 10,
              "cacheSize": 0,
              "filter": [
                  {
                      "name": "datareduction",
                      "absTolerance": 0,
                      "timeoutMs": 10000
                  }
              ]
          },
          {
              "channelType": "timestamped",
              "name": "Some Revs",
              "physicalUnit": "1/min",
              "dataType": "float"
          },
          {
              "channelType": "timestamped",
              "name": "Some GPS Location",
              "dataType": "gpslocation"
          },

          < More channel specifications >

        ]
      }
    }

Configurazione di esempio (tipica configurazione massima)

    {
      "module":"Playback",
      "factory":"playback",
      "config":{
        "gridUs": 5000,
        "decimalSep": ".",
        "structureSep": " ",
        "fieldSep": ",",
        "numCycles": 1,
        "exitOnEnd": false,
        "exitDelay": 0,
        "timebase": "absolute",
        "channels":[

          < Channel specifications >

        ]
      }
    }

Struttura di un file di playback

Il formato di un file di playback corrisponde in linea di principio a quello di un file CSV, con separatori decimali, di struttura e di campo liberamente configurabili (a eccezione di '='). Tuttavia, per migliorare l'aspetto, NON sono ammessi più separatori consecutivi.

Se nel file di configurazione manca completamente la configurazione di tutti i separatori, viene eseguito un rilevamento automatico (per la compatibilità con i file CSV esportati da Excel, sia con localizzazione inglese sia tedesca).

I valori temporali nella prima colonna di questo file sono da intendersi come secondi (facoltativamente con frazioni di secondo, separate dal separatore decimale "decimalSep"). Tutti i caratteri separatori devono essere inseriti correttamente ovvero sottoposti a "escape".

Esempi di file di playback

Zeit [s];Geschwindigkeit;Drehzahl;GPS Position
0,7;60;1500
1,4;85;;60,123456 18,111222333 123,4
2,8;100;2200

Time [s],Speed,Revs,GPS Location
0.7,60,1500
1.4,85,,60.123456 18.111222333 123.4
2.8,100,2200

Parametri globali del modulo

Nome del parametro	Obbligatorio	Tipo di dati	Intervallo di valori consigliato	Default	Descrizione
gridUs	No	INT	1 -	5000 (5 ms)	Passo temporale della griglia per la suddivisione in blocchi di dati da produrre
decimalSep	No	STRING	"."	"."	Separatore decimale all'interno dei numeri in virgola mobile (*)
structureSep	No	STRING	" "	" "	Separatore per impostare più valori di una struttura (ad es. GPS Location) (*)
fieldSep	No	STRING	","	","	Separatore tra più canali da produrre contemporaneamente (*)
numCycles	No	INT	-1, 1 -	1	per la ripetizione multipla (ovvero infinita con -1) del file di playback
exitOnEnd	No	BOOL	false, true	false	Arresto di smartCORE al termine di tutti i cicli di produzione
exitDelay	No	INT	1 -	0	Ritardo prima dell'arresto di smartCORE
timebase	No	STRING	"absolute", "relative"	"absolute"	Base temporale dei timestamp dei dati di misura prodotti ("absolute" per risultati riproducibili)
channels	SÌ	JSON Array of JSON Objects			vedere sotto

(*) se TUTTI i parametri 'decimalSep', 'structureSep' e 'fieldSep' non sono definiti, i separatori vengono rilevati automaticamente. Inoltre NON è possibile utilizzare '=' come separatore.

Configurazione di un canale (JSON Object all'interno di "channels")

Questo è soltanto un estratto (per maggiori dettagli consultare la documentazione sulla configurazione uniforme dei canali).

Nome del parametro	Obbligatorio	Tipo di dati	Intervallo di valori consigliato	Default	Descrizione
name	SÌ	STRING			Nome del canale
channelType	SÌ	STRING	"timestamped", "singlevalue"		Tipo di canale
dataType	SÌ	STRING	vedere sotto		Tipo di dati del canale
bufferSize	No	INT	1 -	1024	Dimensione del buffer del canale creato
physicalUnit	No	STRING			unità fisica

Tipi di dati del canale supportati 'dataType'

• string (codificata in UTF-8)
• bytearray (codificato in HEX SENZA prefisso)
• double
• float
• int64, int32, int16, int8
• uint64, uint32, uint16, uint8
• bool
• gpslocation (tre valori float separati dal separatore di struttura)

Informazioni sul modulo

Informazione	Valore
Autori	optiMEAS GmbH
da smartCORE	2.3
Tipo di modulo	Producer
Dipendenze	NESSUNA