RTC. Merge to trunk.

git-svn-id: svn://svn.code.sf.net/p/chibios/svn/trunk@3281 35acf78f-673a-0410-8e92-d51de3d6d3f4

9 files changed, 654 insertions, 2 deletions

diff --git a/os/hal/dox/rtc.dox b/os/hal/dox/rtc.dox
new file mode 100644
index 000000000..3572aca18
--- /dev/null
+++ b/os/hal/dox/rtc.dox
@@ -0,0 +1,34 @@
+/*

+    ChibiOS/RT - Copyright (C) 2006,2007,2008,2009,2010,

+                 2011 Giovanni Di Sirio.

+

+    This file is part of ChibiOS/RT.

+

+    ChibiOS/RT is free software; you can redistribute it and/or modify

+    it under the terms of the GNU General Public License as published by

+    the Free Software Foundation; either version 3 of the License, or

+    (at your option) any later version.

+

+    ChibiOS/RT is distributed in the hope that it will be useful,

+    but WITHOUT ANY WARRANTY; without even the implied warranty of

+    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the

+    GNU General Public License for more details.

+

+    You should have received a copy of the GNU General Public License

+    along with this program.  If not, see <http://www.gnu.org/licenses/>.

+*/

+

+/**

+ * @defgroup RTC RTC Driver

+ * @brief   Real Time Clock Abstraction Layer

+ * @details This module defines an abstract interface for Real Time Clock cell.

+ *          If you do not need callback functionality than disable 

+ *          @p RTC_SUPPORTS_CALLBACKS option in @p halconf.h.

+ *          In @p halconf.h you also can select clock source for RTC in

+ *          @p RTC_CLOCK_SOURCE option.

+ *

+ * @pre     In order to use the RTC driver the @p HAL_USE_RTC option

+ *          must be enabled in @p halconf.h. 

+ *

+ * @ingroup IO

+ */

diff --git a/os/hal/hal.mk b/os/hal/hal.mk
index 762bda57f..87a3c6dc3 100644
--- a/os/hal/hal.mk
+++ b/os/hal/hal.mk
@@ -15,7 +15,8 @@ HALSRC = ${CHIBIOS}/os/hal/src/hal.c \
          ${CHIBIOS}/os/hal/src/uart.c \

          ${CHIBIOS}/os/hal/src/usb.c \

          ${CHIBIOS}/os/hal/src/mmc_spi.c \

-         ${CHIBIOS}/os/hal/src/serial_usb.c

+         ${CHIBIOS}/os/hal/src/serial_usb.c \

+         ${CHIBIOS}/os/hal/src/rtc.c

 

 # Required include directories

 HALINC = ${CHIBIOS}/os/hal/include

diff --git a/os/hal/include/hal.h b/os/hal/include/hal.h
index 1ed893aab..b92789b02 100644
--- a/os/hal/include/hal.h
+++ b/os/hal/include/hal.h
@@ -49,6 +49,7 @@
 #include "usb.h"

 #include "mmc_spi.h"

 #include "serial_usb.h"

+#include "rtc.h"

 

 /*===========================================================================*/

 /* External declarations.                                                    */

diff --git a/os/hal/include/rtc.h b/os/hal/include/rtc.h
new file mode 100644
index 000000000..0c545c3a6
--- /dev/null
+++ b/os/hal/include/rtc.h
@@ -0,0 +1,92 @@
+/*

+    ChibiOS/RT - Copyright (C) 2006,2007,2008,2009,2010,

+                 2011 Giovanni Di Sirio.

+

+    This file is part of ChibiOS/RT.

+

+    ChibiOS/RT is free software; you can redistribute it and/or modify

+    it under the terms of the GNU General Public License as published by

+    the Free Software Foundation; either version 3 of the License, or

+    (at your option) any later version.

+

+    ChibiOS/RT is distributed in the hope that it will be useful,

+    but WITHOUT ANY WARRANTY; without even the implied warranty of

+    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the

+    GNU General Public License for more details.

+

+    You should have received a copy of the GNU General Public License

+    along with this program.  If not, see <http://www.gnu.org/licenses/>.

+*/

