Merge from arduion-libraries/RTCZero

Author: GabrielNotman

examples/SimpleRTC/SimpleRTC.ino

@@ -7,6 +7,11 @@
 
  http://arduino.cc/en/Tutorial/SimpleRTC
 
+  created by Arturo Guadalupi <[email protected]>
+  15 Jun 2015
+
+  modified
+  21 Oct 2015
 */
 
 #include <RTCZero.h>
@@ -28,7 +33,7 @@ void setup()
 {
   Serial.begin(9600);
 
-  rtc.begin(H24); // initialize RTC 24H format. The dual option is H12
+  rtc.begin(); // initialize RTC
 
   // Set the time
   rtc.setHours(hours);

examples/SimpleRTCAlarm/SimpleRTCAlarm.ino

@@ -0,0 +1,55 @@
+/*
+  Simple RTC Alarm for Arduino Zero
+
+  Demonstrates the use of alarms using the RTC library for the Arduino Zero
+
+  This example code is in the public domain
+
+  http://arduino.cc/en/Tutorial/SimpleRTCAlarm
+
+  created by Arturo Guadalupi <[email protected]>
+  25 Sept 2015
+  
+  modified
+  21 Oct 2015
+*/
+
+#include <RTCZero.h>
+
+/* Create an rtc object */
+RTCZero rtc;
+
+/* Change these values to set the current initial time */
+const uint8_t seconds = 0;
+const uint8_t minutes = 0;
+const uint8_t hours = 16;
+
+/* Change these values to set the current initial date */
+const uint8_t day = 25;
+const uint8_t month = 9;
+const uint8_t year = 15;
+
+void setup()
+{
+  Serial.begin(9600);
+
+  rtc.begin(); // initialize RTC 24H format
+
+  rtc.setTime(hours, minutes, seconds);
+  rtc.setDate(day, month, year);
+
+  rtc.setAlarmTime(16, 0, 10);
+  rtc.enableAlarm(rtc.MATCH_HHMMSS);
+  
+  rtc.attachInterrupt(alarmMatch);
+}
+
+void loop()
+{
+
+}
+
+void alarmMatch()
+{
+  Serial.println("Alarm Match!");
+}

examples/SleepRTCAlarm/SleepRTCAlarm.ino

@@ -0,0 +1,64 @@
+/*
+  Simple RTC Alarm for Arduino Zero
+
+  Demonstrates the use an alarm to wake up an Arduino zero from Standby mode
+
+  This example code is in the public domain
+
+  http://arduino.cc/en/Tutorial/SleepRTCAlarm
+
+  created by Arturo Guadalupi
+  17 Nov 2015
+*/
+
+#include <RTCZero.h>
+
+/* Create an rtc object */
+RTCZero rtc;
+
+/* Change these values to set the current initial time */
+const uint8_t seconds = 0;
+const uint8_t minutes = 00;
+const uint8_t hours = 17;
+
+/* Change these values to set the current initial date */
+const uint8_t day = 17;
+const uint8_t month = 11;
+const uint8_t year = 15;
+
+void setup()
+{
+  Serial.begin(115200);
+
+  rtc.begin();
+
+  rtc.setTime(hours, minutes, seconds);
+  rtc.setDate(day, month, year);
+
+  rtc.setAlarmTime(17, 00, 10);
+  rtc.enableAlarm(rtc.MATCH_HHMMSS);
+
+  rtc.attachInterrupt(alarmMatch);
+
+  rtc.standbyMode();
+}
+
+void loop()
+{
+
+  Serial.println("Awake!");
+
+  for (int i = 0; i < 10; i++)
+    Serial.print(i);
+
+  Serial.println();
+
+  Serial.println("Done! Goodnight!");
+
+  rtc.standbyMode();    // Sleep until next alarm match
+}
+
+void alarmMatch()
+{
+
+}

keywords.txt

@@ -12,23 +12,43 @@ RTCZero	KEYWORD1
 # Methods and Functions (KEYWORD2)
 #######################################
 
-getDay	KEYWORD2
-getMonth	KEYWORD2
-getYear	KEYWORD2
-getHours KEYWORD2
-getMinutes	KEYWORD2
-getSeconds KEYWORD2
+getDay					KEYWORD2
+getMonth				KEYWORD2
+getYear					KEYWORD2
+getHours 				KEYWORD2
+getMinutes			KEYWORD2
+getSeconds 			KEYWORD2
 
-setDay	KEYWORD2
-setMonth	KEYWORD2
-setYear	KEYWORD2
-setHours KEYWORD2
-setMinutes	KEYWORD2
-setSeconds KEYWORD2
+setDay					KEYWORD2
+setMonth				KEYWORD2
+setYear					KEYWORD2
+setHours 				KEYWORD2
+setMinutes			KEYWORD2
+setSeconds 			KEYWORD2
+setDate					KEYWORD2
+setTime					KEYWORD2
+
+getAlarmDay			KEYWORD2
+getAlarmMonth		KEYWORD2
+getAlarmYear		KEYWORD2
+getAlarmHours 	KEYWORD2
+getAlarmMinutes	KEYWORD2
+getAlarmSeconds KEYWORD2
+
+setAlarmDay			KEYWORD2
+setAlarmMonth		KEYWORD2
+setAlarmYear		KEYWORD2
+setAlarmHours 	KEYWORD2
+setAlarmMinutes	KEYWORD2
+setAlarmSeconds KEYWORD2
+setAlarmDate		KEYWORD2
+setAlarmTime		KEYWORD2
+
+enableAlarm 		KEYWORD2
+disableAlarm 		KEYWORD2
+
+standbyMode			KEYWORD2
 
 #######################################
 # Constants (LITERAL1)
 #######################################
-H24 LITERAL1
-H12 LITERAL1
-

library.properties

@@ -1,5 +1,5 @@
 name=RTCZero
-version=1.0.0
+version=1.3.0
 author=Arduino
 maintainer=Arduino <[email protected]>
 sentence=Allows to use the RTC functionalities. For Arduino Zero only.