Merging PR 14.

Author: nseidle

README.md

@@ -27,6 +27,7 @@ Thanks to:
 * We are always interested in adding SPI support with a checkUbloxSPI() function
 * [trycoon](https://github.com/sparkfun/SparkFun_Ublox_Arduino_Library/pull/7) for fixing the lack of I2C buffer length defines
 * [tve](https://github.com/tve) for building out serial additions and examples
+* [Redstoned](https://github.com/Redstoned) and [davidallenmann](https://github.com/davidallenmann) for adding PVT date and time
 
 Need a library for the Ublox and Particle? Checkout the [Particle library](https://github.com/aseelye/SparkFun_Ublox_Particle_Library) fork.
 

examples/Example15_GetDateTime/Example15_GetDateTime.ino

@@ -0,0 +1,95 @@
+/*
+  Getting time and date using Ublox commands
+  By: davidallenmann
+  SparkFun Electronics
+  Date: April 16th, 2019
+  License: MIT. See license file for more information but you can
+  basically do whatever you want with this code.
+
+  This example shows how to query a Ublox module for the current time and date. We also
+  turn off the NMEA output on the I2C port. This decreases the amount of I2C traffic 
+  dramatically.
+
+  Leave NMEA parsing behind. Now you can simply ask the module for the datums you want!
+
+  Feel like supporting open source hardware?
+  Buy a board from SparkFun!
+  ZED-F9P RTK2: https://www.sparkfun.com/products/15136
+  NEO-M8P RTK: https://www.sparkfun.com/products/15005
+  SAM-M8Q: https://www.sparkfun.com/products/15106
+
+  Hardware Connections:
+  Plug a Qwiic cable into the GPS and a BlackBoard
+  If you don't have a platform with a Qwiic connection use the SparkFun Qwiic Breadboard Jumper (https://www.sparkfun.com/products/14425)
+  Open the serial monitor at 115200 baud to see the output
+*/
+
+#include <Wire.h> //Needed for I2C to GPS
+
+#include "SparkFun_Ublox_Arduino_Library.h" //http://librarymanager/All#SparkFun_Ublox_GPS
+SFE_UBLOX_GPS myGPS;
+
+long lastTime = 0; //Simple local timer. Limits amount if I2C traffic to Ublox module.
+
+void setup()
+{
+    Serial.begin(115200);
+    while (!Serial)
+        ; //Wait for user to open terminal
+    Serial.println("SparkFun Ublox Example");
+
+    Wire.begin();
+
+    if (myGPS.begin() == false) //Connect to the Ublox module using Wire port
+    {
+        Serial.println(F("Ublox GPS not detected at default I2C address. Please check wiring. Freezing."));
+        while (1)
+            ;
+    }
+
+    myGPS.setI2COutput(COM_TYPE_UBX); //Set the I2C port to output UBX only (turn off NMEA noise)
+    myGPS.saveConfiguration();        //Save the current settings to flash and BBR
+}
+
+void loop()
+{
+    //Query module only every second. Doing it more often will just cause I2C traffic.
+    //The module only responds when a new position is available
+    if (millis() - lastTime > 1000)
+    {
+        lastTime = millis(); //Update the timer
+
+        long latitude = myGPS.getLatitude();
+        Serial.print(F("Lat: "));
+        Serial.print(latitude);
+
+        long longitude = myGPS.getLongitude();
+        Serial.print(F(" Long: "));
+        Serial.print(longitude);
+        Serial.print(F(" (degrees * 10^-7)"));
+
+        long altitude = myGPS.getAltitude();
+        Serial.print(F(" Alt: "));
+        Serial.print(altitude);
+        Serial.print(F(" (mm)"));
+
+        byte SIV = myGPS.getSIV();
+        Serial.print(F(" SIV: "));
+        Serial.print(SIV);
+
+        Serial.println();
+        Serial.print(myGPS.getYear());
+        Serial.print("-");
+        Serial.print(myGPS.getMonth());
+        Serial.print("-");
+        Serial.print(myGPS.getDay());
+        Serial.print(" ");
+        Serial.print(myGPS.getHour());
+        Serial.print(":");
+        Serial.print(myGPS.getMinute());
+        Serial.print(":");
+        Serial.println(myGPS.getSecond());
+
+        Serial.println();
+    }
+}

src/SparkFun_Ublox_Arduino_Library.cpp

@@ -466,7 +466,7 @@ void SFE_UBLOX_GPS::processUBX(uint8_t incoming, ubxPacket *incomingUBX)
     //If a UBX_NAV_PVT packet comes in asynchronously, we need to fudge the startingSpot
     uint16_t startingSpot = incomingUBX->startingSpot;
     if (incomingUBX->cls == UBX_CLASS_NAV && incomingUBX->id == UBX_NAV_PVT)
-      startingSpot = 20;
+      startingSpot = 0;
     //Begin recording if counter goes past startingSpot
     if ((incomingUBX->counter - 4) >= startingSpot)
     {
@@ -501,7 +501,15 @@ void SFE_UBLOX_GPS::processUBXpacket(ubxPacket *msg)
     if (msg->id == UBX_NAV_PVT && msg->len == 92)
     {
       //Parse various byte fields into global vars
-      constexpr int startingSpot = 20; //fixed value used in processUBX
+      constexpr int startingSpot = 0; //fixed value used in processUBX
+
+      gpsYear = extractInt(4);
+      gpsMonth = extractByte(6);
+      gpsDay = extractByte(7);
+      gpsHour = extractByte(8);
+      gpsMinute = extractByte(9);
+      gpsSecond = extractByte(10);
+
       fixType = extractByte(20 - startingSpot);
       carrierSolution = extractByte(21 - startingSpot) >> 6; //Get 6th&7th bits of this byte
       SIV = extractByte(23 - startingSpot);
@@ -514,6 +522,13 @@ void SFE_UBLOX_GPS::processUBXpacket(ubxPacket *msg)
       pDOP = extractLong(76 - startingSpot);
 
       //Mark all datums as fresh (not read before)
+      moduleQueried.gpsYear = true;
+      moduleQueried.gpsMonth = true;
+      moduleQueried.gpsDay = true;
+      moduleQueried.gpsHour = true;
+      moduleQueried.gpsMinute = true;
+      moduleQueried.gpsSecond = true;
+
       moduleQueried.all = true;
       moduleQueried.longitude = true;
       moduleQueried.latitude = true;
@@ -1204,6 +1219,60 @@ uint8_t SFE_UBLOX_GPS::extractByte(uint8_t spotToStart)
   return (payloadCfg[spotToStart]);
 }
 
+//Get the current year
+uint16_t SFE_UBLOX_GPS::getYear(uint16_t maxWait)
+{
+  if (moduleQueried.gpsYear == false)
+    getPVT();
+  moduleQueried.gpsYear = false; //Since we are about to give this to user, mark this data as stale
+  return (gpsYear);
+}
+
+//Get the current month
+uint8_t SFE_UBLOX_GPS::getMonth(uint16_t maxWait)
+{
+  if (moduleQueried.gpsMonth == false)
+    getPVT();
+  moduleQueried.gpsMonth = false; //Since we are about to give this to user, mark this data as stale
+  return (gpsMonth);
+}
+
+//Get the current year
+uint8_t SFE_UBLOX_GPS::getDay(uint16_t maxWait)
+{
+  if (moduleQueried.gpsDay == false)
+    getPVT();
+  moduleQueried.gpsDay = false; //Since we are about to give this to user, mark this data as stale
+  return (gpsDay);
+}
+
+//Get the current year
+uint8_t SFE_UBLOX_GPS::getHour(uint16_t maxWait)
+{
+  if (moduleQueried.gpsHour == false)
+    getPVT();
+  moduleQueried.gpsHour = false; //Since we are about to give this to user, mark this data as stale
+  return (gpsHour);
+}
+
+//Get the current year
+uint8_t SFE_UBLOX_GPS::getMinute(uint16_t maxWait)
+{
+  if (moduleQueried.gpsMinute == false)
+    getPVT();
+  moduleQueried.gpsMinute = false; //Since we are about to give this to user, mark this data as stale
+  return (gpsMinute);
+}
+
+//Get the current year
+uint8_t SFE_UBLOX_GPS::getSecond(uint16_t maxWait)
+{
+  if (moduleQueried.gpsSecond == false)
+    getPVT();
+  moduleQueried.gpsSecond = false; //Since we are about to give this to user, mark this data as stale
+  return (gpsSecond);
+}
+
 //Get the latest Position/Velocity/Time solution and fill all global variables
 boolean SFE_UBLOX_GPS::getPVT(uint16_t maxWait)
 {