+

+/**

+ * @file    rtc.h

+ * @brief   RTC Driver macros and structures.

+ *

+ * @addtogroup RTC

+ * @{

+ */

+

+

+#ifndef _RTC_H_

+#define _RTC_H_

+

+

+

+#if HAL_USE_RTC || defined(__DOXYGEN__)

+

+/*===========================================================================*/

+/* Driver constants.                                                         */

+/*===========================================================================*/

+

+/*===========================================================================*/

+/* Driver pre-compile time settings.                                         */

+/*===========================================================================*/

+

+/*===========================================================================*/

+/* Derived constants and error checks.                                       */

+/*===========================================================================*/

+

+/*===========================================================================*/

+/* Driver data structures and types.                                         */

+/*===========================================================================*/

+

+typedef struct RTCDriver RTCDriver;

+

+typedef void (*rtccb_t)(RTCDriver *rtcp);

+

+#include "rtc_lld.h"

+

+/*===========================================================================*/

+/* Driver macros.                                                            */

+/*===========================================================================*/

+

+/*===========================================================================*/

+/* External declarations.                                                    */

+/*===========================================================================*/

+

+#ifdef __cplusplus

+extern "C" {

+#endif

+  void rtcInit(void);

+

+  #if RTC_SUPPORTS_CALLBACKS

+    void rtcStart(RTCDriver *rtcp, const RTCConfig *rtccfgp);

+    void rtcStop(void);

+  #else /* RTC_SUPPORTS_CALLBACKS */

+    #define rtcStart(rtcp, rtccfgp)

+    #define rtcStop()

+  #endif /* RTC_SUPPORTS_CALLBACKS */

+

+  void rtcSetTime(uint32_t tv_sec);

+  uint32_t rtcGetSec(void);

+  uint16_t rtcGetMsec(void);

+  void rtcSetAlarm(uint32_t tv_alarm);

+  uint32_t rtcGetAlarm(void);

+#ifdef __cplusplus

+}

+#endif

+

+#endif /* HAL_USE_RTC */

+#endif /* _RTC_H_ */

+

+/** @} */

diff --git a/os/hal/platforms/STM32/rtc_lld.c b/os/hal/platforms/STM32/rtc_lld.c
new file mode 100644
index 000000000..1ddbc0903
--- /dev/null
+++ b/os/hal/platforms/STM32/rtc_lld.c
@@ -0,0 +1,264 @@
+/*

+    ChibiOS/RT - Copyright (C) 2006,2007,2008,2009,2010,

+                 2011 Giovanni Di Sirio.

+

+    This file is part of ChibiOS/RT.

+

+    ChibiOS/RT is free software; you can redistribute it and/or modify

+    it under the terms of the GNU General Public License as published by

+    the Free Software Foundation; either version 3 of the License, or

+    (at your option) any later version.

+

+    ChibiOS/RT is distributed in the hope that it will be useful,

+    but WITHOUT ANY WARRANTY; without even the implied warranty of

+    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the

+    GNU General Public License for more details.

+

+    You should have received a copy of the GNU General Public License

+    along with this program.  If not, see <http://www.gnu.org/licenses/>.

+*/

+

+/**

+ * @file    STM32/rtc_lld.c

+ * @brief   STM32 RTC subsystem low level driver header.

+ *

+ * @addtogroup RTC

+ * @{

+ */

+

+#include "ch.h"

+#include "hal.h"

+

+

+#if HAL_USE_RTC || defined(__DOXYGEN__)

+

+/*===========================================================================*/

+/* Driver exported variables.                                                */

+/*===========================================================================*/

+

+/** @brief RTC driver identifier.*/

+RTCDriver RTCD;

+

+

+/*===========================================================================*/

+/* Driver local variables.                                                   */

+/*===========================================================================*/

