QGIS/external/nmea/info.h
Jürgen Fredriksson 4ca7cd3d63
More detail on GGA quality indicator (#38234)
- UPDATE mTxtAltitude, mTxtHacc and mTxtVacc because GNSS receivers can output higher accuracy! (RTK)

According to https://www.gpsinformation.org/dale/nmea.htm#GGA I suggest an update to the quality information for the GGA sentence.
Since RTK solutions become more and more standard the info.quality "Fix RTK" is a very important information!
2020-09-01 14:28:21 +10:00

137 lines
4.2 KiB
C

/*
* Copyright Tim (xtimor@gmail.com)
*
* NMEA library is free software; you can redistribute it and/or modify
* it under the terms of the GNU Lesser General Public License as published by
* the Free Software Foundation; either version 2 of the License, or
* (at your option) any later version.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public License
* along with this program. If not, see <http://www.gnu.org/licenses/>
*/
/*
*
* NMEA library
* URL: http://nmea.sourceforge.net
* Author: Tim (xtimor@gmail.com)
* Licence: http://www.gnu.org/licenses/lgpl.html
* $Id: info.h 10 2007-11-15 14:50:15Z xtimor $
*
*/
//! \file
#ifndef NMEA_INFO_H
#define NMEA_INFO_H
#include "nmeatime.h"
#define NMEA_SIG_BAD (0)
#define NMEA_SIG_LOW (1)
#define NMEA_SIG_MID (2)
#define NMEA_SIG_HIGH (3)
#define NMEA_FIX_BAD (1)
#define NMEA_FIX_2D (2)
#define NMEA_FIX_3D (3)
#define NMEA_MAXSAT (12)
#define NMEA_SATINPACK (4)
#define NMEA_NSATPACKS (NMEA_MAXSAT / NMEA_SATINPACK)
#define NMEA_DEF_LAT (5001.2621)
#define NMEA_DEF_LON (3613.0595)
#ifdef __cplusplus
extern "C"
{
#endif
/**
* Position data in fractional degrees or radians
*/
typedef struct _nmeaPOS
{
double lat; //!< Latitude
double lon; //!< Longitude
} nmeaPOS;
/**
* Information about satellite
* \see nmeaSATINFO
* \see nmeaGPGSV
*/
typedef struct _nmeaSATELLITE
{
int id; //!< Satellite PRN number
int in_use; //!< Used in position fix
int elv; //!< Elevation in degrees, 90 maximum
int azimuth; //!< Azimuth, degrees from true north, 000 to 359
int sig; //!< Signal, 00-99 dB
} nmeaSATELLITE;
/**
* Information about all satellites in view
* \see nmeaINFO
* \see nmeaGPGSV
*/
typedef struct _nmeaSATINFO
{
int inuse; //!< Number of satellites in use (not those in view)
int inview; //!< Total number of satellites in view
nmeaSATELLITE sat[NMEA_MAXSAT]; //!< Satellites information
} nmeaSATINFO;
/**
* Summary GPS information from all parsed packets,
* used also for generating NMEA stream
* \see nmea_parse
* \see nmea_GPGGA2info, nmea_...2info
*/
typedef struct _nmeaINFO
{
int smask; //!< Mask specifying types of packages from which data have been obtained
nmeaTIME utc; //!< UTC of position
int sig; //!< GPS quality indicator (0 = Invalid; 1 = Fix; 2 = Differential, 3 = Sensitive)
int fix; //!< Operating mode, used for navigation (1 = Fix not available; 2 = 2D; 3 = 3D)
double PDOP; //!< Position Dilution Of Precision
double HDOP; //!< Horizontal Dilution Of Precision
double VDOP; //!< Vertical Dilution Of Precision
double lat; //!< Latitude in NDEG - +/-[degree][min].[sec/60]
double lon; //!< Longitude in NDEG - +/-[degree][min].[sec/60]
double elv; //!< Antenna altitude above/below mean sea level (geoid) in meters
double speed; //!< Speed over the ground in kilometers/hour
double direction; //!< Track angle in degrees True
double declination; //!< Magnetic variation degrees (Easterly var. subtracts from true course)
double rms_pr; //!< RMS value of the pseudorange residuals; includes carrier phase residuals during periods of RTK (float) and RTK (fixed) processing
double err_major; //!< Error ellipse semi-major axis 1 sigma error, in meters
double err_minor; //!< Error ellipse semi-minor axis 1 sigma error, in meters
double err_ori; //!< Error ellipse orientation, degrees from true north
double sig_lat; //!< Latitude 1 sigma error, in meters
double sig_lon; //!< Longitude 1 sigma error, in meters
double sig_alt; //!< Height 1 sigma error, in meters
nmeaSATINFO satinfo; //!< Satellites information
} nmeaINFO;
void nmea_zero_INFO( nmeaINFO *info );
#ifdef __cplusplus
}
#endif
#endif /* NMEA_INFO_H */