Add option for using callback

Author: sebromero

src/Arduino_LowPowerPortentaC33.cpp

@@ -24,15 +24,15 @@ void LowPower::deepSleep(){
     R_LPM_LowPowerModeEnter(&RenesasLowPowerControlBlock);
 }
 
-bool LowPower::setWakeUpAlarm(RTCTime alarmTime){
+bool LowPower::setWakeUpAlarm(RTCTime alarmTime, void (* const callbackFunction)(), RTClock * rtc){
     this->enableWakeupFromRTC();
 
-    if(!RTC.isRunning()){
+    if(!rtc->isRunning()){
         return false;
     }
 
     RTCTime currentTime;
-    if (!RTC.getTime(currentTime)) {
+    if (!rtc->getTime(currentTime)) {
         return false; // Failed to get current time
     }
 
@@ -45,18 +45,22 @@ bool LowPower::setWakeUpAlarm(RTCTime alarmTime){
     match.addMatchMonth();  // Trigger the alarm when the months match
     match.addMatchYear();   // Trigger the alarm when the years match
 
-    return RTC.setAlarm(alarmTime, match);
+    if (callbackFunction) {
+        return rtc->setAlarmCallback(callbackFunction, alarmTime, match);
+    } else {
+        return rtc->setAlarm(alarmTime, match);
+    }
 }
 
-bool LowPower::setWakeUpAlarm(uint8_t hours, uint8_t minutes, uint8_t seconds){
+bool LowPower::setWakeUpAlarm(uint8_t hours, uint8_t minutes, uint8_t seconds, void (* const callbackFunction)(), RTClock * rtc){
 
-    if(!RTC.isRunning()){
+    if(!rtc->isRunning()){
         return false;
     }
 
     // Get the current time from the RTC
     RTCTime currentTime;
-    if (!RTC.getTime(currentTime)) {
+    if (!rtc->getTime(currentTime)) {
         return false; // Failed to get current time
     }
 
@@ -67,7 +71,7 @@ bool LowPower::setWakeUpAlarm(uint8_t hours, uint8_t minutes, uint8_t seconds){
     // Convert back to RTCTime
     RTCTime alarmTime(currentTimestamp);
 
-    return this->setWakeUpAlarm(alarmTime);
+    return this->setWakeUpAlarm(alarmTime, callbackFunction, rtc);
 }
 
 void LowPower::enableWakeupFromRTC(){

src/Arduino_LowPowerPortentaC33.h

@@ -41,8 +41,31 @@ class LowPower {
      */
     bool enableWakeupFromPin(uint8_t pin, PinStatus direction);
 
-    bool setWakeUpAlarm(RTCTime alarmTime);
-    bool setWakeUpAlarm(uint8_t hours, uint8_t minutes, uint8_t seconds);
+    /**
+     * Enables wake-up of the device based on the Real-Time Clock (RTC).
+     * The device will wake up at the specified time.
+     * @param alarmTime The time at which the device will wake up.
+     * @param callbackFunction The function to be called when the device wakes up.
+     * Specifying it only makes sense when used with sleep() and not deepSleep() as the device will reset when it wakes up from deep sleep.
+     * @param rtc The Real-Time Clock (RTC) to be used for setting the wake-up alarm.
+     * If not specified, the default RTC will be used.
+     * @return True if the wake-up alarm was set successfully, false otherwise.
+    */
+    bool setWakeUpAlarm(RTCTime alarmTime, void (* const callbackFunction)() = nullptr, RTClock * rtc = &RTC);
+    
+    /**
+     * Enables wake-up of the device based on the Real-Time Clock (RTC).
+     * The device will wake up at the specified time.
+     * @param hours The hour at which the device will wake up.
+     * @param minutes The minute at which the device will wake up.
+     * @param seconds The second at which the device will wake up.
+     * @param callbackFunction The function to be called when the device wakes up.
+     * Specifying it only makes sense when used with sleep() and not deepSleep() as the device will reset when it wakes up from deep sleep.
+     * @param rtc The Real-Time Clock (RTC) to be used for setting the wake-up alarm.
+     * If not specified, the default RTC will be used.
+     * @return True if the wake-up alarm was set successfully, false otherwise.
+     */
+    bool setWakeUpAlarm(uint8_t hours, uint8_t minutes, uint8_t seconds, void (* const callbackFunction)() = nullptr, RTClock * rtc = &RTC);
 
 private:
     /**