Merge pull request #1473 from arduino/jacobhylen/vrtc-fix

[MKC-1142] Update VRTC pin docs

Author: karlsoderby

content/hardware/02.hero/boards/uno-r4-wifi/tutorials/vrtc-off/vrtc-off.md

@@ -37,36 +37,55 @@ On the header that is located by the barrel jack, you'll find the VRTC pin. And
 
 ![Battery Pack Powering the UNO R4 WiFi RTC](./assets/Circuit.png)
 
-The following sketch will start the RTC but only set the time if it is not already running.
+The following sketch will start the RTC but only set the time if it this is the first time starting the board since adding the VRTC battery.
 
 ```arduino
 #include "RTC.h"
 
 void setup() {
-  // put your setup code here, to run once:
   Serial.begin(9600);
   RTC.begin();
-  RTCTime mytime(24, Month::MAY, 2023, 11, 8, 0, DayOfWeek::THURSDAY, SaveLight::SAVING_TIME_ACTIVE);
 
-  RTC.setTimeIfNotRunning(mytime);
+  // A fallback time object, for setting the time if there is no time to retrieve from the RTC.
+  RTCTime mytime(6, Month::NOVEMBER, 2023, 18, 12, 00, DayOfWeek::MONDAY, SaveLight::SAVING_TIME_ACTIVE);
+
+  // Tries to retrieve time 
+  RTCTime savedTime;
+  RTC.getTime(savedTime);
+
   
+  if (!RTC.isRunning()) {
+    // this means the RTC is waking up "as new"
+    if (savedTime.getYear() == 2000) {
+      RTC.setTime(mytime);
+    } else {
+      RTC.setTime(savedTime);
+    }
+  }
 }
 
 void loop() {
-  // put your main code here, to run repeatedly:
-  
+
   RTCTime currenttime;
   RTC.getTime(currenttime);
-
-  int hours = currenttime.getHour();
-  int minutes = currenttime.getMinutes();
-
-
-  Serial.print("Hours: ");
-  Serial.println(hours);
-  Serial.println("Minutes: ");
-  Serial.println(minutes);
-
+  Serial.print("Current time: ");
+
+  /* DATE */
+  Serial.print(currenttime.getDayOfMonth());
+  Serial.print("/");
+  Serial.print(Month2int(currenttime.getMonth()));
+  Serial.print("/");
+  Serial.print(currenttime.getYear());
+  Serial.print(" - ");
+
+  /* HOURS:MINUTES:SECONDS */
+  Serial.print(currenttime.getHour());
+  Serial.print(":");
+  Serial.print(currenttime.getMinutes());
+  Serial.print(":");
+  Serial.println(currenttime.getSeconds());
+
+  delay(1000);
 }
 
 ```