Qt Positioning Complemento NMEA
Descripción general
Qt Positioning incluye un complemento de posición que analiza las frases NMEA para obtener actualizaciones de posición. Este complemento puede utilizar un puerto serie, un socket o un archivo como fuente.
Este complemento se puede cargar utilizando el nombre de proveedor «nmea».
Parámetros
La siguiente tabla enumera los parámetros que se pueden pasar al complemento nmea.
| Parámetro | Descripción |
|---|---|
| nmea.source | La fuente que se utilizará para obtener datos NMEA. |
| nmea.baudrate | La velocidad de transmisión que utilizará la conexión del puerto serie, expresada como un número entero positivo. Normalmente debe ser uno de los valores de la enumeración QSerialPort::BaudRate. Si no se especifica el parámetro o no contiene un número entero positivo, se utiliza el valor por defecto de 4800. |
| nmea.satellite_info_simulation_interval | El intervalo para leer los datos de información de los satélites del archivo en modo de simulación. |
Las diferentes fuentes requieren distintas formas de proporcionar los datos. La siguiente tabla enumera las diferentes formas de proporcionar el parámetro « nmea.source » para entradas de socket, puerto serie y archivo.
| Esquema | Ejemplo | Descripción |
|---|---|---|
| socket://nombre_del_host:puerto | socket://localhost:12345 | Utiliza la palabra clave «socket:» para especificar que deseas obtener los datos NMEA desde el socket. Se creará un socket TCP, que intentará conectarse al host hostname utilizando el puerto port. Una vez establecida la conexión, se espera recibir un flujo de texto NMEA desde el servidor. |
| serial:nombre_puerto | serial:/dev/ttyUSB0 | Utiliza la palabra clave «serial:» para especificar que deseas obtener los datos NMEA desde el puerto serie. El complemento intentará establecer una conexión con el puerto portname con una velocidad de transmisión predeterminada de 4800 Bd (el valor de la velocidad de transmisión se puede especificar mediante el parámetro nmea.baudrate ). Una vez establecida la conexión, se espera recibir un flujo de texto NMEA desde el puerto serie. Si utilizas «serial:» sin indicar ningún nombre de puerto, el complemento intentará encontrar uno de los dispositivos serie conocidos mediante el identificador de fabricante. Ten en cuenta, sin embargo, que esta no es la forma recomendada de utilizar la conexión del puerto serie, ya que la lista de dispositivos conocidos es reducida y es muy probable que no incluya tu hardware. |
serial:COM1 | ||
serial: | ||
| filepath | /home/user/nmealog.txt | Utiliza «file:///» o simplemente la ruta completa del archivo para especificar la ruta a un archivo local. |
| file:///ruta_del_archivo | file:///home/user/nmealog.txt | |
| qrc:///ruta-del-archivo | qrc:///nmealog.txt | Utiliza el prefijo «qrc:///» para especificar la ruta a un archivo en los recursos de la aplicación. |
Nota: Si no se especifica el parámetro « nmea.source », el complemento intentará localizar uno de los dispositivos serie conocidos (como si se hubiera especificado « nmea.source = serial: »).
Advertencia: El esquema socket:// solo admite conexiones sin cifrar. Por lo tanto, solo es adecuado para su uso dentro de un host o a través de una red de confianza.
Ejemplo de uso de la fuente de posición
Los siguientes ejemplos muestran cómo crear un « PositionSource » NMEA utilizando diferentes fuentes de datos.
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);Nota: Una vez creado un « PositionSource », no se puede reconfigurar para utilizar otro tipo de fuente de datos.
Ejemplo de uso de la fuente de información por satélite
Además de la información de posición, el complemento NMEA también es capaz de proporcionar información sobre satélites.
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);Configuración de la velocidad de simulación personalizada
Si deseas utilizar QGeoSatelliteInfoSource para leer un archivo con flujo NMEA, también puedes emplear el parámetro adicional "nmea.satellite_info_simulation_interval". Este parámetro se utiliza para especificar la velocidad de reproducción (en milisegundos) de los mensajes de información satelital. La frecuencia mínima permitida viene especificada por ` minimumUpdateInterval()`. Si se especifica un valor menor, se ignorará. Si no se especifica ningún valor, el valor por defecto es ` qMax(100, minimumUpdateInterval())`. En tiempo de ejecución, se puede utilizar el método ` QNmeaSatelliteInfoSource::setBackendProperty()` para actualizar este parámetro.
// file
QVariantMap parameters;
parameters["nmea.source"] = "qrc:///nmealog.txt";
parameters["nmea.satellite_info_simulation_interval"] = 1000;
QGeoSatelliteInfoSource *fileSource = QGeoSatelliteInfoSource::createSource("nmea", parameters, this);Este parámetro no es aplicable a la fuente de posición, ya que el protocolo NMEA ya incluye marcas de tiempo en los mensajes de posición. Estas marcas de tiempo se utilizan para simular la frecuencia correcta de los mensajes al utilizar QGeoPositionInfoSource con un archivo como fuente de datos.
Nota: Una vez creado un « QGeoSatelliteInfoSource », no se puede reconfigurar para utilizar otro tipo de fuente de datos.
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.