Modulo smartCORE "odometer"

Descrizione

Il modulo odometer ha il compito di determinare la distanza percorsa (in km) da un veicolo sulla base delle informazioni GPS. Rileva continuamente il chilometraggio e lo salva regolarmente in un file sul dispositivo, in modo che dopo un riavvio del sistema venga utilizzato il valore precedente del contachilometri. Affinché il modulo odometer funzioni correttamente, deve poter accedere alle informazioni GPS del modulo GPS. A tale scopo i nomi dei segnali GPS devono essere indicati nella configurazione. Se il modulo non li trova, non viene rilevato alcun dato!

Per il corretto funzionamento del modulo odometer, i seguenti segnali devono essere presenti e disponibili per il modulo stesso:

• segnale Location con longitudine e latitudine
• segnale PosFixMode, che indica se è presente un GPS fix (2D fix, 3D fix o nessun GPS)
• numero di satelliti del segnale GPS corrente

Se si utilizza il modulo odometer, nella configurazione deve essere attivato anche il modulo GPS e devono essere indicati i relativi nomi dei segnali!

Configurazione JSON

La sezione seguente mostra l'intera configurazione JSON del modulo odometer, incluso il modulo GPS. I nomi dei segnali del modulo odometer hanno sempre come prefisso il nome del modulo ("module": "Odometer").

Configurazione minima

{
  "module": "GPS",
  "factory": "gps",
  "config": {
  }
},
{
  "module": "Odometer",
  "factory": "odometer",
  "config": {
  }
}

Esempio Dalla configurazione precedente risultano i seguenti nomi di segnale:

• "Odometer.TotalDistance"
• "GPS.PositionFixMode"
• "GPS.SatelliteCount"

Configurazione con tutti i parametri

Nota: per tutti i parametri del modulo GPS consultare la relativa documentazione.

{
  "module": "GPS",
  "factory": "gps",
  "config": {
  }
},
{
  "module": "Odometer",
  "factory": "odometer",
  "config": {
    "debugMode": false,
    "sendOdometerSettings": true,
    "minimalAvailableSatCount": 10,
    "timeoutMs": 1000,
    "toleranceRadius_km": 0.06,
    "gpsLocationChannelName": "GPS.Location",
    "gpsPositionFixModeChannelName": "GPS.PositionFixMode",
    "gpsSatelliteCountChannelName": "GPS.SatelliteCount",
    "minimalAvailableFixMode": 2,
    "distanceChannelName": "Odometer.Distance_km"
  }
}

Esempio Dalla configurazione precedente risultano i seguenti nomi di segnale:

• "Odometer.Distance_km"
• "Odometer.ToleranceRadius_km"
• "Odometer.MinSatelliteCount"
• "Odometer.MinFixMode"
• "GPS.PositionFixMode"
• "GPS.SatelliteCount"

Elenco dei parametri di configurazione

Nome del parametro	Must-Have	Tipo di dati	Valore di default	Descrizione
timeoutMs	No	int	1000	Intervallo di esecuzione del modulo in ms
debugMode	No	bool	false	Se attivo (true), nel logbook vengono scritte più informazioni.
sendOdometerSettings	No	bool	false	Se attivo (true), i parametri di impostazione (toleranceRadius_km, minimalAvailableFixMode, minimalAvailableSatCount...) vengono prodotti come segnali e sono disponibili nei file Osf e nel cloud
minimalAvailableSatCount	No	int	8	Numero minimo di satelliti del segnale GPS necessario affinché il segnale GPS sia considerato valido e il chilometraggio venga aggiornato. Se sono disponibili meno satelliti, il chilometraggio non viene incrementato. Valori ragionevoli sono compresi tra 8 e 15.
toleranceRadius_km	No	double	0.05	Distanza minima percorsa (in km) affinché il chilometraggio venga incrementato. Con il valore di default devono essere percorsi 50 metri consecutivi perché il chilometraggio aumenti. Questo comportamento serve a evitare che il jitter del segnale GPS alteri il chilometraggio.
gpsLocationChannelName	No	String	gps.Location	Nome del segnale GPS nel data pool di smartCORE con i valori di longitudine e latitudine.
gpsPositionFixModeChannelName	No	String	gps.PositionFixMode	Nome del segnale con le informazioni GPS PositionFixMode. È necessario per verificare se il segnale GPS è valido ai fini del chilometraggio.
gpsSatelliteCountChannelName	No	String	gps.SatelliteCount	Nome del segnale con il numero di satelliti del segnale GPS. È necessario per verificare se il segnale GPS è valido ai fini del chilometraggio. Se
minimalAvailableFixMode	No	int	2	Valore minimo di GPS PosFixMode necessario affinché il segnale GPS sia considerato valido e il chilometraggio venga aggiornato. I valori validi sono 2 (2D Fix) o 3 (3D Fix).
distanceChannelName	No	String	["module"].TotalDistance	Nome del segnale del chilometraggio come compare nei file Osf. L'unità è "km".

Informazioni sul modulo / scheda tecnica

Informazione	Valore
Autore	optiMEAS GmbH
Consuma segnali	Sì
Produce segnali	Sì
Versione smartCORE	>= 0.175
Dipendenze	modulo gps