.github/workflows/githubci.yml

@@ -7,11 +7,11 @@ jobs:
     runs-on: ubuntu-latest
 
     steps:
-    - uses: actions/setup-python@v1
+    - uses: actions/setup-python@v4
       with:
         python-version: '3.x'
-    - uses: actions/checkout@v2
-    - uses: actions/checkout@v2
+    - uses: actions/checkout@v3
+    - uses: actions/checkout@v3
       with:
          repository: adafruit/ci-arduino
          path: ci

README.md

@@ -4,7 +4,7 @@ This is a fork of JeeLab's fantastic real time clock library for Arduino.
 
 Works great with Adafruit RTC breakouts:
 
-- [DS3231 Precision RTC](https://www.adafruit.com/product/3013)
+- [DS3231 Precision RTC](https://www.adafruit.com/product/3013) (breakout) and [Stemma QT version](https://www.adafruit.com/product/5188)
 - [PCF8523 RTC](https://www.adafruit.com/product/3295)
 - [DS1307 RTC](https://www.adafruit.com/product/3296)
 
@@ -44,7 +44,7 @@ STM32F2            |             |             |     X       |
 Adafruit invests time and resources providing this open source code, please support Adafruit and open-source hardware by purchasing products from Adafruit!
 
 # Dependencies
- * [TinyWireM](https://github.com/adafruit/TinyWireM)
+ * [Adafruit BusIO](https://github.com/adafruit/Adafruit_BusIO)
 
 # Contributing
 

examples/DS3231_alarm/DS3231_alarm.ino

@@ -21,42 +21,42 @@ void setup() {
     if(!rtc.begin()) {
         Serial.println("Couldn't find RTC!");
         Serial.flush();
-        abort();
+        while (1) delay(10);
     }
-    
+
     if(rtc.lostPower()) {
         // this will adjust to the date and time at compilation
         rtc.adjust(DateTime(F(__DATE__), F(__TIME__)));
     }
-    
+
     //we don't need the 32K Pin, so disable it
     rtc.disable32K();
-    
+
     // Making it so, that the alarm will trigger an interrupt
     pinMode(CLOCK_INTERRUPT_PIN, INPUT_PULLUP);
     attachInterrupt(digitalPinToInterrupt(CLOCK_INTERRUPT_PIN), onAlarm, FALLING);
-    
+
     // set alarm 1, 2 flag to false (so alarm 1, 2 didn't happen so far)
     // if not done, this easily leads to problems, as both register aren't reset on reboot/recompile
     rtc.clearAlarm(1);
     rtc.clearAlarm(2);
-    
+
     // stop oscillating signals at SQW Pin
     // otherwise setAlarm1 will fail
     rtc.writeSqwPinMode(DS3231_OFF);
-    
+
     // turn off alarm 2 (in case it isn't off already)
     // again, this isn't done at reboot, so a previously set alarm could easily go overlooked
     rtc.disableAlarm(2);
-    
+
     // schedule an alarm 10 seconds in the future
     if(!rtc.setAlarm1(
             rtc.now() + TimeSpan(10),
             DS3231_A1_Second // this mode triggers the alarm when the seconds match. See Doxygen for other options
     )) {
         Serial.println("Error, alarm wasn't set!");
     }else {
-        Serial.println("Alarm will happen in 10 seconds!");  
+        Serial.println("Alarm will happen in 10 seconds!");
     }
 }
 
@@ -65,25 +65,46 @@ void loop() {
     char date[10] = "hh:mm:ss";
     rtc.now().toString(date);
     Serial.print(date);
+
+    // the stored alarm value + mode
+    DateTime alarm1 = rtc.getAlarm1();
+    Ds3231Alarm1Mode alarm1mode = rtc.getAlarm1Mode();
+    char alarm1Date[12] = "DD hh:mm:ss";
+    alarm1.toString(alarm1Date);
+    Serial.print(" [Alarm1: ");
+    Serial.print(alarm1Date);
+    Serial.print(", Mode: ");
+    switch (alarm1mode) {
+      case DS3231_A1_PerSecond: Serial.print("PerSecond"); break;
+      case DS3231_A1_Second: Serial.print("Second"); break;
+      case DS3231_A1_Minute: Serial.print("Minute"); break;
+      case DS3231_A1_Hour: Serial.print("Hour"); break;
+      case DS3231_A1_Date: Serial.print("Date"); break;
+      case DS3231_A1_Day: Serial.print("Day"); break;
+    }
+
     // the value at SQW-Pin (because of pullup 1 means no alarm)
-    Serial.print(" SQW: ");
+    Serial.print("] SQW: ");
     Serial.print(digitalRead(CLOCK_INTERRUPT_PIN));
-    // whether a alarm happened happened
-    Serial.print(" Alarm1: ");
+
+    // whether a alarm fired
+    Serial.print(" Fired: ");
     Serial.print(rtc.alarmFired(1));
+
     // Serial.print(" Alarm2: ");
     // Serial.println(rtc.alarmFired(2));
     // control register values (see https://datasheets.maximintegrated.com/en/ds/DS3231.pdf page 13)
     // Serial.print(" Control: 0b");
     // Serial.println(read_i2c_register(DS3231_ADDRESS, DS3231_CONTROL), BIN);
-    
+
     // resetting SQW and alarm 1 flag
     // using setAlarm1, the next alarm could now be configurated
-    if(rtc.alarmFired(1)) {
+    if (rtc.alarmFired(1)) {
         rtc.clearAlarm(1);
-        Serial.println("Alarm cleared");
+        Serial.print(" - Alarm cleared");
     }
-
+    Serial.println();
+
     delay(2000);
 }
 

examples/ds1307/ds1307.ino

@@ -15,7 +15,7 @@ void setup () {
   if (! rtc.begin()) {
     Serial.println("Couldn't find RTC");
     Serial.flush();
-    abort();
+    while (1) delay(10);
   }
 
   if (! rtc.isrunning()) {

examples/ds1307SqwPin/ds1307SqwPin.ino

@@ -45,7 +45,7 @@ void setup () {
   if (! rtc.begin()) {
     Serial.println("Couldn't find RTC");
     Serial.flush();
-    abort();
+    while (1) delay(10);
   }
 
   print_mode();

examples/ds1307nvram/ds1307nvram.ino

@@ -23,7 +23,7 @@ void setup () {
   if (! rtc.begin()) {
     Serial.println("Couldn't find RTC");
     Serial.flush();
-    abort();
+    while (1) delay(10);
   }
 
   // Print old RAM contents on startup.

examples/ds3231/ds3231.ino

@@ -15,7 +15,7 @@ void setup () {
   if (! rtc.begin()) {
     Serial.println("Couldn't find RTC");
     Serial.flush();
-    abort();
+    while (1) delay(10);
   }
 
   if (rtc.lostPower()) {

examples/interrupts1Hz/interrupts1Hz.ino

@@ -59,7 +59,7 @@ void setup() {
   if (! rtc.begin()) {
     Serial.println("Couldn't find RTC");
     Serial.flush();
-    abort();
+    while (1) delay(10);
   }
   if (!rtc.initialized() || rtc.lostPower()) {
     rtc.adjust(DateTime(F(__DATE__), F(__TIME__)));

examples/pcf8523/pcf8523.ino

@@ -15,7 +15,7 @@ void setup () {
   if (! rtc.begin()) {
     Serial.println("Couldn't find RTC");
     Serial.flush();
-    abort();
+    while (1) delay(10);
   }
 
   if (! rtc.initialized() || rtc.lostPower()) {
@@ -44,7 +44,7 @@ void setup () {
   // to be restarted by clearing the STOP bit. Let's do this to ensure
   // the RTC is running.
   rtc.start();
-  
+
    // The PCF8523 can be calibrated for:
   //        - Aging adjustment
   //        - Temperature compensation

examples/pcf8523Countdown/pcf8523Countdown.ino

@@ -42,7 +42,7 @@ void setup () {
   if (! rtc.begin()) {
     Serial.println("Couldn't find RTC");
     Serial.flush();
-    abort();
+    while (1) delay(10);
   }
 
   pinMode(LED_BUILTIN, OUTPUT);

examples/pcf8563/pcf8563.ino

@@ -15,7 +15,7 @@ void setup () {
   if (! rtc.begin()) {
     Serial.println("Couldn't find RTC");
     Serial.flush();
-    abort();
+    while (1) delay(10);
   }
 
   if (rtc.lostPower()) {

examples/pcf8563_interrupt/pcf8563_interrupt.ino

@@ -6,7 +6,7 @@ RTC_PCF8563 rtc;
 char daysOfTheWeek[7][12] = {"Sunday", "Monday", "Tuesday", "Wednesday", "Thursday", "Friday", "Saturday"};
 
 // use D2 for INT0; attach to CLKOUT pin on RTC
-const uint8_t INT_PIN = 2; 
+const uint8_t INT_PIN = 2;
 
 // flag to update serial; set in interrupt callback
 volatile uint8_t tick_tock = 1;
@@ -23,7 +23,7 @@ void setup () {
   while (!Serial); // wait for serial port to connect. Needed for native USB
 #endif
 
-  
+
   pinMode(INT_PIN, INPUT);        // set up interrupt pin
   digitalWrite(INT_PIN, HIGH);    // turn on pullup resistors
   // attach interrupt to set_tick_tock callback on rising edge of INT0
@@ -32,7 +32,7 @@ void setup () {
   if (! rtc.begin()) {
     Serial.println("Couldn't find RTC");
     Serial.flush();
-    abort();
+    while (1) delay(10);
   }
 
   if (rtc.lostPower()) {
@@ -51,7 +51,7 @@ void setup () {
   }
 
 
-  
+
   // When time needs to be re-set on a previously configured device, the
   // following line sets the RTC to the date & time this sketch was compiled
   // rtc.adjust(DateTime(F(__DATE__), F(__TIME__)));
@@ -63,7 +63,7 @@ void setup () {
   // to be restarted by clearing the STOP bit. Let's do this to ensure
   // the RTC is running.
   rtc.start();
-    
+
   // turn on 1Hz clock out, used as INT0 for serial update every second
   rtc.writeSqwPinMode(PCF8563_SquareWave1Hz);
 }
@@ -72,7 +72,7 @@ void loop () {
 
   // check if time display should be output
   if(tick_tock) {
- 
+
     DateTime now = rtc.now();
 
     char time_format[] = "hh:mm:ss AP";
@@ -81,7 +81,7 @@ void loop () {
     Serial.println(now.toString(time_format));
     Serial.println(now.toString(date_format));
     Serial.println();
- 
+
     tick_tock = 0;
 
   }

examples/timestamp/timestamp.ino

@@ -22,7 +22,7 @@ void setup () {
   if (! rtc.begin()) {
     Serial.println("Couldn't find RTC");
     Serial.flush();
-    abort();
+    while (1) delay(10);
   }
 
   if (! rtc.isrunning()) {

examples/toString/toString.ino

@@ -14,7 +14,7 @@ void setup () {
   if (! rtc.begin()) {
     Serial.println("Couldn't find RTC");
     Serial.flush();
-    abort();
+    while (1) delay(10);
   }
 
   if (! rtc.isrunning()) {

library.properties

@@ -1,10 +1,10 @@
 name=RTClib
-version=1.14.2
+version=2.1.4
 author=Adafruit
 maintainer=Adafruit <info@adafruit.com>
 sentence=A fork of Jeelab's fantastic RTC library
 paragraph=Works with DS1307, DS3231, PCF8523, PCF8563 on multiple architectures
 category=Timing
 url=https://github.com/adafruit/RTClib
 architectures=*
-depends=TinyWireM
+depends=Adafruit BusIO