Modulo smartCORE GPS

Descrizione

Il modulo "gps" legge e interpreta i messaggi GPS da un'interfaccia seriale e produce dati GPS nei corrispondenti smartCHANNEL.

La posizione GPS (latitudine, longitudine e altitudine geografica) viene prodotta riunita in una struttura appositamente prevista.

Interfacce e protocolli utilizzati

• NMEA 0183

Configurazione JSON

Nella sezione seguente viene descritta l'intera configurazione JSON del modulo e vengono illustrati i singoli parametri.

Configurazione di esempio (minima)

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

Configurazione di esempio (massima) (comunicazione con server GPSD)

    {
        "module": "GPS",
        "factory": "gps",
        "config":
        {
            "host":"localhost",
            "port":2947,
            "outBufferSize": 1024,
            "productionIntervalMs": 1000,
            "process2dFixes": false,
            "posFixModeStabilizationTimeMs": 0,
            "updateIntervalMs": 100,
            "rebootIntervalMs": 3600000,
            "gpsLocationChannelName": "GPS.Location",
            "gpsSpeedOverGroundChannelName": "GPS.SpeedOverGround",
            "gpsSatelliteCountChannelName": "GPS.SatelliteCount",
            "gpsPositionFixModeChannelName": "GPS.PositionFixMode",
            "gpsHDOPChannelName": "GPS.HDOP",
            "gpsPDOPChannelName": "GPS.PDOP",
            "gpsVDOPChannelName": "GPS.VDOP",
            "speedLimit": 280,
            "satelliteSystem": "GPS_GLONASS"
        }
    }

Configurazione di esempio (massima) (comunicazione seriale diretta, dove prevista)

    {
        "module": "GPS",
        "factory": "gps",
        "config":
        {
            "rtPriority": 80,
            "inBufferSize": 1024,
            "outBufferSize": 1024,
            "productionIntervalMs": 1000,
            "process2dFixes": false,
            "deviceType": "smartmini",
            "device": "/dev/ttymxc2",
            "baudRate": 115200,
            "updateIntervalMs": 100,
            "gpsLocationChannelName": "GPS.Location",
            "gpsSpeedOverGroundChannelName": "GPS.SpeedOverGround",
            "gpsSatelliteCountChannelName": "GPS.SatelliteCount",
            "gpsPositionFixModeChannelName": "GPS.PositionFixMode",
            "gpsHDOPChannelName": "GPS.HDOP",
            "gpsPDOPChannelName": "GPS.PDOP",
            "gpsVDOPChannelName": "GPS.VDOP"
        }
    }

Configurazione di esempio (massima, per scopi di compatibilità) (comunicazione seriale diretta, dove prevista)

Nota: è supportata una sola "nmeaInterface".

    {
        "module": "GPS",
        "factory": "gps",
        "config":
        {
            "rtPriority": 80,
            "inBufferSize": 1024,
            "outBufferSize": 1024,
            "productionIntervalMs": 1000,
            "process2dFixes": false,
            "nmeaInterfaces":
            [
                {
                    "name": "GPS.NMEA",
                    "deviceType": "smartmini",
                    "device": "/dev/ttymxc2",
                    "baudRate": 115200,
                    "updateIntervalMs": 100,
                    "gpsLocationChannel": "GPS.Location",
                    "gpsSpeedovergroundChannel": "GPS.SpeedOverGround",
                    "gpsSatcountChannel": "GPS.SatelliteCount",
                    "gpsPosfixmodeChannel": "GPS.PositionFixMode",
                    "gpsHdopChannel": "GPS.HDOP",
                    "gpsPdopChannel": "GPS.PDOP",
                    "gpsVdopChannel": "GPS.VDOP"
                }
            ]
        }
    }

Elenco dei parametri