+

+/*===========================================================================*/

+/* Driver local functions.                                                   */

+/*===========================================================================*/

+

+/**

+ * @brief   Shared IRQ handler.

+ *

+ * @param[in] rtcp    pointer to a @p RTCDriver object

+ */

+#if RTC_SUPPORTS_CALLBACKS

+

+static void rtc_lld_serve_interrupt(RTCDriver *rtcp){

+  chSysLockFromIsr();

+

+  if ((RTC->CRH & RTC_CRH_SECIE) && \

+      (RTC->CRL & RTC_CRL_SECF) && \

+      (rtcp->config->second_cb != NULL)){

+    rtcp->config->second_cb(rtcp);

+    RTC->CRL &= ~RTC_CRL_SECF;

+  }

+  if ((RTC->CRH & RTC_CRH_ALRIE) && \

+      (RTC->CRL & RTC_CRL_ALRF) && \

+      (rtcp->config->alarm_cb != NULL)){

+    rtcp->config->alarm_cb(rtcp);

+    RTC->CRL &= ~RTC_CRL_ALRF;

+  }

+  if ((RTC->CRH & RTC_CRH_OWIE) && \

+      (RTC->CRL & RTC_CRL_OWF) && \

+      (rtcp->config->overflow_cb != NULL)){

+    rtcp->config->overflow_cb(rtcp);

+    RTC->CRL &= ~RTC_CRL_OWF;

+  }

+

+  chSysUnlockFromIsr();

+}

+#endif /* RTC_SUPPORTS_CALLBACKS */

+

+/*===========================================================================*/

+/* Driver interrupt handlers.                                                */

+/*===========================================================================*/

+

+/**

+ * @brief   RTC interrupt handler.

+ * @isr

+ */

+#if RTC_SUPPORTS_CALLBACKS

+

+CH_IRQ_HANDLER(RTC_IRQHandler) {

+  CH_IRQ_PROLOGUE();

+  rtc_lld_serve_interrupt(&RTCD);

+  CH_IRQ_EPILOGUE();

+}

+

+#endif /* RTC_SUPPORTS_CALLBACKS */

+

+/*===========================================================================*/

+/* Driver exported functions.                                                */

+/*===========================================================================*/

+

+/**

+ * @brief   Enable access to registers and initialize RTC if BKP domain

+ *          was previously reseted.

+ */

+void rtc_lld_init(void){

+  RCC->APB1ENR |= (RCC_APB1ENR_PWREN | RCC_APB1ENR_BKPEN);  /* enable clocking */

+  PWR->CR |= PWR_CR_DBP;                                    /* enable access */

+

+  if (!(RCC->BDCR & (RCC_BDCR_RTCEN | RCC_BDCR_LSEON))){    /* BKP domain was reseted */

+    RCC->BDCR |= RTC_CLOCK_SOURCE;                          /* select clocking from LSE */

+    RCC->BDCR |= RCC_BDCR_LSEON;                            /* switch LSE on */

+    while(!(RCC->BDCR & RCC_BDCR_LSEON))                    /* wait for stabilization */

+      ;

+    RCC->BDCR |= RCC_BDCR_RTCEN;                            /* run clock */

+  }

+

+  #if defined(RTC_CLOCK_SOURCE) == defined(RCC_BDCR_RTCSEL_LSE)

+    uint32_t preload = STM32_LSECLK - 1UL;

+  #elif defined(RTC_CLOCK_SOURCE) == defined(RCC_BDCR_RTCSEL_LSI)

+    uint32_t preload = STM32_LSICLK - 1UL;

+  #elif defined(RTC_CLOCK_SOURCE) == defined(RCC_BDCR_RTCSEL_HSE)

+    uint32_t preload = (STM32_HSICLK / 128UL) - 1UL;

+  #else

+    #error "RTC clock source not selected"

+  #endif /* RTC_CLOCK_SOURCE == RCC_BDCR_RTCSEL_LSE */

+

+  /* Write preload register only if value changed */

+  if (preload != (((uint32_t)(RTC->PRLH)) << 16) + RTC->PRLH){

+    while(!(RTC->CRL & RTC_CRL_RTOFF))

+      ;

+

+    RTC->CRL |= RTC_CRL_CNF;                            /* switch on configure mode */

+    RTC->PRLH = (uint16_t)((preload >> 16) & 0b1111);   /* write preloader */

+    RTC->PRLL = (uint16_t)(preload & 0xFFFF);

+    RTC->CRL &= ~RTC_CRL_CNF;                           /* switch off configure mode */

+

+    while(!(RTC->CRL & RTC_CRL_RTOFF))                  /* wait for completion */

+      ;

+  }

+

+  /* Ensure that RTC_CNT and RTC_DIV contain actual values after enabling

+   * clocking on APB1, because these values only update when APB1 functioning.*/

+  RTC->CRL &= ~(RTC_CRL_RSF);

+  while (!(RTC->CRL & RTC_CRL_RSF))

+    ;

+

+  /* disable all interrupts and clear all even flags just to be safe */

+  RTC->CRH &= ~(RTC_CRH_OWIE | RTC_CRH_ALRIE | RTC_CRH_SECIE);

+  RTC->CRL &= ~(RTC_CRL_SECF | RTC_CRL_ALRF | RTC_CRL_OWF);

+

+  RTCD.config = NULL;

+}

