mbed official / mbed-dev

Important changes to repositories hosted on mbed.com

Mbed hosted mercurial repositories are deprecated and are due to be permanently deleted in July 2026.

To keep a copy of this software download the repository Zip archive or clone locally using Mercurial.

It is also possible to export all your personal repositories from the account settings page.

Dependents:   Nucleo_Hello_Encoder BLE_iBeaconScan AM1805_DEMO DISCO-F429ZI_ExportTemplate1 ... more

targets/cmsis/TARGET_STM/TARGET_STM32F1/stm32f1xx_hal_rtc_ex.c@0:9b334a45a8ff, 2015-10-01 (annotated)

Committer:
bogdanm
Date:
Thu Oct 01 15:25:22 2015 +0300
Revision:
0:9b334a45a8ff
Child:
124:6a4a5b7d7324
Initial commit on mbed-dev



Replaces mbed-src (now inactive)

Who changed what in which revision?

UserRevisionLine numberNew contents of line
bogdanm 0:9b334a45a8ff 1 /**
bogdanm 0:9b334a45a8ff 2 ******************************************************************************
bogdanm 0:9b334a45a8ff 3 * @file stm32f1xx_hal_rtc_ex.c
bogdanm 0:9b334a45a8ff 4 * @author MCD Application Team
bogdanm 0:9b334a45a8ff 5 * @version V1.0.0
bogdanm 0:9b334a45a8ff 6 * @date 15-December-2014
bogdanm 0:9b334a45a8ff 7 * @brief Extended RTC HAL module driver.
bogdanm 0:9b334a45a8ff 8 * This file provides firmware functions to manage the following
bogdanm 0:9b334a45a8ff 9 * functionalities of the Real Time Clock (RTC) Extension peripheral:
bogdanm 0:9b334a45a8ff 10 * + RTC Tamper functions
bogdanm 0:9b334a45a8ff 11 * + Extension Control functions
bogdanm 0:9b334a45a8ff 12 * + Extension RTC features functions
bogdanm 0:9b334a45a8ff 13 *
bogdanm 0:9b334a45a8ff 14 ******************************************************************************
bogdanm 0:9b334a45a8ff 15 * @attention
bogdanm 0:9b334a45a8ff 16 *
bogdanm 0:9b334a45a8ff 17 * <h2><center>&copy; COPYRIGHT(c) 2014 STMicroelectronics</center></h2>
bogdanm 0:9b334a45a8ff 18 *
bogdanm 0:9b334a45a8ff 19 * Redistribution and use in source and binary forms, with or without modification,
bogdanm 0:9b334a45a8ff 20 * are permitted provided that the following conditions are met:
bogdanm 0:9b334a45a8ff 21 * 1. Redistributions of source code must retain the above copyright notice,
bogdanm 0:9b334a45a8ff 22 * this list of conditions and the following disclaimer.
bogdanm 0:9b334a45a8ff 23 * 2. Redistributions in binary form must reproduce the above copyright notice,
bogdanm 0:9b334a45a8ff 24 * this list of conditions and the following disclaimer in the documentation
bogdanm 0:9b334a45a8ff 25 * and/or other materials provided with the distribution.
bogdanm 0:9b334a45a8ff 26 * 3. Neither the name of STMicroelectronics nor the names of its contributors
bogdanm 0:9b334a45a8ff 27 * may be used to endorse or promote products derived from this software
bogdanm 0:9b334a45a8ff 28 * without specific prior written permission.
bogdanm 0:9b334a45a8ff 29 *
bogdanm 0:9b334a45a8ff 30 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
bogdanm 0:9b334a45a8ff 31 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
bogdanm 0:9b334a45a8ff 32 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
bogdanm 0:9b334a45a8ff 33 * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
bogdanm 0:9b334a45a8ff 34 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
bogdanm 0:9b334a45a8ff 35 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
bogdanm 0:9b334a45a8ff 36 * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
bogdanm 0:9b334a45a8ff 37 * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
bogdanm 0:9b334a45a8ff 38 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
bogdanm 0:9b334a45a8ff 39 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
bogdanm 0:9b334a45a8ff 40 *
bogdanm 0:9b334a45a8ff 41 ******************************************************************************
bogdanm 0:9b334a45a8ff 42 */
bogdanm 0:9b334a45a8ff 43
bogdanm 0:9b334a45a8ff 44 /* Includes ------------------------------------------------------------------*/
bogdanm 0:9b334a45a8ff 45 #include "stm32f1xx_hal.h"
bogdanm 0:9b334a45a8ff 46
bogdanm 0:9b334a45a8ff 47 /** @addtogroup STM32F1xx_HAL_Driver
bogdanm 0:9b334a45a8ff 48 * @{
bogdanm 0:9b334a45a8ff 49 */
bogdanm 0:9b334a45a8ff 50
bogdanm 0:9b334a45a8ff 51 #ifdef HAL_RTC_MODULE_ENABLED
bogdanm 0:9b334a45a8ff 52
bogdanm 0:9b334a45a8ff 53 /** @defgroup RTCEx RTCEx
bogdanm 0:9b334a45a8ff 54 * @brief RTC Extended HAL module driver
bogdanm 0:9b334a45a8ff 55 * @{
bogdanm 0:9b334a45a8ff 56 */
bogdanm 0:9b334a45a8ff 57
bogdanm 0:9b334a45a8ff 58 /* Private typedef -----------------------------------------------------------*/
bogdanm 0:9b334a45a8ff 59 /* Private define ------------------------------------------------------------*/
bogdanm 0:9b334a45a8ff 60 /* Private macro -------------------------------------------------------------*/
bogdanm 0:9b334a45a8ff 61 /** @defgroup RTCEx_Private_Macros RTCEx Private Macros
bogdanm 0:9b334a45a8ff 62 * @{
bogdanm 0:9b334a45a8ff 63 */
bogdanm 0:9b334a45a8ff 64 /**
bogdanm 0:9b334a45a8ff 65 * @}
bogdanm 0:9b334a45a8ff 66 */
bogdanm 0:9b334a45a8ff 67
bogdanm 0:9b334a45a8ff 68 /* Private variables ---------------------------------------------------------*/
bogdanm 0:9b334a45a8ff 69 /* Private function prototypes -----------------------------------------------*/
bogdanm 0:9b334a45a8ff 70 /* Private functions ---------------------------------------------------------*/
bogdanm 0:9b334a45a8ff 71
bogdanm 0:9b334a45a8ff 72 /** @defgroup RTCEx_Exported_Functions RTCEx Exported Functions
bogdanm 0:9b334a45a8ff 73 * @{
bogdanm 0:9b334a45a8ff 74 */
bogdanm 0:9b334a45a8ff 75
bogdanm 0:9b334a45a8ff 76 /** @defgroup RTCEx_Exported_Functions_Group1 RTC Tamper functions
bogdanm 0:9b334a45a8ff 77 * @brief RTC Tamper functions
bogdanm 0:9b334a45a8ff 78 *
bogdanm 0:9b334a45a8ff 79 @verbatim
bogdanm 0:9b334a45a8ff 80 ===============================================================================
bogdanm 0:9b334a45a8ff 81 ##### RTC Tamper functions #####
bogdanm 0:9b334a45a8ff 82 ===============================================================================
bogdanm 0:9b334a45a8ff 83
bogdanm 0:9b334a45a8ff 84 [..] This section provides functions allowing to configure Tamper feature
bogdanm 0:9b334a45a8ff 85
bogdanm 0:9b334a45a8ff 86 @endverbatim
bogdanm 0:9b334a45a8ff 87 * @{
bogdanm 0:9b334a45a8ff 88 */
bogdanm 0:9b334a45a8ff 89
bogdanm 0:9b334a45a8ff 90 /**
bogdanm 0:9b334a45a8ff 91 * @brief Sets Tamper
bogdanm 0:9b334a45a8ff 92 * @note By calling this API we disable the tamper interrupt for all tampers.
bogdanm 0:9b334a45a8ff 93 * @param hrtc: pointer to a RTC_HandleTypeDef structure that contains
bogdanm 0:9b334a45a8ff 94 * the configuration information for RTC.
bogdanm 0:9b334a45a8ff 95 * @param sTamper: Pointer to Tamper Structure.
bogdanm 0:9b334a45a8ff 96 * @note Tamper can be enabled only if ASOE and CCO bit are reset
bogdanm 0:9b334a45a8ff 97 * @retval HAL status
bogdanm 0:9b334a45a8ff 98 */
bogdanm 0:9b334a45a8ff 99 HAL_StatusTypeDef HAL_RTCEx_SetTamper(RTC_HandleTypeDef *hrtc, RTC_TamperTypeDef* sTamper)
bogdanm 0:9b334a45a8ff 100 {
bogdanm 0:9b334a45a8ff 101 /* Check input parameters */
bogdanm 0:9b334a45a8ff 102 if((hrtc == NULL) || (sTamper == NULL))
bogdanm 0:9b334a45a8ff 103 {
bogdanm 0:9b334a45a8ff 104 return HAL_ERROR;
bogdanm 0:9b334a45a8ff 105 }
bogdanm 0:9b334a45a8ff 106
bogdanm 0:9b334a45a8ff 107 /* Check the parameters */
bogdanm 0:9b334a45a8ff 108 assert_param(IS_RTC_TAMPER(sTamper->Tamper));
bogdanm 0:9b334a45a8ff 109 assert_param(IS_RTC_TAMPER_TRIGGER(sTamper->Trigger));
bogdanm 0:9b334a45a8ff 110
bogdanm 0:9b334a45a8ff 111 /* Process Locked */
bogdanm 0:9b334a45a8ff 112 __HAL_LOCK(hrtc);
bogdanm 0:9b334a45a8ff 113
bogdanm 0:9b334a45a8ff 114 hrtc->State = HAL_RTC_STATE_BUSY;
bogdanm 0:9b334a45a8ff 115
bogdanm 0:9b334a45a8ff 116 if (HAL_IS_BIT_SET(BKP->RTCCR,(BKP_RTCCR_CCO | BKP_RTCCR_ASOE)))
bogdanm 0:9b334a45a8ff 117 {
bogdanm 0:9b334a45a8ff 118 hrtc->State = HAL_RTC_STATE_ERROR;
bogdanm 0:9b334a45a8ff 119
bogdanm 0:9b334a45a8ff 120 /* Process Unlocked */
bogdanm 0:9b334a45a8ff 121 __HAL_UNLOCK(hrtc);
bogdanm 0:9b334a45a8ff 122
bogdanm 0:9b334a45a8ff 123 return HAL_ERROR;
bogdanm 0:9b334a45a8ff 124 }
bogdanm 0:9b334a45a8ff 125
bogdanm 0:9b334a45a8ff 126 MODIFY_REG(BKP->CR, (BKP_CR_TPE | BKP_CR_TPAL), (sTamper->Tamper | (sTamper->Trigger)));
bogdanm 0:9b334a45a8ff 127
bogdanm 0:9b334a45a8ff 128 hrtc->State = HAL_RTC_STATE_READY;
bogdanm 0:9b334a45a8ff 129
bogdanm 0:9b334a45a8ff 130 /* Process Unlocked */
bogdanm 0:9b334a45a8ff 131 __HAL_UNLOCK(hrtc);
bogdanm 0:9b334a45a8ff 132
bogdanm 0:9b334a45a8ff 133 return HAL_OK;
bogdanm 0:9b334a45a8ff 134 }
bogdanm 0:9b334a45a8ff 135
bogdanm 0:9b334a45a8ff 136 /**
bogdanm 0:9b334a45a8ff 137 * @brief Sets Tamper with interrupt.
bogdanm 0:9b334a45a8ff 138 * @note By calling this API we force the tamper interrupt for all tampers.
bogdanm 0:9b334a45a8ff 139 * @param hrtc: pointer to a RTC_HandleTypeDef structure that contains
bogdanm 0:9b334a45a8ff 140 * the configuration information for RTC.
bogdanm 0:9b334a45a8ff 141 * @param sTamper: Pointer to RTC Tamper.
bogdanm 0:9b334a45a8ff 142 * @note Tamper can be enabled only if ASOE and CCO bit are reset
bogdanm 0:9b334a45a8ff 143 * @retval HAL status
bogdanm 0:9b334a45a8ff 144 */
bogdanm 0:9b334a45a8ff 145 HAL_StatusTypeDef HAL_RTCEx_SetTamper_IT(RTC_HandleTypeDef *hrtc, RTC_TamperTypeDef* sTamper)
bogdanm 0:9b334a45a8ff 146 {
bogdanm 0:9b334a45a8ff 147 /* Check input parameters */
bogdanm 0:9b334a45a8ff 148 if((hrtc == NULL) || (sTamper == NULL))
bogdanm 0:9b334a45a8ff 149 {
bogdanm 0:9b334a45a8ff 150 return HAL_ERROR;
bogdanm 0:9b334a45a8ff 151 }
bogdanm 0:9b334a45a8ff 152
bogdanm 0:9b334a45a8ff 153 /* Check the parameters */
bogdanm 0:9b334a45a8ff 154 assert_param(IS_RTC_TAMPER(sTamper->Tamper));
bogdanm 0:9b334a45a8ff 155 assert_param(IS_RTC_TAMPER_TRIGGER(sTamper->Trigger));
bogdanm 0:9b334a45a8ff 156
bogdanm 0:9b334a45a8ff 157 /* Process Locked */
bogdanm 0:9b334a45a8ff 158 __HAL_LOCK(hrtc);
bogdanm 0:9b334a45a8ff 159
bogdanm 0:9b334a45a8ff 160 hrtc->State = HAL_RTC_STATE_BUSY;
bogdanm 0:9b334a45a8ff 161
bogdanm 0:9b334a45a8ff 162 if (HAL_IS_BIT_SET(BKP->RTCCR,(BKP_RTCCR_CCO | BKP_RTCCR_ASOE)))
bogdanm 0:9b334a45a8ff 163 {
bogdanm 0:9b334a45a8ff 164 hrtc->State = HAL_RTC_STATE_ERROR;
bogdanm 0:9b334a45a8ff 165
bogdanm 0:9b334a45a8ff 166 /* Process Unlocked */
bogdanm 0:9b334a45a8ff 167 __HAL_UNLOCK(hrtc);
bogdanm 0:9b334a45a8ff 168
bogdanm 0:9b334a45a8ff 169 return HAL_ERROR;
bogdanm 0:9b334a45a8ff 170 }
bogdanm 0:9b334a45a8ff 171
bogdanm 0:9b334a45a8ff 172 MODIFY_REG(BKP->CR, (BKP_CR_TPE | BKP_CR_TPAL), (sTamper->Tamper | (sTamper->Trigger)));
bogdanm 0:9b334a45a8ff 173
bogdanm 0:9b334a45a8ff 174 /* Configure the Tamper Interrupt in the BKP->CSR */
bogdanm 0:9b334a45a8ff 175 __HAL_RTC_TAMPER_ENABLE_IT(hrtc, RTC_IT_TAMP1);
bogdanm 0:9b334a45a8ff 176
bogdanm 0:9b334a45a8ff 177 hrtc->State = HAL_RTC_STATE_READY;
bogdanm 0:9b334a45a8ff 178
bogdanm 0:9b334a45a8ff 179 /* Process Unlocked */
bogdanm 0:9b334a45a8ff 180 __HAL_UNLOCK(hrtc);
bogdanm 0:9b334a45a8ff 181
bogdanm 0:9b334a45a8ff 182 return HAL_OK;
bogdanm 0:9b334a45a8ff 183 }
bogdanm 0:9b334a45a8ff 184
bogdanm 0:9b334a45a8ff 185 /**
bogdanm 0:9b334a45a8ff 186 * @brief Deactivates Tamper.
bogdanm 0:9b334a45a8ff 187 * @param hrtc: pointer to a RTC_HandleTypeDef structure that contains
bogdanm 0:9b334a45a8ff 188 * the configuration information for RTC.
bogdanm 0:9b334a45a8ff 189 * @param Tamper: Selected tamper pin.
bogdanm 0:9b334a45a8ff 190 * This parameter can be a value of @ref RTCEx_Tamper_Pins_Definitions
bogdanm 0:9b334a45a8ff 191 * @retval HAL status
bogdanm 0:9b334a45a8ff 192 */
bogdanm 0:9b334a45a8ff 193 HAL_StatusTypeDef HAL_RTCEx_DeactivateTamper(RTC_HandleTypeDef *hrtc, uint32_t Tamper)
bogdanm 0:9b334a45a8ff 194 {
bogdanm 0:9b334a45a8ff 195 /* Check input parameters */
bogdanm 0:9b334a45a8ff 196 if(hrtc == NULL)
bogdanm 0:9b334a45a8ff 197 {
bogdanm 0:9b334a45a8ff 198 return HAL_ERROR;
bogdanm 0:9b334a45a8ff 199 }
bogdanm 0:9b334a45a8ff 200
bogdanm 0:9b334a45a8ff 201 assert_param(IS_RTC_TAMPER(Tamper));
bogdanm 0:9b334a45a8ff 202
bogdanm 0:9b334a45a8ff 203 /* Process Locked */
bogdanm 0:9b334a45a8ff 204 __HAL_LOCK(hrtc);
bogdanm 0:9b334a45a8ff 205
bogdanm 0:9b334a45a8ff 206 hrtc->State = HAL_RTC_STATE_BUSY;
bogdanm 0:9b334a45a8ff 207
bogdanm 0:9b334a45a8ff 208 /* Disable the selected Tamper pin */
bogdanm 0:9b334a45a8ff 209 CLEAR_BIT(BKP->CR, BKP_CR_TPE);
bogdanm 0:9b334a45a8ff 210
bogdanm 0:9b334a45a8ff 211 /* Disable the Tamper Interrupt in the BKP->CSR */
bogdanm 0:9b334a45a8ff 212 /* Configure the Tamper Interrupt in the BKP->CSR */
bogdanm 0:9b334a45a8ff 213 __HAL_RTC_TAMPER_DISABLE_IT(hrtc, RTC_IT_TAMP1);
bogdanm 0:9b334a45a8ff 214
bogdanm 0:9b334a45a8ff 215 /* Clear the Tamper interrupt pending bit */
bogdanm 0:9b334a45a8ff 216 __HAL_RTC_TAMPER_CLEAR_FLAG(hrtc, RTC_FLAG_TAMP1F);
bogdanm 0:9b334a45a8ff 217 SET_BIT(BKP->CSR, BKP_CSR_CTE);
bogdanm 0:9b334a45a8ff 218
bogdanm 0:9b334a45a8ff 219 hrtc->State = HAL_RTC_STATE_READY;
bogdanm 0:9b334a45a8ff 220
bogdanm 0:9b334a45a8ff 221 /* Process Unlocked */
bogdanm 0:9b334a45a8ff 222 __HAL_UNLOCK(hrtc);
bogdanm 0:9b334a45a8ff 223
bogdanm 0:9b334a45a8ff 224 return HAL_OK;
bogdanm 0:9b334a45a8ff 225 }
bogdanm 0:9b334a45a8ff 226
bogdanm 0:9b334a45a8ff 227 /**
bogdanm 0:9b334a45a8ff 228 * @brief This function handles Tamper interrupt request.
bogdanm 0:9b334a45a8ff 229 * @param hrtc: pointer to a RTC_HandleTypeDef structure that contains
bogdanm 0:9b334a45a8ff 230 * the configuration information for RTC.
bogdanm 0:9b334a45a8ff 231 * @retval None
bogdanm 0:9b334a45a8ff 232 */
bogdanm 0:9b334a45a8ff 233 void HAL_RTCEx_TamperIRQHandler(RTC_HandleTypeDef *hrtc)
bogdanm 0:9b334a45a8ff 234 {
bogdanm 0:9b334a45a8ff 235 /* Get the status of the Interrupt */
bogdanm 0:9b334a45a8ff 236 if(__HAL_RTC_TAMPER_GET_IT_SOURCE(hrtc, RTC_IT_TAMP1))
bogdanm 0:9b334a45a8ff 237 {
bogdanm 0:9b334a45a8ff 238 /* Get the TAMPER Interrupt enable bit and pending bit */
bogdanm 0:9b334a45a8ff 239 if(__HAL_RTC_TAMPER_GET_FLAG(hrtc, RTC_FLAG_TAMP1F) != (uint32_t)RESET)
bogdanm 0:9b334a45a8ff 240 {
bogdanm 0:9b334a45a8ff 241 /* Tamper callback */
bogdanm 0:9b334a45a8ff 242 HAL_RTCEx_Tamper1EventCallback(hrtc);
bogdanm 0:9b334a45a8ff 243
bogdanm 0:9b334a45a8ff 244 /* Clear the Tamper interrupt pending bit */
bogdanm 0:9b334a45a8ff 245 __HAL_RTC_TAMPER_CLEAR_FLAG(hrtc,RTC_FLAG_TAMP1F);
bogdanm 0:9b334a45a8ff 246 }
bogdanm 0:9b334a45a8ff 247 }
bogdanm 0:9b334a45a8ff 248
bogdanm 0:9b334a45a8ff 249 /* Change RTC state */
bogdanm 0:9b334a45a8ff 250 hrtc->State = HAL_RTC_STATE_READY;
bogdanm 0:9b334a45a8ff 251 }
bogdanm 0:9b334a45a8ff 252
bogdanm 0:9b334a45a8ff 253 /**
bogdanm 0:9b334a45a8ff 254 * @brief Tamper 1 callback.
bogdanm 0:9b334a45a8ff 255 * @param hrtc: pointer to a RTC_HandleTypeDef structure that contains
bogdanm 0:9b334a45a8ff 256 * the configuration information for RTC.
bogdanm 0:9b334a45a8ff 257 * @retval None
bogdanm 0:9b334a45a8ff 258 */
bogdanm 0:9b334a45a8ff 259 __weak void HAL_RTCEx_Tamper1EventCallback(RTC_HandleTypeDef *hrtc)
bogdanm 0:9b334a45a8ff 260 {
bogdanm 0:9b334a45a8ff 261 /* NOTE : This function Should not be modified, when the callback is needed,
bogdanm 0:9b334a45a8ff 262 the HAL_RTCEx_Tamper1EventCallback could be implemented in the user file
bogdanm 0:9b334a45a8ff 263 */
bogdanm 0:9b334a45a8ff 264 }
bogdanm 0:9b334a45a8ff 265
bogdanm 0:9b334a45a8ff 266 /**
bogdanm 0:9b334a45a8ff 267 * @brief This function handles Tamper1 Polling.
bogdanm 0:9b334a45a8ff 268 * @param hrtc: pointer to a RTC_HandleTypeDef structure that contains
bogdanm 0:9b334a45a8ff 269 * the configuration information for RTC.
bogdanm 0:9b334a45a8ff 270 * @param Timeout: Timeout duration
bogdanm 0:9b334a45a8ff 271 * @retval HAL status
bogdanm 0:9b334a45a8ff 272 */
bogdanm 0:9b334a45a8ff 273 HAL_StatusTypeDef HAL_RTCEx_PollForTamper1Event(RTC_HandleTypeDef *hrtc, uint32_t Timeout)
bogdanm 0:9b334a45a8ff 274 {
bogdanm 0:9b334a45a8ff 275 uint32_t tickstart = HAL_GetTick();
bogdanm 0:9b334a45a8ff 276
bogdanm 0:9b334a45a8ff 277 /* Check input parameters */
bogdanm 0:9b334a45a8ff 278 if(hrtc == NULL)
bogdanm 0:9b334a45a8ff 279 {
bogdanm 0:9b334a45a8ff 280 return HAL_ERROR;
bogdanm 0:9b334a45a8ff 281 }
bogdanm 0:9b334a45a8ff 282
bogdanm 0:9b334a45a8ff 283 /* Get the status of the Interrupt */
bogdanm 0:9b334a45a8ff 284 while(__HAL_RTC_TAMPER_GET_FLAG(hrtc,RTC_FLAG_TAMP1F)== RESET)
bogdanm 0:9b334a45a8ff 285 {
bogdanm 0:9b334a45a8ff 286 if(Timeout != HAL_MAX_DELAY)
bogdanm 0:9b334a45a8ff 287 {
bogdanm 0:9b334a45a8ff 288 if((Timeout == 0)||((HAL_GetTick() - tickstart ) > Timeout))
bogdanm 0:9b334a45a8ff 289 {
bogdanm 0:9b334a45a8ff 290 hrtc->State = HAL_RTC_STATE_TIMEOUT;
bogdanm 0:9b334a45a8ff 291 return HAL_TIMEOUT;
bogdanm 0:9b334a45a8ff 292 }
bogdanm 0:9b334a45a8ff 293 }
bogdanm 0:9b334a45a8ff 294 }
bogdanm 0:9b334a45a8ff 295
bogdanm 0:9b334a45a8ff 296 /* Clear the Tamper Flag */
bogdanm 0:9b334a45a8ff 297 __HAL_RTC_TAMPER_CLEAR_FLAG(hrtc,RTC_FLAG_TAMP1F);
bogdanm 0:9b334a45a8ff 298
bogdanm 0:9b334a45a8ff 299 /* Change RTC state */
bogdanm 0:9b334a45a8ff 300 hrtc->State = HAL_RTC_STATE_READY;
bogdanm 0:9b334a45a8ff 301
bogdanm 0:9b334a45a8ff 302 return HAL_OK;
bogdanm 0:9b334a45a8ff 303 }
bogdanm 0:9b334a45a8ff 304
bogdanm 0:9b334a45a8ff 305 /**
bogdanm 0:9b334a45a8ff 306 * @}
bogdanm 0:9b334a45a8ff 307 */
bogdanm 0:9b334a45a8ff 308
bogdanm 0:9b334a45a8ff 309 /** @defgroup RTCEx_Exported_Functions_Group2 RTC Second functions
bogdanm 0:9b334a45a8ff 310 * @brief RTC Second functions
bogdanm 0:9b334a45a8ff 311 *
bogdanm 0:9b334a45a8ff 312 @verbatim
bogdanm 0:9b334a45a8ff 313 ===============================================================================
bogdanm 0:9b334a45a8ff 314 ##### RTC Second functions #####
bogdanm 0:9b334a45a8ff 315 ===============================================================================
bogdanm 0:9b334a45a8ff 316
bogdanm 0:9b334a45a8ff 317 [..] This section provides functions implementing second interupt handlers
bogdanm 0:9b334a45a8ff 318
bogdanm 0:9b334a45a8ff 319 @endverbatim
bogdanm 0:9b334a45a8ff 320 * @{
bogdanm 0:9b334a45a8ff 321 */
bogdanm 0:9b334a45a8ff 322
bogdanm 0:9b334a45a8ff 323 /**
bogdanm 0:9b334a45a8ff 324 * @brief Sets Interrupt for second
bogdanm 0:9b334a45a8ff 325 * @param hrtc: pointer to a RTC_HandleTypeDef structure that contains
bogdanm 0:9b334a45a8ff 326 * the configuration information for RTC.
bogdanm 0:9b334a45a8ff 327 * @retval HAL status
bogdanm 0:9b334a45a8ff 328 */
bogdanm 0:9b334a45a8ff 329 HAL_StatusTypeDef HAL_RTCEx_SetSecond_IT(RTC_HandleTypeDef *hrtc)
bogdanm 0:9b334a45a8ff 330 {
bogdanm 0:9b334a45a8ff 331 /* Check input parameters */
bogdanm 0:9b334a45a8ff 332 if(hrtc == NULL)
bogdanm 0:9b334a45a8ff 333 {
bogdanm 0:9b334a45a8ff 334 return HAL_ERROR;
bogdanm 0:9b334a45a8ff 335 }
bogdanm 0:9b334a45a8ff 336
bogdanm 0:9b334a45a8ff 337 /* Process Locked */
bogdanm 0:9b334a45a8ff 338 __HAL_LOCK(hrtc);
bogdanm 0:9b334a45a8ff 339
bogdanm 0:9b334a45a8ff 340 hrtc->State = HAL_RTC_STATE_BUSY;
bogdanm 0:9b334a45a8ff 341
bogdanm 0:9b334a45a8ff 342 /* Enable Second interuption */
bogdanm 0:9b334a45a8ff 343 __HAL_RTC_SECOND_ENABLE_IT(hrtc, RTC_IT_SEC);
bogdanm 0:9b334a45a8ff 344
bogdanm 0:9b334a45a8ff 345 hrtc->State = HAL_RTC_STATE_READY;
bogdanm 0:9b334a45a8ff 346
bogdanm 0:9b334a45a8ff 347 /* Process Unlocked */
bogdanm 0:9b334a45a8ff 348 __HAL_UNLOCK(hrtc);
bogdanm 0:9b334a45a8ff 349
bogdanm 0:9b334a45a8ff 350 return HAL_OK;
bogdanm 0:9b334a45a8ff 351 }
bogdanm 0:9b334a45a8ff 352
bogdanm 0:9b334a45a8ff 353 /**
bogdanm 0:9b334a45a8ff 354 * @brief Deactivates Second.
bogdanm 0:9b334a45a8ff 355 * @param hrtc: pointer to a RTC_HandleTypeDef structure that contains
bogdanm 0:9b334a45a8ff 356 * the configuration information for RTC.
bogdanm 0:9b334a45a8ff 357 * @retval HAL status
bogdanm 0:9b334a45a8ff 358 */
bogdanm 0:9b334a45a8ff 359 HAL_StatusTypeDef HAL_RTCEx_DeactivateSecond(RTC_HandleTypeDef *hrtc)
bogdanm 0:9b334a45a8ff 360 {
bogdanm 0:9b334a45a8ff 361 /* Check input parameters */
bogdanm 0:9b334a45a8ff 362 if(hrtc == NULL)
bogdanm 0:9b334a45a8ff 363 {
bogdanm 0:9b334a45a8ff 364 return HAL_ERROR;
bogdanm 0:9b334a45a8ff 365 }
bogdanm 0:9b334a45a8ff 366
bogdanm 0:9b334a45a8ff 367 /* Process Locked */
bogdanm 0:9b334a45a8ff 368 __HAL_LOCK(hrtc);
bogdanm 0:9b334a45a8ff 369
bogdanm 0:9b334a45a8ff 370 hrtc->State = HAL_RTC_STATE_BUSY;
bogdanm 0:9b334a45a8ff 371
bogdanm 0:9b334a45a8ff 372 /* Deactivate Second interuption*/
bogdanm 0:9b334a45a8ff 373 __HAL_RTC_SECOND_DISABLE_IT(hrtc, RTC_IT_SEC);
bogdanm 0:9b334a45a8ff 374
bogdanm 0:9b334a45a8ff 375 hrtc->State = HAL_RTC_STATE_READY;
bogdanm 0:9b334a45a8ff 376
bogdanm 0:9b334a45a8ff 377 /* Process Unlocked */
bogdanm 0:9b334a45a8ff 378 __HAL_UNLOCK(hrtc);
bogdanm 0:9b334a45a8ff 379
bogdanm 0:9b334a45a8ff 380 return HAL_OK;
bogdanm 0:9b334a45a8ff 381 }
bogdanm 0:9b334a45a8ff 382
bogdanm 0:9b334a45a8ff 383 /**
bogdanm 0:9b334a45a8ff 384 * @brief This function handles second interrupt request.
bogdanm 0:9b334a45a8ff 385 * @param hrtc: pointer to a RTC_HandleTypeDef structure that contains
bogdanm 0:9b334a45a8ff 386 * the configuration information for RTC.
bogdanm 0:9b334a45a8ff 387 * @retval None
bogdanm 0:9b334a45a8ff 388 */
bogdanm 0:9b334a45a8ff 389 void HAL_RTCEx_RTCIRQHandler(RTC_HandleTypeDef* hrtc)
bogdanm 0:9b334a45a8ff 390 {
bogdanm 0:9b334a45a8ff 391 if(__HAL_RTC_SECOND_GET_IT_SOURCE(hrtc, RTC_IT_SEC))
bogdanm 0:9b334a45a8ff 392 {
bogdanm 0:9b334a45a8ff 393 /* Get the status of the Interrupt */
bogdanm 0:9b334a45a8ff 394 if(__HAL_RTC_SECOND_GET_FLAG(hrtc, RTC_FLAG_SEC))
bogdanm 0:9b334a45a8ff 395 {
bogdanm 0:9b334a45a8ff 396 /* Check if Overrun occurred */
bogdanm 0:9b334a45a8ff 397 if (__HAL_RTC_SECOND_GET_FLAG(hrtc, RTC_FLAG_OW))
bogdanm 0:9b334a45a8ff 398 {
bogdanm 0:9b334a45a8ff 399 /* Second error callback */
bogdanm 0:9b334a45a8ff 400 HAL_RTCEx_RTCEventErrorCallback(hrtc);
bogdanm 0:9b334a45a8ff 401
bogdanm 0:9b334a45a8ff 402 /* Clear flag Second */
bogdanm 0:9b334a45a8ff 403 __HAL_RTC_OVERFLOW_CLEAR_FLAG(hrtc, RTC_FLAG_OW);
bogdanm 0:9b334a45a8ff 404
bogdanm 0:9b334a45a8ff 405 /* Change RTC state */
bogdanm 0:9b334a45a8ff 406 hrtc->State = HAL_RTC_STATE_ERROR;
bogdanm 0:9b334a45a8ff 407 }
bogdanm 0:9b334a45a8ff 408 else
bogdanm 0:9b334a45a8ff 409 {
bogdanm 0:9b334a45a8ff 410 /* Second callback */
bogdanm 0:9b334a45a8ff 411 HAL_RTCEx_RTCEventCallback(hrtc);
bogdanm 0:9b334a45a8ff 412
bogdanm 0:9b334a45a8ff 413 /* Change RTC state */
bogdanm 0:9b334a45a8ff 414 hrtc->State = HAL_RTC_STATE_READY;
bogdanm 0:9b334a45a8ff 415 }
bogdanm 0:9b334a45a8ff 416
bogdanm 0:9b334a45a8ff 417 /* Clear flag Second */
bogdanm 0:9b334a45a8ff 418 __HAL_RTC_SECOND_CLEAR_FLAG(hrtc, RTC_FLAG_SEC);
bogdanm 0:9b334a45a8ff 419 }
bogdanm 0:9b334a45a8ff 420 }
bogdanm 0:9b334a45a8ff 421 }
bogdanm 0:9b334a45a8ff 422
bogdanm 0:9b334a45a8ff 423 /**
bogdanm 0:9b334a45a8ff 424 * @brief Second event callback.
bogdanm 0:9b334a45a8ff 425 * @param hrtc: pointer to a RTC_HandleTypeDef structure that contains
bogdanm 0:9b334a45a8ff 426 * the configuration information for RTC.
bogdanm 0:9b334a45a8ff 427 * @retval None
bogdanm 0:9b334a45a8ff 428 */
bogdanm 0:9b334a45a8ff 429 __weak void HAL_RTCEx_RTCEventCallback(RTC_HandleTypeDef *hrtc)
bogdanm 0:9b334a45a8ff 430 {
bogdanm 0:9b334a45a8ff 431 /* NOTE : This function Should not be modified, when the callback is needed,
bogdanm 0:9b334a45a8ff 432 the HAL_RTCEx_RTCEventCallback could be implemented in the user file
bogdanm 0:9b334a45a8ff 433 */
bogdanm 0:9b334a45a8ff 434 }
bogdanm 0:9b334a45a8ff 435
bogdanm 0:9b334a45a8ff 436 /**
bogdanm 0:9b334a45a8ff 437 * @brief Second event error callback.
bogdanm 0:9b334a45a8ff 438 * @param hrtc: pointer to a RTC_HandleTypeDef structure that contains
bogdanm 0:9b334a45a8ff 439 * the configuration information for RTC.
bogdanm 0:9b334a45a8ff 440 * @retval None
bogdanm 0:9b334a45a8ff 441 */
bogdanm 0:9b334a45a8ff 442 __weak void HAL_RTCEx_RTCEventErrorCallback(RTC_HandleTypeDef *hrtc)
bogdanm 0:9b334a45a8ff 443 {
bogdanm 0:9b334a45a8ff 444 /* NOTE : This function Should not be modified, when the callback is needed,
bogdanm 0:9b334a45a8ff 445 the HAL_RTCEx_RTCEventErrorCallback could be implemented in the user file
bogdanm 0:9b334a45a8ff 446 */
bogdanm 0:9b334a45a8ff 447 }
bogdanm 0:9b334a45a8ff 448
bogdanm 0:9b334a45a8ff 449 /**
bogdanm 0:9b334a45a8ff 450 * @}
bogdanm 0:9b334a45a8ff 451 */
bogdanm 0:9b334a45a8ff 452
bogdanm 0:9b334a45a8ff 453 /** @defgroup RTCEx_Exported_Functions_Group3 Extended Peripheral Control functions
bogdanm 0:9b334a45a8ff 454 * @brief Extended Peripheral Control functions
bogdanm 0:9b334a45a8ff 455 *
bogdanm 0:9b334a45a8ff 456 @verbatim
bogdanm 0:9b334a45a8ff 457 ===============================================================================
bogdanm 0:9b334a45a8ff 458 ##### Extension Peripheral Control functions #####
bogdanm 0:9b334a45a8ff 459 ===============================================================================
bogdanm 0:9b334a45a8ff 460 [..]
bogdanm 0:9b334a45a8ff 461 This subsection provides functions allowing to
bogdanm 0:9b334a45a8ff 462 (+) Writes a data in a specified RTC Backup data register
bogdanm 0:9b334a45a8ff 463 (+) Read a data in a specified RTC Backup data register
bogdanm 0:9b334a45a8ff 464 (+) Sets the Smooth calibration parameters.
bogdanm 0:9b334a45a8ff 465
bogdanm 0:9b334a45a8ff 466 @endverbatim
bogdanm 0:9b334a45a8ff 467 * @{
bogdanm 0:9b334a45a8ff 468 */
bogdanm 0:9b334a45a8ff 469
bogdanm 0:9b334a45a8ff 470 /**
bogdanm 0:9b334a45a8ff 471 * @brief Writes a data in a specified RTC Backup data register.
bogdanm 0:9b334a45a8ff 472 * @param hrtc: pointer to a RTC_HandleTypeDef structure that contains
bogdanm 0:9b334a45a8ff 473 * the configuration information for RTC.
bogdanm 0:9b334a45a8ff 474 * @param BackupRegister: RTC Backup data Register number.
bogdanm 0:9b334a45a8ff 475 * This parameter can be: RTC_BKP_DRx where x can be from 1 to 10 (or 42) to
bogdanm 0:9b334a45a8ff 476 * specify the register (depending devices).
bogdanm 0:9b334a45a8ff 477 * @param Data: Data to be written in the specified RTC Backup data register.
bogdanm 0:9b334a45a8ff 478 * @retval None
bogdanm 0:9b334a45a8ff 479 */
bogdanm 0:9b334a45a8ff 480 void HAL_RTCEx_BKUPWrite(RTC_HandleTypeDef *hrtc, uint32_t BackupRegister, uint32_t Data)
bogdanm 0:9b334a45a8ff 481 {
bogdanm 0:9b334a45a8ff 482 uint32_t tmp = 0;
bogdanm 0:9b334a45a8ff 483
bogdanm 0:9b334a45a8ff 484 /* Check the parameters */
bogdanm 0:9b334a45a8ff 485 assert_param(IS_RTC_BKP(BackupRegister));
bogdanm 0:9b334a45a8ff 486
bogdanm 0:9b334a45a8ff 487 tmp = (uint32_t)BKP_BASE;
bogdanm 0:9b334a45a8ff 488 tmp += (BackupRegister * 4);
bogdanm 0:9b334a45a8ff 489
bogdanm 0:9b334a45a8ff 490 *(__IO uint32_t *) tmp = (Data & BKP_DR1_D);
bogdanm 0:9b334a45a8ff 491 }
bogdanm 0:9b334a45a8ff 492
bogdanm 0:9b334a45a8ff 493 /**
bogdanm 0:9b334a45a8ff 494 * @brief Reads data from the specified RTC Backup data Register.
bogdanm 0:9b334a45a8ff 495 * @param hrtc: pointer to a RTC_HandleTypeDef structure that contains
bogdanm 0:9b334a45a8ff 496 * the configuration information for RTC.
bogdanm 0:9b334a45a8ff 497 * @param BackupRegister: RTC Backup data Register number.
bogdanm 0:9b334a45a8ff 498 * This parameter can be: RTC_BKP_DRx where x can be from 1 to 10 (or 42) to
bogdanm 0:9b334a45a8ff 499 * specify the register (depending devices).
bogdanm 0:9b334a45a8ff 500 * @retval Read value
bogdanm 0:9b334a45a8ff 501 */
bogdanm 0:9b334a45a8ff 502 uint32_t HAL_RTCEx_BKUPRead(RTC_HandleTypeDef *hrtc, uint32_t BackupRegister)
bogdanm 0:9b334a45a8ff 503 {
bogdanm 0:9b334a45a8ff 504 uint32_t backupregister = 0;
bogdanm 0:9b334a45a8ff 505 uint32_t pvalue = 0;
bogdanm 0:9b334a45a8ff 506
bogdanm 0:9b334a45a8ff 507 /* Check the parameters */
bogdanm 0:9b334a45a8ff 508 assert_param(IS_RTC_BKP(BackupRegister));
bogdanm 0:9b334a45a8ff 509
bogdanm 0:9b334a45a8ff 510 backupregister = (uint32_t)BKP_BASE;
bogdanm 0:9b334a45a8ff 511 backupregister += (BackupRegister * 4);
bogdanm 0:9b334a45a8ff 512
bogdanm 0:9b334a45a8ff 513 pvalue = (*(__IO uint32_t *)(backupregister)) & BKP_DR1_D;
bogdanm 0:9b334a45a8ff 514
bogdanm 0:9b334a45a8ff 515 /* Read the specified register */
bogdanm 0:9b334a45a8ff 516 return pvalue;
bogdanm 0:9b334a45a8ff 517 }
bogdanm 0:9b334a45a8ff 518
bogdanm 0:9b334a45a8ff 519
bogdanm 0:9b334a45a8ff 520 /**
bogdanm 0:9b334a45a8ff 521 * @brief Sets the Smooth calibration parameters.
bogdanm 0:9b334a45a8ff 522 * @param hrtc: RTC handle
bogdanm 0:9b334a45a8ff 523 * @param SmoothCalibPeriod: Not used (only present for compatibility with another families)
bogdanm 0:9b334a45a8ff 524 * @param SmoothCalibPlusPulses: Not used (only present for compatibility with another families)
bogdanm 0:9b334a45a8ff 525 * @param SmouthCalibMinusPulsesValue: specifies the RTC Clock Calibration value.
bogdanm 0:9b334a45a8ff 526 * This parameter must be a number between 0 and 0x7F.
bogdanm 0:9b334a45a8ff 527 * @retval HAL status
bogdanm 0:9b334a45a8ff 528 */
bogdanm 0:9b334a45a8ff 529 HAL_StatusTypeDef HAL_RTCEx_SetSmoothCalib(RTC_HandleTypeDef* hrtc, uint32_t SmoothCalibPeriod, uint32_t SmoothCalibPlusPulses, uint32_t SmouthCalibMinusPulsesValue)
bogdanm 0:9b334a45a8ff 530 {
bogdanm 0:9b334a45a8ff 531 /* Check input parameters */
bogdanm 0:9b334a45a8ff 532 if(hrtc == NULL)
bogdanm 0:9b334a45a8ff 533 {
bogdanm 0:9b334a45a8ff 534 return HAL_ERROR;
bogdanm 0:9b334a45a8ff 535 }
bogdanm 0:9b334a45a8ff 536
bogdanm 0:9b334a45a8ff 537 /* Check the parameters */
bogdanm 0:9b334a45a8ff 538 assert_param(IS_RTC_SMOOTH_CALIB_MINUS(SmouthCalibMinusPulsesValue));
bogdanm 0:9b334a45a8ff 539
bogdanm 0:9b334a45a8ff 540 /* Process Locked */
bogdanm 0:9b334a45a8ff 541 __HAL_LOCK(hrtc);
bogdanm 0:9b334a45a8ff 542
bogdanm 0:9b334a45a8ff 543 hrtc->State = HAL_RTC_STATE_BUSY;
bogdanm 0:9b334a45a8ff 544
bogdanm 0:9b334a45a8ff 545 /* Sets RTC Clock Calibration value.*/
bogdanm 0:9b334a45a8ff 546 MODIFY_REG(BKP->RTCCR, BKP_RTCCR_CAL, SmouthCalibMinusPulsesValue);
bogdanm 0:9b334a45a8ff 547
bogdanm 0:9b334a45a8ff 548 /* Change RTC state */
bogdanm 0:9b334a45a8ff 549 hrtc->State = HAL_RTC_STATE_READY;
bogdanm 0:9b334a45a8ff 550
bogdanm 0:9b334a45a8ff 551 /* Process Unlocked */
bogdanm 0:9b334a45a8ff 552 __HAL_UNLOCK(hrtc);
bogdanm 0:9b334a45a8ff 553
bogdanm 0:9b334a45a8ff 554 return HAL_OK;
bogdanm 0:9b334a45a8ff 555 }
bogdanm 0:9b334a45a8ff 556
bogdanm 0:9b334a45a8ff 557 /**
bogdanm 0:9b334a45a8ff 558 * @}
bogdanm 0:9b334a45a8ff 559 */
bogdanm 0:9b334a45a8ff 560
bogdanm 0:9b334a45a8ff 561 /**
bogdanm 0:9b334a45a8ff 562 * @}
bogdanm 0:9b334a45a8ff 563 */
bogdanm 0:9b334a45a8ff 564
bogdanm 0:9b334a45a8ff 565 /**
bogdanm 0:9b334a45a8ff 566 * @}
bogdanm 0:9b334a45a8ff 567 */
bogdanm 0:9b334a45a8ff 568
bogdanm 0:9b334a45a8ff 569 #endif /* HAL_RTC_MODULE_ENABLED */
bogdanm 0:9b334a45a8ff 570
bogdanm 0:9b334a45a8ff 571 /**
bogdanm 0:9b334a45a8ff 572 * @}
bogdanm 0:9b334a45a8ff 573 */
bogdanm 0:9b334a45a8ff 574
bogdanm 0:9b334a45a8ff 575 /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/
bogdanm 0:9b334a45a8ff 576