Add support for automatic NMEA

Author: PaulZC

examples/Automatic_NMEA/Example1_getLatestNMEAGPGGA/Example1_getLatestNMEAGPGGA.ino

@@ -0,0 +1,125 @@
+/*
+  Get the GPGGA NMEA sentence using getLatestNMEAGPGGA
+  By: Paul Clark
+  SparkFun Electronics
+  Date: January 12th, 2021
+  License: MIT. See license file for more information but you can
+  basically do whatever you want with this code.
+
+  This example shows how to turn on/off the NMEA sentences being output over I2C.
+  It then demonstrates how to use the new getLatestNMEAGPGGA function to retrieve the latest GPGGA message.
+  getLatestNMEAGPGGA returns immediately - it is not blocking.
+  It returns:
+    0 if no data is available
+    1 if the data is valid but is stale (you have read it before)
+    2 if the data is valid and fresh
+
+  This example turns off all sentences except for GPGGA.
+
+  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 GNSS and a RedBoard
+  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 GNSS
+
+#include <SparkFun_u-blox_GNSS_Arduino_Library.h> //Click here to get the library: http://librarymanager/All#SparkFun_u-blox_GNSS
+SFE_UBLOX_GNSS myGNSS;
+
+void setup()
+{
+
+  Serial.begin(115200);
+  Serial.println(F("SparkFun u-blox GNSS Example"));
+
+  Wire.begin();
+
+  //myGNSS.enableDebugging(); // Uncomment this line to enable debug messages on Serial
+
+  if (myGNSS.begin() == false)
+  {
+    Serial.println(F("u-blox GNSS not detected at default I2C address. Please check wiring. Freezing."));
+    while (1)
+      ;
+  }
+
+  //Disable or enable various NMEA sentences over the I2C interface
+  myGNSS.setI2COutput(COM_TYPE_NMEA | COM_TYPE_UBX); // Turn on both UBX and NMEA sentences on I2C. (Turn off RTCM and SPARTN)
+  myGNSS.disableNMEAMessage(UBX_NMEA_GLL, COM_PORT_I2C); // Several of these are on by default on ublox board so let's disable them
+  myGNSS.disableNMEAMessage(UBX_NMEA_GSA, COM_PORT_I2C);
+  myGNSS.disableNMEAMessage(UBX_NMEA_GSV, COM_PORT_I2C);
+  myGNSS.disableNMEAMessage(UBX_NMEA_RMC, COM_PORT_I2C);
+  myGNSS.disableNMEAMessage(UBX_NMEA_VTG, COM_PORT_I2C);
+  myGNSS.enableNMEAMessage(UBX_NMEA_GGA, COM_PORT_I2C); // Leave only GGA enabled at current navigation rate
+
+  //myGNSS.saveConfiguration(); //Optional: Save these settings to NVM
+
+  Serial.println(F("Messages configured"));
+
+  //myGNSS.setNMEAOutputPort(Serial); // Uncomment this line to echo all NMEA data to Serial for debugging
+}
+
+void loop()
+{
+  // getLatestNMEAGPGGA calls checkUblox for us. We don't need to do it here
+
+  NMEA_GGA_data_t data; // Storage for the GPGGA data
+  uint8_t result = myGNSS.getLatestNMEAGPGGA(&data); // Get the latest GPGGA data (if any)
+  
+  if (result == 0)
+  {
+    Serial.println(F("No GPGGA data available"));
+  }
+  else if (result == 1)
+  {
+    Serial.println(F("GPGGA data is available but is stale"));
+  }
+  else if (result == 2)
+  {
+    // Data contains .length and .nmea
+    Serial.print(F("NMEA: Length: "));
+    Serial.print(data.length);
+    Serial.print(F("\tData: "));
+    Serial.println((const char *)data.nmea); // .nmea is printable (NULL-terminated)
+  }
+  else
+  {
+    Serial.print(F("result == "));
+    Serial.print(result);
+    Serial.println(F(". This should be impossible!"));
+  }
+
+  result = myGNSS.getLatestNMEAGNGGA(&data); // Get the latest GNGGA data (if any)
+  
+  if (result == 0)
+  {
+    Serial.println(F("No GNGGA data available"));
+  }
+  else if (result == 1)
+  {
+    Serial.println(F("GNGGA data is available but is stale"));
+  }
+  else if (result == 2)
+  {
+    // Data contains .length and .nmea
+    Serial.print(F("NMEA: Length: "));
+    Serial.print(data.length);
+    Serial.print(F("\tData: "));
+    Serial.println((const char *)data.nmea); // .nmea is printable (NULL-terminated)
+  }
+  else
+  {
+    Serial.print(F("result == "));
+    Serial.print(result);
+    Serial.println(F(". This should be impossible!"));
+  }
+
+  delay(250);
+}