Module smartCORE GPS
Description
Le module « gps » lit et interprète les messages GPS provenant d'une interface série et produit des données GPS dans les smartCHANNELs correspondants.
La position GPS (latitude, longitude et altitude géographique) est alors produite regroupée dans une structure prévue à cet effet.
Interfaces et protocoles utilisés
- NMEA 0183
Configuration JSON
La section suivante décrit l'ensemble de la configuration JSON du module et explique chacun des paramètres.
Exemple de configuration (minimale)
{
"module": "GPS",
"factory": "gps",
"config":
{
}
}
Exemple de configuration (maximale) (communication avec le serveur 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"
}
}
Exemple de configuration (maximale) (communication série directe, lorsqu'elle est prévue)
{
"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"
}
}
Exemple de configuration (maximale, à des fins de compatibilité) (communication série directe, lorsqu'elle est prévue)
Remarque : une seule « nmeaInterface » est prise en charge.
{
"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"
}
]
}
}
Liste des paramètres
| Nom du paramètre | Requis | Type de données | Plage de valeurs pertinente | Défaut | Description |
|---|---|---|---|---|---|
| rtPriority | Non | INT | 1 - 99 | 80 | Priorité de la lecture de l'interface série * |
| inBufferSize | Non | INT | 1 - | 1024 | Tampon [octets] pour la lecture de l'interface série * |
| outBufferSize | Non | INT | 1 - | 1024 | Tampon [échantillons] pour les smartCHANNELs à produire |
| productionIntervalMs | Non | INT | 1 - | 1000 | Intervalle d'interrogation [ms] pour la production d'échantillons dans les smartCHANNELs |
| process2dFixes | Non | BOOL | false, true | false | Mise à disposition de positions GPS sur la base de fix GPS 2D, l'altitude au-dessus du niveau de la mer étant reprise du dernier fix GPS 3D valide |
| posFixModeStabilizationTimeMs | Non | INT | 1 - | 0 | Temps de stabilisation pendant lequel le mode de fix de position requis doit être présent pour que la position GPS et la vitesse soient produites *** |
| nmeaInterfaces | Non | Tableau JSON d'objets JSON | Configuration des interfaces NMEA 0183 ** |
* uniquement pour la communication série directe
** uniquement à des fins de compatibilité
*** uniquement avec la communication GPSD
Configuration des interfaces NMEA 0183
Les interfaces NMEA 0183 sont configurées chacune sous forme d'objet JSON. Ces paramètres peuvent aussi être indiqués directement dans la configuration et sont les suivants :
| Nom du paramètre | Requis | Type de données | Plage de valeurs pertinente | Défaut | Description | |
|---|---|---|---|---|---|---|
| name | Non | String | "nmea0" | Nom de l'adaptateur NMEA | ||
| host | Non | String | hôte valide | "localhost" | Hôte du serveur GPSD (communication TCP) ou "" (communication SHM) * | |
| port | Non | INT | port valide | 2947 | Port du serveur GPSD (ignoré pour la communication SHM) * | |
| deviceType | Non | String | "generic","smartmini","smartrail","smartminis" | détecté automatiquement | Type d'appareil de l'adaptateur NMEA ** | |
| device | Non | String | Fichier de périphérique existant | détecté automatiquement | Fichier de périphérique de l'adaptateur NMEA ** | |
| baudRate | Non | INT | Débit en bauds valide | 115200 | Débit en bauds de l'adaptateur NMEA ** | |
| updateIntervalMs | Non | INT | 1000 - (smartMINI S), 200 - (avec satelliteSystem: "GPS_GLONASS_GALILEO"), sinon 100 - | 1000 (smartMINI S), sinon 100 | Intervalle d'actualisation [ms] des NMEA Sentences | |
| satelliteSystem | Non | String | "GPS", "GLONASS", "GALILEO", "BEIDOU", "GPS_GLONASS", "GPS_GALILEO", "GPS_BEIDOU", "GPS_GLONASS_GALILEO" | "GPS_GLONASS" | Système de satellites à utiliser pour la localisation | Disponible uniquement sur smartMINI et smartRAIL. |
| rebootIntervalMs | Non | INT | 1 - | 3600000 | Intervalle [ms] après lequel un redémarrage de l'appareil est effectué au plus tôt en cas d'absence de connexion GPSD * | |
| gpsLocationChannelName | Non | String | [nom de l'instance du module]".Location" | smartCHANNEL pour la structure de données de position (longitude/latitude/altitude) | ||
| gpsSpeedOverGroundChannelName | Non | String | [nom de l'instance du module]".SpeedOverGround" | smartCHANNEL pour la Speed over Ground [km/h] | ||
| gpsSatelliteCountChannelName | Non | String | [nom de l'instance du module]".SatelliteCount" | smartCHANNEL pour le nombre de satellites actuellement utilisés | ||
| gpsPositionFixModeChannelName | Non | String | [nom de l'instance du module]".PositionFixMode" | smartCHANNEL pour le mode de détermination de la position | ||
| gpsHDOPChannelName | Non | String | [nom de l'instance du module]".HDOP" | smartCHANNEL pour le H DOP | ||
| gpsPDOPChannelName | Non | String | [nom de l'instance du module]".PDOP" | smartCHANNEL pour le P DOP | ||
| gpsVDOPChannelName | Non | String | [nom de l'instance du module]".VDOP" | smartCHANNEL pour le V DOP | ||
| speedLimit | Non | INT | AUCUN défaut (illimité) | filtrage/rejet complet des vitesses supérieures à la valeur réglée |
* uniquement avec l'utilisation de GPSD
** uniquement pour la communication série directe
Informations sur le module
| Information | Valeur |
|---|---|
| Auteur | optiMEAS GmbH |
| depuis smartCORE | 0.8 |
| Type de module | Producer |
| Dépendances | AUCUNE |