Módulo smartCORE GPS
Descripción
El módulo "gps" lee e interpreta los mensajes GPS de una interfaz serie y produce datos GPS en los smartCHANNEL correspondientes.
La posición GPS (latitud, longitud y altitud geográfica) se produce agrupada en una estructura prevista para ello.
Interfaces y protocolos utilizados
- NMEA 0183
Configuración JSON
En la sección siguiente se describe la configuración JSON completa del módulo y se explican los distintos parámetros.
Ejemplo de configuración (mínima)
{
"module": "GPS",
"factory": "gps",
"config":
{
}
}
Ejemplo de configuración (máxima) (comunicación con el servidor 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"
}
}
Ejemplo de configuración (máxima) (comunicación serie directa, donde esté 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"
}
}
Ejemplo de configuración (máxima, por motivos de compatibilidad) (comunicación serie directa, donde esté prevista)
Nota: solo se admite una única "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"
}
]
}
}
Lista de parámetros
| Nombre del parámetro | Obligatorio | Tipo de datos | Rango de valores recomendado | Valor predeterminado | Descripción |
|---|---|---|---|---|---|
| rtPriority | No | INT | 1 - 99 | 80 | Prioridad de la lectura de la interfaz serie * |
| inBufferSize | No | INT | 1 - | 1024 | Búfer [bytes] para la lectura de la interfaz serie * |
| outBufferSize | No | INT | 1 - | 1024 | Búfer [muestras] para los smartCHANNEL que se van a producir |
| productionIntervalMs | No | INT | 1 - | 1000 | Intervalo de sondeo [ms] para la producción de muestras en los smartCHANNEL |
| process2dFixes | No | BOOL | false, true | false | Suministro de posiciones GPS a partir de fixes GPS 2D, obteniendo la altitud sobre el nivel del mar del último fix GPS 3D válido |
| posFixModeStabilizationTimeMs | No | INT | 1 - | 0 | Tiempo de estabilización dentro del cual debe estar presente el Position Fix Mode necesario para que se produzcan la posición y la velocidad GPS *** |
| nmeaInterfaces | No | JSON Array de objetos JSON | Configuración de las interfaces NMEA 0183 ** |
* solo para comunicación serie directa
** solo por motivos de compatibilidad
*** solo con comunicación GPSD
Configuración de las interfaces NMEA 0183
Cada interfaz NMEA 0183 se configura como un objeto JSON. Estos parámetros también pueden indicarse directamente en la configuración y son los siguientes:
| Nombre del parámetro | Obligatorio | Tipo de datos | Rango de valores recomendado | Valor predeterminado | Descripción | |
|---|---|---|---|---|---|---|
| name | No | String | "nmea0" | Nombre del adaptador NMEA | ||
| host | No | String | host válido | "localhost" | Host del servidor GPSD (comunicación TCP) o "" (comunicación SHM) * | |
| port | No | INT | puerto válido | 2947 | Puerto del servidor GPSD (se ignora en la comunicación SHM) * | |
| deviceType | No | String | "generic","smartmini","smartrail","smartminis" | detectado automáticamente | Tipo de dispositivo del adaptador NMEA ** | |
| device | No | String | Archivo de dispositivo existente | detectado automáticamente | Archivo de dispositivo del adaptador NMEA ** | |
| baudRate | No | INT | Velocidad en baudios válida | 115200 | Velocidad en baudios del adaptador NMEA ** | |
| updateIntervalMs | No | INT | 1000 - (smartMINI S), 200 - (con satelliteSystem: "GPS_GLONASS_GALILEO"), en otro caso 100 - | 1000 (smartMINI S), en otro caso 100 | Intervalo de actualización [ms] de las NMEA Sentences | |
| satelliteSystem | No | String | "GPS", "GLONASS", "GALILEO", "BEIDOU", "GPS_GLONASS", "GPS_GALILEO", "GPS_BEIDOU", "GPS_GLONASS_GALILEO" | "GPS_GLONASS" | Qué sistema de satélites debe utilizarse para la localización | Solo disponible en smartMINI y smartRAIL. |
| rebootIntervalMs | No | INT | 1 - | 3600000 | Intervalo [ms] tras el cual, como pronto, se reinicia el dispositivo si falta la conexión GPSD * | |
| gpsLocationChannelName | No | String | [Nombre de la instancia del módulo]".Location" | smartCHANNEL para la estructura de datos de posición (longitud/latitud/altitud) | ||
| gpsSpeedOverGroundChannelName | No | String | [Nombre de la instancia del módulo]".SpeedOverGround" | smartCHANNEL para Speed over Ground [km/h] | ||
| gpsSatelliteCountChannelName | No | String | [Nombre de la instancia del módulo]".SatelliteCount" | smartCHANNEL para el número de satélites utilizados actualmente | ||
| gpsPositionFixModeChannelName | No | String | [Nombre de la instancia del módulo]".PositionFixMode" | smartCHANNEL para el modo de determinación de la posición | ||
| gpsHDOPChannelName | No | String | [Nombre de la instancia del módulo]".HDOP" | smartCHANNEL para H DOP | ||
| gpsPDOPChannelName | No | String | [Nombre de la instancia del módulo]".PDOP" | smartCHANNEL para P DOP | ||
| gpsVDOPChannelName | No | String | [Nombre de la instancia del módulo]".VDOP" | smartCHANNEL para V DOP | ||
| speedLimit | No | INT | SIN valor predeterminado (sin límite) | filtrado/descarte completo de las velocidades superiores al valor configurado |
* solo al utilizar GPSD
** solo para comunicación serie directa
Información del módulo
| Información | Valor |
|---|---|
| Autor | optiMEAS GmbH |
| desde smartCORE | 0.8 |
| Tipo de módulo | Producer |
| Dependencias | NINGUNA |