Qt Positioning NMEA-Plugin

Übersicht

Qt Positioning enthält ein Positions-Plugin, das NMEA-Sätze in Positionsaktualisierungen parst. Dieses Plugin kann eine serielle Schnittstelle, einen Socket oder eine Datei als Quelle verwenden.

Dieses Plugin kann mit dem Providernamen nmea geladen werden.

Parameter

In der folgenden Tabelle sind die Parameter aufgeführt, die an das nmea-Plugin übergeben werden können.

Unterschiedliche Quellen erfordern unterschiedliche Methoden zur Bereitstellung der Daten. In der folgenden Tabelle sind die verschiedenen Möglichkeiten zur Bereitstellung der nmea.source Parameter für Socket-, serielle Port- und Dateieingänge aufgeführt.

Beispiel für die Verwendung der Positionsquelle

Die folgenden Beispiele zeigen, wie ein nmea PositionSource unter Verwendung verschiedener Datenquellen erstellt werden kann.

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

Beispiel für die Verwendung einer Satelliteninformationsquelle

Neben den Positionsdaten kann das nmea-Plugin auch Satelliteninformationen bereitstellen.

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

Einstellungen der benutzerdefinierten Simulationsgeschwindigkeit

Wenn Sie QGeoSatelliteInfoSource zum Lesen von Dateien mit NMEA-Stream verwenden möchten, können Sie auch den zusätzlichen Parameter "nmea.satellite_info_simulation_interval" verwenden. Mit diesem Parameter wird die Wiedergaberate (in Millisekunden) für die Satelliteninformationsmeldungen festgelegt. Die minimal zulässige Frequenz wird durch minimumUpdateInterval() festgelegt. Wenn Sie einen kleineren Wert angeben, wird dieser ignoriert. Wenn kein Wert angegeben wird, ist der Standardwert qMax(100, minimumUpdateInterval()). Zur Laufzeit kann die Methode QNmeaSatelliteInfoSource::setBackendProperty() verwendet werden, um diesen Parameter zu aktualisieren.

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

Dieser Parameter ist nicht auf die Positionsquelle anwendbar, da das NMEA-Protokoll bereits Zeitstempel in Positionsnachrichten enthält. Diese Zeitstempel werden verwendet, um die korrekte Nachrichtenrate zu simulieren, wenn QGeoPositionInfoSource mit einer Datei als Datenquelle verwendet wird.