Clean up examples

Author: nseidle

examples/Example11_FactoryReset/Example11_FactoryReset.ino

@@ -30,6 +30,8 @@ UM980 myGNSS;
 
 HardwareSerial SerialGNSS(1); //Use UART1 on the ESP32
 
+unsigned long lastCheck = 0;
+
 void setup()
 {
   Serial.begin(115200);
@@ -49,9 +51,9 @@ void setup()
   }
   Serial.println("UM980 detected!");
 
-  while(Serial.available()) Serial.read(); //Clear RX buffer
+  while (Serial.available()) Serial.read(); //Clear RX buffer
   Serial.println("Press any key to factory reset the UM980");
-  while(Serial.available() == 0) delay(1); //Wait for user to press a button
+  while (Serial.available() == 0) delay(1); //Wait for user to press a button
 
   // Clear saved configurations, satellite ephemerides, position information, and reset baud rate to 115200bps.
   if (myGNSS.factoryReset() == true)
@@ -70,7 +72,6 @@ void setup()
 
   Serial.println("UM980 has completed reset");
 
-
   // Resetting the receiver will clear the satellite ephemerides, position information, satellite
   // almanacs, ionosphere parameters and UTC parameters saved in the receiver.
   //myGNSS.reset();
@@ -84,5 +85,61 @@ void setup()
 
 void loop()
 {
-  //Do nothing
-}
+  myGNSS.update(); //Regularly call to parse any new data
+
+  if (millis() - lastCheck > 1000)
+  {
+    lastCheck = millis();
+
+    //The get methods are updated whenever new data is parsed with the update() call.
+    //By default, this data is updated once per second.
+
+    Serial.print("Lat/Long/Alt: ");
+    Serial.print(myGNSS.getLatitude(), 11);
+    Serial.print("/");
+    Serial.print(myGNSS.getLongitude(), 11);
+    Serial.print("/");
+    Serial.print(myGNSS.getAltitude(), 4);
+    Serial.println();
+
+    Serial.print("Horizontal Speed: ");
+    Serial.print(myGNSS.getHorizontalSpeed());
+    Serial.print("m/s Vertical Speed: ");
+    Serial.print(myGNSS.getVerticalSpeed());
+    Serial.print("m/s Direction from North: ");
+    Serial.print(myGNSS.getTrackGround());
+    Serial.print("(degrees)");
+    Serial.println();
+
+    Serial.print("Date (yyyy/mm/dd): ");
+    Serial.print(myGNSS.getYear());
+    Serial.print("/");
+    if (myGNSS.getMonth() < 10)
+      Serial.print("0");
+    Serial.print(myGNSS.getMonth());
+    Serial.print("/");
+    if (myGNSS.getDay() < 10)
+      Serial.print("0");
+    Serial.print(myGNSS.getDay());
+
+    Serial.print(" Time (hh:mm:dd): ");
+    if (myGNSS.getHour() < 10)
+      Serial.print("0");
+    Serial.print(myGNSS.getHour());
+    Serial.print(":");
+    if (myGNSS.getMinute() < 10)
+      Serial.print("0");
+    Serial.print(myGNSS.getMinute());
+    Serial.print(":");
+    if (myGNSS.getSecond() < 10)
+      Serial.print("0");
+    Serial.print(myGNSS.getSecond());
+    Serial.println();
+
+    Serial.print("Satellites in view: ");
+    Serial.print(myGNSS.getSIV());
+    Serial.println();
+
+    Serial.println();
+  }
+}

examples/Example3_EnableNMEA_5Hz/Example3_EnableNMEA_5Hz.ino

@@ -51,6 +51,8 @@ void setup()
   }
   Serial.println("UM980 detected!");
 
+  myGNSS.disableOutput(); // Disables all messages on this port
+
   //Set the output rate of NMEA messages. Users can set both the message type and update rate.
   //1, 0.5, 0.2, 0.1, 0.05 corresponds to 1Hz, 2Hz, 5Hz, 10Hz, 20Hz respectively.
   //1, 2, 5 corresponds to 1Hz, 0.5Hz, 0.2Hz respectively.
@@ -71,11 +73,13 @@ void setup()
   myGNSS.setNMEAPortMessage("GPGSV", comName, 1); //Limit GSV to 1Hz
 
   myGNSS.saveConfiguration(); //Save the current configuration into non-volatile memory (NVM)
+
+  Serial.println("Wait for UM980 to get fix and output NMEA...");
 }
 
 void loop()
 {
   //Read in NMEA from the UM980
   while (SerialGNSS.available())
     Serial.write(SerialGNSS.read());
-}
+}

examples/Example4_EnableRTCM/Example4_EnableRTCM.ino

@@ -49,6 +49,8 @@ void setup()
   }
   Serial.println("UM980 detected!");
 
+  myGNSS.disableOutput(); // Disables all messages on this port
+
   //Configure the port on the UM980 we are currently commuicating with
   myGNSS.setRTCMMessage("RTCM1005", 1); //Message type, 1 report per second.
 
@@ -59,11 +61,12 @@ void setup()
   myGNSS.setRTCMPortMessage("RTCM1093", "COM1", 0); //Disable given message on a given port
 
   myGNSS.saveConfiguration(); //Save the current configuration into non-volatile memory (NVM)
+
+  Serial.println("RTCM is in binary so printing it will show random characters");
 }
 
 void loop()
 {
-  //RTCM is in binary so printing it to the serial terminal will not show anything legible
-  //  while (SerialGNSS.available())
-  //    Serial.write(SerialGNSS.read());
-}
+  while (SerialGNSS.available())
+    Serial.write(SerialGNSS.read());
+}

examples/Example5_AverageBase/Example5_AverageBase.ino

@@ -80,9 +80,11 @@ void setup()
 
   myGNSS.setRTCMMessage("RTCM1033", 0); //Disable a specific message
 
-  myGNSS.setRTCMMessage("RTCM1074", "COM1", 1); //Enable message on a specific port
+  myGNSS.setRTCMPortMessage("RTCM1074", "COM1", 1); //Enable message on a specific port
 
   myGNSS.saveConfiguration(); //Save the current configuration into non-volatile memory (NVM)
+
+  Serial.println("Output will be a mix of NMEA and binary RTCM non-visible characters");
 }
 
 void loop()
@@ -91,4 +93,4 @@ void loop()
   //RTCM is binary and will appear as random characters.
   while (SerialGNSS.available())
     Serial.write(SerialGNSS.read());
-}
+}

examples/Example6_FixedBase/Example6_FixedBase.ino

@@ -76,16 +76,18 @@ void setup()
   myGNSS.setRTCMMessage("RTCM1124", 1);
   myGNSS.setRTCMMessage("RTCM1033", 10);
 
-  myGNSS.setRTCMMessage("RTCM1033", 0); //Disable a specific message
+  //myGNSS.setRTCMMessage("RTCM1033", 0); //Disable a specific message
 
-  myGNSS.setRTCMMessage("RTCM1074", "COM1", 1); //Enable message on a specific port
+  //myGNSS.setRTCMPortMessage("RTCM1074", "COM1", 1); //Enable message on a specific port
 
   myGNSS.saveConfiguration(); //Save the current configuration into non-volatile memory (NVM)
+
+  Serial.println("Output will be a mix of NMEA and binary RTCM non-visible characters");
 }
 
 void loop()
 {
   //Read in NMEA and RTCM from the UM980
   while (SerialGNSS.available())
     Serial.write(SerialGNSS.read());
-}
+}