+

+/**

+ * @brief     Configure and start interrupt servicing routines.

+ *            This function do nothing if callbacks disabled.

+ *

+ * @param[in] rtcp    pointer to a @p RTCDriver object

+ * @param[in] rtccfgp pointer to a @p RTCDriver config object

+ */

+void rtc_lld_start(RTCDriver *rtcp, const RTCConfig *rtccfgp){

+  uint16_t isr_flags = 0;

+

+  NVICEnableVector(RTC_IRQn, CORTEX_PRIORITY_MASK(STM32_RTC_IRQ_PRIORITY));

+

+  rtcp->config = rtccfgp;

+  if (rtcp->config->overflow_cb != NULL){

+    isr_flags |= RTC_CRH_OWIE;

+  }

+  if (rtcp->config->alarm_cb != NULL){

+    isr_flags |= RTC_CRH_ALRIE;

+  }

+  if (rtcp->config->second_cb != NULL){

+    isr_flags |= RTC_CRH_SECIE;

+  }

+

+  /* clear all event flags just to be safe */

+  RTC->CRL &= ~(RTC_CRL_SECF | RTC_CRL_ALRF | RTC_CRL_OWF);

+  RTC->CRH |= isr_flags;

+}

+

+/**

+ * @brief   Disable interrupt servicing routines.

+ */

+void rtc_lld_stop(void){

+  NVICDisableVector(RTC_IRQn);

+  RTC->CRH = 0;

+}

+

+

+/**

+ * @brief     Set current time.

+ *

+ * @param[in] tv_sec     time value in UNIX notation.

+ */

+void rtc_lld_set_time(uint32_t tv_sec){

+

+  while(!(RTC->CRL & RTC_CRL_RTOFF))

+    ;

+

+  RTC->CRL |= RTC_CRL_CNF;                            /* switch on configure mode */

+  RTC->CNTH = (uint16_t)((tv_sec >> 16) & 0xFFFF);    /* write time */

+  RTC->CNTL = (uint16_t)(tv_sec & 0xFFFF);

+  RTC->CRL &= ~RTC_CRL_CNF;                           /* switch off configure mode */

+

+  while(!(RTC->CRL & RTC_CRL_RTOFF))                  /* wait for completion */

+    ;

+}

+

+/**

+ * @brief Return current time in UNIX notation.

+ */

+inline uint32_t rtc_lld_get_sec(void){

+  return ((RTC->CNTH << 16) + RTC->CNTL);

+}

+

+/**

+ * @brief Return fractional part of current time (milliseconds).

+ */