Nome del parametro	Obbligatorio	Tipo di dati	Intervallo di valori sensato	Default	Descrizione
rtPriority	No	INT	1 - 99	80	Priorità della lettura dell'interfaccia seriale *
inBufferSize	No	INT	1 -	1024	Buffer [byte] per la lettura dell'interfaccia seriale *
outBufferSize	No	INT	1 -	1024	Buffer [campioni] per gli smartCHANNEL da produrre
productionIntervalMs	No	INT	1 -	1000	Intervallo di polling [ms] per la produzione di campioni negli smartCHANNEL
process2dFixes	No	BOOL	false, true	false	Fornitura di posizioni GPS sulla base di fix GPS 2D, con l'altitudine sul livello del mare ricavata dall'ultimo fix GPS 3D valido
posFixModeStabilizationTimeMs	No	INT	1 -	0	Tempo di stabilizzazione entro il quale deve essere presente la Position Fix Mode necessaria, affinché vengano prodotte posizione e velocità GPS ***
nmeaInterfaces	No	JSON Array di oggetti JSON			Configurazione delle interfacce NMEA 0183 **

* solo per la comunicazione seriale diretta

** solo per scopi di compatibilità

*** solo con comunicazione GPSD

Configurazione delle interfacce NMEA 0183

Le interfacce NMEA 0183 vengono configurate ciascuna come oggetto JSON. Questi parametri possono essere indicati anche direttamente nella configurazione e sono:

Nome del parametro	Obbligatorio	Tipo di dati	Intervallo di valori sensato	Default	Descrizione
name	No	String		"nmea0"	Nome dell'adattatore NMEA
host	No	String	host valido	"localhost"	Host del server GPSD (comunicazione TCP) oppure "" (comunicazione SHM) *
port	No	INT	porta valida	2947	Porta del server GPSD (ignorata per la comunicazione SHM) *
deviceType	No	String	"generic","smartmini","smartrail","smartminis"	rilevato automaticamente	Tipo di dispositivo dell'adattatore NMEA **
device	No	String	File di dispositivo esistente	rilevato automaticamente	File di dispositivo dell'adattatore NMEA **
baudRate	No	INT	Baud rate valida	115200	Baud rate dell'adattatore NMEA **
updateIntervalMs	No	INT	1000 - (smartMINI S), 200 - (con satelliteSystem: "GPS_GLONASS_GALILEO"), altrimenti 100 -	1000 (smartMINI S), altrimenti 100	Intervallo di aggiornamento [ms] delle NMEA Sentences
satelliteSystem	No	String	"GPS", "GLONASS", "GALILEO", "BEIDOU", "GPS_GLONASS", "GPS_GALILEO", "GPS_BEIDOU", "GPS_GLONASS_GALILEO"	"GPS_GLONASS"	Quale sistema satellitare utilizzare per la localizzazione	Disponibile solo su smartMINI e smartRAIL.
rebootIntervalMs	No	INT	1 -	3600000	Intervallo [ms] dopo il quale viene eseguito al più presto il riavvio del dispositivo in assenza di connessione GPSD *
gpsLocationChannelName	No	String		[Nome dell'istanza del modulo]".Location"	smartCHANNEL per la struttura dei dati di posizione (longitudine/latitudine/altitudine)
gpsSpeedOverGroundChannelName	No	String		[Nome dell'istanza del modulo]".SpeedOverGround"	smartCHANNEL per Speed over Ground [km/h]
gpsSatelliteCountChannelName	No	String		[Nome dell'istanza del modulo]".SatelliteCount"	smartCHANNEL per il numero di satelliti attualmente utilizzati
gpsPositionFixModeChannelName	No	String		[Nome dell'istanza del modulo]".PositionFixMode"	smartCHANNEL per la modalità di determinazione della posizione
gpsHDOPChannelName	No	String		[Nome dell'istanza del modulo]".HDOP"	smartCHANNEL per H DOP
gpsPDOPChannelName	No	String		[Nome dell'istanza del modulo]".PDOP"	smartCHANNEL per P DOP
gpsVDOPChannelName	No	String		[Nome dell'istanza del modulo]".VDOP"	smartCHANNEL per V DOP
speedLimit	No	INT		NESSUN default (illimitato)	esclusione/scarto completo delle velocità superiori al valore impostato

* solo con l'uso di GPSD

** solo per la comunicazione seriale diretta

Informazioni sul modulo

Informazione	Valore
Autore	optiMEAS GmbH
da smartCORE	0.8
Tipo di modulo	Producer
Dipendenze	NESSUNA