Merge pull request #142 from dotMorten/dotMorten/fixstatus

Add gnssfix valid status and whether differential has been applied

Author: PaulZC

src/SparkFun_Ublox_Arduino_Library.cpp

@@ -982,6 +982,8 @@ void SFE_UBLOX_GPS::processUBXpacket(ubxPacket *msg)
       gpsNanosecond = extractLong(16); //Includes milliseconds
 
       fixType = extractByte(20 - startingSpot);
+      gnssFixOk = extractByte(21 - startingSpot) & 0x1; //Get the 1st bit
+      diffSoln = extractByte(21 - startingSpot) >> 1 & 0x1; //Get the 2nd bit
       carrierSolution = extractByte(21 - startingSpot) >> 6; //Get 6th&7th bits of this byte
       SIV = extractByte(23 - startingSpot);
       longitude = extractLong(24 - startingSpot);
@@ -1005,6 +1007,8 @@ void SFE_UBLOX_GPS::processUBXpacket(ubxPacket *msg)
       moduleQueried.gpsNanosecond = true;
 
       moduleQueried.all = true;
+      moduleQueried.gnssFixOk = true;
+      moduleQueried.diffSoln = true;
       moduleQueried.longitude = true;
       moduleQueried.latitude = true;
       moduleQueried.altitude = true;
@@ -3548,6 +3552,28 @@ uint8_t SFE_UBLOX_GPS::getFixType(uint16_t maxWait)
   return (fixType);
 }
 
+//Get whether we have a valid fix (i.e within DOP & accuracy masks)
+bool SFE_UBLOX_GPS::getGnssFixOk(uint16_t maxWait)
+{
+  if (moduleQueried.gnssFixOk == false)
+    getPVT(maxWait);
+  moduleQueried.gnssFixOk = false; //Since we are about to give this to user, mark this data as stale
+  moduleQueried.all = false;
+
+  return (gnssFixOk);
+}
+
+//Get whether differential corrections were applied
+bool SFE_UBLOX_GPS::getDiffSoln(uint16_t maxWait)
+{
+  if (moduleQueried.diffSoln == false)
+    getPVT(maxWait);
+  moduleQueried.diffSoln = false; //Since we are about to give this to user, mark this data as stale
+  moduleQueried.all = false;
+
+  return (diffSoln);
+}
+
 //Get the carrier phase range solution status
 //Useful when querying module to see if it has high-precision RTK fix
 //0=No solution, 1=Float solution, 2=Fixed solution
@@ -3680,6 +3706,8 @@ void SFE_UBLOX_GPS::flushPVT()
   moduleQueried.gpsNanosecond = false;
 
   moduleQueried.all = false;
+  moduleQueried.gnssFixOk = false;
+  moduleQueried.diffSoln = false;
   moduleQueried.longitude = false;
   moduleQueried.latitude = false;
   moduleQueried.altitude = false;

src/SparkFun_Ublox_Arduino_Library.h

@@ -509,6 +509,8 @@ class SFE_UBLOX_GPS
 	void flushHPPOSLLH();																				//Mark all the PVT data as read/stale. This is handy to get data alignment after CRC failure
   void flushDOP();                                       //Mark all the DOP data as read/stale. This is handy to get data alignment after CRC failure
 
+	bool getGnssFixOk(uint16_t maxWait = getPVTmaxWait);          //Get whether we have a valid fix (i.e within DOP & accuracy masks)
+	bool getDiffSoln(uint16_t maxWait = getPVTmaxWait);           //Get whether differential corrections were applied
 	int32_t getLatitude(uint16_t maxWait = getPVTmaxWait);			  //Returns the current latitude in degrees * 10^-7. Auto selects between HighPrecision and Regular depending on ability of module.
 	int32_t getLongitude(uint16_t maxWait = getPVTmaxWait);			  //Returns the current longitude in degrees * 10-7. Auto selects between HighPrecision and Regular depending on ability of module.
 	int32_t getAltitude(uint16_t maxWait = getPVTmaxWait);			  //Returns the current altitude in mm above ellipsoid
@@ -700,6 +702,9 @@ class SFE_UBLOX_GPS
 	bool gpsDateValid;
 	bool gpsTimeValid;
 
+
+	bool gnssFixOk;      //valid fix (i.e within DOP & accuracy masks)
+	bool diffSoln;       //Differential corrections were applied
 	int32_t latitude;		 //Degrees * 10^-7 (more accurate than floats)
 	int32_t longitude;		 //Degrees * 10^-7 (more accurate than floats)
 	int32_t altitude;		 //Number of mm above ellipsoid
@@ -897,6 +902,8 @@ uint16_t eastingDOP; // Easting dilution of precision * 10^-2
 		uint32_t gpsNanosecond : 1;
 
 		uint32_t all : 1;
+		uint32_t gnssFixOk : 1;
+		uint32_t diffSoln : 1;
 		uint32_t longitude : 1;
 		uint32_t latitude : 1;
 		uint32_t altitude : 1;