+inline uint16_t rtc_lld_get_msec(void){

+  uint32_t time_frac = 0;

+  time_frac = (((uint32_t)RTC->DIVH) << 16) + (RTC->DIVL);

+  return(((STM32_LSECLK - time_frac) * 1000) / STM32_LSECLK);

+}

+

+/**

+ * @brief Set alarm date in UNIX notation.

+ */

+void rtc_lld_set_alarm(uint32_t tv_alarm){

+

+  while(!(RTC->CRL & RTC_CRL_RTOFF))

+    ;

+

+  RTC->CRL |= RTC_CRL_CNF;                            /* switch on configure mode */

+  RTC->ALRH = (uint16_t)((tv_alarm >> 16) & 0xFFFF);  /* write time */

+  RTC->ALRL = (uint16_t)(tv_alarm & 0xFFFF);

+  RTC->CRL &= ~RTC_CRL_CNF;                           /* switch off configure mode */

+

+#if !(RTC_SUPPORTS_CALLBACKS)

+  RTC->CRL &= ~RTC_CRL_ALRF;

+  RTC->CRH |= RTC_CRH_ALRIE;

+#endif /* !(RTC_SUPPORTS_CALLBACKS) */

+

+  while(!(RTC->CRL & RTC_CRL_RTOFF))                  /* wait for completion */

+    ;

+}

+

+/**

+ * @brief Get current alarm date in UNIX notation.

+ * @note  Default value after reset is 0xFFFFFFFF

+ */

+inline uint32_t rtc_lld_get_alarm(void){

+  return ((RTC->ALRH << 16) + RTC->ALRL);

+}

+

+

+#endif /* HAL_USE_RTC */

+

+/** @} */

diff --git a/os/hal/platforms/STM32/rtc_lld.h b/os/hal/platforms/STM32/rtc_lld.h
new file mode 100644
index 000000000..3b4f69665
--- /dev/null
+++ b/os/hal/platforms/STM32/rtc_lld.h
@@ -0,0 +1,130 @@
+/*

+    ChibiOS/RT - Copyright (C) 2006,2007,2008,2009,2010,

+                 2011 Giovanni Di Sirio.

+

+    This file is part of ChibiOS/RT.

+

+    ChibiOS/RT is free software; you can redistribute it and/or modify

+    it under the terms of the GNU General Public License as published by

+    the Free Software Foundation; either version 3 of the License, or

+    (at your option) any later version.

+

+    ChibiOS/RT is distributed in the hope that it will be useful,

+    but WITHOUT ANY WARRANTY; without even the implied warranty of

+    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the

+    GNU General Public License for more details.

+

+    You should have received a copy of the GNU General Public License

+    along with this program.  If not, see <http://www.gnu.org/licenses/>.

+*/

+

+/**

+ * @file    STM32/rtc_lld.h

+ * @brief   STM32 RTC subsystem low level driver header.

+ *

+ * @addtogroup RTC

+ * @{

+ */

+

+#ifndef _RTC_LLD_H_

+#define _RTC_LLD_H_

+

+#if HAL_USE_RTC || defined(__DOXYGEN__)

+

+/*===========================================================================*/

+/* Driver constants.                                                         */

+/*===========================================================================*/

+

+/*===========================================================================*/

+/* Driver pre-compile time settings.                                         */

+/*===========================================================================*/

+/**

+ * @brief   Switch to TRUE if you need callbacks from RTC. Switch to FALSE

+ *          if you need only time keeping.

+ * @note    Default is true.

+ */

+#if !defined(RTC_SUPPORTS_CALLBACKS) || defined(__DOXYGEN__)

+#define RTC_SUPPORTS_CALLBACKS              TRUE

+#endif

+

+/**

+ * @brief   Clock source selecting. LSE by default.

+ */

+#if !defined(RTC_CLOCK_SOURCE) || defined(__DOXYGEN__)

