Qt Positioning Plugin NMEA

Vue d'ensemble

Le site Qt Positioning comprend un module d'extension de position qui analyse les phrases NMEA pour en faire des mises à jour de position. Ce plugin peut utiliser le port série, le socket ou un fichier comme source.

Ce plugin peut être chargé en utilisant le nom du fournisseur nmea.

Paramètres

Le tableau suivant énumère les paramètres qui peuvent être transmis au plugin nmea.

Les données doivent être fournies de différentes manières selon les sources. Le tableau suivant répertorie les différentes manières de fournir le paramètre nmea.source pour les entrées de type socket, port série et fichier.

Exemple d'utilisation de la source de position

Les exemples suivants montrent comment créer un nmea PositionSource en utilisant 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'information satellite

Outre les informations sur la position, le plugin nmea est également capable de fournir des informations sur les satellites.

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);

Paramétrage 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 permet de spécifier la fréquence de lecture (en millisecondes) des messages d'information sur les satellites. La fréquence minimale autorisée est spécifiée par minimumUpdateInterval(). Si vous spécifiez une valeur inférieure, elle sera ignorée. Si aucune valeur n'est spécifiée, la valeur par défaut est qMax(100, minimumUpdateInterval()). Au moment 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 n'est pas applicable à la source de position car le protocole NMEA contient déjà des horodatages dans les messages de position. Ces horodatages sont utilisés pour simuler le taux de messages correct lors de l'utilisation de QGeoPositionInfoSource avec un fichier comme source de données.