Qt Positioning Plugin NMEA

Présentation

Qt Positioning intègre un plugin de position qui analyse les phrases NMEA pour en extraire les mises à jour de position. Ce plugin peut utiliser un port série, un socket ou un fichier comme source.

Ce plugin peut être chargé en utilisant le nom de fournisseur « nmea ».

Paramètres

Le tableau suivant répertorie les paramètres pouvant être transmis au plug-in nmea.

Les différentes sources nécessitent des méthodes différentes pour fournir les données. Le tableau suivant répertorie les différentes façons de fournir le paramètre ` nmea.source ` pour les entrées via socket, port série et fichier.

Exemple d’utilisation de la source de position

Les exemples suivants montrent comment créer une PositionSource NMEA à l’aide de différentes sources de données.

QML

// text file
PositionSource {
    name: "nmea"
    PluginParameter { name: "nmea.source"; value: "qrc:///nmealog.txt" }
}

// socket
PositionSource {
    name: "nmea"
    PluginParameter { name: "nmea.source"; value: "socket://localhost:22222" }
}

// serial port
PositionSource {
    name: "nmea"
    PluginParameter { name: "nmea.source"; value: "serial:/dev/ttyACM0" }
    PluginParameter { name: "nmea.baudrate"; value: 4800 }
}

C

// text file
QVariantMap params;
params["nmea.source"] = "qrc:///nmealog.txt";
QGeoPositionInfoSource *textPositionSource = QGeoPositionInfoSource::createSource("nmea", params, this);

// socket
params["nmea.source"] = "socket://localhost:22222";
QGeoPositionInfoSource *socketPositionSource = QGeoPositionInfoSource::createSource("nmea", params, this);

// serial port
params["nmea.source"] = "serial:/dev/ttyACM0";
params["nmea.baudrate"] = 4800;
QGeoPositionInfoSource *serialPositionSource = QGeoPositionInfoSource::createSource("nmea", params, this);

Exemple d'utilisation d'une source d'informations par satellite

Outre les informations de position, le plugin NMEA est également capable de fournir des informations par satellite.

QML

// serial port
SatelliteSource {
    name: "nmea"
    PluginParameter { name: "nmea.source"; value: "serial:/dev/ttyUSB0" }
    PluginParameter { name: "nmea.baudrate"; value: 9600 }
}

// socket
SatelliteSource {
    name: "nmea"
    PluginParameter { name: "nmea.source"; value: "socket://localhost:22222" }
}

C++

// serial port
QVariantMap parameters;
parameters["nmea.source"] = "serial:/dev/ttyUSB0";
params["nmea.baudrate"] = 9600;
QGeoSatelliteInfoSource *serialSource = QGeoSatelliteInfoSource::createSource("nmea", parameters, this);

// socket
parameters["nmea.source"] = "socket://localhost:22222";
QGeoSatelliteInfoSource *socketSource = QGeoSatelliteInfoSource::createSource("nmea", parameters, this);

Réglage de la vitesse de simulation personnalisée

Si vous souhaitez utiliser QGeoSatelliteInfoSource pour lire un fichier contenant un flux NMEA, vous pouvez également utiliser le paramètre supplémentaire "nmea.satellite_info_simulation_interval". Ce paramètre sert à spécifier la fréquence de lecture (en millisecondes) des messages d’informations satellite. La fréquence minimale autorisée est définie par minimumUpdateInterval(). Si vous spécifiez une valeur inférieure, celle-ci sera ignorée. Si aucune valeur n’est spécifiée, la valeur par défaut est qMax(100, minimumUpdateInterval()). Lors de l’exécution, la méthode QNmeaSatelliteInfoSource::setBackendProperty() peut être utilisée pour mettre à jour ce paramètre.

// file
QVariantMap parameters;
parameters["nmea.source"] = "qrc:///nmealog.txt";
parameters["nmea.satellite_info_simulation_interval"] = 1000;
QGeoSatelliteInfoSource *fileSource = QGeoSatelliteInfoSource::createSource("nmea", parameters, this);

Ce paramètre ne s’applique pas à la source de position, car le protocole NMEA inclut déjà des horodatages dans les messages de position. Ces horodatages sont utilisés pour simuler le débit de messages correct lors de l’utilisation de ` QGeoPositionInfoSource ` avec un fichier comme source de données.