+#define RTC_CLOCK_SOURCE                    RCC_BDCR_RTCSEL_LSE

+#endif

+

+

+/*===========================================================================*/

+/* Derived constants and error checks.                                       */

+/*===========================================================================*/

+

+#if HAL_USE_RTC && !STM32_HAS_RTC

+#error "RTC not present in the selected device"

+#endif

+

+/*===========================================================================*/

+/* Driver data structures and types.                                         */

+/*===========================================================================*/

+/**

+ * @brief Structure representing an RTC driver config.

+ */

+typedef struct {

+  /**

+   * @brief Overflow callback. Set it to NULL if not used.

+   */

+  rtccb_t           overflow_cb;

+

+  /**

+   * @brief Every second callback. Set it to NULL if not used.

+   */

+  rtccb_t           second_cb;

+

+  /**

+   * @brief Alarm callback. Set it to NULL if not used.

+   */

+  rtccb_t           alarm_cb;

+}RTCConfig;

+

+

+/**

+ * @brief Structure representing an RTC driver.

+ */

+struct RTCDriver{

+  /**

+   * @brief Pointer to RCT config.

+   */

+  const RTCConfig       *config;

+};

+

+/*===========================================================================*/

+/* Driver macros.                                                            */

+/*===========================================================================*/

+

+/*===========================================================================*/

+/* External declarations.                                                    */

+/*===========================================================================*/

+

+extern RTCDriver RTCD;

+

+

+#ifdef __cplusplus

+extern "C" {

+#endif

+  void rtc_lld_init(void);

+  void rtc_lld_start(RTCDriver *rtcp, const RTCConfig *rtccfgp);

+  void rtc_lld_stop(void);

+  void rtc_lld_set_time(uint32_t tv_sec);

+  uint32_t rtc_lld_get_sec(void);

+  uint16_t rtc_lld_get_msec(void);

+  uint32_t rtc_lld_get_alarm(void);

+  void rtc_lld_set_alarm(uint32_t);

+#ifdef __cplusplus

+}

+#endif

+

+

+#endif /* HAL_USE_RTC */

+#endif /* _RTC_LLD_H_ */

+

+/** @} */

diff --git a/os/hal/platforms/STM32F1xx/platform.mk b/os/hal/platforms/STM32F1xx/platform.mk
index 010a3f96d..26f13cd81 100644
--- a/os/hal/platforms/STM32F1xx/platform.mk
+++ b/os/hal/platforms/STM32F1xx/platform.mk
@@ -12,7 +12,8 @@ PLATFORMSRC = ${CHIBIOS}/os/hal/platforms/STM32F1xx/hal_lld.c \
               ${CHIBIOS}/os/hal/platforms/STM32/DMAv1/spi_lld.c \

               ${CHIBIOS}/os/hal/platforms/STM32/DMAv1/uart_lld.c \

               ${CHIBIOS}/os/hal/platforms/STM32/DMAv1/stm32_dma.c \

-              ${CHIBIOS}/os/hal/platforms/STM32/USBv1/usb_lld.c

+              ${CHIBIOS}/os/hal/platforms/STM32/USBv1/usb_lld.c \

+              ${CHIBIOS}/os/hal/platforms/STM32/rtc_lld.c

 

 # Required include directories

 PLATFORMINC = ${CHIBIOS}/os/hal/platforms/STM32F1xx \

diff --git a/os/hal/src/hal.c b/os/hal/src/hal.c
index ef7d7af8b..3c8fb2fe6 100644
--- a/os/hal/src/hal.c
+++ b/os/hal/src/hal.c
@@ -107,6 +107,9 @@ void halInit(void) {
 #if HAL_USE_SERIAL_USB || defined(__DOXYGEN__)

   sduInit();

 #endif

+#if HAL_USE_RTC || defined(__DOXYGEN__)

+  rtcInit();

+#endif

   /* Board specific initialization.*/

   boardInit();

 }

