WebSVN – canSerial – Diff – /trunk/Drivers/STM32F1xx_HAL_Driver/Src/stm32f1xx_hal_rtc_ex.c

 /**
   ******************************************************************************
   * @file    stm32f1xx_hal_rtc_ex.c
   * @author  MCD Application Team
   * @brief   Extended RTC HAL module driver.
   *          This file provides firmware functions to manage the following
   *          functionalities of the Real Time Clock (RTC) Extension peripheral:
   *           + RTC Tamper functions
   *           + Extension Control functions
   *           + Extension RTC features functions
   *
   ******************************************************************************
   * @attention
   *
-  * <h2><center>&copy; Copyright (c) 2016 STMicroelectronics.
+  * Copyright (c) 2016 STMicroelectronics.
-  * All rights reserved.</center></h2>
+  * All rights reserved.
   *
-  * This software component is licensed by ST under BSD 3-Clause license,
+  * This software is licensed under terms that can be found in the LICENSE file
-  * the "License"; You may not use this file except in compliance with the
+  * in the root directory of this software component.
-  * License. You may obtain a copy of the License at:
+  * If no LICENSE file comes with this software, it is provided AS-IS.
-  *                        opensource.org/licenses/BSD-3-Clause
+  *
-  *
+  ******************************************************************************
-  ******************************************************************************
+  */
-  */
+/* Includes ------------------------------------------------------------------*/
-/* Includes ------------------------------------------------------------------*/
+#include "stm32f1xx_hal.h"
-#include "stm32f1xx_hal.h"
+/** @addtogroup STM32F1xx_HAL_Driver
-/** @addtogroup STM32F1xx_HAL_Driver
+  * @{
-  * @{
+  */
-  */
+#ifdef HAL_RTC_MODULE_ENABLED
-#ifdef HAL_RTC_MODULE_ENABLED
+/** @defgroup RTCEx RTCEx
-/** @defgroup RTCEx RTCEx
+  * @brief RTC Extended HAL module driver
-  * @brief RTC Extended HAL module driver
+  * @{
-  * @{
+  */
-  */
+/* Private typedef -----------------------------------------------------------*/
-/* Private typedef -----------------------------------------------------------*/
+/* Private define ------------------------------------------------------------*/
-/* Private define ------------------------------------------------------------*/
+/* Private macro -------------------------------------------------------------*/
-/* Private macro -------------------------------------------------------------*/
+/** @defgroup RTCEx_Private_Macros RTCEx Private Macros
-/** @defgroup RTCEx_Private_Macros RTCEx Private Macros
+  * @{
-  * @{
+  */
-  */
+/**
-/**
+  * @}
-  * @}
+  */
-  */
+/* Private variables ---------------------------------------------------------*/
-/* Private variables ---------------------------------------------------------*/
+/* Private function prototypes -----------------------------------------------*/
-/* Private function prototypes -----------------------------------------------*/
+/* Private functions ---------------------------------------------------------*/
-/* Private functions ---------------------------------------------------------*/
+/** @defgroup RTCEx_Exported_Functions RTCEx Exported Functions
-/** @defgroup RTCEx_Exported_Functions RTCEx Exported Functions
+  * @{
-  * @{
+  */
-  */
+/** @defgroup RTCEx_Exported_Functions_Group1 RTC Tamper functions
-/** @defgroup RTCEx_Exported_Functions_Group1 RTC Tamper functions
+  * @brief    RTC Tamper functions
-  * @brief    RTC Tamper functions
+  *
-  *
+@verbatim
-@verbatim
+ ===============================================================================
- ===============================================================================
+                 ##### RTC Tamper functions #####
-                 ##### RTC Tamper functions #####
+ ===============================================================================
- ===============================================================================
+ [..] This section provides functions allowing to configure Tamper feature
- [..] This section provides functions allowing to configure Tamper feature
+@endverbatim
-@endverbatim
+  * @{
-  * @{
+  */
-  */
+/**
-/**
+  * @brief  Sets Tamper
-  * @brief  Sets Tamper
+  * @note   By calling this API we disable the tamper interrupt for all tampers.
-  * @note   By calling this API we disable the tamper interrupt for all tampers.
+  * @param  hrtc: pointer to a RTC_HandleTypeDef structure that contains
-  * @param  hrtc: pointer to a RTC_HandleTypeDef structure that contains
+  *                the configuration information for RTC.
-  *                the configuration information for RTC.
+  * @param  sTamper: Pointer to Tamper Structure.
-  * @param  sTamper: Pointer to Tamper Structure.
+  * @note   Tamper can be enabled only if ASOE and CCO bit are reset
-  * @note   Tamper can be enabled only if ASOE and CCO bit are reset
+  * @retval HAL status
-  * @retval HAL status
+  */
-  */
+HAL_StatusTypeDef HAL_RTCEx_SetTamper(RTC_HandleTypeDef *hrtc, RTC_TamperTypeDef *sTamper)
-HAL_StatusTypeDef HAL_RTCEx_SetTamper(RTC_HandleTypeDef *hrtc, RTC_TamperTypeDef *sTamper)
+{
-{
+  /* Check input parameters */
-  /* Check input parameters */
+  if ((hrtc == NULL) || (sTamper == NULL))
-  if ((hrtc == NULL) || (sTamper == NULL))
+  {
-  {
+    return HAL_ERROR;
-    return HAL_ERROR;
+  }
-  }
+  /* Check the parameters */
-  /* Check the parameters */
+  assert_param(IS_RTC_TAMPER(sTamper->Tamper));
-  assert_param(IS_RTC_TAMPER(sTamper->Tamper));
+  assert_param(IS_RTC_TAMPER_TRIGGER(sTamper->Trigger));
-  assert_param(IS_RTC_TAMPER_TRIGGER(sTamper->Trigger));
+  /* Process Locked */
-  /* Process Locked */
+  __HAL_LOCK(hrtc);
-  __HAL_LOCK(hrtc);
+  hrtc->State = HAL_RTC_STATE_BUSY;
-  hrtc->State = HAL_RTC_STATE_BUSY;
+  if (HAL_IS_BIT_SET(BKP->RTCCR, (BKP_RTCCR_CCO | BKP_RTCCR_ASOE)))
-  if (HAL_IS_BIT_SET(BKP->RTCCR, (BKP_RTCCR_CCO | BKP_RTCCR_ASOE)))
+  {
-  {
+    hrtc->State = HAL_RTC_STATE_ERROR;
-    hrtc->State = HAL_RTC_STATE_ERROR;
+    /* Process Unlocked */
-    /* Process Unlocked */
+    __HAL_UNLOCK(hrtc);
-    __HAL_UNLOCK(hrtc);
+    return HAL_ERROR;
-    return HAL_ERROR;
+  }
-  }
+  MODIFY_REG(BKP->CR, (BKP_CR_TPE | BKP_CR_TPAL), (sTamper->Tamper | (sTamper->Trigger)));
-  MODIFY_REG(BKP->CR, (BKP_CR_TPE | BKP_CR_TPAL), (sTamper->Tamper | (sTamper->Trigger)));
+  hrtc->State = HAL_RTC_STATE_READY;
-  hrtc->State = HAL_RTC_STATE_READY;
+  /* Process Unlocked */
-  /* Process Unlocked */
+  __HAL_UNLOCK(hrtc);
-  __HAL_UNLOCK(hrtc);
+  return HAL_OK;
-  return HAL_OK;
+}
-}
+/**
-/**
+  * @brief  Sets Tamper with interrupt.
-  * @brief  Sets Tamper with interrupt.
+  * @note   By calling this API we force the tamper interrupt for all tampers.
-  * @note   By calling this API we force the tamper interrupt for all tampers.
+  * @param  hrtc: pointer to a RTC_HandleTypeDef structure that contains
-  * @param  hrtc: pointer to a RTC_HandleTypeDef structure that contains
+  *                the configuration information for RTC.
-  *                the configuration information for RTC.
+  * @param  sTamper: Pointer to RTC Tamper.
-  * @param  sTamper: Pointer to RTC Tamper.
+  * @note   Tamper can be enabled only if ASOE and CCO bit are reset
-  * @note   Tamper can be enabled only if ASOE and CCO bit are reset
+  * @retval HAL status
-  * @retval HAL status
+  */
-  */
+HAL_StatusTypeDef HAL_RTCEx_SetTamper_IT(RTC_HandleTypeDef *hrtc, RTC_TamperTypeDef *sTamper)
-HAL_StatusTypeDef HAL_RTCEx_SetTamper_IT(RTC_HandleTypeDef *hrtc, RTC_TamperTypeDef *sTamper)
+{
-{
+  /* Check input parameters */
-  /* Check input parameters */
+  if ((hrtc == NULL) || (sTamper == NULL))
-  if ((hrtc == NULL) || (sTamper == NULL))
+  {
-  {
+    return HAL_ERROR;
-    return HAL_ERROR;
+  }
-  }
+  /* Check the parameters */
-  /* Check the parameters */
+  assert_param(IS_RTC_TAMPER(sTamper->Tamper));
-  assert_param(IS_RTC_TAMPER(sTamper->Tamper));
+  assert_param(IS_RTC_TAMPER_TRIGGER(sTamper->Trigger));
-  assert_param(IS_RTC_TAMPER_TRIGGER(sTamper->Trigger));
+  /* Process Locked */
-  /* Process Locked */
+  __HAL_LOCK(hrtc);
-  __HAL_LOCK(hrtc);
+  hrtc->State = HAL_RTC_STATE_BUSY;
-  hrtc->State = HAL_RTC_STATE_BUSY;
+  if (HAL_IS_BIT_SET(BKP->RTCCR, (BKP_RTCCR_CCO | BKP_RTCCR_ASOE)))
-  if (HAL_IS_BIT_SET(BKP->RTCCR, (BKP_RTCCR_CCO | BKP_RTCCR_ASOE)))
+  {
-  {
+    hrtc->State = HAL_RTC_STATE_ERROR;
-    hrtc->State = HAL_RTC_STATE_ERROR;
+    /* Process Unlocked */
-    /* Process Unlocked */
+    __HAL_UNLOCK(hrtc);
-    __HAL_UNLOCK(hrtc);
+    return HAL_ERROR;
-    return HAL_ERROR;
+  }
-  }
+  MODIFY_REG(BKP->CR, (BKP_CR_TPE | BKP_CR_TPAL), (sTamper->Tamper | (sTamper->Trigger)));
-  MODIFY_REG(BKP->CR, (BKP_CR_TPE | BKP_CR_TPAL), (sTamper->Tamper | (sTamper->Trigger)));
+  /* Configure the Tamper Interrupt in the BKP->CSR */
-  /* Configure the Tamper Interrupt in the BKP->CSR */
+  __HAL_RTC_TAMPER_ENABLE_IT(hrtc, RTC_IT_TAMP1);
-  __HAL_RTC_TAMPER_ENABLE_IT(hrtc, RTC_IT_TAMP1);
+  hrtc->State = HAL_RTC_STATE_READY;
-  hrtc->State = HAL_RTC_STATE_READY;
+  /* Process Unlocked */
-  /* Process Unlocked */
+  __HAL_UNLOCK(hrtc);
-  __HAL_UNLOCK(hrtc);
+  return HAL_OK;
-  return HAL_OK;
+}
-}
+/**
-/**
+  * @brief  Deactivates Tamper.
-  * @brief  Deactivates Tamper.
+  * @param  hrtc: pointer to a RTC_HandleTypeDef structure that contains
-  * @param  hrtc: pointer to a RTC_HandleTypeDef structure that contains
+  *                the configuration information for RTC.
-  *                the configuration information for RTC.
+  * @param  Tamper: Selected tamper pin.
-  * @param  Tamper: Selected tamper pin.
+  *          This parameter can be a value of @ref RTCEx_Tamper_Pins_Definitions
-  *          This parameter can be a value of @ref RTCEx_Tamper_Pins_Definitions
+  * @retval HAL status
-  * @retval HAL status
+  */
-  */
+HAL_StatusTypeDef HAL_RTCEx_DeactivateTamper(RTC_HandleTypeDef *hrtc, uint32_t Tamper)
-HAL_StatusTypeDef HAL_RTCEx_DeactivateTamper(RTC_HandleTypeDef *hrtc, uint32_t Tamper)
+{
-{
+  /* Check input parameters */
-  /* Check input parameters */
+  if (hrtc == NULL)
-  if (hrtc == NULL)
+  {
-  {
+    return HAL_ERROR;
-    return HAL_ERROR;
+  }
-  }
+  /* Prevent unused argument(s) compilation warning */
-  /* Prevent unused argument(s) compilation warning */
+  UNUSED(Tamper);
-  UNUSED(Tamper);
+  assert_param(IS_RTC_TAMPER(Tamper));
-  assert_param(IS_RTC_TAMPER(Tamper));
+  /* Process Locked */
-  /* Process Locked */
+  __HAL_LOCK(hrtc);
-  __HAL_LOCK(hrtc);
+  hrtc->State = HAL_RTC_STATE_BUSY;
-  hrtc->State = HAL_RTC_STATE_BUSY;
+  /* Disable the selected Tamper pin */
-  /* Disable the selected Tamper pin */
+  CLEAR_BIT(BKP->CR, BKP_CR_TPE);
-  CLEAR_BIT(BKP->CR, BKP_CR_TPE);
+  /* Disable the Tamper Interrupt in the BKP->CSR */
-  /* Disable the Tamper Interrupt in the BKP->CSR */
+  /* Configure the Tamper Interrupt in the BKP->CSR */
-  /* Configure the Tamper Interrupt in the BKP->CSR */
+  __HAL_RTC_TAMPER_DISABLE_IT(hrtc, RTC_IT_TAMP1);
-  __HAL_RTC_TAMPER_DISABLE_IT(hrtc, RTC_IT_TAMP1);
+  /* Clear the Tamper interrupt pending bit */
-  /* Clear the Tamper interrupt pending bit */
+  __HAL_RTC_TAMPER_CLEAR_FLAG(hrtc, RTC_FLAG_TAMP1F);
-  __HAL_RTC_TAMPER_CLEAR_FLAG(hrtc, RTC_FLAG_TAMP1F);
+  SET_BIT(BKP->CSR, BKP_CSR_CTE);
-  SET_BIT(BKP->CSR, BKP_CSR_CTE);
+  hrtc->State = HAL_RTC_STATE_READY;
-  hrtc->State = HAL_RTC_STATE_READY;
+  /* Process Unlocked */
-  /* Process Unlocked */
+  __HAL_UNLOCK(hrtc);
-  __HAL_UNLOCK(hrtc);
+  return HAL_OK;
-  return HAL_OK;
+}
-}
+/**
-/**
+  * @brief  This function handles Tamper interrupt request.
-  * @brief  This function handles Tamper interrupt request.
+  * @param  hrtc: pointer to a RTC_HandleTypeDef structure that contains
-  * @param  hrtc: pointer to a RTC_HandleTypeDef structure that contains
+  *                the configuration information for RTC.
-  *                the configuration information for RTC.
+  * @retval None
-  * @retval None
+  */
-  */
+void HAL_RTCEx_TamperIRQHandler(RTC_HandleTypeDef *hrtc)
-void HAL_RTCEx_TamperIRQHandler(RTC_HandleTypeDef *hrtc)
+{
-{
+  /* Get the status of the Interrupt */
-  /* Get the status of the Interrupt */
+  if (__HAL_RTC_TAMPER_GET_IT_SOURCE(hrtc, RTC_IT_TAMP1))
-  if (__HAL_RTC_TAMPER_GET_IT_SOURCE(hrtc, RTC_IT_TAMP1))
+  {
-  {
+    /* Get the TAMPER Interrupt enable bit and pending bit */
-    /* Get the TAMPER Interrupt enable bit and pending bit */
+    if (__HAL_RTC_TAMPER_GET_FLAG(hrtc, RTC_FLAG_TAMP1F) != (uint32_t)RESET)
-    if (__HAL_RTC_TAMPER_GET_FLAG(hrtc, RTC_FLAG_TAMP1F) != (uint32_t)RESET)
+    {
-    {
+      /* Tamper callback */
-      /* Tamper callback */
+#if (USE_HAL_RTC_REGISTER_CALLBACKS == 1)
-#if (USE_HAL_RTC_REGISTER_CALLBACKS == 1)
+      hrtc->Tamper1EventCallback(hrtc);
-      hrtc->Tamper1EventCallback(hrtc);
+#else
-#else
+      HAL_RTCEx_Tamper1EventCallback(hrtc);
-      HAL_RTCEx_Tamper1EventCallback(hrtc);
+#endif /* USE_HAL_RTC_REGISTER_CALLBACKS */
-#endif /* USE_HAL_RTC_REGISTER_CALLBACKS */
+      /* Clear the Tamper interrupt pending bit */
-      /* Clear the Tamper interrupt pending bit */
+      __HAL_RTC_TAMPER_CLEAR_FLAG(hrtc, RTC_FLAG_TAMP1F);
-      __HAL_RTC_TAMPER_CLEAR_FLAG(hrtc, RTC_FLAG_TAMP1F);
+    }
-    }
+  }
-  }
+  /* Change RTC state */
-  /* Change RTC state */
+  hrtc->State = HAL_RTC_STATE_READY;
-  hrtc->State = HAL_RTC_STATE_READY;
+}
-}
+/**
-/**
+  * @brief  Tamper 1 callback.
-  * @brief  Tamper 1 callback.
+  * @param  hrtc: pointer to a RTC_HandleTypeDef structure that contains
-  * @param  hrtc: pointer to a RTC_HandleTypeDef structure that contains
+  *                the configuration information for RTC.
-  *                the configuration information for RTC.
+  * @retval None
-  * @retval None
+  */
-  */
+__weak void HAL_RTCEx_Tamper1EventCallback(RTC_HandleTypeDef *hrtc)
-__weak void HAL_RTCEx_Tamper1EventCallback(RTC_HandleTypeDef *hrtc)
+{
-{
+  /* Prevent unused argument(s) compilation warning */
-  /* Prevent unused argument(s) compilation warning */
+  UNUSED(hrtc);
-  UNUSED(hrtc);
+  /* NOTE : This function Should not be modified, when the callback is needed,
-  /* NOTE : This function Should not be modified, when the callback is needed,
+            the HAL_RTCEx_Tamper1EventCallback could be implemented in the user file
-            the HAL_RTCEx_Tamper1EventCallback could be implemented in the user file
+   */
-   */
+}
-}
+/**
-/**
+  * @brief  This function handles Tamper1 Polling.
-  * @brief  This function handles Tamper1 Polling.
+  * @param  hrtc: pointer to a RTC_HandleTypeDef structure that contains
-  * @param  hrtc: pointer to a RTC_HandleTypeDef structure that contains
+  *                the configuration information for RTC.
-  *                the configuration information for RTC.
+  * @param  Timeout: Timeout duration
-  * @param  Timeout: Timeout duration
+  * @retval HAL status
-  * @retval HAL status
+  */
-  */
+HAL_StatusTypeDef HAL_RTCEx_PollForTamper1Event(RTC_HandleTypeDef *hrtc, uint32_t Timeout)
-HAL_StatusTypeDef HAL_RTCEx_PollForTamper1Event(RTC_HandleTypeDef *hrtc, uint32_t Timeout)
+{
-{
+  uint32_t tickstart = HAL_GetTick();
-  uint32_t tickstart = HAL_GetTick();
+  /* Check input parameters */
-  /* Check input parameters */
+  if (hrtc == NULL)
-  if (hrtc == NULL)
+  {
-  {
+    return HAL_ERROR;
-    return HAL_ERROR;
+  }
-  }
+  /* Get the status of the Interrupt */
-  /* Get the status of the Interrupt */
+  while (__HAL_RTC_TAMPER_GET_FLAG(hrtc, RTC_FLAG_TAMP1F) == RESET)
-  while (__HAL_RTC_TAMPER_GET_FLAG(hrtc, RTC_FLAG_TAMP1F) == RESET)
+  {
-  {
+    if (Timeout != HAL_MAX_DELAY)
-    if (Timeout != HAL_MAX_DELAY)
+    {
-    {
+      if ((Timeout == 0U) || ((HAL_GetTick() - tickstart) > Timeout))
-      if ((Timeout == 0U) || ((HAL_GetTick() - tickstart) > Timeout))
+      {
-      {
+        hrtc->State = HAL_RTC_STATE_TIMEOUT;
-        hrtc->State = HAL_RTC_STATE_TIMEOUT;
+        return HAL_TIMEOUT;
-        return HAL_TIMEOUT;
+      }
-      }
+    }
-    }
+  }
-  }
+  /* Clear the Tamper Flag */
-  /* Clear the Tamper Flag */
+  __HAL_RTC_TAMPER_CLEAR_FLAG(hrtc, RTC_FLAG_TAMP1F);
-  __HAL_RTC_TAMPER_CLEAR_FLAG(hrtc, RTC_FLAG_TAMP1F);
+  /* Change RTC state */
-  /* Change RTC state */
+  hrtc->State = HAL_RTC_STATE_READY;
-  hrtc->State = HAL_RTC_STATE_READY;
+  return HAL_OK;
-  return HAL_OK;
+}
-}
+/**
-/**
+  * @}
-  * @}
+  */
-  */
+/** @defgroup RTCEx_Exported_Functions_Group2 RTC Second functions
-/** @defgroup RTCEx_Exported_Functions_Group2 RTC Second functions
+  * @brief    RTC Second functions
-  * @brief    RTC Second functions
+  *
-  *
+@verbatim
-@verbatim
+ ===============================================================================
- ===============================================================================
+                 ##### RTC Second functions #####
-                 ##### RTC Second functions #####
+ ===============================================================================
- ===============================================================================
+ [..] This section provides functions implementing second interrupt handlers
- [..] This section provides functions implementing second interupt handlers
+@endverbatim
-@endverbatim
+  * @{
-  * @{
+  */
-  */
+/**
-/**
+  * @brief  Sets Interrupt for second
-  * @brief  Sets Interrupt for second
+  * @param  hrtc: pointer to a RTC_HandleTypeDef structure that contains
-  * @param  hrtc: pointer to a RTC_HandleTypeDef structure that contains
+  *                the configuration information for RTC.
-  *                the configuration information for RTC.
+  * @retval HAL status
-  * @retval HAL status
+  */
-  */
+HAL_StatusTypeDef HAL_RTCEx_SetSecond_IT(RTC_HandleTypeDef *hrtc)
-HAL_StatusTypeDef HAL_RTCEx_SetSecond_IT(RTC_HandleTypeDef *hrtc)
+{
-{
+  /* Check input parameters */
-  /* Check input parameters */
+  if (hrtc == NULL)
-  if (hrtc == NULL)
+  {
-  {
+    return HAL_ERROR;
-    return HAL_ERROR;
+  }
-  }
+  /* Process Locked */
-  /* Process Locked */
+  __HAL_LOCK(hrtc);
-  __HAL_LOCK(hrtc);
+  hrtc->State = HAL_RTC_STATE_BUSY;
-  hrtc->State = HAL_RTC_STATE_BUSY;
+  /* Enable Second interruption */
-  /* Enable Second interuption */
+  __HAL_RTC_SECOND_ENABLE_IT(hrtc, RTC_IT_SEC);
-  __HAL_RTC_SECOND_ENABLE_IT(hrtc, RTC_IT_SEC);
+  hrtc->State = HAL_RTC_STATE_READY;
-  hrtc->State = HAL_RTC_STATE_READY;
+  /* Process Unlocked */
-  /* Process Unlocked */
+  __HAL_UNLOCK(hrtc);
-  __HAL_UNLOCK(hrtc);
+  return HAL_OK;
-  return HAL_OK;
+}
-}
+/**
-/**
+  * @brief  Deactivates Second.
-  * @brief  Deactivates Second.
+  * @param  hrtc: pointer to a RTC_HandleTypeDef structure that contains
-  * @param  hrtc: pointer to a RTC_HandleTypeDef structure that contains
+  *                the configuration information for RTC.
-  *                the configuration information for RTC.
+  * @retval HAL status
-  * @retval HAL status
+  */
-  */
+HAL_StatusTypeDef HAL_RTCEx_DeactivateSecond(RTC_HandleTypeDef *hrtc)
-HAL_StatusTypeDef HAL_RTCEx_DeactivateSecond(RTC_HandleTypeDef *hrtc)
+{
-{
+  /* Check input parameters */
-  /* Check input parameters */
+  if (hrtc == NULL)
-  if (hrtc == NULL)
+  {
-  {
+    return HAL_ERROR;
-    return HAL_ERROR;
+  }
-  }
+  /* Process Locked */
-  /* Process Locked */
+  __HAL_LOCK(hrtc);
-  __HAL_LOCK(hrtc);
+  hrtc->State = HAL_RTC_STATE_BUSY;
-  hrtc->State = HAL_RTC_STATE_BUSY;
+  /* Deactivate Second interruption*/
-  /* Deactivate Second interuption*/
+  __HAL_RTC_SECOND_DISABLE_IT(hrtc, RTC_IT_SEC);
-  __HAL_RTC_SECOND_DISABLE_IT(hrtc, RTC_IT_SEC);
+  hrtc->State = HAL_RTC_STATE_READY;
-  hrtc->State = HAL_RTC_STATE_READY;
+  /* Process Unlocked */
-  /* Process Unlocked */
+  __HAL_UNLOCK(hrtc);
-  __HAL_UNLOCK(hrtc);
+  return HAL_OK;
-  return HAL_OK;
+}
-}
+/**
-/**
+  * @brief  This function handles second interrupt request.
-  * @brief  This function handles second interrupt request.
+  * @param  hrtc: pointer to a RTC_HandleTypeDef structure that contains
-  * @param  hrtc: pointer to a RTC_HandleTypeDef structure that contains
+  *                the configuration information for RTC.
-  *                the configuration information for RTC.
+  * @retval None
-  * @retval None
+  */
-  */
+void HAL_RTCEx_RTCIRQHandler(RTC_HandleTypeDef *hrtc)
-void HAL_RTCEx_RTCIRQHandler(RTC_HandleTypeDef *hrtc)
+{
-{
+  if (__HAL_RTC_SECOND_GET_IT_SOURCE(hrtc, RTC_IT_SEC))
-  if (__HAL_RTC_SECOND_GET_IT_SOURCE(hrtc, RTC_IT_SEC))
+  {
-  {
+    /* Get the status of the Interrupt */
-    /* Get the status of the Interrupt */
+    if (__HAL_RTC_SECOND_GET_FLAG(hrtc, RTC_FLAG_SEC))
-    if (__HAL_RTC_SECOND_GET_FLAG(hrtc, RTC_FLAG_SEC))
+    {
-    {
+      /* Check if Overrun occurred */
-      /* Check if Overrun occurred */
+      if (__HAL_RTC_SECOND_GET_FLAG(hrtc, RTC_FLAG_OW))
-      if (__HAL_RTC_SECOND_GET_FLAG(hrtc, RTC_FLAG_OW))
+      {
-      {
+        /* Second error callback */
-        /* Second error callback */
+        HAL_RTCEx_RTCEventErrorCallback(hrtc);
-        HAL_RTCEx_RTCEventErrorCallback(hrtc);
+        /* Clear flag Second */
-        /* Clear flag Second */
+        __HAL_RTC_OVERFLOW_CLEAR_FLAG(hrtc, RTC_FLAG_OW);
-        __HAL_RTC_OVERFLOW_CLEAR_FLAG(hrtc, RTC_FLAG_OW);
+        /* Change RTC state */
-        /* Change RTC state */
+        hrtc->State = HAL_RTC_STATE_ERROR;
-        hrtc->State = HAL_RTC_STATE_ERROR;
+      }
-      }
+      else
-      else
+      {
-      {
+        /* Second callback */
-        /* Second callback */
+        HAL_RTCEx_RTCEventCallback(hrtc);
-        HAL_RTCEx_RTCEventCallback(hrtc);
+        /* Change RTC state */
-        /* Change RTC state */
+        hrtc->State = HAL_RTC_STATE_READY;
-        hrtc->State = HAL_RTC_STATE_READY;
+      }
-      }
+      /* Clear flag Second */
-      /* Clear flag Second */
+      __HAL_RTC_SECOND_CLEAR_FLAG(hrtc, RTC_FLAG_SEC);
-      __HAL_RTC_SECOND_CLEAR_FLAG(hrtc, RTC_FLAG_SEC);
+    }
-    }
+  }
-  }
+}
-}
+/**
-/**
+  * @brief  Second event callback.
-  * @brief  Second event callback.
+  * @param  hrtc: pointer to a RTC_HandleTypeDef structure that contains
-  * @param  hrtc: pointer to a RTC_HandleTypeDef structure that contains
+  *                the configuration information for RTC.
-  *                the configuration information for RTC.
+  * @retval None
-  * @retval None
+  */
-  */
+__weak void HAL_RTCEx_RTCEventCallback(RTC_HandleTypeDef *hrtc)
-__weak void HAL_RTCEx_RTCEventCallback(RTC_HandleTypeDef *hrtc)
+{
-{
+  /* Prevent unused argument(s) compilation warning */
-  /* Prevent unused argument(s) compilation warning */
+  UNUSED(hrtc);
-  UNUSED(hrtc);
+  /* NOTE : This function Should not be modified, when the callback is needed,
-  /* NOTE : This function Should not be modified, when the callback is needed,
+            the HAL_RTCEx_RTCEventCallback could be implemented in the user file
-            the HAL_RTCEx_RTCEventCallback could be implemented in the user file
+   */
-   */
+}
-}
+/**
-/**
+  * @brief  Second event error callback.
-  * @brief  Second event error callback.
+  * @param  hrtc: pointer to a RTC_HandleTypeDef structure that contains
-  * @param  hrtc: pointer to a RTC_HandleTypeDef structure that contains
+  *                the configuration information for RTC.
-  *                the configuration information for RTC.
+  * @retval None
-  * @retval None
+  */
-  */
+__weak void HAL_RTCEx_RTCEventErrorCallback(RTC_HandleTypeDef *hrtc)
-__weak void HAL_RTCEx_RTCEventErrorCallback(RTC_HandleTypeDef *hrtc)
+{
-{
+  /* Prevent unused argument(s) compilation warning */
-  /* Prevent unused argument(s) compilation warning */
+  UNUSED(hrtc);
-  UNUSED(hrtc);
+  /* NOTE : This function Should not be modified, when the callback is needed,
-  /* NOTE : This function Should not be modified, when the callback is needed,
+            the HAL_RTCEx_RTCEventErrorCallback could be implemented in the user file
-            the HAL_RTCEx_RTCEventErrorCallback could be implemented in the user file
+   */
-   */
+}
-}
+/**
-/**
+  * @}
-  * @}
+  */
-  */
+/** @defgroup RTCEx_Exported_Functions_Group3 Extended Peripheral Control functions
-/** @defgroup RTCEx_Exported_Functions_Group3 Extended Peripheral Control functions
+  * @brief    Extended Peripheral Control functions
-  * @brief    Extended Peripheral Control functions
+  *
-  *
+@verbatim
-@verbatim
+ ===============================================================================
- ===============================================================================
+              ##### Extension Peripheral Control functions #####
-              ##### Extension Peripheral Control functions #####
+ ===============================================================================
- ===============================================================================
+    [..]
-    [..]
+    This subsection provides functions allowing to
-    This subsection provides functions allowing to
+      (+) Writes a data in a specified RTC Backup data register
-      (+) Writes a data in a specified RTC Backup data register
+      (+) Read a data in a specified RTC Backup data register
-      (+) Read a data in a specified RTC Backup data register
+      (+) Sets the Smooth calibration parameters.
-      (+) Sets the Smooth calibration parameters.
+@endverbatim
-@endverbatim
+  * @{
-  * @{
+  */
-  */
+/**
-/**
+  * @brief  Writes a data in a specified RTC Backup data register.
-  * @brief  Writes a data in a specified RTC Backup data register.
+  * @param  hrtc: pointer to a RTC_HandleTypeDef structure that contains
-  * @param  hrtc: pointer to a RTC_HandleTypeDef structure that contains
+  *                the configuration information for RTC.
-  *                the configuration information for RTC.
+  * @param  BackupRegister: RTC Backup data Register number.
-  * @param  BackupRegister: RTC Backup data Register number.
+  *          This parameter can be: RTC_BKP_DRx where x can be from 1 to 10 (or 42) to
-  *          This parameter can be: RTC_BKP_DRx where x can be from 1 to 10 (or 42) to
+  *                                 specify the register (depending devices).
-  *                                 specify the register (depending devices).
+  * @param  Data: Data to be written in the specified RTC Backup data register.
-  * @param  Data: Data to be written in the specified RTC Backup data register.
+  * @retval None
-  * @retval None
+  */
-  */
+void HAL_RTCEx_BKUPWrite(RTC_HandleTypeDef *hrtc, uint32_t BackupRegister, uint32_t Data)
-void HAL_RTCEx_BKUPWrite(RTC_HandleTypeDef *hrtc, uint32_t BackupRegister, uint32_t Data)
+{
-{
+  uint32_t tmp = 0U;
-  uint32_t tmp = 0U;
+  /* Prevent unused argument(s) compilation warning */
-  /* Prevent unused argument(s) compilation warning */
+  UNUSED(hrtc);
-  UNUSED(hrtc);
+  /* Check the parameters */
-  /* Check the parameters */
+  assert_param(IS_RTC_BKP(BackupRegister));
-  assert_param(IS_RTC_BKP(BackupRegister));
+  tmp = (uint32_t)BKP_BASE;
-  tmp = (uint32_t)BKP_BASE;
+  tmp += (BackupRegister * 4U);
-  tmp += (BackupRegister * 4U);
+  *(__IO uint32_t *) tmp = (Data & BKP_DR1_D);
-  *(__IO uint32_t *) tmp = (Data & BKP_DR1_D);
+}
-}
+/**
-/**
+  * @brief  Reads data from the specified RTC Backup data Register.
-  * @brief  Reads data from the specified RTC Backup data Register.
+  * @param  hrtc: pointer to a RTC_HandleTypeDef structure that contains
-  * @param  hrtc: pointer to a RTC_HandleTypeDef structure that contains
+  *                the configuration information for RTC.
-  *                the configuration information for RTC.
+  * @param  BackupRegister: RTC Backup data Register number.
-  * @param  BackupRegister: RTC Backup data Register number.
+  *          This parameter can be: RTC_BKP_DRx where x can be from 1 to 10 (or 42) to
-  *          This parameter can be: RTC_BKP_DRx where x can be from 1 to 10 (or 42) to
+  *                                 specify the register (depending devices).
-  *                                 specify the register (depending devices).
+  * @retval Read value
-  * @retval Read value
+  */
-  */
+uint32_t HAL_RTCEx_BKUPRead(RTC_HandleTypeDef *hrtc, uint32_t BackupRegister)
-uint32_t HAL_RTCEx_BKUPRead(RTC_HandleTypeDef *hrtc, uint32_t BackupRegister)
+{
-{
+  uint32_t backupregister = 0U;
-  uint32_t backupregister = 0U;
+  uint32_t pvalue = 0U;
-  uint32_t pvalue = 0U;
+  /* Prevent unused argument(s) compilation warning */
-  /* Prevent unused argument(s) compilation warning */
+  UNUSED(hrtc);
-  UNUSED(hrtc);
+  /* Check the parameters */
-  /* Check the parameters */
+  assert_param(IS_RTC_BKP(BackupRegister));
-  assert_param(IS_RTC_BKP(BackupRegister));
+  backupregister = (uint32_t)BKP_BASE;
-  backupregister = (uint32_t)BKP_BASE;
+  backupregister += (BackupRegister * 4U);
-  backupregister += (BackupRegister * 4U);
+  pvalue = (*(__IO uint32_t *)(backupregister)) & BKP_DR1_D;
-  pvalue = (*(__IO uint32_t *)(backupregister)) & BKP_DR1_D;
+  /* Read the specified register */
-  /* Read the specified register */
+  return pvalue;
-  return pvalue;
+}
-}
+/**
-/**
+  * @brief  Sets the Smooth calibration parameters.
-  * @brief  Sets the Smooth calibration parameters.
+  * @param  hrtc: RTC handle
-  * @param  hrtc: RTC handle
+  * @param  SmoothCalibPeriod: Not used (only present for compatibility with another families)
-  * @param  SmoothCalibPeriod: Not used (only present for compatibility with another families)
+  * @param  SmoothCalibPlusPulses: Not used (only present for compatibility with another families)
-  * @param  SmoothCalibPlusPulses: Not used (only present for compatibility with another families)
+  * @param  SmouthCalibMinusPulsesValue: specifies the RTC Clock Calibration value.
-  * @param  SmouthCalibMinusPulsesValue: specifies the RTC Clock Calibration value.
+  *          This parameter must be a number between 0 and 0x7F.
-  *          This parameter must be a number between 0 and 0x7F.
+  * @retval HAL status
-  * @retval HAL status
+  */
-  */
+HAL_StatusTypeDef HAL_RTCEx_SetSmoothCalib(RTC_HandleTypeDef *hrtc, uint32_t SmoothCalibPeriod, uint32_t SmoothCalibPlusPulses, uint32_t SmouthCalibMinusPulsesValue)
-HAL_StatusTypeDef HAL_RTCEx_SetSmoothCalib(RTC_HandleTypeDef *hrtc, uint32_t SmoothCalibPeriod, uint32_t SmoothCalibPlusPulses, uint32_t SmouthCalibMinusPulsesValue)
+{
-{
+  /* Check input parameters */
-  /* Check input parameters */
+  if (hrtc == NULL)
-  if (hrtc == NULL)
+  {
-  {
+    return HAL_ERROR;
-    return HAL_ERROR;
+  }
-  }
+  /* Prevent unused argument(s) compilation warning */
-  /* Prevent unused argument(s) compilation warning */
+  UNUSED(SmoothCalibPeriod);
-  UNUSED(SmoothCalibPeriod);
+  UNUSED(SmoothCalibPlusPulses);
-  UNUSED(SmoothCalibPlusPulses);
+  /* Check the parameters */
-  /* Check the parameters */
+  assert_param(IS_RTC_SMOOTH_CALIB_MINUS(SmouthCalibMinusPulsesValue));
-  assert_param(IS_RTC_SMOOTH_CALIB_MINUS(SmouthCalibMinusPulsesValue));
+  /* Process Locked */
-  /* Process Locked */
+  __HAL_LOCK(hrtc);
-  __HAL_LOCK(hrtc);
+  hrtc->State = HAL_RTC_STATE_BUSY;
-  hrtc->State = HAL_RTC_STATE_BUSY;
+  /* Sets RTC Clock Calibration value.*/
-  /* Sets RTC Clock Calibration value.*/
+  MODIFY_REG(BKP->RTCCR, BKP_RTCCR_CAL, SmouthCalibMinusPulsesValue);
-  MODIFY_REG(BKP->RTCCR, BKP_RTCCR_CAL, SmouthCalibMinusPulsesValue);
+  /* Change RTC state */
-  /* Change RTC state */
+  hrtc->State = HAL_RTC_STATE_READY;
-  hrtc->State = HAL_RTC_STATE_READY;
+  /* Process Unlocked */
-  /* Process Unlocked */
+  __HAL_UNLOCK(hrtc);
-  __HAL_UNLOCK(hrtc);
+  return HAL_OK;
-  return HAL_OK;
+}
-}
+/**
-/**
+  * @}
-  * @}
+  */
-  */
+/**
-/**
+  * @}
-  * @}
+  */
-  */
+/**
-/**
+  * @}
-  * @}
+  */
-  */
+#endif /* HAL_RTC_MODULE_ENABLED */
-#endif /* HAL_RTC_MODULE_ENABLED */
+/**
-/**
+  * @}
-  * @}
+  */
-  */
-/************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/

Subversion Repositories canSerial

(root)/trunk/Drivers/STM32F1xx_HAL_Driver/Src/stm32f1xx_hal_rtc_ex.c – Rev 2 → 3