Flotsam / mbed-modifed

Modified version of the mbed library for use with the Nucleo boards.

Dependents:   EEPROMWrite Full-Project

Fork of mbed-src by mbed official

targets/cmsis/TARGET_STM/TARGET_STM32F4/stm32f4xx_hal_rtc_ex.c@613:bc40b8d2aec4, 2015-08-20 (annotated)

Committer:
mbed_official
Date:
Thu Aug 20 10:45:13 2015 +0100
Revision:
613:bc40b8d2aec4
Parent:
532:fe11edbda85c 
Synchronized with git revision 92ca8c7b60a283b6bb60eb65b183dac1599f0ade



Full URL: https://github.com/mbedmicro/mbed/commit/92ca8c7b60a283b6bb60eb65b183dac1599f0ade/



Nordic: update application start address in GCC linker script

Who changed what in which revision?

UserRevisionLine numberNew contents of line
mbed_official 235:685d5f11838f 1 /**
mbed_official 235:685d5f11838f 2 ******************************************************************************
mbed_official 235:685d5f11838f 3 * @file stm32f4xx_hal_rtc_ex.c
mbed_official 235:685d5f11838f 4 * @author MCD Application Team
mbed_official 613:bc40b8d2aec4 5 * @version V1.3.2
mbed_official 613:bc40b8d2aec4 6 * @date 26-June-2015
mbed_official 235:685d5f11838f 7 * @brief RTC HAL module driver.
mbed_official 235:685d5f11838f 8 * This file provides firmware functions to manage the following
mbed_official 235:685d5f11838f 9 * functionalities of the Real Time Clock (RTC) Extension peripheral:
mbed_official 235:685d5f11838f 10 * + RTC Time Stamp functions
mbed_official 235:685d5f11838f 11 * + RTC Tamper functions
mbed_official 235:685d5f11838f 12 * + RTC Wake-up functions
mbed_official 235:685d5f11838f 13 * + Extension Control functions
mbed_official 235:685d5f11838f 14 * + Extension RTC features functions
mbed_official 235:685d5f11838f 15 *
mbed_official 235:685d5f11838f 16 @verbatim
mbed_official 235:685d5f11838f 17 ==============================================================================
mbed_official 235:685d5f11838f 18 ##### How to use this driver #####
mbed_official 235:685d5f11838f 19 ==============================================================================
mbed_official 235:685d5f11838f 20 [..]
mbed_official 235:685d5f11838f 21 (+) Enable the RTC domain access.
mbed_official 235:685d5f11838f 22 (+) Configure the RTC Prescaler (Asynchronous and Synchronous) and RTC hour
mbed_official 235:685d5f11838f 23 format using the HAL_RTC_Init() function.
mbed_official 235:685d5f11838f 24
mbed_official 532:fe11edbda85c 25 *** RTC Wake-up configuration ***
mbed_official 235:685d5f11838f 26 ================================
mbed_official 235:685d5f11838f 27 [..]
mbed_official 532:fe11edbda85c 28 (+) To configure the RTC Wake-up Clock source and Counter use the HAL_RTC_SetWakeUpTimer()
mbed_official 532:fe11edbda85c 29 function. You can also configure the RTC Wake-up timer in interrupt mode
mbed_official 235:685d5f11838f 30 using the HAL_RTC_SetWakeUpTimer_IT() function.
mbed_official 532:fe11edbda85c 31 (+) To read the RTC Wake-up Counter register, use the HAL_RTC_GetWakeUpTimer()
mbed_official 235:685d5f11838f 32 function.
mbed_official 235:685d5f11838f 33
mbed_official 235:685d5f11838f 34 *** TimeStamp configuration ***
mbed_official 235:685d5f11838f 35 ===============================
mbed_official 235:685d5f11838f 36 [..]
mbed_official 235:685d5f11838f 37 (+) Configure the RTC_AFx trigger and enable the RTC TimeStamp using the
mbed_official 235:685d5f11838f 38 HAL_RTC_SetTimeStamp() function. You can also configure the RTC TimeStamp with
mbed_official 235:685d5f11838f 39 interrupt mode using the HAL_RTC_SetTimeStamp_IT() function.
mbed_official 235:685d5f11838f 40 (+) To read the RTC TimeStamp Time and Date register, use the HAL_RTC_GetTimeStamp()
mbed_official 235:685d5f11838f 41 function.
mbed_official 235:685d5f11838f 42 (+) The TIMESTAMP alternate function can be mapped either to RTC_AF1 (PC13)
mbed_official 532:fe11edbda85c 43 or RTC_AF2 (PI8 or PA0 only for STM32F446xx devices) depending on the value of TSINSEL bit in
mbed_official 235:685d5f11838f 44 RTC_TAFCR register. The corresponding pin is also selected by HAL_RTC_SetTimeStamp()
mbed_official 235:685d5f11838f 45 or HAL_RTC_SetTimeStamp_IT() function.
mbed_official 235:685d5f11838f 46
mbed_official 235:685d5f11838f 47 *** Tamper configuration ***
mbed_official 235:685d5f11838f 48 ============================
mbed_official 235:685d5f11838f 49 [..]
mbed_official 235:685d5f11838f 50 (+) Enable the RTC Tamper and configure the Tamper filter count, trigger Edge
mbed_official 235:685d5f11838f 51 or Level according to the Tamper filter (if equal to 0 Edge else Level)
mbed_official 235:685d5f11838f 52 value, sampling frequency, precharge or discharge and Pull-UP using the
mbed_official 235:685d5f11838f 53 HAL_RTC_SetTamper() function. You can configure RTC Tamper in interrupt
mbed_official 235:685d5f11838f 54 mode using HAL_RTC_SetTamper_IT() function.
mbed_official 235:685d5f11838f 55 (+) The TAMPER1 alternate function can be mapped either to RTC_AF1 (PC13)
mbed_official 532:fe11edbda85c 56 or RTC_AF2 (PI8 or PA0 only for STM32F446xx devices) depending on the value of TAMP1INSEL bit in
mbed_official 235:685d5f11838f 57 RTC_TAFCR register. The corresponding pin is also selected by HAL_RTC_SetTamper()
mbed_official 235:685d5f11838f 58 or HAL_RTC_SetTamper_IT() function.
mbed_official 235:685d5f11838f 59
mbed_official 235:685d5f11838f 60 *** Backup Data Registers configuration ***
mbed_official 235:685d5f11838f 61 ===========================================
mbed_official 235:685d5f11838f 62 [..]
mbed_official 235:685d5f11838f 63 (+) To write to the RTC Backup Data registers, use the HAL_RTC_BKUPWrite()
mbed_official 235:685d5f11838f 64 function.
mbed_official 235:685d5f11838f 65 (+) To read the RTC Backup Data registers, use the HAL_RTC_BKUPRead()
mbed_official 235:685d5f11838f 66 function.
mbed_official 235:685d5f11838f 67
mbed_official 235:685d5f11838f 68 @endverbatim
mbed_official 235:685d5f11838f 69 ******************************************************************************
mbed_official 235:685d5f11838f 70 * @attention
mbed_official 235:685d5f11838f 71 *
mbed_official 532:fe11edbda85c 72 * <h2><center>&copy; COPYRIGHT(c) 2015 STMicroelectronics</center></h2>
mbed_official 235:685d5f11838f 73 *
mbed_official 235:685d5f11838f 74 * Redistribution and use in source and binary forms, with or without modification,
mbed_official 235:685d5f11838f 75 * are permitted provided that the following conditions are met:
mbed_official 235:685d5f11838f 76 * 1. Redistributions of source code must retain the above copyright notice,
mbed_official 235:685d5f11838f 77 * this list of conditions and the following disclaimer.
mbed_official 235:685d5f11838f 78 * 2. Redistributions in binary form must reproduce the above copyright notice,
mbed_official 235:685d5f11838f 79 * this list of conditions and the following disclaimer in the documentation
mbed_official 235:685d5f11838f 80 * and/or other materials provided with the distribution.
mbed_official 235:685d5f11838f 81 * 3. Neither the name of STMicroelectronics nor the names of its contributors
mbed_official 235:685d5f11838f 82 * may be used to endorse or promote products derived from this software
mbed_official 235:685d5f11838f 83 * without specific prior written permission.
mbed_official 235:685d5f11838f 84 *
mbed_official 235:685d5f11838f 85 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
mbed_official 235:685d5f11838f 86 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
mbed_official 235:685d5f11838f 87 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
mbed_official 235:685d5f11838f 88 * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
mbed_official 235:685d5f11838f 89 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
mbed_official 235:685d5f11838f 90 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
mbed_official 235:685d5f11838f 91 * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
mbed_official 235:685d5f11838f 92 * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
mbed_official 235:685d5f11838f 93 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
mbed_official 235:685d5f11838f 94 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
mbed_official 235:685d5f11838f 95 *
mbed_official 235:685d5f11838f 96 ******************************************************************************
mbed_official 235:685d5f11838f 97 */
mbed_official 235:685d5f11838f 98
mbed_official 235:685d5f11838f 99 /* Includes ------------------------------------------------------------------*/
mbed_official 235:685d5f11838f 100 #include "stm32f4xx_hal.h"
mbed_official 235:685d5f11838f 101
mbed_official 235:685d5f11838f 102 /** @addtogroup STM32F4xx_HAL_Driver
mbed_official 235:685d5f11838f 103 * @{
mbed_official 235:685d5f11838f 104 */
mbed_official 235:685d5f11838f 105
mbed_official 532:fe11edbda85c 106 /** @defgroup RTCEx RTCEx
mbed_official 235:685d5f11838f 107 * @brief RTC HAL module driver
mbed_official 235:685d5f11838f 108 * @{
mbed_official 235:685d5f11838f 109 */
mbed_official 235:685d5f11838f 110
mbed_official 235:685d5f11838f 111 #ifdef HAL_RTC_MODULE_ENABLED
mbed_official 235:685d5f11838f 112
mbed_official 235:685d5f11838f 113 /* Private typedef -----------------------------------------------------------*/
mbed_official 235:685d5f11838f 114 /* Private define ------------------------------------------------------------*/
mbed_official 235:685d5f11838f 115 /* Private macro -------------------------------------------------------------*/
mbed_official 235:685d5f11838f 116 /* Private variables ---------------------------------------------------------*/
mbed_official 235:685d5f11838f 117 /* Private function prototypes -----------------------------------------------*/
mbed_official 235:685d5f11838f 118 /* Private functions ---------------------------------------------------------*/
mbed_official 235:685d5f11838f 119
mbed_official 532:fe11edbda85c 120 /** @defgroup RTCEx_Exported_Functions RTCEx Exported Functions
mbed_official 235:685d5f11838f 121 * @{
mbed_official 532:fe11edbda85c 122 */
mbed_official 235:685d5f11838f 123
mbed_official 532:fe11edbda85c 124 /** @defgroup RTCEx_Exported_Functions_Group1 RTC TimeStamp and Tamper functions
mbed_official 235:685d5f11838f 125 * @brief RTC TimeStamp and Tamper functions
mbed_official 235:685d5f11838f 126 *
mbed_official 235:685d5f11838f 127 @verbatim
mbed_official 235:685d5f11838f 128 ===============================================================================
mbed_official 235:685d5f11838f 129 ##### RTC TimeStamp and Tamper functions #####
mbed_official 235:685d5f11838f 130 ===============================================================================
mbed_official 235:685d5f11838f 131
mbed_official 235:685d5f11838f 132 [..] This section provides functions allowing to configure TimeStamp feature
mbed_official 235:685d5f11838f 133
mbed_official 235:685d5f11838f 134 @endverbatim
mbed_official 235:685d5f11838f 135 * @{
mbed_official 235:685d5f11838f 136 */
mbed_official 235:685d5f11838f 137
mbed_official 235:685d5f11838f 138 /**
mbed_official 235:685d5f11838f 139 * @brief Sets TimeStamp.
mbed_official 235:685d5f11838f 140 * @note This API must be called before enabling the TimeStamp feature.
mbed_official 235:685d5f11838f 141 * @param hrtc: pointer to a RTC_HandleTypeDef structure that contains
mbed_official 235:685d5f11838f 142 * the configuration information for RTC.
mbed_official 235:685d5f11838f 143 * @param TimeStampEdge: Specifies the pin edge on which the TimeStamp is
mbed_official 235:685d5f11838f 144 * activated.
mbed_official 235:685d5f11838f 145 * This parameter can be one of the following values:
mbed_official 235:685d5f11838f 146 * @arg RTC_TIMESTAMPEDGE_RISING: the Time stamp event occurs on the
mbed_official 235:685d5f11838f 147 * rising edge of the related pin.
mbed_official 235:685d5f11838f 148 * @arg RTC_TIMESTAMPEDGE_FALLING: the Time stamp event occurs on the
mbed_official 235:685d5f11838f 149 * falling edge of the related pin.
mbed_official 235:685d5f11838f 150 * @param RTC_TimeStampPin: specifies the RTC TimeStamp Pin.
mbed_official 235:685d5f11838f 151 * This parameter can be one of the following values:
mbed_official 613:bc40b8d2aec4 152 * @arg RTC_TIMESTAMPPIN_DEFAULT: PC13 is selected as RTC TimeStamp Pin.
mbed_official 613:bc40b8d2aec4 153 * @arg RTC_TIMESTAMPPIN_POS1: PI8/PA0 is selected as RTC TimeStamp Pin.
mbed_official 613:bc40b8d2aec4 154 * (PI8 for all STM32 devices except for STM32F446xx devices the PA0 is used)
mbed_official 532:fe11edbda85c 155 * @arg RTC_TIMESTAMPPIN_PA0: PA0 is selected as RTC TimeStamp Pin only for STM32F446xx devices
mbed_official 235:685d5f11838f 156 * @retval HAL status
mbed_official 235:685d5f11838f 157 */
mbed_official 235:685d5f11838f 158 HAL_StatusTypeDef HAL_RTCEx_SetTimeStamp(RTC_HandleTypeDef *hrtc, uint32_t TimeStampEdge, uint32_t RTC_TimeStampPin)
mbed_official 235:685d5f11838f 159 {
mbed_official 235:685d5f11838f 160 uint32_t tmpreg = 0;
mbed_official 235:685d5f11838f 161
mbed_official 235:685d5f11838f 162 /* Check the parameters */
mbed_official 235:685d5f11838f 163 assert_param(IS_TIMESTAMP_EDGE(TimeStampEdge));
mbed_official 235:685d5f11838f 164 assert_param(IS_RTC_TIMESTAMP_PIN(RTC_TimeStampPin));
mbed_official 235:685d5f11838f 165
mbed_official 235:685d5f11838f 166 /* Process Locked */
mbed_official 235:685d5f11838f 167 __HAL_LOCK(hrtc);
mbed_official 235:685d5f11838f 168
mbed_official 235:685d5f11838f 169 hrtc->State = HAL_RTC_STATE_BUSY;
mbed_official 235:685d5f11838f 170
mbed_official 235:685d5f11838f 171 /* Get the RTC_CR register and clear the bits to be configured */
mbed_official 235:685d5f11838f 172 tmpreg = (uint32_t)(hrtc->Instance->CR & (uint32_t)~(RTC_CR_TSEDGE | RTC_CR_TSE));
mbed_official 235:685d5f11838f 173
mbed_official 235:685d5f11838f 174 tmpreg|= TimeStampEdge;
mbed_official 235:685d5f11838f 175
mbed_official 235:685d5f11838f 176 /* Disable the write protection for RTC registers */
mbed_official 235:685d5f11838f 177 __HAL_RTC_WRITEPROTECTION_DISABLE(hrtc);
mbed_official 235:685d5f11838f 178
mbed_official 235:685d5f11838f 179 hrtc->Instance->TAFCR &= (uint32_t)~RTC_TAFCR_TSINSEL;
mbed_official 235:685d5f11838f 180 hrtc->Instance->TAFCR |= (uint32_t)(RTC_TimeStampPin);
mbed_official 235:685d5f11838f 181
mbed_official 235:685d5f11838f 182 /* Configure the Time Stamp TSEDGE and Enable bits */
mbed_official 235:685d5f11838f 183 hrtc->Instance->CR = (uint32_t)tmpreg;
mbed_official 235:685d5f11838f 184
mbed_official 235:685d5f11838f 185 __HAL_RTC_TIMESTAMP_ENABLE(hrtc);
mbed_official 235:685d5f11838f 186
mbed_official 235:685d5f11838f 187 /* Enable the write protection for RTC registers */
mbed_official 235:685d5f11838f 188 __HAL_RTC_WRITEPROTECTION_ENABLE(hrtc);
mbed_official 235:685d5f11838f 189
mbed_official 235:685d5f11838f 190 /* Change RTC state */
mbed_official 235:685d5f11838f 191 hrtc->State = HAL_RTC_STATE_READY;
mbed_official 235:685d5f11838f 192
mbed_official 235:685d5f11838f 193 /* Process Unlocked */
mbed_official 235:685d5f11838f 194 __HAL_UNLOCK(hrtc);
mbed_official 235:685d5f11838f 195
mbed_official 235:685d5f11838f 196 return HAL_OK;
mbed_official 235:685d5f11838f 197 }
mbed_official 235:685d5f11838f 198
mbed_official 235:685d5f11838f 199 /**
mbed_official 235:685d5f11838f 200 * @brief Sets TimeStamp with Interrupt.
mbed_official 235:685d5f11838f 201 * @param hrtc: pointer to a RTC_HandleTypeDef structure that contains
mbed_official 235:685d5f11838f 202 * the configuration information for RTC.
mbed_official 235:685d5f11838f 203 * @note This API must be called before enabling the TimeStamp feature.
mbed_official 235:685d5f11838f 204 * @param TimeStampEdge: Specifies the pin edge on which the TimeStamp is
mbed_official 235:685d5f11838f 205 * activated.
mbed_official 235:685d5f11838f 206 * This parameter can be one of the following values:
mbed_official 235:685d5f11838f 207 * @arg RTC_TIMESTAMPEDGE_RISING: the Time stamp event occurs on the
mbed_official 235:685d5f11838f 208 * rising edge of the related pin.
mbed_official 235:685d5f11838f 209 * @arg RTC_TIMESTAMPEDGE_FALLING: the Time stamp event occurs on the
mbed_official 235:685d5f11838f 210 * falling edge of the related pin.
mbed_official 235:685d5f11838f 211 * @param RTC_TimeStampPin: Specifies the RTC TimeStamp Pin.
mbed_official 235:685d5f11838f 212 * This parameter can be one of the following values:
mbed_official 235:685d5f11838f 213 * @arg RTC_TIMESTAMPPIN_PC13: PC13 is selected as RTC TimeStamp Pin.
mbed_official 532:fe11edbda85c 214 * @arg RTC_TIMESTAMPPIN_PI8: PI8 is selected as RTC TimeStamp Pin. (not applicable in the case of STM32F446xx devices)
mbed_official 532:fe11edbda85c 215 * @arg RTC_TIMESTAMPPIN_PA0: PA0 is selected as RTC TimeStamp Pin only for STM32F446xx devices
mbed_official 235:685d5f11838f 216 * @retval HAL status
mbed_official 235:685d5f11838f 217 */
mbed_official 235:685d5f11838f 218 HAL_StatusTypeDef HAL_RTCEx_SetTimeStamp_IT(RTC_HandleTypeDef *hrtc, uint32_t TimeStampEdge, uint32_t RTC_TimeStampPin)
mbed_official 235:685d5f11838f 219 {
mbed_official 235:685d5f11838f 220 uint32_t tmpreg = 0;
mbed_official 235:685d5f11838f 221
mbed_official 235:685d5f11838f 222 /* Check the parameters */
mbed_official 235:685d5f11838f 223 assert_param(IS_TIMESTAMP_EDGE(TimeStampEdge));
mbed_official 235:685d5f11838f 224 assert_param(IS_RTC_TIMESTAMP_PIN(RTC_TimeStampPin));
mbed_official 235:685d5f11838f 225
mbed_official 235:685d5f11838f 226 /* Process Locked */
mbed_official 235:685d5f11838f 227 __HAL_LOCK(hrtc);
mbed_official 235:685d5f11838f 228
mbed_official 235:685d5f11838f 229 hrtc->State = HAL_RTC_STATE_BUSY;
mbed_official 235:685d5f11838f 230
mbed_official 235:685d5f11838f 231 /* Get the RTC_CR register and clear the bits to be configured */
mbed_official 235:685d5f11838f 232 tmpreg = (uint32_t)(hrtc->Instance->CR & (uint32_t)~(RTC_CR_TSEDGE | RTC_CR_TSE));
mbed_official 235:685d5f11838f 233
mbed_official 235:685d5f11838f 234 tmpreg |= TimeStampEdge;
mbed_official 235:685d5f11838f 235
mbed_official 235:685d5f11838f 236 /* Disable the write protection for RTC registers */
mbed_official 235:685d5f11838f 237 __HAL_RTC_WRITEPROTECTION_DISABLE(hrtc);
mbed_official 235:685d5f11838f 238
mbed_official 235:685d5f11838f 239 /* Configure the Time Stamp TSEDGE and Enable bits */
mbed_official 235:685d5f11838f 240 hrtc->Instance->CR = (uint32_t)tmpreg;
mbed_official 235:685d5f11838f 241
mbed_official 235:685d5f11838f 242 hrtc->Instance->TAFCR &= (uint32_t)~RTC_TAFCR_TSINSEL;
mbed_official 235:685d5f11838f 243 hrtc->Instance->TAFCR |= (uint32_t)(RTC_TimeStampPin);
mbed_official 235:685d5f11838f 244
mbed_official 235:685d5f11838f 245 __HAL_RTC_TIMESTAMP_ENABLE(hrtc);
mbed_official 235:685d5f11838f 246
mbed_official 235:685d5f11838f 247 /* Enable IT timestamp */
mbed_official 235:685d5f11838f 248 __HAL_RTC_TIMESTAMP_ENABLE_IT(hrtc,RTC_IT_TS);
mbed_official 235:685d5f11838f 249
mbed_official 235:685d5f11838f 250 /* RTC timestamp Interrupt Configuration: EXTI configuration */
mbed_official 532:fe11edbda85c 251 __HAL_RTC_TAMPER_TIMESTAMP_EXTI_ENABLE_IT();
mbed_official 235:685d5f11838f 252
mbed_official 235:685d5f11838f 253 EXTI->RTSR |= RTC_EXTI_LINE_TAMPER_TIMESTAMP_EVENT;
mbed_official 235:685d5f11838f 254
mbed_official 235:685d5f11838f 255 /* Enable the write protection for RTC registers */
mbed_official 235:685d5f11838f 256 __HAL_RTC_WRITEPROTECTION_ENABLE(hrtc);
mbed_official 235:685d5f11838f 257
mbed_official 235:685d5f11838f 258 hrtc->State = HAL_RTC_STATE_READY;
mbed_official 235:685d5f11838f 259
mbed_official 235:685d5f11838f 260 /* Process Unlocked */
mbed_official 235:685d5f11838f 261 __HAL_UNLOCK(hrtc);
mbed_official 235:685d5f11838f 262
mbed_official 235:685d5f11838f 263 return HAL_OK;
mbed_official 235:685d5f11838f 264 }
mbed_official 235:685d5f11838f 265
mbed_official 235:685d5f11838f 266 /**
mbed_official 235:685d5f11838f 267 * @brief Deactivates TimeStamp.
mbed_official 235:685d5f11838f 268 * @param hrtc: pointer to a RTC_HandleTypeDef structure that contains
mbed_official 235:685d5f11838f 269 * the configuration information for RTC.
mbed_official 235:685d5f11838f 270 * @retval HAL status
mbed_official 235:685d5f11838f 271 */
mbed_official 235:685d5f11838f 272 HAL_StatusTypeDef HAL_RTCEx_DeactivateTimeStamp(RTC_HandleTypeDef *hrtc)
mbed_official 235:685d5f11838f 273 {
mbed_official 235:685d5f11838f 274 uint32_t tmpreg = 0;
mbed_official 235:685d5f11838f 275
mbed_official 235:685d5f11838f 276 /* Process Locked */
mbed_official 235:685d5f11838f 277 __HAL_LOCK(hrtc);
mbed_official 235:685d5f11838f 278
mbed_official 235:685d5f11838f 279 hrtc->State = HAL_RTC_STATE_BUSY;
mbed_official 235:685d5f11838f 280
mbed_official 235:685d5f11838f 281 /* Disable the write protection for RTC registers */
mbed_official 235:685d5f11838f 282 __HAL_RTC_WRITEPROTECTION_DISABLE(hrtc);
mbed_official 235:685d5f11838f 283
mbed_official 235:685d5f11838f 284 /* In case of interrupt mode is used, the interrupt source must disabled */
mbed_official 235:685d5f11838f 285 __HAL_RTC_TIMESTAMP_DISABLE_IT(hrtc, RTC_IT_TS);
mbed_official 235:685d5f11838f 286
mbed_official 235:685d5f11838f 287 /* Get the RTC_CR register and clear the bits to be configured */
mbed_official 235:685d5f11838f 288 tmpreg = (uint32_t)(hrtc->Instance->CR & (uint32_t)~(RTC_CR_TSEDGE | RTC_CR_TSE));
mbed_official 235:685d5f11838f 289
mbed_official 235:685d5f11838f 290 /* Configure the Time Stamp TSEDGE and Enable bits */
mbed_official 235:685d5f11838f 291 hrtc->Instance->CR = (uint32_t)tmpreg;
mbed_official 235:685d5f11838f 292
mbed_official 235:685d5f11838f 293 /* Enable the write protection for RTC registers */
mbed_official 235:685d5f11838f 294 __HAL_RTC_WRITEPROTECTION_ENABLE(hrtc);
mbed_official 235:685d5f11838f 295
mbed_official 235:685d5f11838f 296 hrtc->State = HAL_RTC_STATE_READY;
mbed_official 235:685d5f11838f 297
mbed_official 235:685d5f11838f 298 /* Process Unlocked */
mbed_official 235:685d5f11838f 299 __HAL_UNLOCK(hrtc);
mbed_official 235:685d5f11838f 300
mbed_official 235:685d5f11838f 301 return HAL_OK;
mbed_official 235:685d5f11838f 302 }
mbed_official 235:685d5f11838f 303
mbed_official 235:685d5f11838f 304 /**
mbed_official 235:685d5f11838f 305 * @brief Gets the RTC TimeStamp value.
mbed_official 235:685d5f11838f 306 * @param hrtc: pointer to a RTC_HandleTypeDef structure that contains
mbed_official 235:685d5f11838f 307 * the configuration information for RTC.
mbed_official 235:685d5f11838f 308 * @param sTimeStamp: Pointer to Time structure
mbed_official 235:685d5f11838f 309 * @param sTimeStampDate: Pointer to Date structure
mbed_official 235:685d5f11838f 310 * @param Format: specifies the format of the entered parameters.
mbed_official 235:685d5f11838f 311 * This parameter can be one of the following values:
mbed_official 532:fe11edbda85c 312 * RTC_FORMAT_BIN: Binary data format
mbed_official 532:fe11edbda85c 313 * RTC_FORMAT_BCD: BCD data format
mbed_official 235:685d5f11838f 314 * @retval HAL status
mbed_official 235:685d5f11838f 315 */
mbed_official 235:685d5f11838f 316 HAL_StatusTypeDef HAL_RTCEx_GetTimeStamp(RTC_HandleTypeDef *hrtc, RTC_TimeTypeDef* sTimeStamp, RTC_DateTypeDef* sTimeStampDate, uint32_t Format)
mbed_official 235:685d5f11838f 317 {
mbed_official 235:685d5f11838f 318 uint32_t tmptime = 0, tmpdate = 0;
mbed_official 235:685d5f11838f 319
mbed_official 235:685d5f11838f 320 /* Check the parameters */
mbed_official 235:685d5f11838f 321 assert_param(IS_RTC_FORMAT(Format));
mbed_official 235:685d5f11838f 322
mbed_official 235:685d5f11838f 323 /* Get the TimeStamp time and date registers values */
mbed_official 235:685d5f11838f 324 tmptime = (uint32_t)(hrtc->Instance->TSTR & RTC_TR_RESERVED_MASK);
mbed_official 235:685d5f11838f 325 tmpdate = (uint32_t)(hrtc->Instance->TSDR & RTC_DR_RESERVED_MASK);
mbed_official 235:685d5f11838f 326
mbed_official 235:685d5f11838f 327 /* Fill the Time structure fields with the read parameters */
mbed_official 235:685d5f11838f 328 sTimeStamp->Hours = (uint8_t)((tmptime & (RTC_TR_HT | RTC_TR_HU)) >> 16);
mbed_official 235:685d5f11838f 329 sTimeStamp->Minutes = (uint8_t)((tmptime & (RTC_TR_MNT | RTC_TR_MNU)) >> 8);
mbed_official 235:685d5f11838f 330 sTimeStamp->Seconds = (uint8_t)(tmptime & (RTC_TR_ST | RTC_TR_SU));
mbed_official 235:685d5f11838f 331 sTimeStamp->TimeFormat = (uint8_t)((tmptime & (RTC_TR_PM)) >> 16);
mbed_official 235:685d5f11838f 332 sTimeStamp->SubSeconds = (uint32_t) hrtc->Instance->TSSSR;
mbed_official 235:685d5f11838f 333
mbed_official 235:685d5f11838f 334 /* Fill the Date structure fields with the read parameters */
mbed_official 235:685d5f11838f 335 sTimeStampDate->Year = 0;
mbed_official 235:685d5f11838f 336 sTimeStampDate->Month = (uint8_t)((tmpdate & (RTC_DR_MT | RTC_DR_MU)) >> 8);
mbed_official 235:685d5f11838f 337 sTimeStampDate->Date = (uint8_t)(tmpdate & (RTC_DR_DT | RTC_DR_DU));
mbed_official 235:685d5f11838f 338 sTimeStampDate->WeekDay = (uint8_t)((tmpdate & (RTC_DR_WDU)) >> 13);
mbed_official 235:685d5f11838f 339
mbed_official 235:685d5f11838f 340 /* Check the input parameters format */
mbed_official 532:fe11edbda85c 341 if(Format == RTC_FORMAT_BIN)
mbed_official 235:685d5f11838f 342 {
mbed_official 235:685d5f11838f 343 /* Convert the TimeStamp structure parameters to Binary format */
mbed_official 235:685d5f11838f 344 sTimeStamp->Hours = (uint8_t)RTC_Bcd2ToByte(sTimeStamp->Hours);
mbed_official 235:685d5f11838f 345 sTimeStamp->Minutes = (uint8_t)RTC_Bcd2ToByte(sTimeStamp->Minutes);
mbed_official 235:685d5f11838f 346 sTimeStamp->Seconds = (uint8_t)RTC_Bcd2ToByte(sTimeStamp->Seconds);
mbed_official 235:685d5f11838f 347
mbed_official 235:685d5f11838f 348 /* Convert the DateTimeStamp structure parameters to Binary format */
mbed_official 235:685d5f11838f 349 sTimeStampDate->Month = (uint8_t)RTC_Bcd2ToByte(sTimeStampDate->Month);
mbed_official 235:685d5f11838f 350 sTimeStampDate->Date = (uint8_t)RTC_Bcd2ToByte(sTimeStampDate->Date);
mbed_official 235:685d5f11838f 351 sTimeStampDate->WeekDay = (uint8_t)RTC_Bcd2ToByte(sTimeStampDate->WeekDay);
mbed_official 235:685d5f11838f 352 }
mbed_official 235:685d5f11838f 353
mbed_official 235:685d5f11838f 354 /* Clear the TIMESTAMP Flag */
mbed_official 235:685d5f11838f 355 __HAL_RTC_TIMESTAMP_CLEAR_FLAG(hrtc, RTC_FLAG_TSF);
mbed_official 235:685d5f11838f 356
mbed_official 235:685d5f11838f 357 return HAL_OK;
mbed_official 235:685d5f11838f 358 }
mbed_official 235:685d5f11838f 359
mbed_official 235:685d5f11838f 360 /**
mbed_official 235:685d5f11838f 361 * @brief Sets Tamper
mbed_official 235:685d5f11838f 362 * @note By calling this API we disable the tamper interrupt for all tampers.
mbed_official 235:685d5f11838f 363 * @param hrtc: pointer to a RTC_HandleTypeDef structure that contains
mbed_official 235:685d5f11838f 364 * the configuration information for RTC.
mbed_official 235:685d5f11838f 365 * @param sTamper: Pointer to Tamper Structure.
mbed_official 235:685d5f11838f 366 * @retval HAL status
mbed_official 235:685d5f11838f 367 */
mbed_official 235:685d5f11838f 368 HAL_StatusTypeDef HAL_RTCEx_SetTamper(RTC_HandleTypeDef *hrtc, RTC_TamperTypeDef* sTamper)
mbed_official 235:685d5f11838f 369 {
mbed_official 235:685d5f11838f 370 uint32_t tmpreg = 0;
mbed_official 235:685d5f11838f 371
mbed_official 235:685d5f11838f 372 /* Check the parameters */
mbed_official 532:fe11edbda85c 373 assert_param(IS_RTC_TAMPER(sTamper->Tamper));
mbed_official 235:685d5f11838f 374 assert_param(IS_RTC_TAMPER_PIN(sTamper->PinSelection));
mbed_official 532:fe11edbda85c 375 assert_param(IS_RTC_TAMPER_TRIGGER(sTamper->Trigger));
mbed_official 532:fe11edbda85c 376 assert_param(IS_RTC_TAMPER_FILTER(sTamper->Filter));
mbed_official 532:fe11edbda85c 377 assert_param(IS_RTC_TAMPER_SAMPLING_FREQ(sTamper->SamplingFrequency));
mbed_official 532:fe11edbda85c 378 assert_param(IS_RTC_TAMPER_PRECHARGE_DURATION(sTamper->PrechargeDuration));
mbed_official 532:fe11edbda85c 379 assert_param(IS_RTC_TAMPER_PULLUP_STATE(sTamper->TamperPullUp));
mbed_official 532:fe11edbda85c 380 assert_param(IS_RTC_TAMPER_TIMESTAMPONTAMPER_DETECTION(sTamper->TimeStampOnTamperDetection));
mbed_official 235:685d5f11838f 381
mbed_official 235:685d5f11838f 382 /* Process Locked */
mbed_official 235:685d5f11838f 383 __HAL_LOCK(hrtc);
mbed_official 235:685d5f11838f 384
mbed_official 235:685d5f11838f 385 hrtc->State = HAL_RTC_STATE_BUSY;
mbed_official 235:685d5f11838f 386
mbed_official 235:685d5f11838f 387 if(sTamper->Trigger != RTC_TAMPERTRIGGER_RISINGEDGE)
mbed_official 235:685d5f11838f 388 {
mbed_official 235:685d5f11838f 389 sTamper->Trigger = (uint32_t)(sTamper->Tamper << 1);
mbed_official 235:685d5f11838f 390 }
mbed_official 235:685d5f11838f 391
mbed_official 235:685d5f11838f 392 tmpreg = ((uint32_t)sTamper->Tamper | (uint32_t)sTamper->PinSelection | (uint32_t)sTamper->Trigger |\
mbed_official 235:685d5f11838f 393 (uint32_t)sTamper->Filter | (uint32_t)sTamper->SamplingFrequency | (uint32_t)sTamper->PrechargeDuration |\
mbed_official 235:685d5f11838f 394 (uint32_t)sTamper->TamperPullUp | sTamper->TimeStampOnTamperDetection);
mbed_official 235:685d5f11838f 395
mbed_official 235:685d5f11838f 396 hrtc->Instance->TAFCR &= (uint32_t)~((uint32_t)sTamper->Tamper | (uint32_t)(sTamper->Tamper << 1) | (uint32_t)RTC_TAFCR_TAMPTS |\
mbed_official 235:685d5f11838f 397 (uint32_t)RTC_TAFCR_TAMPFREQ | (uint32_t)RTC_TAFCR_TAMPFLT | (uint32_t)RTC_TAFCR_TAMPPRCH |\
mbed_official 235:685d5f11838f 398 (uint32_t)RTC_TAFCR_TAMPPUDIS | (uint32_t)RTC_TAFCR_TAMPINSEL | (uint32_t)RTC_TAFCR_TAMPIE);
mbed_official 235:685d5f11838f 399
mbed_official 235:685d5f11838f 400 hrtc->Instance->TAFCR |= tmpreg;
mbed_official 235:685d5f11838f 401
mbed_official 235:685d5f11838f 402 hrtc->State = HAL_RTC_STATE_READY;
mbed_official 235:685d5f11838f 403
mbed_official 235:685d5f11838f 404 /* Process Unlocked */
mbed_official 235:685d5f11838f 405 __HAL_UNLOCK(hrtc);
mbed_official 235:685d5f11838f 406
mbed_official 235:685d5f11838f 407 return HAL_OK;
mbed_official 235:685d5f11838f 408 }
mbed_official 235:685d5f11838f 409
mbed_official 235:685d5f11838f 410 /**
mbed_official 235:685d5f11838f 411 * @brief Sets Tamper with interrupt.
mbed_official 235:685d5f11838f 412 * @note By calling this API we force the tamper interrupt for all tampers.
mbed_official 235:685d5f11838f 413 * @param hrtc: pointer to a RTC_HandleTypeDef structure that contains
mbed_official 235:685d5f11838f 414 * the configuration information for RTC.
mbed_official 235:685d5f11838f 415 * @param sTamper: Pointer to RTC Tamper.
mbed_official 235:685d5f11838f 416 * @retval HAL status
mbed_official 235:685d5f11838f 417 */
mbed_official 235:685d5f11838f 418 HAL_StatusTypeDef HAL_RTCEx_SetTamper_IT(RTC_HandleTypeDef *hrtc, RTC_TamperTypeDef* sTamper)
mbed_official 235:685d5f11838f 419 {
mbed_official 235:685d5f11838f 420 uint32_t tmpreg = 0;
mbed_official 235:685d5f11838f 421
mbed_official 235:685d5f11838f 422 /* Check the parameters */
mbed_official 532:fe11edbda85c 423 assert_param(IS_RTC_TAMPER(sTamper->Tamper));
mbed_official 235:685d5f11838f 424 assert_param(IS_RTC_TAMPER_PIN(sTamper->PinSelection));
mbed_official 532:fe11edbda85c 425 assert_param(IS_RTC_TAMPER_TRIGGER(sTamper->Trigger));
mbed_official 532:fe11edbda85c 426 assert_param(IS_RTC_TAMPER_FILTER(sTamper->Filter));
mbed_official 532:fe11edbda85c 427 assert_param(IS_RTC_TAMPER_SAMPLING_FREQ(sTamper->SamplingFrequency));
mbed_official 532:fe11edbda85c 428 assert_param(IS_RTC_TAMPER_PRECHARGE_DURATION(sTamper->PrechargeDuration));
mbed_official 532:fe11edbda85c 429 assert_param(IS_RTC_TAMPER_PULLUP_STATE(sTamper->TamperPullUp));
mbed_official 532:fe11edbda85c 430 assert_param(IS_RTC_TAMPER_TIMESTAMPONTAMPER_DETECTION(sTamper->TimeStampOnTamperDetection));
mbed_official 235:685d5f11838f 431
mbed_official 235:685d5f11838f 432 /* Process Locked */
mbed_official 235:685d5f11838f 433 __HAL_LOCK(hrtc);
mbed_official 235:685d5f11838f 434
mbed_official 235:685d5f11838f 435 hrtc->State = HAL_RTC_STATE_BUSY;
mbed_official 235:685d5f11838f 436
mbed_official 235:685d5f11838f 437 /* Configure the tamper trigger */
mbed_official 235:685d5f11838f 438 if(sTamper->Trigger != RTC_TAMPERTRIGGER_RISINGEDGE)
mbed_official 235:685d5f11838f 439 {
mbed_official 235:685d5f11838f 440 sTamper->Trigger = (uint32_t)(sTamper->Tamper << 1);
mbed_official 235:685d5f11838f 441 }
mbed_official 235:685d5f11838f 442
mbed_official 235:685d5f11838f 443 tmpreg = ((uint32_t)sTamper->Tamper | (uint32_t)sTamper->PinSelection | (uint32_t)sTamper->Trigger |\
mbed_official 235:685d5f11838f 444 (uint32_t)sTamper->Filter | (uint32_t)sTamper->SamplingFrequency | (uint32_t)sTamper->PrechargeDuration |\
mbed_official 235:685d5f11838f 445 (uint32_t)sTamper->TamperPullUp | sTamper->TimeStampOnTamperDetection);
mbed_official 235:685d5f11838f 446
mbed_official 235:685d5f11838f 447 hrtc->Instance->TAFCR &= (uint32_t)~((uint32_t)sTamper->Tamper | (uint32_t)(sTamper->Tamper << 1) | (uint32_t)RTC_TAFCR_TAMPTS |\
mbed_official 235:685d5f11838f 448 (uint32_t)RTC_TAFCR_TAMPFREQ | (uint32_t)RTC_TAFCR_TAMPFLT | (uint32_t)RTC_TAFCR_TAMPPRCH |\
mbed_official 235:685d5f11838f 449 (uint32_t)RTC_TAFCR_TAMPPUDIS | (uint32_t)RTC_TAFCR_TAMPINSEL);
mbed_official 235:685d5f11838f 450
mbed_official 235:685d5f11838f 451 hrtc->Instance->TAFCR |= tmpreg;
mbed_official 235:685d5f11838f 452
mbed_official 235:685d5f11838f 453 /* Configure the Tamper Interrupt in the RTC_TAFCR */
mbed_official 235:685d5f11838f 454 hrtc->Instance->TAFCR |= (uint32_t)RTC_TAFCR_TAMPIE;
mbed_official 235:685d5f11838f 455
mbed_official 235:685d5f11838f 456 /* RTC Tamper Interrupt Configuration: EXTI configuration */
mbed_official 532:fe11edbda85c 457 __HAL_RTC_TAMPER_TIMESTAMP_EXTI_ENABLE_IT();
mbed_official 235:685d5f11838f 458
mbed_official 235:685d5f11838f 459 EXTI->RTSR |= RTC_EXTI_LINE_TAMPER_TIMESTAMP_EVENT;
mbed_official 235:685d5f11838f 460
mbed_official 235:685d5f11838f 461 hrtc->State = HAL_RTC_STATE_READY;
mbed_official 235:685d5f11838f 462
mbed_official 235:685d5f11838f 463 /* Process Unlocked */
mbed_official 235:685d5f11838f 464 __HAL_UNLOCK(hrtc);
mbed_official 235:685d5f11838f 465
mbed_official 235:685d5f11838f 466 return HAL_OK;
mbed_official 235:685d5f11838f 467 }
mbed_official 235:685d5f11838f 468
mbed_official 235:685d5f11838f 469 /**
mbed_official 235:685d5f11838f 470 * @brief Deactivates Tamper.
mbed_official 235:685d5f11838f 471 * @param hrtc: pointer to a RTC_HandleTypeDef structure that contains
mbed_official 235:685d5f11838f 472 * the configuration information for RTC.
mbed_official 235:685d5f11838f 473 * @param Tamper: Selected tamper pin.
mbed_official 235:685d5f11838f 474 * This parameter can be RTC_Tamper_1 and/or RTC_TAMPER_2.
mbed_official 235:685d5f11838f 475 * @retval HAL status
mbed_official 235:685d5f11838f 476 */
mbed_official 235:685d5f11838f 477 HAL_StatusTypeDef HAL_RTCEx_DeactivateTamper(RTC_HandleTypeDef *hrtc, uint32_t Tamper)
mbed_official 235:685d5f11838f 478 {
mbed_official 532:fe11edbda85c 479 assert_param(IS_RTC_TAMPER(Tamper));
mbed_official 235:685d5f11838f 480
mbed_official 235:685d5f11838f 481 /* Process Locked */
mbed_official 235:685d5f11838f 482 __HAL_LOCK(hrtc);
mbed_official 235:685d5f11838f 483
mbed_official 235:685d5f11838f 484 hrtc->State = HAL_RTC_STATE_BUSY;
mbed_official 235:685d5f11838f 485
mbed_official 235:685d5f11838f 486 /* Disable the selected Tamper pin */
mbed_official 235:685d5f11838f 487 hrtc->Instance->TAFCR &= (uint32_t)~Tamper;
mbed_official 235:685d5f11838f 488
mbed_official 235:685d5f11838f 489 hrtc->State = HAL_RTC_STATE_READY;
mbed_official 235:685d5f11838f 490
mbed_official 235:685d5f11838f 491 /* Process Unlocked */
mbed_official 235:685d5f11838f 492 __HAL_UNLOCK(hrtc);
mbed_official 235:685d5f11838f 493
mbed_official 235:685d5f11838f 494 return HAL_OK;
mbed_official 235:685d5f11838f 495 }
mbed_official 235:685d5f11838f 496
mbed_official 235:685d5f11838f 497 /**
mbed_official 235:685d5f11838f 498 * @brief This function handles TimeStamp interrupt request.
mbed_official 235:685d5f11838f 499 * @param hrtc: pointer to a RTC_HandleTypeDef structure that contains
mbed_official 235:685d5f11838f 500 * the configuration information for RTC.
mbed_official 235:685d5f11838f 501 * @retval None
mbed_official 235:685d5f11838f 502 */
mbed_official 235:685d5f11838f 503 void HAL_RTCEx_TamperTimeStampIRQHandler(RTC_HandleTypeDef *hrtc)
mbed_official 235:685d5f11838f 504 {
mbed_official 235:685d5f11838f 505 if(__HAL_RTC_TIMESTAMP_GET_IT(hrtc, RTC_IT_TS))
mbed_official 235:685d5f11838f 506 {
mbed_official 235:685d5f11838f 507 /* Get the status of the Interrupt */
mbed_official 235:685d5f11838f 508 if((uint32_t)(hrtc->Instance->CR & RTC_IT_TS) != (uint32_t)RESET)
mbed_official 235:685d5f11838f 509 {
mbed_official 235:685d5f11838f 510 /* TIMESTAMP callback */
mbed_official 235:685d5f11838f 511 HAL_RTCEx_TimeStampEventCallback(hrtc);
mbed_official 235:685d5f11838f 512
mbed_official 235:685d5f11838f 513 /* Clear the TIMESTAMP interrupt pending bit */
mbed_official 235:685d5f11838f 514 __HAL_RTC_TIMESTAMP_CLEAR_FLAG(hrtc,RTC_FLAG_TSF);
mbed_official 235:685d5f11838f 515 }
mbed_official 235:685d5f11838f 516 }
mbed_official 235:685d5f11838f 517
mbed_official 235:685d5f11838f 518 /* Get the status of the Interrupt */
mbed_official 235:685d5f11838f 519 if(__HAL_RTC_TAMPER_GET_IT(hrtc,RTC_IT_TAMP1))
mbed_official 235:685d5f11838f 520 {
mbed_official 235:685d5f11838f 521 /* Get the TAMPER Interrupt enable bit and pending bit */
mbed_official 235:685d5f11838f 522 if(((hrtc->Instance->TAFCR & (RTC_TAFCR_TAMPIE))) != (uint32_t)RESET)
mbed_official 235:685d5f11838f 523 {
mbed_official 235:685d5f11838f 524 /* Tamper callback */
mbed_official 235:685d5f11838f 525 HAL_RTCEx_Tamper1EventCallback(hrtc);
mbed_official 235:685d5f11838f 526
mbed_official 235:685d5f11838f 527 /* Clear the Tamper interrupt pending bit */
mbed_official 235:685d5f11838f 528 __HAL_RTC_TAMPER_CLEAR_FLAG(hrtc,RTC_FLAG_TAMP1F);
mbed_official 235:685d5f11838f 529 }
mbed_official 235:685d5f11838f 530 }
mbed_official 235:685d5f11838f 531
mbed_official 235:685d5f11838f 532 /* Get the status of the Interrupt */
mbed_official 235:685d5f11838f 533 if(__HAL_RTC_TAMPER_GET_IT(hrtc, RTC_IT_TAMP2))
mbed_official 235:685d5f11838f 534 {
mbed_official 235:685d5f11838f 535 /* Get the TAMPER Interrupt enable bit and pending bit */
mbed_official 235:685d5f11838f 536 if(((hrtc->Instance->TAFCR & RTC_TAFCR_TAMPIE)) != (uint32_t)RESET)
mbed_official 235:685d5f11838f 537 {
mbed_official 235:685d5f11838f 538 /* Tamper callback */
mbed_official 235:685d5f11838f 539 HAL_RTCEx_Tamper2EventCallback(hrtc);
mbed_official 235:685d5f11838f 540
mbed_official 235:685d5f11838f 541 /* Clear the Tamper interrupt pending bit */
mbed_official 235:685d5f11838f 542 __HAL_RTC_TAMPER_CLEAR_FLAG(hrtc, RTC_FLAG_TAMP2F);
mbed_official 235:685d5f11838f 543 }
mbed_official 235:685d5f11838f 544 }
mbed_official 235:685d5f11838f 545 /* Clear the EXTI's Flag for RTC TimeStamp and Tamper */
mbed_official 532:fe11edbda85c 546 __HAL_RTC_TAMPER_TIMESTAMP_EXTI_CLEAR_FLAG();
mbed_official 235:685d5f11838f 547
mbed_official 235:685d5f11838f 548 /* Change RTC state */
mbed_official 235:685d5f11838f 549 hrtc->State = HAL_RTC_STATE_READY;
mbed_official 235:685d5f11838f 550 }
mbed_official 235:685d5f11838f 551
mbed_official 235:685d5f11838f 552 /**
mbed_official 235:685d5f11838f 553 * @brief TimeStamp callback.
mbed_official 235:685d5f11838f 554 * @param hrtc: pointer to a RTC_HandleTypeDef structure that contains
mbed_official 235:685d5f11838f 555 * the configuration information for RTC.
mbed_official 235:685d5f11838f 556 * @retval None
mbed_official 235:685d5f11838f 557 */
mbed_official 235:685d5f11838f 558 __weak void HAL_RTCEx_TimeStampEventCallback(RTC_HandleTypeDef *hrtc)
mbed_official 235:685d5f11838f 559 {
mbed_official 235:685d5f11838f 560 /* NOTE : This function Should not be modified, when the callback is needed,
mbed_official 235:685d5f11838f 561 the HAL_RTC_TimeStampEventCallback could be implemented in the user file
mbed_official 235:685d5f11838f 562 */
mbed_official 235:685d5f11838f 563 }
mbed_official 235:685d5f11838f 564
mbed_official 235:685d5f11838f 565 /**
mbed_official 235:685d5f11838f 566 * @brief Tamper 1 callback.
mbed_official 235:685d5f11838f 567 * @param hrtc: pointer to a RTC_HandleTypeDef structure that contains
mbed_official 235:685d5f11838f 568 * the configuration information for RTC.
mbed_official 235:685d5f11838f 569 * @retval None
mbed_official 235:685d5f11838f 570 */
mbed_official 235:685d5f11838f 571 __weak void HAL_RTCEx_Tamper1EventCallback(RTC_HandleTypeDef *hrtc)
mbed_official 235:685d5f11838f 572 {
mbed_official 235:685d5f11838f 573 /* NOTE : This function Should not be modified, when the callback is needed,
mbed_official 235:685d5f11838f 574 the HAL_RTC_Tamper1EventCallback could be implemented in the user file
mbed_official 235:685d5f11838f 575 */
mbed_official 235:685d5f11838f 576 }
mbed_official 235:685d5f11838f 577
mbed_official 235:685d5f11838f 578 /**
mbed_official 235:685d5f11838f 579 * @brief Tamper 2 callback.
mbed_official 235:685d5f11838f 580 * @param hrtc: pointer to a RTC_HandleTypeDef structure that contains
mbed_official 235:685d5f11838f 581 * the configuration information for RTC.
mbed_official 235:685d5f11838f 582 * @retval None
mbed_official 235:685d5f11838f 583 */
mbed_official 235:685d5f11838f 584 __weak void HAL_RTCEx_Tamper2EventCallback(RTC_HandleTypeDef *hrtc)
mbed_official 235:685d5f11838f 585 {
mbed_official 235:685d5f11838f 586 /* NOTE : This function Should not be modified, when the callback is needed,
mbed_official 235:685d5f11838f 587 the HAL_RTC_Tamper2EventCallback could be implemented in the user file
mbed_official 235:685d5f11838f 588 */
mbed_official 235:685d5f11838f 589 }
mbed_official 235:685d5f11838f 590
mbed_official 235:685d5f11838f 591 /**
mbed_official 235:685d5f11838f 592 * @brief This function handles TimeStamp polling request.
mbed_official 235:685d5f11838f 593 * @param hrtc: pointer to a RTC_HandleTypeDef structure that contains
mbed_official 235:685d5f11838f 594 * the configuration information for RTC.
mbed_official 235:685d5f11838f 595 * @param Timeout: Timeout duration
mbed_official 235:685d5f11838f 596 * @retval HAL status
mbed_official 235:685d5f11838f 597 */
mbed_official 235:685d5f11838f 598 HAL_StatusTypeDef HAL_RTCEx_PollForTimeStampEvent(RTC_HandleTypeDef *hrtc, uint32_t Timeout)
mbed_official 235:685d5f11838f 599 {
mbed_official 235:685d5f11838f 600 uint32_t tickstart = 0;
mbed_official 235:685d5f11838f 601
mbed_official 235:685d5f11838f 602 /* Get tick */
mbed_official 235:685d5f11838f 603 tickstart = HAL_GetTick();
mbed_official 235:685d5f11838f 604
mbed_official 235:685d5f11838f 605 while(__HAL_RTC_TIMESTAMP_GET_FLAG(hrtc, RTC_FLAG_TSF) == RESET)
mbed_official 235:685d5f11838f 606 {
mbed_official 235:685d5f11838f 607 if(__HAL_RTC_TIMESTAMP_GET_FLAG(hrtc, RTC_FLAG_TSOVF) != RESET)
mbed_official 235:685d5f11838f 608 {
mbed_official 532:fe11edbda85c 609 /* Clear the TIMESTAMP Overrun Flag */
mbed_official 235:685d5f11838f 610 __HAL_RTC_TIMESTAMP_CLEAR_FLAG(hrtc, RTC_FLAG_TSOVF);
mbed_official 235:685d5f11838f 611
mbed_official 235:685d5f11838f 612 /* Change TIMESTAMP state */
mbed_official 235:685d5f11838f 613 hrtc->State = HAL_RTC_STATE_ERROR;
mbed_official 235:685d5f11838f 614
mbed_official 235:685d5f11838f 615 return HAL_ERROR;
mbed_official 235:685d5f11838f 616 }
mbed_official 235:685d5f11838f 617
mbed_official 235:685d5f11838f 618 if(Timeout != HAL_MAX_DELAY)
mbed_official 235:685d5f11838f 619 {
mbed_official 235:685d5f11838f 620 if((Timeout == 0)||((HAL_GetTick() - tickstart ) > Timeout))
mbed_official 235:685d5f11838f 621 {
mbed_official 235:685d5f11838f 622 hrtc->State = HAL_RTC_STATE_TIMEOUT;
mbed_official 235:685d5f11838f 623 return HAL_TIMEOUT;
mbed_official 235:685d5f11838f 624 }
mbed_official 235:685d5f11838f 625 }
mbed_official 235:685d5f11838f 626 }
mbed_official 235:685d5f11838f 627
mbed_official 235:685d5f11838f 628 /* Change RTC state */
mbed_official 235:685d5f11838f 629 hrtc->State = HAL_RTC_STATE_READY;
mbed_official 235:685d5f11838f 630
mbed_official 235:685d5f11838f 631 return HAL_OK;
mbed_official 235:685d5f11838f 632 }
mbed_official 235:685d5f11838f 633
mbed_official 235:685d5f11838f 634 /**
mbed_official 235:685d5f11838f 635 * @brief This function handles Tamper1 Polling.
mbed_official 235:685d5f11838f 636 * @param hrtc: pointer to a RTC_HandleTypeDef structure that contains
mbed_official 235:685d5f11838f 637 * the configuration information for RTC.
mbed_official 235:685d5f11838f 638 * @param Timeout: Timeout duration
mbed_official 235:685d5f11838f 639 * @retval HAL status
mbed_official 235:685d5f11838f 640 */
mbed_official 235:685d5f11838f 641 HAL_StatusTypeDef HAL_RTCEx_PollForTamper1Event(RTC_HandleTypeDef *hrtc, uint32_t Timeout)
mbed_official 235:685d5f11838f 642 {
mbed_official 235:685d5f11838f 643 uint32_t tickstart = 0;
mbed_official 235:685d5f11838f 644
mbed_official 235:685d5f11838f 645 /* Get tick */
mbed_official 235:685d5f11838f 646 tickstart = HAL_GetTick();
mbed_official 235:685d5f11838f 647
mbed_official 235:685d5f11838f 648 /* Get the status of the Interrupt */
mbed_official 235:685d5f11838f 649 while(__HAL_RTC_TAMPER_GET_FLAG(hrtc, RTC_FLAG_TAMP1F)== RESET)
mbed_official 235:685d5f11838f 650 {
mbed_official 235:685d5f11838f 651 if(Timeout != HAL_MAX_DELAY)
mbed_official 235:685d5f11838f 652 {
mbed_official 235:685d5f11838f 653 if((Timeout == 0)||((HAL_GetTick() - tickstart ) > Timeout))
mbed_official 235:685d5f11838f 654 {
mbed_official 235:685d5f11838f 655 hrtc->State = HAL_RTC_STATE_TIMEOUT;
mbed_official 235:685d5f11838f 656 return HAL_TIMEOUT;
mbed_official 235:685d5f11838f 657 }
mbed_official 235:685d5f11838f 658 }
mbed_official 235:685d5f11838f 659 }
mbed_official 235:685d5f11838f 660
mbed_official 235:685d5f11838f 661 /* Clear the Tamper Flag */
mbed_official 235:685d5f11838f 662 __HAL_RTC_TAMPER_CLEAR_FLAG(hrtc,RTC_FLAG_TAMP1F);
mbed_official 235:685d5f11838f 663
mbed_official 235:685d5f11838f 664 /* Change RTC state */
mbed_official 235:685d5f11838f 665 hrtc->State = HAL_RTC_STATE_READY;
mbed_official 235:685d5f11838f 666
mbed_official 235:685d5f11838f 667 return HAL_OK;
mbed_official 235:685d5f11838f 668 }
mbed_official 235:685d5f11838f 669
mbed_official 235:685d5f11838f 670 /**
mbed_official 235:685d5f11838f 671 * @brief This function handles Tamper2 Polling.
mbed_official 235:685d5f11838f 672 * @param hrtc: pointer to a RTC_HandleTypeDef structure that contains
mbed_official 235:685d5f11838f 673 * the configuration information for RTC.
mbed_official 235:685d5f11838f 674 * @param Timeout: Timeout duration
mbed_official 235:685d5f11838f 675 * @retval HAL status
mbed_official 235:685d5f11838f 676 */
mbed_official 235:685d5f11838f 677 HAL_StatusTypeDef HAL_RTCEx_PollForTamper2Event(RTC_HandleTypeDef *hrtc, uint32_t Timeout)
mbed_official 235:685d5f11838f 678 {
mbed_official 235:685d5f11838f 679 uint32_t tickstart = 0;
mbed_official 235:685d5f11838f 680
mbed_official 235:685d5f11838f 681 /* Get tick */
mbed_official 235:685d5f11838f 682 tickstart = HAL_GetTick();
mbed_official 235:685d5f11838f 683
mbed_official 235:685d5f11838f 684 /* Get the status of the Interrupt */
mbed_official 235:685d5f11838f 685 while(__HAL_RTC_TAMPER_GET_FLAG(hrtc, RTC_FLAG_TAMP2F) == RESET)
mbed_official 235:685d5f11838f 686 {
mbed_official 235:685d5f11838f 687 if(Timeout != HAL_MAX_DELAY)
mbed_official 235:685d5f11838f 688 {
mbed_official 235:685d5f11838f 689 if((Timeout == 0)||((HAL_GetTick() - tickstart ) > Timeout))
mbed_official 235:685d5f11838f 690 {
mbed_official 235:685d5f11838f 691 hrtc->State = HAL_RTC_STATE_TIMEOUT;
mbed_official 235:685d5f11838f 692 return HAL_TIMEOUT;
mbed_official 235:685d5f11838f 693 }
mbed_official 235:685d5f11838f 694 }
mbed_official 235:685d5f11838f 695 }
mbed_official 235:685d5f11838f 696
mbed_official 235:685d5f11838f 697 /* Clear the Tamper Flag */
mbed_official 235:685d5f11838f 698 __HAL_RTC_TAMPER_CLEAR_FLAG(hrtc,RTC_FLAG_TAMP2F);
mbed_official 235:685d5f11838f 699
mbed_official 235:685d5f11838f 700 /* Change RTC state */
mbed_official 235:685d5f11838f 701 hrtc->State = HAL_RTC_STATE_READY;
mbed_official 235:685d5f11838f 702
mbed_official 235:685d5f11838f 703 return HAL_OK;
mbed_official 235:685d5f11838f 704 }
mbed_official 235:685d5f11838f 705
mbed_official 235:685d5f11838f 706 /**
mbed_official 235:685d5f11838f 707 * @}
mbed_official 235:685d5f11838f 708 */
mbed_official 235:685d5f11838f 709
mbed_official 532:fe11edbda85c 710 /** @defgroup RTCEx_Exported_Functions_Group2 RTC Wake-up functions
mbed_official 235:685d5f11838f 711 * @brief RTC Wake-up functions
mbed_official 235:685d5f11838f 712 *
mbed_official 235:685d5f11838f 713 @verbatim
mbed_official 235:685d5f11838f 714 ===============================================================================
mbed_official 235:685d5f11838f 715 ##### RTC Wake-up functions #####
mbed_official 235:685d5f11838f 716 ===============================================================================
mbed_official 235:685d5f11838f 717
mbed_official 235:685d5f11838f 718 [..] This section provides functions allowing to configure Wake-up feature
mbed_official 235:685d5f11838f 719
mbed_official 235:685d5f11838f 720 @endverbatim
mbed_official 235:685d5f11838f 721 * @{
mbed_official 235:685d5f11838f 722 */
mbed_official 235:685d5f11838f 723
mbed_official 235:685d5f11838f 724 /**
mbed_official 235:685d5f11838f 725 * @brief Sets wake up timer.
mbed_official 235:685d5f11838f 726 * @param hrtc: pointer to a RTC_HandleTypeDef structure that contains
mbed_official 235:685d5f11838f 727 * the configuration information for RTC.
mbed_official 235:685d5f11838f 728 * @param WakeUpCounter: Wake up counter
mbed_official 235:685d5f11838f 729 * @param WakeUpClock: Wake up clock
mbed_official 235:685d5f11838f 730 * @retval HAL status
mbed_official 235:685d5f11838f 731 */
mbed_official 235:685d5f11838f 732 HAL_StatusTypeDef HAL_RTCEx_SetWakeUpTimer(RTC_HandleTypeDef *hrtc, uint32_t WakeUpCounter, uint32_t WakeUpClock)
mbed_official 235:685d5f11838f 733 {
mbed_official 235:685d5f11838f 734 uint32_t tickstart = 0;
mbed_official 235:685d5f11838f 735
mbed_official 235:685d5f11838f 736 /* Check the parameters */
mbed_official 532:fe11edbda85c 737 assert_param(IS_RTC_WAKEUP_CLOCK(WakeUpClock));
mbed_official 532:fe11edbda85c 738 assert_param(IS_RTC_WAKEUP_COUNTER(WakeUpCounter));
mbed_official 235:685d5f11838f 739
mbed_official 235:685d5f11838f 740 /* Process Locked */
mbed_official 235:685d5f11838f 741 __HAL_LOCK(hrtc);
mbed_official 235:685d5f11838f 742
mbed_official 235:685d5f11838f 743 hrtc->State = HAL_RTC_STATE_BUSY;
mbed_official 235:685d5f11838f 744
mbed_official 235:685d5f11838f 745 /* Disable the write protection for RTC registers */
mbed_official 235:685d5f11838f 746 __HAL_RTC_WRITEPROTECTION_DISABLE(hrtc);
mbed_official 235:685d5f11838f 747
mbed_official 235:685d5f11838f 748 __HAL_RTC_WAKEUPTIMER_DISABLE(hrtc);
mbed_official 235:685d5f11838f 749
mbed_official 235:685d5f11838f 750 /* Get tick */
mbed_official 235:685d5f11838f 751 tickstart = HAL_GetTick();
mbed_official 235:685d5f11838f 752
mbed_official 235:685d5f11838f 753 /* Wait till RTC WUTWF flag is set and if Time out is reached exit */
mbed_official 235:685d5f11838f 754 while(__HAL_RTC_WAKEUPTIMER_GET_FLAG(hrtc, RTC_FLAG_WUTWF) == RESET)
mbed_official 235:685d5f11838f 755 {
mbed_official 235:685d5f11838f 756 if((HAL_GetTick() - tickstart ) > RTC_TIMEOUT_VALUE)
mbed_official 235:685d5f11838f 757 {
mbed_official 235:685d5f11838f 758 /* Enable the write protection for RTC registers */
mbed_official 235:685d5f11838f 759 __HAL_RTC_WRITEPROTECTION_ENABLE(hrtc);
mbed_official 235:685d5f11838f 760
mbed_official 235:685d5f11838f 761 hrtc->State = HAL_RTC_STATE_TIMEOUT;
mbed_official 235:685d5f11838f 762
mbed_official 235:685d5f11838f 763 /* Process Unlocked */
mbed_official 235:685d5f11838f 764 __HAL_UNLOCK(hrtc);
mbed_official 235:685d5f11838f 765
mbed_official 235:685d5f11838f 766 return HAL_TIMEOUT;
mbed_official 235:685d5f11838f 767 }
mbed_official 235:685d5f11838f 768 }
mbed_official 235:685d5f11838f 769
mbed_official 532:fe11edbda85c 770 /* Clear the Wake-up Timer clock source bits in CR register */
mbed_official 235:685d5f11838f 771 hrtc->Instance->CR &= (uint32_t)~RTC_CR_WUCKSEL;
mbed_official 235:685d5f11838f 772
mbed_official 235:685d5f11838f 773 /* Configure the clock source */
mbed_official 235:685d5f11838f 774 hrtc->Instance->CR |= (uint32_t)WakeUpClock;
mbed_official 235:685d5f11838f 775
mbed_official 532:fe11edbda85c 776 /* Configure the Wake-up Timer counter */
mbed_official 235:685d5f11838f 777 hrtc->Instance->WUTR = (uint32_t)WakeUpCounter;
mbed_official 235:685d5f11838f 778
mbed_official 532:fe11edbda85c 779 /* Enable the Wake-up Timer */
mbed_official 235:685d5f11838f 780 __HAL_RTC_WAKEUPTIMER_ENABLE(hrtc);
mbed_official 235:685d5f11838f 781
mbed_official 235:685d5f11838f 782 /* Enable the write protection for RTC registers */
mbed_official 235:685d5f11838f 783 __HAL_RTC_WRITEPROTECTION_ENABLE(hrtc);
mbed_official 235:685d5f11838f 784
mbed_official 235:685d5f11838f 785 hrtc->State = HAL_RTC_STATE_READY;
mbed_official 235:685d5f11838f 786
mbed_official 235:685d5f11838f 787 /* Process Unlocked */
mbed_official 235:685d5f11838f 788 __HAL_UNLOCK(hrtc);
mbed_official 235:685d5f11838f 789
mbed_official 235:685d5f11838f 790 return HAL_OK;
mbed_official 235:685d5f11838f 791 }
mbed_official 235:685d5f11838f 792
mbed_official 235:685d5f11838f 793 /**
mbed_official 235:685d5f11838f 794 * @brief Sets wake up timer with interrupt
mbed_official 235:685d5f11838f 795 * @param hrtc: pointer to a RTC_HandleTypeDef structure that contains
mbed_official 235:685d5f11838f 796 * the configuration information for RTC.
mbed_official 235:685d5f11838f 797 * @param WakeUpCounter: Wake up counter
mbed_official 235:685d5f11838f 798 * @param WakeUpClock: Wake up clock
mbed_official 235:685d5f11838f 799 * @retval HAL status
mbed_official 235:685d5f11838f 800 */
mbed_official 235:685d5f11838f 801 HAL_StatusTypeDef HAL_RTCEx_SetWakeUpTimer_IT(RTC_HandleTypeDef *hrtc, uint32_t WakeUpCounter, uint32_t WakeUpClock)
mbed_official 235:685d5f11838f 802 {
mbed_official 235:685d5f11838f 803 uint32_t tickstart = 0;
mbed_official 235:685d5f11838f 804
mbed_official 235:685d5f11838f 805 /* Check the parameters */
mbed_official 532:fe11edbda85c 806 assert_param(IS_RTC_WAKEUP_CLOCK(WakeUpClock));
mbed_official 532:fe11edbda85c 807 assert_param(IS_RTC_WAKEUP_COUNTER(WakeUpCounter));
mbed_official 235:685d5f11838f 808
mbed_official 235:685d5f11838f 809 /* Process Locked */
mbed_official 235:685d5f11838f 810 __HAL_LOCK(hrtc);
mbed_official 235:685d5f11838f 811
mbed_official 235:685d5f11838f 812 hrtc->State = HAL_RTC_STATE_BUSY;
mbed_official 235:685d5f11838f 813
mbed_official 235:685d5f11838f 814 /* Disable the write protection for RTC registers */
mbed_official 235:685d5f11838f 815 __HAL_RTC_WRITEPROTECTION_DISABLE(hrtc);
mbed_official 235:685d5f11838f 816
mbed_official 235:685d5f11838f 817 __HAL_RTC_WAKEUPTIMER_DISABLE(hrtc);
mbed_official 235:685d5f11838f 818
mbed_official 235:685d5f11838f 819 /* Get tick */
mbed_official 235:685d5f11838f 820 tickstart = HAL_GetTick();
mbed_official 235:685d5f11838f 821
mbed_official 235:685d5f11838f 822 /* Wait till RTC WUTWF flag is set and if Time out is reached exit */
mbed_official 235:685d5f11838f 823 while(__HAL_RTC_WAKEUPTIMER_GET_FLAG(hrtc, RTC_FLAG_WUTWF) == RESET)
mbed_official 235:685d5f11838f 824 {
mbed_official 235:685d5f11838f 825 if((HAL_GetTick() - tickstart ) > RTC_TIMEOUT_VALUE)
mbed_official 235:685d5f11838f 826 {
mbed_official 235:685d5f11838f 827 /* Enable the write protection for RTC registers */
mbed_official 235:685d5f11838f 828 __HAL_RTC_WRITEPROTECTION_ENABLE(hrtc);
mbed_official 235:685d5f11838f 829
mbed_official 235:685d5f11838f 830 hrtc->State = HAL_RTC_STATE_TIMEOUT;
mbed_official 235:685d5f11838f 831
mbed_official 235:685d5f11838f 832 /* Process Unlocked */
mbed_official 235:685d5f11838f 833 __HAL_UNLOCK(hrtc);
mbed_official 235:685d5f11838f 834
mbed_official 235:685d5f11838f 835 return HAL_TIMEOUT;
mbed_official 235:685d5f11838f 836 }
mbed_official 235:685d5f11838f 837 }
mbed_official 235:685d5f11838f 838
mbed_official 532:fe11edbda85c 839 /* Configure the Wake-up Timer counter */
mbed_official 235:685d5f11838f 840 hrtc->Instance->WUTR = (uint32_t)WakeUpCounter;
mbed_official 235:685d5f11838f 841
mbed_official 532:fe11edbda85c 842 /* Clear the Wake-up Timer clock source bits in CR register */
mbed_official 235:685d5f11838f 843 hrtc->Instance->CR &= (uint32_t)~RTC_CR_WUCKSEL;
mbed_official 235:685d5f11838f 844
mbed_official 235:685d5f11838f 845 /* Configure the clock source */
mbed_official 235:685d5f11838f 846 hrtc->Instance->CR |= (uint32_t)WakeUpClock;
mbed_official 235:685d5f11838f 847
mbed_official 235:685d5f11838f 848 /* RTC WakeUpTimer Interrupt Configuration: EXTI configuration */
mbed_official 532:fe11edbda85c 849 __HAL_RTC_WAKEUPTIMER_EXTI_ENABLE_IT();
mbed_official 235:685d5f11838f 850
mbed_official 235:685d5f11838f 851 EXTI->RTSR |= RTC_EXTI_LINE_WAKEUPTIMER_EVENT;
mbed_official 235:685d5f11838f 852
mbed_official 235:685d5f11838f 853 /* Configure the Interrupt in the RTC_CR register */
mbed_official 235:685d5f11838f 854 __HAL_RTC_WAKEUPTIMER_ENABLE_IT(hrtc,RTC_IT_WUT);
mbed_official 235:685d5f11838f 855
mbed_official 532:fe11edbda85c 856 /* Enable the Wake-up Timer */
mbed_official 235:685d5f11838f 857 __HAL_RTC_WAKEUPTIMER_ENABLE(hrtc);
mbed_official 235:685d5f11838f 858
mbed_official 235:685d5f11838f 859 /* Enable the write protection for RTC registers */
mbed_official 235:685d5f11838f 860 __HAL_RTC_WRITEPROTECTION_ENABLE(hrtc);
mbed_official 235:685d5f11838f 861
mbed_official 235:685d5f11838f 862 hrtc->State = HAL_RTC_STATE_READY;
mbed_official 235:685d5f11838f 863
mbed_official 235:685d5f11838f 864 /* Process Unlocked */
mbed_official 235:685d5f11838f 865 __HAL_UNLOCK(hrtc);
mbed_official 235:685d5f11838f 866
mbed_official 235:685d5f11838f 867 return HAL_OK;
mbed_official 235:685d5f11838f 868 }
mbed_official 235:685d5f11838f 869
mbed_official 235:685d5f11838f 870 /**
mbed_official 235:685d5f11838f 871 * @brief Deactivates wake up timer counter.
mbed_official 235:685d5f11838f 872 * @param hrtc: pointer to a RTC_HandleTypeDef structure that contains
mbed_official 235:685d5f11838f 873 * the configuration information for RTC.
mbed_official 235:685d5f11838f 874 * @retval HAL status
mbed_official 235:685d5f11838f 875 */
mbed_official 235:685d5f11838f 876 uint32_t HAL_RTCEx_DeactivateWakeUpTimer(RTC_HandleTypeDef *hrtc)
mbed_official 235:685d5f11838f 877 {
mbed_official 235:685d5f11838f 878 uint32_t tickstart = 0;
mbed_official 235:685d5f11838f 879
mbed_official 235:685d5f11838f 880 /* Process Locked */
mbed_official 235:685d5f11838f 881 __HAL_LOCK(hrtc);
mbed_official 235:685d5f11838f 882
mbed_official 235:685d5f11838f 883 hrtc->State = HAL_RTC_STATE_BUSY;
mbed_official 235:685d5f11838f 884
mbed_official 235:685d5f11838f 885 /* Disable the write protection for RTC registers */
mbed_official 235:685d5f11838f 886 __HAL_RTC_WRITEPROTECTION_DISABLE(hrtc);
mbed_official 235:685d5f11838f 887
mbed_official 532:fe11edbda85c 888 /* Disable the Wake-up Timer */
mbed_official 235:685d5f11838f 889 __HAL_RTC_WAKEUPTIMER_DISABLE(hrtc);
mbed_official 235:685d5f11838f 890
mbed_official 235:685d5f11838f 891 /* In case of interrupt mode is used, the interrupt source must disabled */
mbed_official 235:685d5f11838f 892 __HAL_RTC_WAKEUPTIMER_DISABLE_IT(hrtc,RTC_IT_WUT);
mbed_official 235:685d5f11838f 893
mbed_official 235:685d5f11838f 894 /* Get tick */
mbed_official 235:685d5f11838f 895 tickstart = HAL_GetTick();
mbed_official 235:685d5f11838f 896
mbed_official 235:685d5f11838f 897 /* Wait till RTC WUTWF flag is set and if Time out is reached exit */
mbed_official 235:685d5f11838f 898 while(__HAL_RTC_WAKEUPTIMER_GET_FLAG(hrtc, RTC_FLAG_WUTWF) == RESET)
mbed_official 235:685d5f11838f 899 {
mbed_official 235:685d5f11838f 900 if((HAL_GetTick() - tickstart ) > RTC_TIMEOUT_VALUE)
mbed_official 235:685d5f11838f 901 {
mbed_official 235:685d5f11838f 902 /* Enable the write protection for RTC registers */
mbed_official 235:685d5f11838f 903 __HAL_RTC_WRITEPROTECTION_ENABLE(hrtc);
mbed_official 235:685d5f11838f 904
mbed_official 235:685d5f11838f 905 hrtc->State = HAL_RTC_STATE_TIMEOUT;
mbed_official 235:685d5f11838f 906
mbed_official 235:685d5f11838f 907 /* Process Unlocked */
mbed_official 235:685d5f11838f 908 __HAL_UNLOCK(hrtc);
mbed_official 235:685d5f11838f 909
mbed_official 235:685d5f11838f 910 return HAL_TIMEOUT;
mbed_official 235:685d5f11838f 911 }
mbed_official 235:685d5f11838f 912 }
mbed_official 235:685d5f11838f 913
mbed_official 235:685d5f11838f 914 /* Enable the write protection for RTC registers */
mbed_official 235:685d5f11838f 915 __HAL_RTC_WRITEPROTECTION_ENABLE(hrtc);
mbed_official 235:685d5f11838f 916
mbed_official 235:685d5f11838f 917 hrtc->State = HAL_RTC_STATE_READY;
mbed_official 235:685d5f11838f 918
mbed_official 235:685d5f11838f 919 /* Process Unlocked */
mbed_official 235:685d5f11838f 920 __HAL_UNLOCK(hrtc);
mbed_official 235:685d5f11838f 921
mbed_official 235:685d5f11838f 922 return HAL_OK;
mbed_official 235:685d5f11838f 923 }
mbed_official 235:685d5f11838f 924
mbed_official 235:685d5f11838f 925 /**
mbed_official 235:685d5f11838f 926 * @brief Gets wake up timer counter.
mbed_official 235:685d5f11838f 927 * @param hrtc: pointer to a RTC_HandleTypeDef structure that contains
mbed_official 235:685d5f11838f 928 * the configuration information for RTC.
mbed_official 235:685d5f11838f 929 * @retval Counter value
mbed_official 235:685d5f11838f 930 */
mbed_official 235:685d5f11838f 931 uint32_t HAL_RTCEx_GetWakeUpTimer(RTC_HandleTypeDef *hrtc)
mbed_official 235:685d5f11838f 932 {
mbed_official 235:685d5f11838f 933 /* Get the counter value */
mbed_official 235:685d5f11838f 934 return ((uint32_t)(hrtc->Instance->WUTR & RTC_WUTR_WUT));
mbed_official 235:685d5f11838f 935 }
mbed_official 235:685d5f11838f 936
mbed_official 235:685d5f11838f 937 /**
mbed_official 235:685d5f11838f 938 * @brief This function handles Wake Up Timer interrupt request.
mbed_official 235:685d5f11838f 939 * @param hrtc: pointer to a RTC_HandleTypeDef structure that contains
mbed_official 235:685d5f11838f 940 * the configuration information for RTC.
mbed_official 235:685d5f11838f 941 * @retval None
mbed_official 235:685d5f11838f 942 */
mbed_official 235:685d5f11838f 943 void HAL_RTCEx_WakeUpTimerIRQHandler(RTC_HandleTypeDef *hrtc)
mbed_official 235:685d5f11838f 944 {
mbed_official 235:685d5f11838f 945 if(__HAL_RTC_WAKEUPTIMER_GET_IT(hrtc, RTC_IT_WUT))
mbed_official 235:685d5f11838f 946 {
mbed_official 235:685d5f11838f 947 /* Get the status of the Interrupt */
mbed_official 235:685d5f11838f 948 if((uint32_t)(hrtc->Instance->CR & RTC_IT_WUT) != (uint32_t)RESET)
mbed_official 235:685d5f11838f 949 {
mbed_official 235:685d5f11838f 950 /* WAKEUPTIMER callback */
mbed_official 235:685d5f11838f 951 HAL_RTCEx_WakeUpTimerEventCallback(hrtc);
mbed_official 235:685d5f11838f 952
mbed_official 235:685d5f11838f 953 /* Clear the WAKEUPTIMER interrupt pending bit */
mbed_official 235:685d5f11838f 954 __HAL_RTC_WAKEUPTIMER_CLEAR_FLAG(hrtc, RTC_FLAG_WUTF);
mbed_official 235:685d5f11838f 955 }
mbed_official 235:685d5f11838f 956 }
mbed_official 235:685d5f11838f 957
mbed_official 235:685d5f11838f 958 /* Clear the EXTI's line Flag for RTC WakeUpTimer */
mbed_official 532:fe11edbda85c 959 __HAL_RTC_WAKEUPTIMER_EXTI_CLEAR_FLAG();
mbed_official 532:fe11edbda85c 960
mbed_official 235:685d5f11838f 961 /* Change RTC state */
mbed_official 235:685d5f11838f 962 hrtc->State = HAL_RTC_STATE_READY;
mbed_official 235:685d5f11838f 963 }
mbed_official 235:685d5f11838f 964
mbed_official 235:685d5f11838f 965 /**
mbed_official 235:685d5f11838f 966 * @brief Wake Up Timer callback.
mbed_official 235:685d5f11838f 967 * @param hrtc: pointer to a RTC_HandleTypeDef structure that contains
mbed_official 235:685d5f11838f 968 * the configuration information for RTC.
mbed_official 235:685d5f11838f 969 * @retval None
mbed_official 235:685d5f11838f 970 */
mbed_official 235:685d5f11838f 971 __weak void HAL_RTCEx_WakeUpTimerEventCallback(RTC_HandleTypeDef *hrtc)
mbed_official 235:685d5f11838f 972 {
mbed_official 235:685d5f11838f 973 /* NOTE : This function Should not be modified, when the callback is needed,
mbed_official 235:685d5f11838f 974 the HAL_RTC_WakeUpTimerEventCallback could be implemented in the user file
mbed_official 235:685d5f11838f 975 */
mbed_official 235:685d5f11838f 976 }
mbed_official 235:685d5f11838f 977
mbed_official 235:685d5f11838f 978 /**
mbed_official 235:685d5f11838f 979 * @brief This function handles Wake Up Timer Polling.
mbed_official 235:685d5f11838f 980 * @param hrtc: pointer to a RTC_HandleTypeDef structure that contains
mbed_official 235:685d5f11838f 981 * the configuration information for RTC.
mbed_official 235:685d5f11838f 982 * @param Timeout: Timeout duration
mbed_official 235:685d5f11838f 983 * @retval HAL status
mbed_official 235:685d5f11838f 984 */
mbed_official 235:685d5f11838f 985 HAL_StatusTypeDef HAL_RTCEx_PollForWakeUpTimerEvent(RTC_HandleTypeDef *hrtc, uint32_t Timeout)
mbed_official 235:685d5f11838f 986 {
mbed_official 235:685d5f11838f 987 uint32_t tickstart = 0;
mbed_official 235:685d5f11838f 988
mbed_official 235:685d5f11838f 989 /* Get tick */
mbed_official 235:685d5f11838f 990 tickstart = HAL_GetTick();
mbed_official 235:685d5f11838f 991
mbed_official 235:685d5f11838f 992 while(__HAL_RTC_WAKEUPTIMER_GET_FLAG(hrtc, RTC_FLAG_WUTF) == RESET)
mbed_official 235:685d5f11838f 993 {
mbed_official 235:685d5f11838f 994 if(Timeout != HAL_MAX_DELAY)
mbed_official 235:685d5f11838f 995 {
mbed_official 235:685d5f11838f 996 if((Timeout == 0)||((HAL_GetTick() - tickstart ) > Timeout))
mbed_official 235:685d5f11838f 997 {
mbed_official 235:685d5f11838f 998 hrtc->State = HAL_RTC_STATE_TIMEOUT;
mbed_official 235:685d5f11838f 999
mbed_official 235:685d5f11838f 1000 return HAL_TIMEOUT;
mbed_official 235:685d5f11838f 1001 }
mbed_official 235:685d5f11838f 1002 }
mbed_official 235:685d5f11838f 1003 }
mbed_official 235:685d5f11838f 1004
mbed_official 235:685d5f11838f 1005 /* Clear the WAKEUPTIMER Flag */
mbed_official 235:685d5f11838f 1006 __HAL_RTC_WAKEUPTIMER_CLEAR_FLAG(hrtc, RTC_FLAG_WUTF);
mbed_official 235:685d5f11838f 1007
mbed_official 235:685d5f11838f 1008 /* Change RTC state */
mbed_official 235:685d5f11838f 1009 hrtc->State = HAL_RTC_STATE_READY;
mbed_official 235:685d5f11838f 1010
mbed_official 235:685d5f11838f 1011 return HAL_OK;
mbed_official 235:685d5f11838f 1012 }
mbed_official 235:685d5f11838f 1013
mbed_official 235:685d5f11838f 1014 /**
mbed_official 235:685d5f11838f 1015 * @}
mbed_official 235:685d5f11838f 1016 */
mbed_official 235:685d5f11838f 1017
mbed_official 235:685d5f11838f 1018
mbed_official 532:fe11edbda85c 1019 /** @defgroup RTCEx_Exported_Functions_Group3 Extension Peripheral Control functions
mbed_official 235:685d5f11838f 1020 * @brief Extension Peripheral Control functions
mbed_official 235:685d5f11838f 1021 *
mbed_official 235:685d5f11838f 1022 @verbatim
mbed_official 235:685d5f11838f 1023 ===============================================================================
mbed_official 235:685d5f11838f 1024 ##### Extension Peripheral Control functions #####
mbed_official 235:685d5f11838f 1025 ===============================================================================
mbed_official 235:685d5f11838f 1026 [..]
mbed_official 235:685d5f11838f 1027 This subsection provides functions allowing to
mbed_official 235:685d5f11838f 1028 (+) Write a data in a specified RTC Backup data register
mbed_official 235:685d5f11838f 1029 (+) Read a data in a specified RTC Backup data register
mbed_official 235:685d5f11838f 1030 (+) Set the Coarse calibration parameters.
mbed_official 235:685d5f11838f 1031 (+) Deactivate the Coarse calibration parameters
mbed_official 235:685d5f11838f 1032 (+) Set the Smooth calibration parameters.
mbed_official 235:685d5f11838f 1033 (+) Configure the Synchronization Shift Control Settings.
mbed_official 235:685d5f11838f 1034 (+) Configure the Calibration Pinout (RTC_CALIB) Selection (1Hz or 512Hz).
mbed_official 235:685d5f11838f 1035 (+) Deactivate the Calibration Pinout (RTC_CALIB) Selection (1Hz or 512Hz).
mbed_official 235:685d5f11838f 1036 (+) Enable the RTC reference clock detection.
mbed_official 235:685d5f11838f 1037 (+) Disable the RTC reference clock detection.
mbed_official 235:685d5f11838f 1038 (+) Enable the Bypass Shadow feature.
mbed_official 235:685d5f11838f 1039 (+) Disable the Bypass Shadow feature.
mbed_official 235:685d5f11838f 1040
mbed_official 235:685d5f11838f 1041 @endverbatim
mbed_official 235:685d5f11838f 1042 * @{
mbed_official 235:685d5f11838f 1043 */
mbed_official 235:685d5f11838f 1044
mbed_official 235:685d5f11838f 1045 /**
mbed_official 235:685d5f11838f 1046 * @brief Writes a data in a specified RTC Backup data register.
mbed_official 235:685d5f11838f 1047 * @param hrtc: pointer to a RTC_HandleTypeDef structure that contains
mbed_official 235:685d5f11838f 1048 * the configuration information for RTC.
mbed_official 235:685d5f11838f 1049 * @param BackupRegister: RTC Backup data Register number.
mbed_official 235:685d5f11838f 1050 * This parameter can be: RTC_BKP_DRx where x can be from 0 to 19 to
mbed_official 235:685d5f11838f 1051 * specify the register.
mbed_official 235:685d5f11838f 1052 * @param Data: Data to be written in the specified RTC Backup data register.
mbed_official 235:685d5f11838f 1053 * @retval None
mbed_official 235:685d5f11838f 1054 */
mbed_official 235:685d5f11838f 1055 void HAL_RTCEx_BKUPWrite(RTC_HandleTypeDef *hrtc, uint32_t BackupRegister, uint32_t Data)
mbed_official 235:685d5f11838f 1056 {
mbed_official 235:685d5f11838f 1057 uint32_t tmp = 0;
mbed_official 235:685d5f11838f 1058
mbed_official 235:685d5f11838f 1059 /* Check the parameters */
mbed_official 235:685d5f11838f 1060 assert_param(IS_RTC_BKP(BackupRegister));
mbed_official 235:685d5f11838f 1061
mbed_official 235:685d5f11838f 1062 tmp = (uint32_t)&(hrtc->Instance->BKP0R);
mbed_official 235:685d5f11838f 1063 tmp += (BackupRegister * 4);
mbed_official 235:685d5f11838f 1064
mbed_official 235:685d5f11838f 1065 /* Write the specified register */
mbed_official 235:685d5f11838f 1066 *(__IO uint32_t *)tmp = (uint32_t)Data;
mbed_official 235:685d5f11838f 1067 }
mbed_official 235:685d5f11838f 1068
mbed_official 235:685d5f11838f 1069 /**
mbed_official 235:685d5f11838f 1070 * @brief Reads data from the specified RTC Backup data Register.
mbed_official 235:685d5f11838f 1071 * @param hrtc: pointer to a RTC_HandleTypeDef structure that contains
mbed_official 235:685d5f11838f 1072 * the configuration information for RTC.
mbed_official 235:685d5f11838f 1073 * @param BackupRegister: RTC Backup data Register number.
mbed_official 235:685d5f11838f 1074 * This parameter can be: RTC_BKP_DRx where x can be from 0 to 19 to
mbed_official 235:685d5f11838f 1075 * specify the register.
mbed_official 235:685d5f11838f 1076 * @retval Read value
mbed_official 235:685d5f11838f 1077 */
mbed_official 235:685d5f11838f 1078 uint32_t HAL_RTCEx_BKUPRead(RTC_HandleTypeDef *hrtc, uint32_t BackupRegister)
mbed_official 235:685d5f11838f 1079 {
mbed_official 235:685d5f11838f 1080 uint32_t tmp = 0;
mbed_official 235:685d5f11838f 1081
mbed_official 235:685d5f11838f 1082 /* Check the parameters */
mbed_official 235:685d5f11838f 1083 assert_param(IS_RTC_BKP(BackupRegister));
mbed_official 235:685d5f11838f 1084
mbed_official 235:685d5f11838f 1085 tmp = (uint32_t)&(hrtc->Instance->BKP0R);
mbed_official 235:685d5f11838f 1086 tmp += (BackupRegister * 4);
mbed_official 235:685d5f11838f 1087
mbed_official 235:685d5f11838f 1088 /* Read the specified register */
mbed_official 235:685d5f11838f 1089 return (*(__IO uint32_t *)tmp);
mbed_official 235:685d5f11838f 1090 }
mbed_official 235:685d5f11838f 1091
mbed_official 235:685d5f11838f 1092 /**
mbed_official 235:685d5f11838f 1093 * @brief Sets the Coarse calibration parameters.
mbed_official 235:685d5f11838f 1094 * @param hrtc: pointer to a RTC_HandleTypeDef structure that contains
mbed_official 235:685d5f11838f 1095 * the configuration information for RTC.
mbed_official 235:685d5f11838f 1096 * @param CalibSign: Specifies the sign of the coarse calibration value.
mbed_official 235:685d5f11838f 1097 * This parameter can be one of the following values :
mbed_official 235:685d5f11838f 1098 * @arg RTC_CALIBSIGN_POSITIVE: The value sign is positive
mbed_official 235:685d5f11838f 1099 * @arg RTC_CALIBSIGN_NEGATIVE: The value sign is negative
mbed_official 235:685d5f11838f 1100 * @param Value: value of coarse calibration expressed in ppm (coded on 5 bits).
mbed_official 235:685d5f11838f 1101 *
mbed_official 235:685d5f11838f 1102 * @note This Calibration value should be between 0 and 63 when using negative
mbed_official 235:685d5f11838f 1103 * sign with a 2-ppm step.
mbed_official 235:685d5f11838f 1104 *
mbed_official 235:685d5f11838f 1105 * @note This Calibration value should be between 0 and 126 when using positive
mbed_official 235:685d5f11838f 1106 * sign with a 4-ppm step.
mbed_official 235:685d5f11838f 1107 * @retval HAL status
mbed_official 235:685d5f11838f 1108 */
mbed_official 235:685d5f11838f 1109 HAL_StatusTypeDef HAL_RTCEx_SetCoarseCalib(RTC_HandleTypeDef* hrtc, uint32_t CalibSign, uint32_t Value)
mbed_official 235:685d5f11838f 1110 {
mbed_official 235:685d5f11838f 1111 /* Check the parameters */
mbed_official 235:685d5f11838f 1112 assert_param(IS_RTC_CALIB_SIGN(CalibSign));
mbed_official 235:685d5f11838f 1113 assert_param(IS_RTC_CALIB_VALUE(Value));
mbed_official 235:685d5f11838f 1114
mbed_official 235:685d5f11838f 1115 /* Process Locked */
mbed_official 235:685d5f11838f 1116 __HAL_LOCK(hrtc);
mbed_official 235:685d5f11838f 1117
mbed_official 235:685d5f11838f 1118 hrtc->State = HAL_RTC_STATE_BUSY;
mbed_official 235:685d5f11838f 1119
mbed_official 235:685d5f11838f 1120 /* Disable the write protection for RTC registers */
mbed_official 235:685d5f11838f 1121 __HAL_RTC_WRITEPROTECTION_DISABLE(hrtc);
mbed_official 235:685d5f11838f 1122
mbed_official 235:685d5f11838f 1123 /* Set Initialization mode */
mbed_official 235:685d5f11838f 1124 if(RTC_EnterInitMode(hrtc) != HAL_OK)
mbed_official 235:685d5f11838f 1125 {
mbed_official 235:685d5f11838f 1126 /* Enable the write protection for RTC registers */
mbed_official 235:685d5f11838f 1127 __HAL_RTC_WRITEPROTECTION_ENABLE(hrtc);
mbed_official 235:685d5f11838f 1128
mbed_official 235:685d5f11838f 1129 /* Set RTC state*/
mbed_official 235:685d5f11838f 1130 hrtc->State = HAL_RTC_STATE_ERROR;
mbed_official 235:685d5f11838f 1131
mbed_official 235:685d5f11838f 1132 /* Process Unlocked */
mbed_official 235:685d5f11838f 1133 __HAL_UNLOCK(hrtc);
mbed_official 235:685d5f11838f 1134
mbed_official 235:685d5f11838f 1135 return HAL_ERROR;
mbed_official 235:685d5f11838f 1136 }
mbed_official 235:685d5f11838f 1137 else
mbed_official 235:685d5f11838f 1138 {
mbed_official 235:685d5f11838f 1139 /* Enable the Coarse Calibration */
mbed_official 235:685d5f11838f 1140 __HAL_RTC_COARSE_CALIB_ENABLE(hrtc);
mbed_official 235:685d5f11838f 1141
mbed_official 235:685d5f11838f 1142 /* Set the coarse calibration value */
mbed_official 235:685d5f11838f 1143 hrtc->Instance->CALIBR = (uint32_t)(CalibSign|Value);
mbed_official 235:685d5f11838f 1144
mbed_official 235:685d5f11838f 1145 /* Exit Initialization mode */
mbed_official 235:685d5f11838f 1146 hrtc->Instance->ISR &= (uint32_t)~RTC_ISR_INIT;
mbed_official 235:685d5f11838f 1147 }
mbed_official 235:685d5f11838f 1148
mbed_official 235:685d5f11838f 1149 /* Enable the write protection for RTC registers */
mbed_official 235:685d5f11838f 1150 __HAL_RTC_WRITEPROTECTION_ENABLE(hrtc);
mbed_official 235:685d5f11838f 1151
mbed_official 235:685d5f11838f 1152 /* Change state */
mbed_official 235:685d5f11838f 1153 hrtc->State = HAL_RTC_STATE_READY;
mbed_official 235:685d5f11838f 1154
mbed_official 235:685d5f11838f 1155 /* Process Unlocked */
mbed_official 235:685d5f11838f 1156 __HAL_UNLOCK(hrtc);
mbed_official 235:685d5f11838f 1157
mbed_official 235:685d5f11838f 1158 return HAL_OK;
mbed_official 235:685d5f11838f 1159 }
mbed_official 235:685d5f11838f 1160
mbed_official 235:685d5f11838f 1161 /**
mbed_official 235:685d5f11838f 1162 * @brief Deactivates the Coarse calibration parameters.
mbed_official 235:685d5f11838f 1163 * @param hrtc: pointer to a RTC_HandleTypeDef structure that contains
mbed_official 235:685d5f11838f 1164 * the configuration information for RTC.
mbed_official 235:685d5f11838f 1165 * @retval HAL status
mbed_official 235:685d5f11838f 1166 */
mbed_official 235:685d5f11838f 1167 HAL_StatusTypeDef HAL_RTCEx_DeactivateCoarseCalib(RTC_HandleTypeDef* hrtc)
mbed_official 235:685d5f11838f 1168 {
mbed_official 235:685d5f11838f 1169 /* Process Locked */
mbed_official 235:685d5f11838f 1170 __HAL_LOCK(hrtc);
mbed_official 235:685d5f11838f 1171
mbed_official 235:685d5f11838f 1172 hrtc->State = HAL_RTC_STATE_BUSY;
mbed_official 235:685d5f11838f 1173
mbed_official 235:685d5f11838f 1174 /* Disable the write protection for RTC registers */
mbed_official 235:685d5f11838f 1175 __HAL_RTC_WRITEPROTECTION_DISABLE(hrtc);
mbed_official 235:685d5f11838f 1176
mbed_official 235:685d5f11838f 1177 /* Set Initialization mode */
mbed_official 235:685d5f11838f 1178 if(RTC_EnterInitMode(hrtc) != HAL_OK)
mbed_official 235:685d5f11838f 1179 {
mbed_official 235:685d5f11838f 1180 /* Enable the write protection for RTC registers */
mbed_official 235:685d5f11838f 1181 __HAL_RTC_WRITEPROTECTION_ENABLE(hrtc);
mbed_official 235:685d5f11838f 1182
mbed_official 235:685d5f11838f 1183 /* Set RTC state*/
mbed_official 235:685d5f11838f 1184 hrtc->State = HAL_RTC_STATE_ERROR;
mbed_official 235:685d5f11838f 1185
mbed_official 235:685d5f11838f 1186 /* Process Unlocked */
mbed_official 235:685d5f11838f 1187 __HAL_UNLOCK(hrtc);
mbed_official 235:685d5f11838f 1188
mbed_official 235:685d5f11838f 1189 return HAL_ERROR;
mbed_official 235:685d5f11838f 1190 }
mbed_official 235:685d5f11838f 1191 else
mbed_official 235:685d5f11838f 1192 {
mbed_official 235:685d5f11838f 1193 /* Enable the Coarse Calibration */
mbed_official 235:685d5f11838f 1194 __HAL_RTC_COARSE_CALIB_DISABLE(hrtc);
mbed_official 235:685d5f11838f 1195
mbed_official 235:685d5f11838f 1196 /* Exit Initialization mode */
mbed_official 235:685d5f11838f 1197 hrtc->Instance->ISR &= (uint32_t)~RTC_ISR_INIT;
mbed_official 235:685d5f11838f 1198 }
mbed_official 235:685d5f11838f 1199
mbed_official 235:685d5f11838f 1200 /* Enable the write protection for RTC registers */
mbed_official 235:685d5f11838f 1201 __HAL_RTC_WRITEPROTECTION_ENABLE(hrtc);
mbed_official 235:685d5f11838f 1202
mbed_official 235:685d5f11838f 1203 /* Change state */
mbed_official 235:685d5f11838f 1204 hrtc->State = HAL_RTC_STATE_READY;
mbed_official 235:685d5f11838f 1205
mbed_official 235:685d5f11838f 1206 /* Process Unlocked */
mbed_official 235:685d5f11838f 1207 __HAL_UNLOCK(hrtc);
mbed_official 235:685d5f11838f 1208
mbed_official 235:685d5f11838f 1209 return HAL_OK;
mbed_official 235:685d5f11838f 1210 }
mbed_official 235:685d5f11838f 1211
mbed_official 235:685d5f11838f 1212 /**
mbed_official 235:685d5f11838f 1213 * @brief Sets the Smooth calibration parameters.
mbed_official 235:685d5f11838f 1214 * @param hrtc: pointer to a RTC_HandleTypeDef structure that contains
mbed_official 235:685d5f11838f 1215 * the configuration information for RTC.
mbed_official 235:685d5f11838f 1216 * @param SmoothCalibPeriod: Select the Smooth Calibration Period.
mbed_official 235:685d5f11838f 1217 * This parameter can be can be one of the following values :
mbed_official 532:fe11edbda85c 1218 * @arg RTC_SMOOTHCALIB_PERIOD_32SEC: The smooth calibration period is 32s.
mbed_official 532:fe11edbda85c 1219 * @arg RTC_SMOOTHCALIB_PERIOD_16SEC: The smooth calibration period is 16s.
mbed_official 532:fe11edbda85c 1220 * @arg RTC_SMOOTHCALIB_PERIOD_8SEC: The smooth calibration period is 8s.
mbed_official 235:685d5f11838f 1221 * @param SmoothCalibPlusPulses: Select to Set or reset the CALP bit.
mbed_official 235:685d5f11838f 1222 * This parameter can be one of the following values:
mbed_official 532:fe11edbda85c 1223 * @arg RTC_SMOOTHCALIB_PLUSPULSES_SET: Add one RTCCLK pulse every 2*11 pulses.
mbed_official 235:685d5f11838f 1224 * @arg RTC_SMOOTHCALIB_PLUSPULSES_RESET: No RTCCLK pulses are added.
mbed_official 235:685d5f11838f 1225 * @param SmouthCalibMinusPulsesValue: Select the value of CALM[8:0] bits.
mbed_official 235:685d5f11838f 1226 * This parameter can be one any value from 0 to 0x000001FF.
mbed_official 235:685d5f11838f 1227 * @note To deactivate the smooth calibration, the field SmoothCalibPlusPulses
mbed_official 235:685d5f11838f 1228 * must be equal to SMOOTHCALIB_PLUSPULSES_RESET and the field
mbed_official 235:685d5f11838f 1229 * SmouthCalibMinusPulsesValue must be equal to 0.
mbed_official 235:685d5f11838f 1230 * @retval HAL status
mbed_official 235:685d5f11838f 1231 */
mbed_official 235:685d5f11838f 1232 HAL_StatusTypeDef HAL_RTCEx_SetSmoothCalib(RTC_HandleTypeDef* hrtc, uint32_t SmoothCalibPeriod, uint32_t SmoothCalibPlusPulses, uint32_t SmouthCalibMinusPulsesValue)
mbed_official 235:685d5f11838f 1233 {
mbed_official 235:685d5f11838f 1234 uint32_t tickstart = 0;
mbed_official 235:685d5f11838f 1235
mbed_official 235:685d5f11838f 1236 /* Check the parameters */
mbed_official 235:685d5f11838f 1237 assert_param(IS_RTC_SMOOTH_CALIB_PERIOD(SmoothCalibPeriod));
mbed_official 235:685d5f11838f 1238 assert_param(IS_RTC_SMOOTH_CALIB_PLUS(SmoothCalibPlusPulses));
mbed_official 235:685d5f11838f 1239 assert_param(IS_RTC_SMOOTH_CALIB_MINUS(SmouthCalibMinusPulsesValue));
mbed_official 235:685d5f11838f 1240
mbed_official 235:685d5f11838f 1241 /* Process Locked */
mbed_official 235:685d5f11838f 1242 __HAL_LOCK(hrtc);
mbed_official 235:685d5f11838f 1243
mbed_official 235:685d5f11838f 1244 hrtc->State = HAL_RTC_STATE_BUSY;
mbed_official 235:685d5f11838f 1245
mbed_official 235:685d5f11838f 1246 /* Disable the write protection for RTC registers */
mbed_official 235:685d5f11838f 1247 __HAL_RTC_WRITEPROTECTION_DISABLE(hrtc);
mbed_official 235:685d5f11838f 1248
mbed_official 235:685d5f11838f 1249 /* check if a calibration is pending*/
mbed_official 235:685d5f11838f 1250 if((hrtc->Instance->ISR & RTC_ISR_RECALPF) != RESET)
mbed_official 235:685d5f11838f 1251 {
mbed_official 235:685d5f11838f 1252 /* Get tick */
mbed_official 235:685d5f11838f 1253 tickstart = HAL_GetTick();
mbed_official 235:685d5f11838f 1254
mbed_official 235:685d5f11838f 1255 /* check if a calibration is pending*/
mbed_official 235:685d5f11838f 1256 while((hrtc->Instance->ISR & RTC_ISR_RECALPF) != RESET)
mbed_official 235:685d5f11838f 1257 {
mbed_official 235:685d5f11838f 1258 if((HAL_GetTick() - tickstart ) > RTC_TIMEOUT_VALUE)
mbed_official 235:685d5f11838f 1259 {
mbed_official 235:685d5f11838f 1260 /* Enable the write protection for RTC registers */
mbed_official 235:685d5f11838f 1261 __HAL_RTC_WRITEPROTECTION_ENABLE(hrtc);
mbed_official 235:685d5f11838f 1262
mbed_official 235:685d5f11838f 1263 /* Change RTC state */
mbed_official 235:685d5f11838f 1264 hrtc->State = HAL_RTC_STATE_TIMEOUT;
mbed_official 235:685d5f11838f 1265
mbed_official 235:685d5f11838f 1266 /* Process Unlocked */
mbed_official 235:685d5f11838f 1267 __HAL_UNLOCK(hrtc);
mbed_official 235:685d5f11838f 1268
mbed_official 235:685d5f11838f 1269 return HAL_TIMEOUT;
mbed_official 235:685d5f11838f 1270 }
mbed_official 235:685d5f11838f 1271 }
mbed_official 235:685d5f11838f 1272 }
mbed_official 235:685d5f11838f 1273
mbed_official 235:685d5f11838f 1274 /* Configure the Smooth calibration settings */
mbed_official 235:685d5f11838f 1275 hrtc->Instance->CALR = (uint32_t)((uint32_t)SmoothCalibPeriod | (uint32_t)SmoothCalibPlusPulses | (uint32_t)SmouthCalibMinusPulsesValue);
mbed_official 235:685d5f11838f 1276
mbed_official 235:685d5f11838f 1277 /* Enable the write protection for RTC registers */
mbed_official 235:685d5f11838f 1278 __HAL_RTC_WRITEPROTECTION_ENABLE(hrtc);
mbed_official 235:685d5f11838f 1279
mbed_official 235:685d5f11838f 1280 /* Change RTC state */
mbed_official 235:685d5f11838f 1281 hrtc->State = HAL_RTC_STATE_READY;
mbed_official 235:685d5f11838f 1282
mbed_official 235:685d5f11838f 1283 /* Process Unlocked */
mbed_official 235:685d5f11838f 1284 __HAL_UNLOCK(hrtc);
mbed_official 235:685d5f11838f 1285
mbed_official 235:685d5f11838f 1286 return HAL_OK;
mbed_official 235:685d5f11838f 1287 }
mbed_official 235:685d5f11838f 1288
mbed_official 235:685d5f11838f 1289 /**
mbed_official 235:685d5f11838f 1290 * @brief Configures the Synchronization Shift Control Settings.
mbed_official 235:685d5f11838f 1291 * @note When REFCKON is set, firmware must not write to Shift control register.
mbed_official 235:685d5f11838f 1292 * @param hrtc: pointer to a RTC_HandleTypeDef structure that contains
mbed_official 235:685d5f11838f 1293 * the configuration information for RTC.
mbed_official 235:685d5f11838f 1294 * @param ShiftAdd1S: Select to add or not 1 second to the time calendar.
mbed_official 235:685d5f11838f 1295 * This parameter can be one of the following values :
mbed_official 235:685d5f11838f 1296 * @arg RTC_SHIFTADD1S_SET: Add one second to the clock calendar.
mbed_official 235:685d5f11838f 1297 * @arg RTC_SHIFTADD1S_RESET: No effect.
mbed_official 235:685d5f11838f 1298 * @param ShiftSubFS: Select the number of Second Fractions to substitute.
mbed_official 235:685d5f11838f 1299 * This parameter can be one any value from 0 to 0x7FFF.
mbed_official 235:685d5f11838f 1300 * @retval HAL status
mbed_official 235:685d5f11838f 1301 */
mbed_official 235:685d5f11838f 1302 HAL_StatusTypeDef HAL_RTCEx_SetSynchroShift(RTC_HandleTypeDef* hrtc, uint32_t ShiftAdd1S, uint32_t ShiftSubFS)
mbed_official 235:685d5f11838f 1303 {
mbed_official 235:685d5f11838f 1304 uint32_t tickstart = 0;
mbed_official 235:685d5f11838f 1305
mbed_official 235:685d5f11838f 1306 /* Check the parameters */
mbed_official 235:685d5f11838f 1307 assert_param(IS_RTC_SHIFT_ADD1S(ShiftAdd1S));
mbed_official 235:685d5f11838f 1308 assert_param(IS_RTC_SHIFT_SUBFS(ShiftSubFS));
mbed_official 235:685d5f11838f 1309
mbed_official 235:685d5f11838f 1310 /* Process Locked */
mbed_official 235:685d5f11838f 1311 __HAL_LOCK(hrtc);
mbed_official 235:685d5f11838f 1312
mbed_official 235:685d5f11838f 1313 hrtc->State = HAL_RTC_STATE_BUSY;
mbed_official 235:685d5f11838f 1314
mbed_official 235:685d5f11838f 1315 /* Disable the write protection for RTC registers */
mbed_official 235:685d5f11838f 1316 __HAL_RTC_WRITEPROTECTION_DISABLE(hrtc);
mbed_official 235:685d5f11838f 1317
mbed_official 235:685d5f11838f 1318 /* Get tick */
mbed_official 235:685d5f11838f 1319 tickstart = HAL_GetTick();
mbed_official 235:685d5f11838f 1320
mbed_official 235:685d5f11838f 1321 /* Wait until the shift is completed*/
mbed_official 235:685d5f11838f 1322 while((hrtc->Instance->ISR & RTC_ISR_SHPF) != RESET)
mbed_official 235:685d5f11838f 1323 {
mbed_official 235:685d5f11838f 1324 if((HAL_GetTick() - tickstart ) > RTC_TIMEOUT_VALUE)
mbed_official 235:685d5f11838f 1325 {
mbed_official 235:685d5f11838f 1326 /* Enable the write protection for RTC registers */
mbed_official 235:685d5f11838f 1327 __HAL_RTC_WRITEPROTECTION_ENABLE(hrtc);
mbed_official 235:685d5f11838f 1328
mbed_official 235:685d5f11838f 1329 hrtc->State = HAL_RTC_STATE_TIMEOUT;
mbed_official 235:685d5f11838f 1330
mbed_official 235:685d5f11838f 1331 /* Process Unlocked */
mbed_official 235:685d5f11838f 1332 __HAL_UNLOCK(hrtc);
mbed_official 235:685d5f11838f 1333
mbed_official 235:685d5f11838f 1334 return HAL_TIMEOUT;
mbed_official 235:685d5f11838f 1335 }
mbed_official 235:685d5f11838f 1336 }
mbed_official 235:685d5f11838f 1337
mbed_official 235:685d5f11838f 1338 /* Check if the reference clock detection is disabled */
mbed_official 235:685d5f11838f 1339 if((hrtc->Instance->CR & RTC_CR_REFCKON) == RESET)
mbed_official 235:685d5f11838f 1340 {
mbed_official 235:685d5f11838f 1341 /* Configure the Shift settings */
mbed_official 235:685d5f11838f 1342 hrtc->Instance->SHIFTR = (uint32_t)(uint32_t)(ShiftSubFS) | (uint32_t)(ShiftAdd1S);
mbed_official 235:685d5f11838f 1343
mbed_official 235:685d5f11838f 1344 /* If RTC_CR_BYPSHAD bit = 0, wait for synchro else this check is not needed */
mbed_official 235:685d5f11838f 1345 if((hrtc->Instance->CR & RTC_CR_BYPSHAD) == RESET)
mbed_official 235:685d5f11838f 1346 {
mbed_official 235:685d5f11838f 1347 if(HAL_RTC_WaitForSynchro(hrtc) != HAL_OK)
mbed_official 235:685d5f11838f 1348 {
mbed_official 235:685d5f11838f 1349 /* Enable the write protection for RTC registers */
mbed_official 235:685d5f11838f 1350 __HAL_RTC_WRITEPROTECTION_ENABLE(hrtc);
mbed_official 235:685d5f11838f 1351
mbed_official 235:685d5f11838f 1352 hrtc->State = HAL_RTC_STATE_ERROR;
mbed_official 235:685d5f11838f 1353
mbed_official 235:685d5f11838f 1354 /* Process Unlocked */
mbed_official 235:685d5f11838f 1355 __HAL_UNLOCK(hrtc);
mbed_official 235:685d5f11838f 1356
mbed_official 235:685d5f11838f 1357 return HAL_ERROR;
mbed_official 235:685d5f11838f 1358 }
mbed_official 235:685d5f11838f 1359 }
mbed_official 235:685d5f11838f 1360 }
mbed_official 235:685d5f11838f 1361 else
mbed_official 235:685d5f11838f 1362 {
mbed_official 235:685d5f11838f 1363 /* Enable the write protection for RTC registers */
mbed_official 235:685d5f11838f 1364 __HAL_RTC_WRITEPROTECTION_ENABLE(hrtc);
mbed_official 235:685d5f11838f 1365
mbed_official 235:685d5f11838f 1366 /* Change RTC state */
mbed_official 235:685d5f11838f 1367 hrtc->State = HAL_RTC_STATE_ERROR;
mbed_official 235:685d5f11838f 1368
mbed_official 235:685d5f11838f 1369 /* Process Unlocked */
mbed_official 235:685d5f11838f 1370 __HAL_UNLOCK(hrtc);
mbed_official 235:685d5f11838f 1371
mbed_official 235:685d5f11838f 1372 return HAL_ERROR;
mbed_official 235:685d5f11838f 1373 }
mbed_official 235:685d5f11838f 1374
mbed_official 235:685d5f11838f 1375 /* Enable the write protection for RTC registers */
mbed_official 235:685d5f11838f 1376 __HAL_RTC_WRITEPROTECTION_ENABLE(hrtc);
mbed_official 235:685d5f11838f 1377
mbed_official 235:685d5f11838f 1378 /* Change RTC state */
mbed_official 235:685d5f11838f 1379 hrtc->State = HAL_RTC_STATE_READY;
mbed_official 235:685d5f11838f 1380
mbed_official 235:685d5f11838f 1381 /* Process Unlocked */
mbed_official 235:685d5f11838f 1382 __HAL_UNLOCK(hrtc);
mbed_official 235:685d5f11838f 1383
mbed_official 235:685d5f11838f 1384 return HAL_OK;
mbed_official 235:685d5f11838f 1385 }
mbed_official 235:685d5f11838f 1386
mbed_official 235:685d5f11838f 1387 /**
mbed_official 235:685d5f11838f 1388 * @brief Configures the Calibration Pinout (RTC_CALIB) Selection (1Hz or 512Hz).
mbed_official 235:685d5f11838f 1389 * @param hrtc: pointer to a RTC_HandleTypeDef structure that contains
mbed_official 235:685d5f11838f 1390 * the configuration information for RTC.
mbed_official 235:685d5f11838f 1391 * @param CalibOutput: Select the Calibration output Selection .
mbed_official 235:685d5f11838f 1392 * This parameter can be one of the following values:
mbed_official 235:685d5f11838f 1393 * @arg RTC_CALIBOUTPUT_512HZ: A signal has a regular waveform at 512Hz.
mbed_official 235:685d5f11838f 1394 * @arg RTC_CALIBOUTPUT_1HZ: A signal has a regular waveform at 1Hz.
mbed_official 235:685d5f11838f 1395 * @retval HAL status
mbed_official 235:685d5f11838f 1396 */
mbed_official 235:685d5f11838f 1397 HAL_StatusTypeDef HAL_RTCEx_SetCalibrationOutPut(RTC_HandleTypeDef* hrtc, uint32_t CalibOutput)
mbed_official 235:685d5f11838f 1398 {
mbed_official 235:685d5f11838f 1399 /* Check the parameters */
mbed_official 235:685d5f11838f 1400 assert_param(IS_RTC_CALIB_OUTPUT(CalibOutput));
mbed_official 235:685d5f11838f 1401
mbed_official 235:685d5f11838f 1402 /* Process Locked */
mbed_official 235:685d5f11838f 1403 __HAL_LOCK(hrtc);
mbed_official 235:685d5f11838f 1404
mbed_official 235:685d5f11838f 1405 hrtc->State = HAL_RTC_STATE_BUSY;
mbed_official 235:685d5f11838f 1406
mbed_official 235:685d5f11838f 1407 /* Disable the write protection for RTC registers */
mbed_official 235:685d5f11838f 1408 __HAL_RTC_WRITEPROTECTION_DISABLE(hrtc);
mbed_official 235:685d5f11838f 1409
mbed_official 235:685d5f11838f 1410 /* Clear flags before config */
mbed_official 235:685d5f11838f 1411 hrtc->Instance->CR &= (uint32_t)~RTC_CR_COSEL;
mbed_official 235:685d5f11838f 1412
mbed_official 235:685d5f11838f 1413 /* Configure the RTC_CR register */
mbed_official 235:685d5f11838f 1414 hrtc->Instance->CR |= (uint32_t)CalibOutput;
mbed_official 235:685d5f11838f 1415
mbed_official 235:685d5f11838f 1416 __HAL_RTC_CALIBRATION_OUTPUT_ENABLE(hrtc);
mbed_official 235:685d5f11838f 1417
mbed_official 235:685d5f11838f 1418 /* Enable the write protection for RTC registers */
mbed_official 235:685d5f11838f 1419 __HAL_RTC_WRITEPROTECTION_ENABLE(hrtc);
mbed_official 235:685d5f11838f 1420
mbed_official 235:685d5f11838f 1421 /* Change RTC state */
mbed_official 235:685d5f11838f 1422 hrtc->State = HAL_RTC_STATE_READY;
mbed_official 235:685d5f11838f 1423
mbed_official 235:685d5f11838f 1424 /* Process Unlocked */
mbed_official 235:685d5f11838f 1425 __HAL_UNLOCK(hrtc);
mbed_official 235:685d5f11838f 1426
mbed_official 235:685d5f11838f 1427 return HAL_OK;
mbed_official 235:685d5f11838f 1428 }
mbed_official 235:685d5f11838f 1429
mbed_official 235:685d5f11838f 1430 /**
mbed_official 235:685d5f11838f 1431 * @brief Deactivates the Calibration Pinout (RTC_CALIB) Selection (1Hz or 512Hz).
mbed_official 235:685d5f11838f 1432 * @param hrtc: pointer to a RTC_HandleTypeDef structure that contains
mbed_official 235:685d5f11838f 1433 * the configuration information for RTC.
mbed_official 235:685d5f11838f 1434 * @retval HAL status
mbed_official 235:685d5f11838f 1435 */
mbed_official 235:685d5f11838f 1436 HAL_StatusTypeDef HAL_RTCEx_DeactivateCalibrationOutPut(RTC_HandleTypeDef* hrtc)
mbed_official 235:685d5f11838f 1437 {
mbed_official 235:685d5f11838f 1438 /* Process Locked */
mbed_official 235:685d5f11838f 1439 __HAL_LOCK(hrtc);
mbed_official 235:685d5f11838f 1440
mbed_official 235:685d5f11838f 1441 hrtc->State = HAL_RTC_STATE_BUSY;
mbed_official 235:685d5f11838f 1442
mbed_official 235:685d5f11838f 1443 /* Disable the write protection for RTC registers */
mbed_official 235:685d5f11838f 1444 __HAL_RTC_WRITEPROTECTION_DISABLE(hrtc);
mbed_official 235:685d5f11838f 1445
mbed_official 235:685d5f11838f 1446 __HAL_RTC_CALIBRATION_OUTPUT_DISABLE(hrtc);
mbed_official 235:685d5f11838f 1447
mbed_official 235:685d5f11838f 1448 /* Enable the write protection for RTC registers */
mbed_official 235:685d5f11838f 1449 __HAL_RTC_WRITEPROTECTION_ENABLE(hrtc);
mbed_official 235:685d5f11838f 1450
mbed_official 235:685d5f11838f 1451 /* Change RTC state */
mbed_official 235:685d5f11838f 1452 hrtc->State = HAL_RTC_STATE_READY;
mbed_official 235:685d5f11838f 1453
mbed_official 235:685d5f11838f 1454 /* Process Unlocked */
mbed_official 235:685d5f11838f 1455 __HAL_UNLOCK(hrtc);
mbed_official 235:685d5f11838f 1456
mbed_official 235:685d5f11838f 1457 return HAL_OK;
mbed_official 235:685d5f11838f 1458 }
mbed_official 235:685d5f11838f 1459
mbed_official 235:685d5f11838f 1460 /**
mbed_official 235:685d5f11838f 1461 * @brief Enables the RTC reference clock detection.
mbed_official 235:685d5f11838f 1462 * @param hrtc: pointer to a RTC_HandleTypeDef structure that contains
mbed_official 235:685d5f11838f 1463 * the configuration information for RTC.
mbed_official 235:685d5f11838f 1464 * @retval HAL status
mbed_official 235:685d5f11838f 1465 */
mbed_official 235:685d5f11838f 1466 HAL_StatusTypeDef HAL_RTCEx_SetRefClock(RTC_HandleTypeDef* hrtc)
mbed_official 235:685d5f11838f 1467 {
mbed_official 235:685d5f11838f 1468 /* Process Locked */
mbed_official 235:685d5f11838f 1469 __HAL_LOCK(hrtc);
mbed_official 235:685d5f11838f 1470
mbed_official 235:685d5f11838f 1471 hrtc->State = HAL_RTC_STATE_BUSY;
mbed_official 235:685d5f11838f 1472
mbed_official 235:685d5f11838f 1473 /* Disable the write protection for RTC registers */
mbed_official 235:685d5f11838f 1474 __HAL_RTC_WRITEPROTECTION_DISABLE(hrtc);
mbed_official 235:685d5f11838f 1475
mbed_official 235:685d5f11838f 1476 /* Set Initialization mode */
mbed_official 235:685d5f11838f 1477 if(RTC_EnterInitMode(hrtc) != HAL_OK)
mbed_official 235:685d5f11838f 1478 {
mbed_official 235:685d5f11838f 1479 /* Enable the write protection for RTC registers */
mbed_official 235:685d5f11838f 1480 __HAL_RTC_WRITEPROTECTION_ENABLE(hrtc);
mbed_official 235:685d5f11838f 1481
mbed_official 235:685d5f11838f 1482 /* Set RTC state*/
mbed_official 235:685d5f11838f 1483 hrtc->State = HAL_RTC_STATE_ERROR;
mbed_official 235:685d5f11838f 1484
mbed_official 235:685d5f11838f 1485 /* Process Unlocked */
mbed_official 235:685d5f11838f 1486 __HAL_UNLOCK(hrtc);
mbed_official 235:685d5f11838f 1487
mbed_official 235:685d5f11838f 1488 return HAL_ERROR;
mbed_official 235:685d5f11838f 1489 }
mbed_official 235:685d5f11838f 1490 else
mbed_official 235:685d5f11838f 1491 {
mbed_official 235:685d5f11838f 1492 __HAL_RTC_CLOCKREF_DETECTION_ENABLE(hrtc);
mbed_official 235:685d5f11838f 1493
mbed_official 235:685d5f11838f 1494 /* Exit Initialization mode */
mbed_official 235:685d5f11838f 1495 hrtc->Instance->ISR &= (uint32_t)~RTC_ISR_INIT;
mbed_official 235:685d5f11838f 1496 }
mbed_official 235:685d5f11838f 1497
mbed_official 235:685d5f11838f 1498 /* Enable the write protection for RTC registers */
mbed_official 235:685d5f11838f 1499 __HAL_RTC_WRITEPROTECTION_ENABLE(hrtc);
mbed_official 235:685d5f11838f 1500
mbed_official 235:685d5f11838f 1501 /* Change RTC state */
mbed_official 235:685d5f11838f 1502 hrtc->State = HAL_RTC_STATE_READY;
mbed_official 235:685d5f11838f 1503
mbed_official 235:685d5f11838f 1504 /* Process Unlocked */
mbed_official 235:685d5f11838f 1505 __HAL_UNLOCK(hrtc);
mbed_official 235:685d5f11838f 1506
mbed_official 235:685d5f11838f 1507 return HAL_OK;
mbed_official 235:685d5f11838f 1508 }
mbed_official 235:685d5f11838f 1509
mbed_official 235:685d5f11838f 1510 /**
mbed_official 235:685d5f11838f 1511 * @brief Disable the RTC reference clock detection.
mbed_official 235:685d5f11838f 1512 * @param hrtc: pointer to a RTC_HandleTypeDef structure that contains
mbed_official 235:685d5f11838f 1513 * the configuration information for RTC.
mbed_official 235:685d5f11838f 1514 * @retval HAL status
mbed_official 235:685d5f11838f 1515 */
mbed_official 235:685d5f11838f 1516 HAL_StatusTypeDef HAL_RTCEx_DeactivateRefClock(RTC_HandleTypeDef* hrtc)
mbed_official 235:685d5f11838f 1517 {
mbed_official 235:685d5f11838f 1518 /* Process Locked */
mbed_official 235:685d5f11838f 1519 __HAL_LOCK(hrtc);
mbed_official 235:685d5f11838f 1520
mbed_official 235:685d5f11838f 1521 hrtc->State = HAL_RTC_STATE_BUSY;
mbed_official 235:685d5f11838f 1522
mbed_official 235:685d5f11838f 1523 /* Disable the write protection for RTC registers */
mbed_official 235:685d5f11838f 1524 __HAL_RTC_WRITEPROTECTION_DISABLE(hrtc);
mbed_official 235:685d5f11838f 1525
mbed_official 235:685d5f11838f 1526 /* Set Initialization mode */
mbed_official 235:685d5f11838f 1527 if(RTC_EnterInitMode(hrtc) != HAL_OK)
mbed_official 235:685d5f11838f 1528 {
mbed_official 235:685d5f11838f 1529 /* Enable the write protection for RTC registers */
mbed_official 235:685d5f11838f 1530 __HAL_RTC_WRITEPROTECTION_ENABLE(hrtc);
mbed_official 235:685d5f11838f 1531
mbed_official 235:685d5f11838f 1532 /* Set RTC state*/
mbed_official 235:685d5f11838f 1533 hrtc->State = HAL_RTC_STATE_ERROR;
mbed_official 235:685d5f11838f 1534
mbed_official 235:685d5f11838f 1535 /* Process Unlocked */
mbed_official 235:685d5f11838f 1536 __HAL_UNLOCK(hrtc);
mbed_official 235:685d5f11838f 1537
mbed_official 235:685d5f11838f 1538 return HAL_ERROR;
mbed_official 235:685d5f11838f 1539 }
mbed_official 235:685d5f11838f 1540 else
mbed_official 235:685d5f11838f 1541 {
mbed_official 235:685d5f11838f 1542 __HAL_RTC_CLOCKREF_DETECTION_DISABLE(hrtc);
mbed_official 235:685d5f11838f 1543
mbed_official 235:685d5f11838f 1544 /* Exit Initialization mode */
mbed_official 235:685d5f11838f 1545 hrtc->Instance->ISR &= (uint32_t)~RTC_ISR_INIT;
mbed_official 235:685d5f11838f 1546 }
mbed_official 235:685d5f11838f 1547
mbed_official 235:685d5f11838f 1548 /* Enable the write protection for RTC registers */
mbed_official 235:685d5f11838f 1549 __HAL_RTC_WRITEPROTECTION_ENABLE(hrtc);
mbed_official 235:685d5f11838f 1550
mbed_official 235:685d5f11838f 1551 /* Change RTC state */
mbed_official 235:685d5f11838f 1552 hrtc->State = HAL_RTC_STATE_READY;
mbed_official 235:685d5f11838f 1553
mbed_official 235:685d5f11838f 1554 /* Process Unlocked */
mbed_official 235:685d5f11838f 1555 __HAL_UNLOCK(hrtc);
mbed_official 235:685d5f11838f 1556
mbed_official 235:685d5f11838f 1557 return HAL_OK;
mbed_official 235:685d5f11838f 1558 }
mbed_official 235:685d5f11838f 1559
mbed_official 235:685d5f11838f 1560 /**
mbed_official 235:685d5f11838f 1561 * @brief Enables the Bypass Shadow feature.
mbed_official 235:685d5f11838f 1562 * @param hrtc: pointer to a RTC_HandleTypeDef structure that contains
mbed_official 235:685d5f11838f 1563 * the configuration information for RTC.
mbed_official 235:685d5f11838f 1564 * @note When the Bypass Shadow is enabled the calendar value are taken
mbed_official 235:685d5f11838f 1565 * directly from the Calendar counter.
mbed_official 235:685d5f11838f 1566 * @retval HAL status
mbed_official 235:685d5f11838f 1567 */
mbed_official 235:685d5f11838f 1568 HAL_StatusTypeDef HAL_RTCEx_EnableBypassShadow(RTC_HandleTypeDef* hrtc)
mbed_official 235:685d5f11838f 1569 {
mbed_official 235:685d5f11838f 1570 /* Process Locked */
mbed_official 235:685d5f11838f 1571 __HAL_LOCK(hrtc);
mbed_official 235:685d5f11838f 1572
mbed_official 235:685d5f11838f 1573 hrtc->State = HAL_RTC_STATE_BUSY;
mbed_official 235:685d5f11838f 1574
mbed_official 235:685d5f11838f 1575 /* Disable the write protection for RTC registers */
mbed_official 235:685d5f11838f 1576 __HAL_RTC_WRITEPROTECTION_DISABLE(hrtc);
mbed_official 235:685d5f11838f 1577
mbed_official 235:685d5f11838f 1578 /* Set the BYPSHAD bit */
mbed_official 235:685d5f11838f 1579 hrtc->Instance->CR |= (uint8_t)RTC_CR_BYPSHAD;
mbed_official 235:685d5f11838f 1580
mbed_official 235:685d5f11838f 1581 /* Enable the write protection for RTC registers */
mbed_official 235:685d5f11838f 1582 __HAL_RTC_WRITEPROTECTION_ENABLE(hrtc);
mbed_official 235:685d5f11838f 1583
mbed_official 235:685d5f11838f 1584 /* Change RTC state */
mbed_official 235:685d5f11838f 1585 hrtc->State = HAL_RTC_STATE_READY;
mbed_official 235:685d5f11838f 1586
mbed_official 235:685d5f11838f 1587 /* Process Unlocked */
mbed_official 235:685d5f11838f 1588 __HAL_UNLOCK(hrtc);
mbed_official 235:685d5f11838f 1589
mbed_official 235:685d5f11838f 1590 return HAL_OK;
mbed_official 235:685d5f11838f 1591 }
mbed_official 235:685d5f11838f 1592
mbed_official 235:685d5f11838f 1593 /**
mbed_official 235:685d5f11838f 1594 * @brief Disables the Bypass Shadow feature.
mbed_official 235:685d5f11838f 1595 * @param hrtc: pointer to a RTC_HandleTypeDef structure that contains
mbed_official 235:685d5f11838f 1596 * the configuration information for RTC.
mbed_official 235:685d5f11838f 1597 * @note When the Bypass Shadow is enabled the calendar value are taken
mbed_official 235:685d5f11838f 1598 * directly from the Calendar counter.
mbed_official 235:685d5f11838f 1599 * @retval HAL status
mbed_official 235:685d5f11838f 1600 */
mbed_official 235:685d5f11838f 1601 HAL_StatusTypeDef HAL_RTCEx_DisableBypassShadow(RTC_HandleTypeDef* hrtc)
mbed_official 235:685d5f11838f 1602 {
mbed_official 235:685d5f11838f 1603 /* Process Locked */
mbed_official 235:685d5f11838f 1604 __HAL_LOCK(hrtc);
mbed_official 235:685d5f11838f 1605
mbed_official 235:685d5f11838f 1606 hrtc->State = HAL_RTC_STATE_BUSY;
mbed_official 235:685d5f11838f 1607
mbed_official 235:685d5f11838f 1608 /* Disable the write protection for RTC registers */
mbed_official 235:685d5f11838f 1609 __HAL_RTC_WRITEPROTECTION_DISABLE(hrtc);
mbed_official 235:685d5f11838f 1610
mbed_official 235:685d5f11838f 1611 /* Reset the BYPSHAD bit */
mbed_official 235:685d5f11838f 1612 hrtc->Instance->CR &= (uint8_t)~RTC_CR_BYPSHAD;
mbed_official 235:685d5f11838f 1613
mbed_official 235:685d5f11838f 1614 /* Enable the write protection for RTC registers */
mbed_official 235:685d5f11838f 1615 __HAL_RTC_WRITEPROTECTION_ENABLE(hrtc);
mbed_official 235:685d5f11838f 1616
mbed_official 235:685d5f11838f 1617 /* Change RTC state */
mbed_official 235:685d5f11838f 1618 hrtc->State = HAL_RTC_STATE_READY;
mbed_official 235:685d5f11838f 1619
mbed_official 235:685d5f11838f 1620 /* Process Unlocked */
mbed_official 235:685d5f11838f 1621 __HAL_UNLOCK(hrtc);
mbed_official 235:685d5f11838f 1622
mbed_official 235:685d5f11838f 1623 return HAL_OK;
mbed_official 235:685d5f11838f 1624 }
mbed_official 235:685d5f11838f 1625
mbed_official 235:685d5f11838f 1626 /**
mbed_official 235:685d5f11838f 1627 * @}
mbed_official 235:685d5f11838f 1628 */
mbed_official 235:685d5f11838f 1629
mbed_official 532:fe11edbda85c 1630 /** @defgroup RTCEx_Exported_Functions_Group4 Extended features functions
mbed_official 235:685d5f11838f 1631 * @brief Extended features functions
mbed_official 235:685d5f11838f 1632 *
mbed_official 235:685d5f11838f 1633 @verbatim
mbed_official 235:685d5f11838f 1634 ===============================================================================
mbed_official 235:685d5f11838f 1635 ##### Extended features functions #####
mbed_official 235:685d5f11838f 1636 ===============================================================================
mbed_official 235:685d5f11838f 1637 [..] This section provides functions allowing to:
mbed_official 532:fe11edbda85c 1638 (+) RTC Alarm B callback
mbed_official 235:685d5f11838f 1639 (+) RTC Poll for Alarm B request
mbed_official 235:685d5f11838f 1640
mbed_official 235:685d5f11838f 1641 @endverbatim
mbed_official 235:685d5f11838f 1642 * @{
mbed_official 235:685d5f11838f 1643 */
mbed_official 235:685d5f11838f 1644
mbed_official 235:685d5f11838f 1645 /**
mbed_official 235:685d5f11838f 1646 * @brief Alarm B callback.
mbed_official 235:685d5f11838f 1647 * @param hrtc: pointer to a RTC_HandleTypeDef structure that contains
mbed_official 235:685d5f11838f 1648 * the configuration information for RTC.
mbed_official 235:685d5f11838f 1649 * @retval None
mbed_official 235:685d5f11838f 1650 */
mbed_official 235:685d5f11838f 1651 __weak void HAL_RTCEx_AlarmBEventCallback(RTC_HandleTypeDef *hrtc)
mbed_official 235:685d5f11838f 1652 {
mbed_official 235:685d5f11838f 1653 /* NOTE : This function Should not be modified, when the callback is needed,
mbed_official 235:685d5f11838f 1654 the HAL_RTC_AlarmBEventCallback could be implemented in the user file
mbed_official 235:685d5f11838f 1655 */
mbed_official 235:685d5f11838f 1656 }
mbed_official 235:685d5f11838f 1657
mbed_official 235:685d5f11838f 1658 /**
mbed_official 235:685d5f11838f 1659 * @brief This function handles AlarmB Polling request.
mbed_official 235:685d5f11838f 1660 * @param hrtc: pointer to a RTC_HandleTypeDef structure that contains
mbed_official 235:685d5f11838f 1661 * the configuration information for RTC.
mbed_official 235:685d5f11838f 1662 * @param Timeout: Timeout duration
mbed_official 235:685d5f11838f 1663 * @retval HAL status
mbed_official 235:685d5f11838f 1664 */
mbed_official 235:685d5f11838f 1665 HAL_StatusTypeDef HAL_RTCEx_PollForAlarmBEvent(RTC_HandleTypeDef *hrtc, uint32_t Timeout)
mbed_official 235:685d5f11838f 1666 {
mbed_official 235:685d5f11838f 1667 uint32_t tickstart = 0;
mbed_official 235:685d5f11838f 1668
mbed_official 235:685d5f11838f 1669 /* Get tick */
mbed_official 235:685d5f11838f 1670 tickstart = HAL_GetTick();
mbed_official 235:685d5f11838f 1671
mbed_official 235:685d5f11838f 1672 while(__HAL_RTC_ALARM_GET_FLAG(hrtc, RTC_FLAG_ALRBF) == RESET)
mbed_official 235:685d5f11838f 1673 {
mbed_official 235:685d5f11838f 1674 if(Timeout != HAL_MAX_DELAY)
mbed_official 235:685d5f11838f 1675 {
mbed_official 235:685d5f11838f 1676 if((Timeout == 0)||((HAL_GetTick() - tickstart ) > Timeout))
mbed_official 235:685d5f11838f 1677 {
mbed_official 235:685d5f11838f 1678 hrtc->State = HAL_RTC_STATE_TIMEOUT;
mbed_official 235:685d5f11838f 1679 return HAL_TIMEOUT;
mbed_official 235:685d5f11838f 1680 }
mbed_official 235:685d5f11838f 1681 }
mbed_official 235:685d5f11838f 1682 }
mbed_official 235:685d5f11838f 1683
mbed_official 235:685d5f11838f 1684 /* Clear the Alarm Flag */
mbed_official 235:685d5f11838f 1685 __HAL_RTC_ALARM_CLEAR_FLAG(hrtc, RTC_FLAG_ALRBF);
mbed_official 235:685d5f11838f 1686
mbed_official 235:685d5f11838f 1687 /* Change RTC state */
mbed_official 235:685d5f11838f 1688 hrtc->State = HAL_RTC_STATE_READY;
mbed_official 235:685d5f11838f 1689
mbed_official 235:685d5f11838f 1690 return HAL_OK;
mbed_official 235:685d5f11838f 1691 }
mbed_official 235:685d5f11838f 1692
mbed_official 235:685d5f11838f 1693 /**
mbed_official 235:685d5f11838f 1694 * @}
mbed_official 235:685d5f11838f 1695 */
mbed_official 235:685d5f11838f 1696
mbed_official 235:685d5f11838f 1697 /**
mbed_official 235:685d5f11838f 1698 * @}
mbed_official 235:685d5f11838f 1699 */
mbed_official 235:685d5f11838f 1700
mbed_official 235:685d5f11838f 1701 #endif /* HAL_RTC_MODULE_ENABLED */
mbed_official 235:685d5f11838f 1702 /**
mbed_official 235:685d5f11838f 1703 * @}
mbed_official 235:685d5f11838f 1704 */
mbed_official 235:685d5f11838f 1705
mbed_official 235:685d5f11838f 1706 /**
mbed_official 235:685d5f11838f 1707 * @}
mbed_official 235:685d5f11838f 1708 */
mbed_official 235:685d5f11838f 1709
mbed_official 235:685d5f11838f 1710 /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/