diff --git a/os/hal/src/rtc.c b/os/hal/src/rtc.c
new file mode 100644
index 000000000..1341bb2dd
--- /dev/null
+++ b/os/hal/src/rtc.c
@@ -0,0 +1,126 @@
+/*

+    ChibiOS/RT - Copyright (C) 2006,2007,2008,2009,2010,

+                 2011 Giovanni Di Sirio.

+

+    This file is part of ChibiOS/RT.

+

+    ChibiOS/RT is free software; you can redistribute it and/or modify

+    it under the terms of the GNU General Public License as published by

+    the Free Software Foundation; either version 3 of the License, or

+    (at your option) any later version.

+

+    ChibiOS/RT is distributed in the hope that it will be useful,

+    but WITHOUT ANY WARRANTY; without even the implied warranty of

+    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the

+    GNU General Public License for more details.

+

+    You should have received a copy of the GNU General Public License

+    along with this program.  If not, see <http://www.gnu.org/licenses/>.

+*/

+

+/**

+ * @file    rtc.c

+ * @brief   Real Time Clock Abstraction Layer code.

+ *

+ * @addtogroup RTC

+ * @{

+ */

+

+#include "ch.h"

+#include "hal.h"

+

+#include "rtc_lld.h"

+

+#if HAL_USE_RTC || defined(__DOXYGEN__)

+

+/*===========================================================================*/

+/* Driver local definitions.                                                 */

+/*===========================================================================*/

+

+/*===========================================================================*/

+/* Driver exported variables.                                                */

+/*===========================================================================*/

+

+/*===========================================================================*/

+/* Driver local variables.                                                   */

+/*===========================================================================*/

+

+/*===========================================================================*/

+/* Driver local functions.                                                   */

+/*===========================================================================*/

+

+/*===========================================================================*/

+/* Driver exported functions.                                                */

+/*===========================================================================*/

+/**

+ * @brief   Enable access to registers and initialize RTC if BKP doamin

+ *          was previously reseted.

+ */

+void rtcInit(void){

+  rtc_lld_init();

+}

+

+/**

+ * @brief     Configure and start interrupt servicing routines.

+ *            This function do nothing if callbacks disabled.

+ *

+ * @param[in] rtcp - pointer to RTC driver structure.

+ * @param[in] rtccfgp - pointer to RTC config structure.

+ */

+#if RTC_SUPPORTS_CALLBACKS

+void rtcStartI(RTCDriver *rtcp, const RTCConfig *rtccfgp){

+  chDbgCheckClassI();

+  chDbgCheck(((rtcp != NULL) && (rtccfgp != NULL)), "rtcStart");

+  rtc_lld_start(rtcp, rtccfgp);

+}

+

+/**

+ * @brief   Stop interrupt servicing routines.

+ */

+void rtcStopI(void){

+  chDbgCheckClassI();

+  rtc_lld_stop();

+}

+#endif /* RTC_SUPPORTS_CALLBACKS */

+

+/**

+ * @brief     Set current time.

+ * @param[in] tv_sec - time value in UNIX notation.

+ */

+void rtcSetTime(uint32_t tv_sec){

+  rtc_lld_set_time(tv_sec);

+}

+

+/**

+ * @brief Return current time in UNIX notation.

+ */

+inline uint32_t rtcGetSec(void){

+  return rtc_lld_get_sec();

+}

+

+/**

+ * @brief Return fractional part of current time (milliseconds).

+ */

+inline uint16_t rtcGetMsec(void){

+  return rtc_lld_get_msec();

+}

+

+/**

+ * @brief Set alarm date in UNIX notation.

+ */

+void rtcSetAlarm(uint32_t tv_alarm){

+  rtc_lld_set_alarm(tv_alarm);

+}

+

+/**

+ * @brief Get current alarm date in UNIX notation.

+ */

+inline uint32_t rtcGetAlarm(void){

+  return rtc_lld_get_alarm();

+}

+

+#endif /* HAL_USE_RTC */

+

+/** @} */

+

+