shao ziyang / mbed-src-kl05

mbed library sources

Dependents:   frdm_kl05z_gpio_test

Fork of mbed-src by mbed official

targets/cmsis/TARGET_STM/TARGET_DISCO_F407VG/stm32f4xx_hal_rtc_ex.c@133:d4dda5c437f0, 2014-03-24 (annotated)

Committer:
mbed_official
Date:
Mon Mar 24 17:45:07 2014 +0000
Revision:
133:d4dda5c437f0
Child:
242:7074e42da0b2
Synchronized with git revision 47b961246bed973fe4cb8932781ffc8025b78a61



Full URL: https://github.com/mbedmicro/mbed/commit/47b961246bed973fe4cb8932781ffc8025b78a61/



[STM32F4-Discovery (STM32F407VG)] initial port

Who changed what in which revision?

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