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_NUCLEO_F401RE/stm32f4xx_hal_rtc.c@323:9e901b0a5aa1, 2014-09-13 (annotated)

Committer:
shaoziyang
Date:
Sat Sep 13 14:25:46 2014 +0000
Revision:
323:9e901b0a5aa1
Parent:
226:b062af740e40 
test with CLOCK_SETUP = 0

Who changed what in which revision?

UserRevisionLine numberNew contents of line
mbed_official 87:085cde657901 1 /**
mbed_official 87:085cde657901 2 ******************************************************************************
mbed_official 87:085cde657901 3 * @file stm32f4xx_hal_rtc.c
mbed_official 87:085cde657901 4 * @author MCD Application Team
mbed_official 226:b062af740e40 5 * @version V1.1.0RC2
mbed_official 226:b062af740e40 6 * @date 14-May-2014
mbed_official 87:085cde657901 7 * @brief RTC HAL module driver.
mbed_official 87:085cde657901 8 * This file provides firmware functions to manage the following
mbed_official 87:085cde657901 9 * functionalities of the Real Time Clock (RTC) peripheral:
mbed_official 87:085cde657901 10 * + Initialization and de-initialization functions
mbed_official 87:085cde657901 11 * + RTC Time and Date functions
mbed_official 87:085cde657901 12 * + RTC Alarm functions
mbed_official 87:085cde657901 13 * + Peripheral Control functions
mbed_official 87:085cde657901 14 * + Peripheral State functions
mbed_official 87:085cde657901 15 *
mbed_official 87:085cde657901 16 @verbatim
mbed_official 87:085cde657901 17 ==============================================================================
mbed_official 87:085cde657901 18 ##### Backup Domain Operating Condition #####
mbed_official 87:085cde657901 19 ==============================================================================
mbed_official 87:085cde657901 20 [..] The real-time clock (RTC), the RTC backup registers, and the backup
mbed_official 87:085cde657901 21 SRAM (BKP SRAM) can be powered from the VBAT voltage when the main
mbed_official 87:085cde657901 22 VDD supply is powered off.
mbed_official 87:085cde657901 23 To retain the content of the RTC backup registers, backup SRAM, and supply
mbed_official 87:085cde657901 24 the RTC when VDD is turned off, VBAT pin can be connected to an optional
mbed_official 87:085cde657901 25 standby voltage supplied by a battery or by another source.
mbed_official 87:085cde657901 26
mbed_official 226:b062af740e40 27 [..] To allow the RTC operating even when the main digital supply (VDD) is turned
mbed_official 87:085cde657901 28 off, the VBAT pin powers the following blocks:
mbed_official 87:085cde657901 29 (#) The RTC
mbed_official 87:085cde657901 30 (#) The LSE oscillator
mbed_official 87:085cde657901 31 (#) The backup SRAM when the low power backup regulator is enabled
mbed_official 87:085cde657901 32 (#) PC13 to PC15 I/Os, plus PI8 I/O (when available)
mbed_official 87:085cde657901 33
mbed_official 87:085cde657901 34 [..] When the backup domain is supplied by VDD (analog switch connected to VDD),
mbed_official 226:b062af740e40 35 the following pins are available:
mbed_official 87:085cde657901 36 (#) PC14 and PC15 can be used as either GPIO or LSE pins
mbed_official 87:085cde657901 37 (#) PC13 can be used as a GPIO or as the RTC_AF1 pin
mbed_official 87:085cde657901 38 (#) PI8 can be used as a GPIO or as the RTC_AF2 pin
mbed_official 87:085cde657901 39
mbed_official 87:085cde657901 40 [..] When the backup domain is supplied by VBAT (analog switch connected to VBAT
mbed_official 226:b062af740e40 41 because VDD is not present), the following pins are available:
mbed_official 87:085cde657901 42 (#) PC14 and PC15 can be used as LSE pins only
mbed_official 87:085cde657901 43 (#) PC13 can be used as the RTC_AF1 pin
mbed_official 87:085cde657901 44 (#) PI8 can be used as the RTC_AF2 pin
mbed_official 87:085cde657901 45
mbed_official 87:085cde657901 46 ##### Backup Domain Reset #####
mbed_official 87:085cde657901 47 ==================================================================
mbed_official 87:085cde657901 48 [..] The backup domain reset sets all RTC registers and the RCC_BDCR register
mbed_official 87:085cde657901 49 to their reset values. The BKPSRAM is not affected by this reset. The only
mbed_official 226:b062af740e40 50 way to reset the BKPSRAM is through the Flash interface by requesting
mbed_official 87:085cde657901 51 a protection level change from 1 to 0.
mbed_official 87:085cde657901 52 [..] A backup domain reset is generated when one of the following events occurs:
mbed_official 87:085cde657901 53 (#) Software reset, triggered by setting the BDRST bit in the
mbed_official 87:085cde657901 54 RCC Backup domain control register (RCC_BDCR).
mbed_official 87:085cde657901 55 (#) VDD or VBAT power on, if both supplies have previously been powered off.
mbed_official 87:085cde657901 56
mbed_official 87:085cde657901 57 ##### Backup Domain Access #####
mbed_official 87:085cde657901 58 ==================================================================
mbed_official 87:085cde657901 59 [..] After reset, the backup domain (RTC registers, RTC backup data
mbed_official 87:085cde657901 60 registers and backup SRAM) is protected against possible unwanted write
mbed_official 87:085cde657901 61 accesses.
mbed_official 87:085cde657901 62 [..] To enable access to the RTC Domain and RTC registers, proceed as follows:
mbed_official 87:085cde657901 63 (+) Enable the Power Controller (PWR) APB1 interface clock using the
mbed_official 87:085cde657901 64 __PWR_CLK_ENABLE() function.
mbed_official 87:085cde657901 65 (+) Enable access to RTC domain using the HAL_PWR_EnableBkUpAccess() function.
mbed_official 87:085cde657901 66 (+) Select the RTC clock source using the __HAL_RCC_RTC_CONFIG() function.
mbed_official 87:085cde657901 67 (+) Enable RTC Clock using the __HAL_RCC_RTC_ENABLE() function.
mbed_official 87:085cde657901 68
mbed_official 87:085cde657901 69
mbed_official 87:085cde657901 70 ##### How to use this driver #####
mbed_official 87:085cde657901 71 ==================================================================
mbed_official 87:085cde657901 72 [..]
mbed_official 87:085cde657901 73 (+) Enable the RTC domain access (see description in the section above).
mbed_official 87:085cde657901 74 (+) Configure the RTC Prescaler (Asynchronous and Synchronous) and RTC hour
mbed_official 87:085cde657901 75 format using the HAL_RTC_Init() function.
mbed_official 87:085cde657901 76
mbed_official 87:085cde657901 77 *** Time and Date configuration ***
mbed_official 87:085cde657901 78 ===================================
mbed_official 87:085cde657901 79 [..]
mbed_official 87:085cde657901 80 (+) To configure the RTC Calendar (Time and Date) use the HAL_RTC_SetTime()
mbed_official 87:085cde657901 81 and HAL_RTC_SetDate() functions.
mbed_official 87:085cde657901 82 (+) To read the RTC Calendar, use the HAL_RTC_GetTime() and HAL_RTC_GetDate() functions.
mbed_official 87:085cde657901 83
mbed_official 87:085cde657901 84 *** Alarm configuration ***
mbed_official 87:085cde657901 85 ===========================
mbed_official 87:085cde657901 86 [..]
mbed_official 87:085cde657901 87 (+) To configure the RTC Alarm use the HAL_RTC_SetAlarm() function.
mbed_official 87:085cde657901 88 You can also configure the RTC Alarm with interrupt mode using the HAL_RTC_SetAlarm_IT() function.
mbed_official 87:085cde657901 89 (+) To read the RTC Alarm, use the HAL_RTC_GetAlarm() function.
mbed_official 87:085cde657901 90
mbed_official 87:085cde657901 91 ##### RTC and low power modes #####
mbed_official 87:085cde657901 92 ==================================================================
mbed_official 87:085cde657901 93 [..] The MCU can be woken up from a low power mode by an RTC alternate
mbed_official 87:085cde657901 94 function.
mbed_official 87:085cde657901 95 [..] The RTC alternate functions are the RTC alarms (Alarm A and Alarm B),
mbed_official 87:085cde657901 96 RTC wakeup, RTC tamper event detection and RTC time stamp event detection.
mbed_official 87:085cde657901 97 These RTC alternate functions can wake up the system from the Stop and
mbed_official 87:085cde657901 98 Standby low power modes.
mbed_official 87:085cde657901 99 [..] The system can also wake up from low power modes without depending
mbed_official 87:085cde657901 100 on an external interrupt (Auto-wakeup mode), by using the RTC alarm
mbed_official 87:085cde657901 101 or the RTC wakeup events.
mbed_official 87:085cde657901 102 [..] The RTC provides a programmable time base for waking up from the
mbed_official 87:085cde657901 103 Stop or Standby mode at regular intervals.
mbed_official 226:b062af740e40 104 Wakeup from STOP and STANDBY modes is possible only when the RTC clock source
mbed_official 87:085cde657901 105 is LSE or LSI.
mbed_official 87:085cde657901 106
mbed_official 87:085cde657901 107 @endverbatim
mbed_official 87:085cde657901 108 ******************************************************************************
mbed_official 87:085cde657901 109 * @attention
mbed_official 87:085cde657901 110 *
mbed_official 87:085cde657901 111 * <h2><center>&copy; COPYRIGHT(c) 2014 STMicroelectronics</center></h2>
mbed_official 87:085cde657901 112 *
mbed_official 87:085cde657901 113 * Redistribution and use in source and binary forms, with or without modification,
mbed_official 87:085cde657901 114 * are permitted provided that the following conditions are met:
mbed_official 87:085cde657901 115 * 1. Redistributions of source code must retain the above copyright notice,
mbed_official 87:085cde657901 116 * this list of conditions and the following disclaimer.
mbed_official 87:085cde657901 117 * 2. Redistributions in binary form must reproduce the above copyright notice,
mbed_official 87:085cde657901 118 * this list of conditions and the following disclaimer in the documentation
mbed_official 87:085cde657901 119 * and/or other materials provided with the distribution.
mbed_official 87:085cde657901 120 * 3. Neither the name of STMicroelectronics nor the names of its contributors
mbed_official 87:085cde657901 121 * may be used to endorse or promote products derived from this software
mbed_official 87:085cde657901 122 * without specific prior written permission.
mbed_official 87:085cde657901 123 *
mbed_official 87:085cde657901 124 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
mbed_official 87:085cde657901 125 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
mbed_official 87:085cde657901 126 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
mbed_official 87:085cde657901 127 * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
mbed_official 87:085cde657901 128 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
mbed_official 87:085cde657901 129 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
mbed_official 87:085cde657901 130 * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
mbed_official 87:085cde657901 131 * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
mbed_official 87:085cde657901 132 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
mbed_official 87:085cde657901 133 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
mbed_official 87:085cde657901 134 *
mbed_official 87:085cde657901 135 ******************************************************************************
mbed_official 87:085cde657901 136 */
mbed_official 87:085cde657901 137
mbed_official 87:085cde657901 138 /* Includes ------------------------------------------------------------------*/
mbed_official 87:085cde657901 139 #include "stm32f4xx_hal.h"
mbed_official 87:085cde657901 140
mbed_official 87:085cde657901 141 /** @addtogroup STM32F4xx_HAL_Driver
mbed_official 87:085cde657901 142 * @{
mbed_official 87:085cde657901 143 */
mbed_official 87:085cde657901 144
mbed_official 87:085cde657901 145 /** @defgroup RTC
mbed_official 87:085cde657901 146 * @brief RTC HAL module driver
mbed_official 87:085cde657901 147 * @{
mbed_official 87:085cde657901 148 */
mbed_official 87:085cde657901 149
mbed_official 87:085cde657901 150 #ifdef HAL_RTC_MODULE_ENABLED
mbed_official 87:085cde657901 151
mbed_official 87:085cde657901 152 /* Private typedef -----------------------------------------------------------*/
mbed_official 87:085cde657901 153 /* Private define ------------------------------------------------------------*/
mbed_official 87:085cde657901 154 /* Private macro -------------------------------------------------------------*/
mbed_official 87:085cde657901 155 /* Private variables ---------------------------------------------------------*/
mbed_official 87:085cde657901 156 /* Private function prototypes -----------------------------------------------*/
mbed_official 87:085cde657901 157 /* Private functions ---------------------------------------------------------*/
mbed_official 87:085cde657901 158
mbed_official 87:085cde657901 159 /** @defgroup RTC_Private_Functions
mbed_official 87:085cde657901 160 * @{
mbed_official 87:085cde657901 161 */
mbed_official 87:085cde657901 162
mbed_official 87:085cde657901 163 /** @defgroup RTC_Group1 Initialization and de-initialization functions
mbed_official 87:085cde657901 164 * @brief Initialization and Configuration functions
mbed_official 87:085cde657901 165 *
mbed_official 87:085cde657901 166 @verbatim
mbed_official 87:085cde657901 167 ===============================================================================
mbed_official 87:085cde657901 168 ##### Initialization and de-initialization functions #####
mbed_official 87:085cde657901 169 ===============================================================================
mbed_official 226:b062af740e40 170 [..] This section provides functions allowing to initialize and configure the
mbed_official 87:085cde657901 171 RTC Prescaler (Synchronous and Asynchronous), RTC Hour format, disable
mbed_official 87:085cde657901 172 RTC registers Write protection, enter and exit the RTC initialization mode,
mbed_official 87:085cde657901 173 RTC registers synchronization check and reference clock detection enable.
mbed_official 87:085cde657901 174 (#) The RTC Prescaler is programmed to generate the RTC 1Hz time base.
mbed_official 87:085cde657901 175 It is split into 2 programmable prescalers to minimize power consumption.
mbed_official 226:b062af740e40 176 (++) A 7-bit asynchronous prescaler and a 13-bit synchronous prescaler.
mbed_official 87:085cde657901 177 (++) When both prescalers are used, it is recommended to configure the
mbed_official 226:b062af740e40 178 asynchronous prescaler to a high value to minimize power consumption.
mbed_official 87:085cde657901 179 (#) All RTC registers are Write protected. Writing to the RTC registers
mbed_official 87:085cde657901 180 is enabled by writing a key into the Write Protection register, RTC_WPR.
mbed_official 226:b062af740e40 181 (#) To configure the RTC Calendar, user application should enter
mbed_official 87:085cde657901 182 initialization mode. In this mode, the calendar counter is stopped
mbed_official 87:085cde657901 183 and its value can be updated. When the initialization sequence is
mbed_official 87:085cde657901 184 complete, the calendar restarts counting after 4 RTCCLK cycles.
mbed_official 87:085cde657901 185 (#) To read the calendar through the shadow registers after Calendar
mbed_official 87:085cde657901 186 initialization, calendar update or after wakeup from low power modes
mbed_official 87:085cde657901 187 the software must first clear the RSF flag. The software must then
mbed_official 87:085cde657901 188 wait until it is set again before reading the calendar, which means
mbed_official 87:085cde657901 189 that the calendar registers have been correctly copied into the
mbed_official 87:085cde657901 190 RTC_TR and RTC_DR shadow registers.The HAL_RTC_WaitForSynchro() function
mbed_official 87:085cde657901 191 implements the above software sequence (RSF clear and RSF check).
mbed_official 87:085cde657901 192
mbed_official 87:085cde657901 193 @endverbatim
mbed_official 87:085cde657901 194 * @{
mbed_official 87:085cde657901 195 */
mbed_official 87:085cde657901 196
mbed_official 87:085cde657901 197 /**
mbed_official 87:085cde657901 198 * @brief Initializes the RTC peripheral
mbed_official 226:b062af740e40 199 * @param hrtc: pointer to a RTC_HandleTypeDef structure that contains
mbed_official 226:b062af740e40 200 * the configuration information for RTC.
mbed_official 87:085cde657901 201 * @retval HAL status
mbed_official 87:085cde657901 202 */
mbed_official 87:085cde657901 203 HAL_StatusTypeDef HAL_RTC_Init(RTC_HandleTypeDef *hrtc)
mbed_official 87:085cde657901 204 {
mbed_official 87:085cde657901 205 /* Check the RTC peripheral state */
mbed_official 87:085cde657901 206 if(hrtc == NULL)
mbed_official 87:085cde657901 207 {
mbed_official 87:085cde657901 208 return HAL_ERROR;
mbed_official 87:085cde657901 209 }
mbed_official 87:085cde657901 210
mbed_official 87:085cde657901 211 /* Check the parameters */
mbed_official 87:085cde657901 212 assert_param(IS_RTC_HOUR_FORMAT(hrtc->Init.HourFormat));
mbed_official 87:085cde657901 213 assert_param(IS_RTC_ASYNCH_PREDIV(hrtc->Init.AsynchPrediv));
mbed_official 87:085cde657901 214 assert_param(IS_RTC_SYNCH_PREDIV(hrtc->Init.SynchPrediv));
mbed_official 87:085cde657901 215 assert_param (IS_RTC_OUTPUT(hrtc->Init.OutPut));
mbed_official 87:085cde657901 216 assert_param (IS_RTC_OUTPUT_POL(hrtc->Init.OutPutPolarity));
mbed_official 87:085cde657901 217 assert_param(IS_RTC_OUTPUT_TYPE(hrtc->Init.OutPutType));
mbed_official 87:085cde657901 218
mbed_official 87:085cde657901 219 if(hrtc->State == HAL_RTC_STATE_RESET)
mbed_official 87:085cde657901 220 {
mbed_official 87:085cde657901 221 /* Initialize RTC MSP */
mbed_official 87:085cde657901 222 HAL_RTC_MspInit(hrtc);
mbed_official 87:085cde657901 223 }
mbed_official 87:085cde657901 224
mbed_official 87:085cde657901 225 /* Set RTC state */
mbed_official 87:085cde657901 226 hrtc->State = HAL_RTC_STATE_BUSY;
mbed_official 87:085cde657901 227
mbed_official 87:085cde657901 228 /* Disable the write protection for RTC registers */
mbed_official 87:085cde657901 229 __HAL_RTC_WRITEPROTECTION_DISABLE(hrtc);
mbed_official 87:085cde657901 230
mbed_official 87:085cde657901 231 /* Set Initialization mode */
mbed_official 87:085cde657901 232 if(RTC_EnterInitMode(hrtc) != HAL_OK)
mbed_official 87:085cde657901 233 {
mbed_official 87:085cde657901 234 /* Enable the write protection for RTC registers */
mbed_official 87:085cde657901 235 __HAL_RTC_WRITEPROTECTION_ENABLE(hrtc);
mbed_official 87:085cde657901 236
mbed_official 87:085cde657901 237 /* Set RTC state */
mbed_official 87:085cde657901 238 hrtc->State = HAL_RTC_STATE_ERROR;
mbed_official 87:085cde657901 239
mbed_official 87:085cde657901 240 return HAL_ERROR;
mbed_official 87:085cde657901 241 }
mbed_official 87:085cde657901 242 else
mbed_official 87:085cde657901 243 {
mbed_official 87:085cde657901 244 /* Clear RTC_CR FMT, OSEL and POL Bits */
mbed_official 87:085cde657901 245 hrtc->Instance->CR &= ((uint32_t)~(RTC_CR_FMT | RTC_CR_OSEL | RTC_CR_POL));
mbed_official 87:085cde657901 246 /* Set RTC_CR register */
mbed_official 87:085cde657901 247 hrtc->Instance->CR |= (uint32_t)(hrtc->Init.HourFormat | hrtc->Init.OutPut | hrtc->Init.OutPutPolarity);
mbed_official 87:085cde657901 248
mbed_official 87:085cde657901 249 /* Configure the RTC PRER */
mbed_official 87:085cde657901 250 hrtc->Instance->PRER = (uint32_t)(hrtc->Init.SynchPrediv);
mbed_official 87:085cde657901 251 hrtc->Instance->PRER |= (uint32_t)(hrtc->Init.AsynchPrediv << 16);
mbed_official 87:085cde657901 252
mbed_official 87:085cde657901 253 /* Exit Initialization mode */
mbed_official 87:085cde657901 254 hrtc->Instance->ISR &= (uint32_t)~RTC_ISR_INIT;
mbed_official 87:085cde657901 255
mbed_official 87:085cde657901 256 hrtc->Instance->TAFCR &= (uint32_t)~RTC_TAFCR_ALARMOUTTYPE;
mbed_official 87:085cde657901 257 hrtc->Instance->TAFCR |= (uint32_t)(hrtc->Init.OutPutType);
mbed_official 87:085cde657901 258
mbed_official 87:085cde657901 259 /* Enable the write protection for RTC registers */
mbed_official 87:085cde657901 260 __HAL_RTC_WRITEPROTECTION_ENABLE(hrtc);
mbed_official 87:085cde657901 261
mbed_official 87:085cde657901 262 /* Set RTC state */
mbed_official 87:085cde657901 263 hrtc->State = HAL_RTC_STATE_READY;
mbed_official 87:085cde657901 264
mbed_official 87:085cde657901 265 return HAL_OK;
mbed_official 87:085cde657901 266 }
mbed_official 87:085cde657901 267 }
mbed_official 87:085cde657901 268
mbed_official 87:085cde657901 269 /**
mbed_official 87:085cde657901 270 * @brief DeInitializes the RTC peripheral
mbed_official 226:b062af740e40 271 * @param hrtc: pointer to a RTC_HandleTypeDef structure that contains
mbed_official 226:b062af740e40 272 * the configuration information for RTC.
mbed_official 87:085cde657901 273 * @note This function doesn't reset the RTC Backup Data registers.
mbed_official 87:085cde657901 274 * @retval HAL status
mbed_official 87:085cde657901 275 */
mbed_official 87:085cde657901 276 HAL_StatusTypeDef HAL_RTC_DeInit(RTC_HandleTypeDef *hrtc)
mbed_official 87:085cde657901 277 {
mbed_official 87:085cde657901 278 uint32_t timeout = 0;
mbed_official 87:085cde657901 279
mbed_official 87:085cde657901 280 /* Set RTC state */
mbed_official 87:085cde657901 281 hrtc->State = HAL_RTC_STATE_BUSY;
mbed_official 87:085cde657901 282
mbed_official 87:085cde657901 283 /* Disable the write protection for RTC registers */
mbed_official 87:085cde657901 284 __HAL_RTC_WRITEPROTECTION_DISABLE(hrtc);
mbed_official 87:085cde657901 285
mbed_official 87:085cde657901 286 /* Set Initialization mode */
mbed_official 87:085cde657901 287 if(RTC_EnterInitMode(hrtc) != HAL_OK)
mbed_official 87:085cde657901 288 {
mbed_official 87:085cde657901 289 /* Enable the write protection for RTC registers */
mbed_official 87:085cde657901 290 __HAL_RTC_WRITEPROTECTION_ENABLE(hrtc);
mbed_official 87:085cde657901 291
mbed_official 87:085cde657901 292 /* Set RTC state */
mbed_official 87:085cde657901 293 hrtc->State = HAL_RTC_STATE_ERROR;
mbed_official 87:085cde657901 294
mbed_official 87:085cde657901 295 return HAL_ERROR;
mbed_official 87:085cde657901 296 }
mbed_official 87:085cde657901 297 else
mbed_official 87:085cde657901 298 {
mbed_official 87:085cde657901 299 /* Reset TR, DR and CR registers */
mbed_official 87:085cde657901 300 hrtc->Instance->TR = (uint32_t)0x00000000;
mbed_official 87:085cde657901 301 hrtc->Instance->DR = (uint32_t)0x00002101;
mbed_official 87:085cde657901 302 /* Reset All CR bits except CR[2:0] */
mbed_official 87:085cde657901 303 hrtc->Instance->CR &= (uint32_t)0x00000007;
mbed_official 87:085cde657901 304
mbed_official 87:085cde657901 305 timeout = HAL_GetTick() + RTC_TIMEOUT_VALUE;
mbed_official 87:085cde657901 306
mbed_official 87:085cde657901 307 /* Wait till WUTWF flag is set and if Time out is reached exit */
mbed_official 87:085cde657901 308 while(((hrtc->Instance->ISR) & RTC_ISR_WUTWF) == (uint32_t)RESET)
mbed_official 87:085cde657901 309 {
mbed_official 87:085cde657901 310 if(HAL_GetTick() >= timeout)
mbed_official 87:085cde657901 311 {
mbed_official 87:085cde657901 312 /* Enable the write protection for RTC registers */
mbed_official 87:085cde657901 313 __HAL_RTC_WRITEPROTECTION_ENABLE(hrtc);
mbed_official 87:085cde657901 314
mbed_official 87:085cde657901 315 /* Set RTC state */
mbed_official 87:085cde657901 316 hrtc->State = HAL_RTC_STATE_TIMEOUT;
mbed_official 87:085cde657901 317
mbed_official 87:085cde657901 318 return HAL_TIMEOUT;
mbed_official 87:085cde657901 319 }
mbed_official 87:085cde657901 320 }
mbed_official 87:085cde657901 321
mbed_official 87:085cde657901 322 /* Reset all RTC CR register bits */
mbed_official 87:085cde657901 323 hrtc->Instance->CR &= (uint32_t)0x00000000;
mbed_official 87:085cde657901 324 hrtc->Instance->WUTR = (uint32_t)0x0000FFFF;
mbed_official 87:085cde657901 325 hrtc->Instance->PRER = (uint32_t)0x007F00FF;
mbed_official 87:085cde657901 326 hrtc->Instance->CALIBR = (uint32_t)0x00000000;
mbed_official 106:ced8cbb51063 327 hrtc->Instance->ALRMAR = (uint32_t)0x00000000;
mbed_official 87:085cde657901 328 hrtc->Instance->ALRMBR = (uint32_t)0x00000000;
mbed_official 87:085cde657901 329 hrtc->Instance->SHIFTR = (uint32_t)0x00000000;
mbed_official 87:085cde657901 330 hrtc->Instance->CALR = (uint32_t)0x00000000;
mbed_official 87:085cde657901 331 hrtc->Instance->ALRMASSR = (uint32_t)0x00000000;
mbed_official 87:085cde657901 332 hrtc->Instance->ALRMBSSR = (uint32_t)0x00000000;
mbed_official 87:085cde657901 333
mbed_official 87:085cde657901 334 /* Reset ISR register and exit initialization mode */
mbed_official 87:085cde657901 335 hrtc->Instance->ISR = (uint32_t)0x00000000;
mbed_official 87:085cde657901 336
mbed_official 87:085cde657901 337 /* Reset Tamper and alternate functions configuration register */
mbed_official 87:085cde657901 338 hrtc->Instance->TAFCR = 0x00000000;
mbed_official 87:085cde657901 339
mbed_official 87:085cde657901 340 /* If RTC_CR_BYPSHAD bit = 0, wait for synchro else this check is not needed */
mbed_official 87:085cde657901 341 if((hrtc->Instance->CR & RTC_CR_BYPSHAD) == RESET)
mbed_official 87:085cde657901 342 {
mbed_official 87:085cde657901 343 if(HAL_RTC_WaitForSynchro(hrtc) != HAL_OK)
mbed_official 87:085cde657901 344 {
mbed_official 87:085cde657901 345 /* Enable the write protection for RTC registers */
mbed_official 87:085cde657901 346 __HAL_RTC_WRITEPROTECTION_ENABLE(hrtc);
mbed_official 87:085cde657901 347
mbed_official 87:085cde657901 348 hrtc->State = HAL_RTC_STATE_ERROR;
mbed_official 87:085cde657901 349
mbed_official 87:085cde657901 350 return HAL_ERROR;
mbed_official 87:085cde657901 351 }
mbed_official 87:085cde657901 352 }
mbed_official 87:085cde657901 353 }
mbed_official 87:085cde657901 354
mbed_official 87:085cde657901 355 /* Enable the write protection for RTC registers */
mbed_official 106:ced8cbb51063 356 __HAL_RTC_WRITEPROTECTION_ENABLE(hrtc);
mbed_official 87:085cde657901 357
mbed_official 87:085cde657901 358 /* De-Initialize RTC MSP */
mbed_official 87:085cde657901 359 HAL_RTC_MspDeInit(hrtc);
mbed_official 87:085cde657901 360
mbed_official 87:085cde657901 361 hrtc->State = HAL_RTC_STATE_RESET;
mbed_official 106:ced8cbb51063 362
mbed_official 106:ced8cbb51063 363 /* Release Lock */
mbed_official 106:ced8cbb51063 364 __HAL_UNLOCK(hrtc);
mbed_official 106:ced8cbb51063 365
mbed_official 87:085cde657901 366 return HAL_OK;
mbed_official 87:085cde657901 367 }
mbed_official 87:085cde657901 368
mbed_official 87:085cde657901 369 /**
mbed_official 87:085cde657901 370 * @brief Initializes the RTC MSP.
mbed_official 226:b062af740e40 371 * @param hrtc: pointer to a RTC_HandleTypeDef structure that contains
mbed_official 226:b062af740e40 372 * the configuration information for RTC.
mbed_official 87:085cde657901 373 * @retval None
mbed_official 87:085cde657901 374 */
mbed_official 87:085cde657901 375 __weak void HAL_RTC_MspInit(RTC_HandleTypeDef* hrtc)
mbed_official 87:085cde657901 376 {
mbed_official 87:085cde657901 377 /* NOTE : This function Should not be modified, when the callback is needed,
mbed_official 87:085cde657901 378 the HAL_RTC_MspInit could be implenetd in the user file
mbed_official 87:085cde657901 379 */
mbed_official 87:085cde657901 380 }
mbed_official 87:085cde657901 381
mbed_official 87:085cde657901 382 /**
mbed_official 87:085cde657901 383 * @brief DeInitializes the RTC MSP.
mbed_official 226:b062af740e40 384 * @param hrtc: pointer to a RTC_HandleTypeDef structure that contains
mbed_official 226:b062af740e40 385 * the configuration information for RTC.
mbed_official 87:085cde657901 386 * @retval None
mbed_official 87:085cde657901 387 */
mbed_official 87:085cde657901 388 __weak void HAL_RTC_MspDeInit(RTC_HandleTypeDef* hrtc)
mbed_official 87:085cde657901 389 {
mbed_official 87:085cde657901 390 /* NOTE : This function Should not be modified, when the callback is needed,
mbed_official 87:085cde657901 391 the HAL_RTC_MspDeInit could be implenetd in the user file
mbed_official 87:085cde657901 392 */
mbed_official 87:085cde657901 393 }
mbed_official 87:085cde657901 394
mbed_official 87:085cde657901 395 /**
mbed_official 87:085cde657901 396 * @}
mbed_official 87:085cde657901 397 */
mbed_official 87:085cde657901 398
mbed_official 87:085cde657901 399 /** @defgroup RTC_Group2 RTC Time and Date functions
mbed_official 87:085cde657901 400 * @brief RTC Time and Date functions
mbed_official 87:085cde657901 401 *
mbed_official 87:085cde657901 402 @verbatim
mbed_official 87:085cde657901 403 ===============================================================================
mbed_official 87:085cde657901 404 ##### RTC Time and Date functions #####
mbed_official 87:085cde657901 405 ===============================================================================
mbed_official 87:085cde657901 406
mbed_official 226:b062af740e40 407 [..] This section provides functions allowing to configure Time and Date features
mbed_official 87:085cde657901 408
mbed_official 87:085cde657901 409 @endverbatim
mbed_official 87:085cde657901 410 * @{
mbed_official 87:085cde657901 411 */
mbed_official 87:085cde657901 412
mbed_official 87:085cde657901 413 /**
mbed_official 87:085cde657901 414 * @brief Sets RTC current time.
mbed_official 226:b062af740e40 415 * @param hrtc: pointer to a RTC_HandleTypeDef structure that contains
mbed_official 226:b062af740e40 416 * the configuration information for RTC.
mbed_official 87:085cde657901 417 * @param sTime: Pointer to Time structure
mbed_official 87:085cde657901 418 * @param Format: Specifies the format of the entered parameters.
mbed_official 87:085cde657901 419 * This parameter can be one of the following values:
mbed_official 226:b062af740e40 420 * @arg FORMAT_BIN: Binary data format
mbed_official 226:b062af740e40 421 * @arg FORMAT_BCD: BCD data format
mbed_official 87:085cde657901 422 * @retval HAL status
mbed_official 87:085cde657901 423 */
mbed_official 87:085cde657901 424 HAL_StatusTypeDef HAL_RTC_SetTime(RTC_HandleTypeDef *hrtc, RTC_TimeTypeDef *sTime, uint32_t Format)
mbed_official 87:085cde657901 425 {
mbed_official 87:085cde657901 426 uint32_t tmpreg = 0;
mbed_official 87:085cde657901 427
mbed_official 87:085cde657901 428 /* Check the parameters */
mbed_official 87:085cde657901 429 assert_param(IS_RTC_FORMAT(Format));
mbed_official 87:085cde657901 430 assert_param(IS_RTC_DAYLIGHT_SAVING(sTime->DayLightSaving));
mbed_official 87:085cde657901 431 assert_param(IS_RTC_STORE_OPERATION(sTime->StoreOperation));
mbed_official 87:085cde657901 432
mbed_official 87:085cde657901 433 /* Process Locked */
mbed_official 87:085cde657901 434 __HAL_LOCK(hrtc);
mbed_official 87:085cde657901 435
mbed_official 87:085cde657901 436 hrtc->State = HAL_RTC_STATE_BUSY;
mbed_official 87:085cde657901 437
mbed_official 87:085cde657901 438 if(Format == FORMAT_BIN)
mbed_official 87:085cde657901 439 {
mbed_official 87:085cde657901 440 if((hrtc->Instance->CR & RTC_CR_FMT) != (uint32_t)RESET)
mbed_official 87:085cde657901 441 {
mbed_official 87:085cde657901 442 assert_param(IS_RTC_HOUR12(sTime->Hours));
mbed_official 87:085cde657901 443 assert_param(IS_RTC_HOURFORMAT12(sTime->TimeFormat));
mbed_official 87:085cde657901 444 }
mbed_official 87:085cde657901 445 else
mbed_official 87:085cde657901 446 {
mbed_official 87:085cde657901 447 sTime->TimeFormat = 0x00;
mbed_official 87:085cde657901 448 assert_param(IS_RTC_HOUR24(sTime->Hours));
mbed_official 87:085cde657901 449 }
mbed_official 87:085cde657901 450 assert_param(IS_RTC_MINUTES(sTime->Minutes));
mbed_official 87:085cde657901 451 assert_param(IS_RTC_SECONDS(sTime->Seconds));
mbed_official 87:085cde657901 452
mbed_official 87:085cde657901 453 tmpreg = (uint32_t)(((uint32_t)RTC_ByteToBcd2(sTime->Hours) << 16) | \
mbed_official 87:085cde657901 454 ((uint32_t)RTC_ByteToBcd2(sTime->Minutes) << 8) | \
mbed_official 87:085cde657901 455 ((uint32_t)RTC_ByteToBcd2(sTime->Seconds)) | \
mbed_official 87:085cde657901 456 (((uint32_t)sTime->TimeFormat) << 16));
mbed_official 87:085cde657901 457 }
mbed_official 87:085cde657901 458 else
mbed_official 87:085cde657901 459 {
mbed_official 87:085cde657901 460 if((hrtc->Instance->CR & RTC_CR_FMT) != (uint32_t)RESET)
mbed_official 87:085cde657901 461 {
mbed_official 87:085cde657901 462 tmpreg = RTC_Bcd2ToByte(sTime->Hours);
mbed_official 87:085cde657901 463 assert_param(IS_RTC_HOUR12(tmpreg));
mbed_official 87:085cde657901 464 assert_param(IS_RTC_HOURFORMAT12(sTime->TimeFormat));
mbed_official 87:085cde657901 465 }
mbed_official 87:085cde657901 466 else
mbed_official 87:085cde657901 467 {
mbed_official 87:085cde657901 468 sTime->TimeFormat = 0x00;
mbed_official 87:085cde657901 469 assert_param(IS_RTC_HOUR24(RTC_Bcd2ToByte(sTime->Hours)));
mbed_official 87:085cde657901 470 }
mbed_official 87:085cde657901 471 assert_param(IS_RTC_MINUTES(RTC_Bcd2ToByte(sTime->Minutes)));
mbed_official 87:085cde657901 472 assert_param(IS_RTC_SECONDS(RTC_Bcd2ToByte(sTime->Seconds)));
mbed_official 87:085cde657901 473 tmpreg = (((uint32_t)(sTime->Hours) << 16) | \
mbed_official 87:085cde657901 474 ((uint32_t)(sTime->Minutes) << 8) | \
mbed_official 87:085cde657901 475 ((uint32_t)sTime->Seconds) | \
mbed_official 87:085cde657901 476 ((uint32_t)(sTime->TimeFormat) << 16));
mbed_official 87:085cde657901 477 }
mbed_official 87:085cde657901 478
mbed_official 87:085cde657901 479 /* Disable the write protection for RTC registers */
mbed_official 87:085cde657901 480 __HAL_RTC_WRITEPROTECTION_DISABLE(hrtc);
mbed_official 87:085cde657901 481
mbed_official 87:085cde657901 482 /* Set Initialization mode */
mbed_official 87:085cde657901 483 if(RTC_EnterInitMode(hrtc) != HAL_OK)
mbed_official 87:085cde657901 484 {
mbed_official 87:085cde657901 485 /* Enable the write protection for RTC registers */
mbed_official 87:085cde657901 486 __HAL_RTC_WRITEPROTECTION_ENABLE(hrtc);
mbed_official 87:085cde657901 487
mbed_official 87:085cde657901 488 /* Set RTC state */
mbed_official 87:085cde657901 489 hrtc->State = HAL_RTC_STATE_ERROR;
mbed_official 87:085cde657901 490
mbed_official 87:085cde657901 491 /* Process Unlocked */
mbed_official 87:085cde657901 492 __HAL_UNLOCK(hrtc);
mbed_official 87:085cde657901 493
mbed_official 87:085cde657901 494 return HAL_ERROR;
mbed_official 87:085cde657901 495 }
mbed_official 87:085cde657901 496 else
mbed_official 87:085cde657901 497 {
mbed_official 87:085cde657901 498 /* Set the RTC_TR register */
mbed_official 87:085cde657901 499 hrtc->Instance->TR = (uint32_t)(tmpreg & RTC_TR_RESERVED_MASK);
mbed_official 87:085cde657901 500
mbed_official 87:085cde657901 501 /* Clear the bits to be configured */
mbed_official 87:085cde657901 502 hrtc->Instance->CR &= (uint32_t)~RTC_CR_BCK;
mbed_official 87:085cde657901 503
mbed_official 87:085cde657901 504 /* Configure the RTC_CR register */
mbed_official 87:085cde657901 505 hrtc->Instance->CR |= (uint32_t)(sTime->DayLightSaving | sTime->StoreOperation);
mbed_official 87:085cde657901 506
mbed_official 87:085cde657901 507 /* Exit Initialization mode */
mbed_official 87:085cde657901 508 hrtc->Instance->ISR &= (uint32_t)~RTC_ISR_INIT;
mbed_official 87:085cde657901 509
mbed_official 87:085cde657901 510 /* If CR_BYPSHAD bit = 0, wait for synchro else this check is not needed */
mbed_official 87:085cde657901 511 if((hrtc->Instance->CR & RTC_CR_BYPSHAD) == RESET)
mbed_official 87:085cde657901 512 {
mbed_official 87:085cde657901 513 if(HAL_RTC_WaitForSynchro(hrtc) != HAL_OK)
mbed_official 87:085cde657901 514 {
mbed_official 87:085cde657901 515 /* Enable the write protection for RTC registers */
mbed_official 87:085cde657901 516 __HAL_RTC_WRITEPROTECTION_ENABLE(hrtc);
mbed_official 87:085cde657901 517
mbed_official 87:085cde657901 518 hrtc->State = HAL_RTC_STATE_ERROR;
mbed_official 87:085cde657901 519
mbed_official 87:085cde657901 520 /* Process Unlocked */
mbed_official 87:085cde657901 521 __HAL_UNLOCK(hrtc);
mbed_official 87:085cde657901 522
mbed_official 87:085cde657901 523 return HAL_ERROR;
mbed_official 87:085cde657901 524 }
mbed_official 87:085cde657901 525 }
mbed_official 87:085cde657901 526
mbed_official 87:085cde657901 527 /* Enable the write protection for RTC registers */
mbed_official 87:085cde657901 528 __HAL_RTC_WRITEPROTECTION_ENABLE(hrtc);
mbed_official 87:085cde657901 529
mbed_official 87:085cde657901 530 hrtc->State = HAL_RTC_STATE_READY;
mbed_official 87:085cde657901 531
mbed_official 87:085cde657901 532 __HAL_UNLOCK(hrtc);
mbed_official 87:085cde657901 533
mbed_official 87:085cde657901 534 return HAL_OK;
mbed_official 87:085cde657901 535 }
mbed_official 87:085cde657901 536 }
mbed_official 87:085cde657901 537
mbed_official 87:085cde657901 538 /**
mbed_official 87:085cde657901 539 * @brief Gets RTC current time.
mbed_official 226:b062af740e40 540 * @param hrtc: pointer to a RTC_HandleTypeDef structure that contains
mbed_official 226:b062af740e40 541 * the configuration information for RTC.
mbed_official 87:085cde657901 542 * @param sTime: Pointer to Time structure
mbed_official 87:085cde657901 543 * @param Format: Specifies the format of the entered parameters.
mbed_official 87:085cde657901 544 * This parameter can be one of the following values:
mbed_official 226:b062af740e40 545 * @arg FORMAT_BIN: Binary data format
mbed_official 226:b062af740e40 546 * @arg FORMAT_BCD: BCD data format
mbed_official 87:085cde657901 547 * @note Call HAL_RTC_GetDate() after HAL_RTC_GetTime() to unlock the values
mbed_official 87:085cde657901 548 * in the higher-order calendar shadow registers.
mbed_official 87:085cde657901 549 * @retval HAL status
mbed_official 87:085cde657901 550 */
mbed_official 87:085cde657901 551 HAL_StatusTypeDef HAL_RTC_GetTime(RTC_HandleTypeDef *hrtc, RTC_TimeTypeDef *sTime, uint32_t Format)
mbed_official 87:085cde657901 552 {
mbed_official 87:085cde657901 553 uint32_t tmpreg = 0;
mbed_official 87:085cde657901 554
mbed_official 87:085cde657901 555 /* Check the parameters */
mbed_official 87:085cde657901 556 assert_param(IS_RTC_FORMAT(Format));
mbed_official 87:085cde657901 557
mbed_official 87:085cde657901 558 /* Get subseconds values from the correspondent registers*/
mbed_official 87:085cde657901 559 sTime->SubSeconds = (uint32_t)(hrtc->Instance->SSR);
mbed_official 87:085cde657901 560
mbed_official 87:085cde657901 561 /* Get the TR register */
mbed_official 87:085cde657901 562 tmpreg = (uint32_t)(hrtc->Instance->TR & RTC_TR_RESERVED_MASK);
mbed_official 87:085cde657901 563
mbed_official 87:085cde657901 564 /* Fill the structure fields with the read parameters */
mbed_official 87:085cde657901 565 sTime->Hours = (uint8_t)((tmpreg & (RTC_TR_HT | RTC_TR_HU)) >> 16);
mbed_official 87:085cde657901 566 sTime->Minutes = (uint8_t)((tmpreg & (RTC_TR_MNT | RTC_TR_MNU)) >>8);
mbed_official 87:085cde657901 567 sTime->Seconds = (uint8_t)(tmpreg & (RTC_TR_ST | RTC_TR_SU));
mbed_official 87:085cde657901 568 sTime->TimeFormat = (uint8_t)((tmpreg & (RTC_TR_PM)) >> 16);
mbed_official 87:085cde657901 569
mbed_official 87:085cde657901 570 /* Check the input parameters format */
mbed_official 87:085cde657901 571 if(Format == FORMAT_BIN)
mbed_official 87:085cde657901 572 {
mbed_official 87:085cde657901 573 /* Convert the time structure parameters to Binary format */
mbed_official 87:085cde657901 574 sTime->Hours = (uint8_t)RTC_Bcd2ToByte(sTime->Hours);
mbed_official 87:085cde657901 575 sTime->Minutes = (uint8_t)RTC_Bcd2ToByte(sTime->Minutes);
mbed_official 87:085cde657901 576 sTime->Seconds = (uint8_t)RTC_Bcd2ToByte(sTime->Seconds);
mbed_official 87:085cde657901 577 }
mbed_official 87:085cde657901 578
mbed_official 87:085cde657901 579 return HAL_OK;
mbed_official 87:085cde657901 580 }
mbed_official 87:085cde657901 581
mbed_official 87:085cde657901 582 /**
mbed_official 87:085cde657901 583 * @brief Sets RTC current date.
mbed_official 226:b062af740e40 584 * @param hrtc: pointer to a RTC_HandleTypeDef structure that contains
mbed_official 226:b062af740e40 585 * the configuration information for RTC.
mbed_official 87:085cde657901 586 * @param sDate: Pointer to date structure
mbed_official 87:085cde657901 587 * @param Format: specifies the format of the entered parameters.
mbed_official 87:085cde657901 588 * This parameter can be one of the following values:
mbed_official 226:b062af740e40 589 * @arg FORMAT_BIN: Binary data format
mbed_official 226:b062af740e40 590 * @arg FORMAT_BCD: BCD data format
mbed_official 87:085cde657901 591 * @retval HAL status
mbed_official 87:085cde657901 592 */
mbed_official 87:085cde657901 593 HAL_StatusTypeDef HAL_RTC_SetDate(RTC_HandleTypeDef *hrtc, RTC_DateTypeDef *sDate, uint32_t Format)
mbed_official 87:085cde657901 594 {
mbed_official 87:085cde657901 595 uint32_t datetmpreg = 0;
mbed_official 87:085cde657901 596
mbed_official 87:085cde657901 597 /* Check the parameters */
mbed_official 87:085cde657901 598 assert_param(IS_RTC_FORMAT(Format));
mbed_official 87:085cde657901 599
mbed_official 87:085cde657901 600 /* Process Locked */
mbed_official 87:085cde657901 601 __HAL_LOCK(hrtc);
mbed_official 87:085cde657901 602
mbed_official 87:085cde657901 603 hrtc->State = HAL_RTC_STATE_BUSY;
mbed_official 87:085cde657901 604
mbed_official 87:085cde657901 605 if((Format == FORMAT_BIN) && ((sDate->Month & 0x10) == 0x10))
mbed_official 87:085cde657901 606 {
mbed_official 87:085cde657901 607 sDate->Month = (uint8_t)((sDate->Month & (uint8_t)~(0x10)) + (uint8_t)0x0A);
mbed_official 87:085cde657901 608 }
mbed_official 87:085cde657901 609
mbed_official 87:085cde657901 610 assert_param(IS_RTC_WEEKDAY(sDate->WeekDay));
mbed_official 87:085cde657901 611
mbed_official 87:085cde657901 612 if(Format == FORMAT_BIN)
mbed_official 87:085cde657901 613 {
mbed_official 87:085cde657901 614 assert_param(IS_RTC_YEAR(sDate->Year));
mbed_official 87:085cde657901 615 assert_param(IS_RTC_MONTH(sDate->Month));
mbed_official 87:085cde657901 616 assert_param(IS_RTC_DATE(sDate->Date));
mbed_official 87:085cde657901 617
mbed_official 87:085cde657901 618 datetmpreg = (((uint32_t)RTC_ByteToBcd2(sDate->Year) << 16) | \
mbed_official 87:085cde657901 619 ((uint32_t)RTC_ByteToBcd2(sDate->Month) << 8) | \
mbed_official 87:085cde657901 620 ((uint32_t)RTC_ByteToBcd2(sDate->Date)) | \
mbed_official 87:085cde657901 621 ((uint32_t)sDate->WeekDay << 13));
mbed_official 87:085cde657901 622 }
mbed_official 87:085cde657901 623 else
mbed_official 87:085cde657901 624 {
mbed_official 87:085cde657901 625 assert_param(IS_RTC_YEAR(RTC_Bcd2ToByte(sDate->Year)));
mbed_official 87:085cde657901 626 datetmpreg = RTC_Bcd2ToByte(sDate->Month);
mbed_official 87:085cde657901 627 assert_param(IS_RTC_MONTH(datetmpreg));
mbed_official 87:085cde657901 628 datetmpreg = RTC_Bcd2ToByte(sDate->Date);
mbed_official 87:085cde657901 629 assert_param(IS_RTC_DATE(datetmpreg));
mbed_official 87:085cde657901 630
mbed_official 87:085cde657901 631 datetmpreg = ((((uint32_t)sDate->Year) << 16) | \
mbed_official 87:085cde657901 632 (((uint32_t)sDate->Month) << 8) | \
mbed_official 87:085cde657901 633 ((uint32_t)sDate->Date) | \
mbed_official 87:085cde657901 634 (((uint32_t)sDate->WeekDay) << 13));
mbed_official 87:085cde657901 635 }
mbed_official 87:085cde657901 636
mbed_official 87:085cde657901 637 /* Disable the write protection for RTC registers */
mbed_official 87:085cde657901 638 __HAL_RTC_WRITEPROTECTION_DISABLE(hrtc);
mbed_official 87:085cde657901 639
mbed_official 87:085cde657901 640 /* Set Initialization mode */
mbed_official 87:085cde657901 641 if(RTC_EnterInitMode(hrtc) != HAL_OK)
mbed_official 87:085cde657901 642 {
mbed_official 87:085cde657901 643 /* Enable the write protection for RTC registers */
mbed_official 87:085cde657901 644 __HAL_RTC_WRITEPROTECTION_ENABLE(hrtc);
mbed_official 87:085cde657901 645
mbed_official 87:085cde657901 646 /* Set RTC state*/
mbed_official 87:085cde657901 647 hrtc->State = HAL_RTC_STATE_ERROR;
mbed_official 87:085cde657901 648
mbed_official 87:085cde657901 649 /* Process Unlocked */
mbed_official 87:085cde657901 650 __HAL_UNLOCK(hrtc);
mbed_official 87:085cde657901 651
mbed_official 87:085cde657901 652 return HAL_ERROR;
mbed_official 87:085cde657901 653 }
mbed_official 87:085cde657901 654 else
mbed_official 87:085cde657901 655 {
mbed_official 87:085cde657901 656 /* Set the RTC_DR register */
mbed_official 87:085cde657901 657 hrtc->Instance->DR = (uint32_t)(datetmpreg & RTC_DR_RESERVED_MASK);
mbed_official 87:085cde657901 658
mbed_official 87:085cde657901 659 /* Exit Initialization mode */
mbed_official 87:085cde657901 660 hrtc->Instance->ISR &= (uint32_t)~RTC_ISR_INIT;
mbed_official 87:085cde657901 661
mbed_official 87:085cde657901 662 /* If CR_BYPSHAD bit = 0, wait for synchro else this check is not needed */
mbed_official 87:085cde657901 663 if((hrtc->Instance->CR & RTC_CR_BYPSHAD) == RESET)
mbed_official 87:085cde657901 664 {
mbed_official 87:085cde657901 665 if(HAL_RTC_WaitForSynchro(hrtc) != HAL_OK)
mbed_official 87:085cde657901 666 {
mbed_official 87:085cde657901 667 /* Enable the write protection for RTC registers */
mbed_official 87:085cde657901 668 __HAL_RTC_WRITEPROTECTION_ENABLE(hrtc);
mbed_official 87:085cde657901 669
mbed_official 87:085cde657901 670 hrtc->State = HAL_RTC_STATE_ERROR;
mbed_official 87:085cde657901 671
mbed_official 87:085cde657901 672 /* Process Unlocked */
mbed_official 87:085cde657901 673 __HAL_UNLOCK(hrtc);
mbed_official 87:085cde657901 674
mbed_official 87:085cde657901 675 return HAL_ERROR;
mbed_official 87:085cde657901 676 }
mbed_official 87:085cde657901 677 }
mbed_official 87:085cde657901 678
mbed_official 87:085cde657901 679 /* Enable the write protection for RTC registers */
mbed_official 87:085cde657901 680 __HAL_RTC_WRITEPROTECTION_ENABLE(hrtc);
mbed_official 87:085cde657901 681
mbed_official 87:085cde657901 682 hrtc->State = HAL_RTC_STATE_READY ;
mbed_official 87:085cde657901 683
mbed_official 87:085cde657901 684 /* Process Unlocked */
mbed_official 87:085cde657901 685 __HAL_UNLOCK(hrtc);
mbed_official 87:085cde657901 686
mbed_official 87:085cde657901 687 return HAL_OK;
mbed_official 87:085cde657901 688 }
mbed_official 87:085cde657901 689 }
mbed_official 87:085cde657901 690
mbed_official 87:085cde657901 691 /**
mbed_official 87:085cde657901 692 * @brief Gets RTC current date.
mbed_official 226:b062af740e40 693 * @param hrtc: pointer to a RTC_HandleTypeDef structure that contains
mbed_official 226:b062af740e40 694 * the configuration information for RTC.
mbed_official 87:085cde657901 695 * @param sDate: Pointer to Date structure
mbed_official 87:085cde657901 696 * @param Format: Specifies the format of the entered parameters.
mbed_official 87:085cde657901 697 * This parameter can be one of the following values:
mbed_official 226:b062af740e40 698 * @arg FORMAT_BIN: Binary data format
mbed_official 226:b062af740e40 699 * @arg FORMAT_BCD: BCD data format
mbed_official 87:085cde657901 700 * @retval HAL status
mbed_official 87:085cde657901 701 */
mbed_official 87:085cde657901 702 HAL_StatusTypeDef HAL_RTC_GetDate(RTC_HandleTypeDef *hrtc, RTC_DateTypeDef *sDate, uint32_t Format)
mbed_official 87:085cde657901 703 {
mbed_official 87:085cde657901 704 uint32_t datetmpreg = 0;
mbed_official 87:085cde657901 705
mbed_official 87:085cde657901 706 /* Check the parameters */
mbed_official 87:085cde657901 707 assert_param(IS_RTC_FORMAT(Format));
mbed_official 87:085cde657901 708
mbed_official 87:085cde657901 709 /* Get the DR register */
mbed_official 87:085cde657901 710 datetmpreg = (uint32_t)(hrtc->Instance->DR & RTC_DR_RESERVED_MASK);
mbed_official 87:085cde657901 711
mbed_official 87:085cde657901 712 /* Fill the structure fields with the read parameters */
mbed_official 87:085cde657901 713 sDate->Year = (uint8_t)((datetmpreg & (RTC_DR_YT | RTC_DR_YU)) >> 16);
mbed_official 87:085cde657901 714 sDate->Month = (uint8_t)((datetmpreg & (RTC_DR_MT | RTC_DR_MU)) >> 8);
mbed_official 87:085cde657901 715 sDate->Date = (uint8_t)(datetmpreg & (RTC_DR_DT | RTC_DR_DU));
mbed_official 87:085cde657901 716 sDate->WeekDay = (uint8_t)((datetmpreg & (RTC_DR_WDU)) >> 13);
mbed_official 87:085cde657901 717
mbed_official 87:085cde657901 718 /* Check the input parameters format */
mbed_official 87:085cde657901 719 if(Format == FORMAT_BIN)
mbed_official 87:085cde657901 720 {
mbed_official 87:085cde657901 721 /* Convert the date structure parameters to Binary format */
mbed_official 87:085cde657901 722 sDate->Year = (uint8_t)RTC_Bcd2ToByte(sDate->Year);
mbed_official 87:085cde657901 723 sDate->Month = (uint8_t)RTC_Bcd2ToByte(sDate->Month);
mbed_official 87:085cde657901 724 sDate->Date = (uint8_t)RTC_Bcd2ToByte(sDate->Date);
mbed_official 87:085cde657901 725 }
mbed_official 87:085cde657901 726 return HAL_OK;
mbed_official 87:085cde657901 727 }
mbed_official 87:085cde657901 728
mbed_official 87:085cde657901 729 /**
mbed_official 87:085cde657901 730 * @}
mbed_official 87:085cde657901 731 */
mbed_official 87:085cde657901 732
mbed_official 87:085cde657901 733 /** @defgroup RTC_Group3 RTC Alarm functions
mbed_official 87:085cde657901 734 * @brief RTC Alarm functions
mbed_official 87:085cde657901 735 *
mbed_official 87:085cde657901 736 @verbatim
mbed_official 87:085cde657901 737 ===============================================================================
mbed_official 87:085cde657901 738 ##### RTC Alarm functions #####
mbed_official 87:085cde657901 739 ===============================================================================
mbed_official 87:085cde657901 740
mbed_official 226:b062af740e40 741 [..] This section provides functions allowing to configure Alarm feature
mbed_official 87:085cde657901 742
mbed_official 87:085cde657901 743 @endverbatim
mbed_official 87:085cde657901 744 * @{
mbed_official 87:085cde657901 745 */
mbed_official 87:085cde657901 746 /**
mbed_official 87:085cde657901 747 * @brief Sets the specified RTC Alarm.
mbed_official 226:b062af740e40 748 * @param hrtc: pointer to a RTC_HandleTypeDef structure that contains
mbed_official 226:b062af740e40 749 * the configuration information for RTC.
mbed_official 87:085cde657901 750 * @param sAlarm: Pointer to Alarm structure
mbed_official 87:085cde657901 751 * @param Format: Specifies the format of the entered parameters.
mbed_official 87:085cde657901 752 * This parameter can be one of the following values:
mbed_official 226:b062af740e40 753 * @arg FORMAT_BIN: Binary data format
mbed_official 226:b062af740e40 754 * @arg FORMAT_BCD: BCD data format
mbed_official 87:085cde657901 755 * @retval HAL status
mbed_official 87:085cde657901 756 */
mbed_official 87:085cde657901 757 HAL_StatusTypeDef HAL_RTC_SetAlarm(RTC_HandleTypeDef *hrtc, RTC_AlarmTypeDef *sAlarm, uint32_t Format)
mbed_official 87:085cde657901 758 {
mbed_official 87:085cde657901 759 uint32_t timeout = 0;
mbed_official 87:085cde657901 760 uint32_t tmpreg = 0, subsecondtmpreg = 0;
mbed_official 87:085cde657901 761
mbed_official 87:085cde657901 762 /* Check the parameters */
mbed_official 87:085cde657901 763 assert_param(IS_RTC_FORMAT(Format));
mbed_official 87:085cde657901 764 assert_param(IS_ALARM(sAlarm->Alarm));
mbed_official 87:085cde657901 765 assert_param(IS_ALARM_MASK(sAlarm->AlarmMask));
mbed_official 87:085cde657901 766 assert_param(IS_RTC_ALARM_DATE_WEEKDAY_SEL(sAlarm->AlarmDateWeekDaySel));
mbed_official 87:085cde657901 767 assert_param(IS_RTC_ALARM_SUB_SECOND_VALUE(sAlarm->AlarmTime.SubSeconds));
mbed_official 87:085cde657901 768 assert_param(IS_RTC_ALARM_SUB_SECOND_MASK(sAlarm->AlarmSubSecondMask));
mbed_official 87:085cde657901 769
mbed_official 87:085cde657901 770 /* Process Locked */
mbed_official 87:085cde657901 771 __HAL_LOCK(hrtc);
mbed_official 87:085cde657901 772
mbed_official 87:085cde657901 773 hrtc->State = HAL_RTC_STATE_BUSY;
mbed_official 87:085cde657901 774
mbed_official 87:085cde657901 775 if(Format == FORMAT_BIN)
mbed_official 87:085cde657901 776 {
mbed_official 87:085cde657901 777 if((hrtc->Instance->CR & RTC_CR_FMT) != (uint32_t)RESET)
mbed_official 87:085cde657901 778 {
mbed_official 87:085cde657901 779 assert_param(IS_RTC_HOUR12(sAlarm->AlarmTime.Hours));
mbed_official 87:085cde657901 780 assert_param(IS_RTC_HOURFORMAT12(sAlarm->AlarmTime.TimeFormat));
mbed_official 87:085cde657901 781 }
mbed_official 87:085cde657901 782 else
mbed_official 87:085cde657901 783 {
mbed_official 87:085cde657901 784 sAlarm->AlarmTime.TimeFormat = 0x00;
mbed_official 87:085cde657901 785 assert_param(IS_RTC_HOUR24(sAlarm->AlarmTime.Hours));
mbed_official 87:085cde657901 786 }
mbed_official 87:085cde657901 787 assert_param(IS_RTC_MINUTES(sAlarm->AlarmTime.Minutes));
mbed_official 87:085cde657901 788 assert_param(IS_RTC_SECONDS(sAlarm->AlarmTime.Seconds));
mbed_official 87:085cde657901 789
mbed_official 87:085cde657901 790 if(sAlarm->AlarmDateWeekDaySel == RTC_ALARMDATEWEEKDAYSEL_DATE)
mbed_official 87:085cde657901 791 {
mbed_official 87:085cde657901 792 assert_param(IS_RTC_ALARM_DATE_WEEKDAY_DATE(sAlarm->AlarmDateWeekDay));
mbed_official 87:085cde657901 793 }
mbed_official 87:085cde657901 794 else
mbed_official 87:085cde657901 795 {
mbed_official 87:085cde657901 796 assert_param(IS_RTC_ALARM_DATE_WEEKDAY_WEEKDAY(sAlarm->AlarmDateWeekDay));
mbed_official 87:085cde657901 797 }
mbed_official 87:085cde657901 798
mbed_official 87:085cde657901 799 tmpreg = (((uint32_t)RTC_ByteToBcd2(sAlarm->AlarmTime.Hours) << 16) | \
mbed_official 87:085cde657901 800 ((uint32_t)RTC_ByteToBcd2(sAlarm->AlarmTime.Minutes) << 8) | \
mbed_official 87:085cde657901 801 ((uint32_t)RTC_ByteToBcd2(sAlarm->AlarmTime.Seconds)) | \
mbed_official 87:085cde657901 802 ((uint32_t)(sAlarm->AlarmTime.TimeFormat) << 16) | \
mbed_official 87:085cde657901 803 ((uint32_t)RTC_ByteToBcd2(sAlarm->AlarmDateWeekDay) << 24) | \
mbed_official 87:085cde657901 804 ((uint32_t)sAlarm->AlarmDateWeekDaySel) | \
mbed_official 87:085cde657901 805 ((uint32_t)sAlarm->AlarmMask));
mbed_official 87:085cde657901 806 }
mbed_official 87:085cde657901 807 else
mbed_official 87:085cde657901 808 {
mbed_official 87:085cde657901 809 if((hrtc->Instance->CR & RTC_CR_FMT) != (uint32_t)RESET)
mbed_official 87:085cde657901 810 {
mbed_official 87:085cde657901 811 tmpreg = RTC_Bcd2ToByte(sAlarm->AlarmTime.Hours);
mbed_official 87:085cde657901 812 assert_param(IS_RTC_HOUR12(tmpreg));
mbed_official 87:085cde657901 813 assert_param(IS_RTC_HOURFORMAT12(sAlarm->AlarmTime.TimeFormat));
mbed_official 87:085cde657901 814 }
mbed_official 87:085cde657901 815 else
mbed_official 87:085cde657901 816 {
mbed_official 87:085cde657901 817 sAlarm->AlarmTime.TimeFormat = 0x00;
mbed_official 87:085cde657901 818 assert_param(IS_RTC_HOUR24(RTC_Bcd2ToByte(sAlarm->AlarmTime.Hours)));
mbed_official 87:085cde657901 819 }
mbed_official 87:085cde657901 820
mbed_official 87:085cde657901 821 assert_param(IS_RTC_MINUTES(RTC_Bcd2ToByte(sAlarm->AlarmTime.Minutes)));
mbed_official 87:085cde657901 822 assert_param(IS_RTC_SECONDS(RTC_Bcd2ToByte(sAlarm->AlarmTime.Seconds)));
mbed_official 87:085cde657901 823
mbed_official 87:085cde657901 824 if(sAlarm->AlarmDateWeekDaySel == RTC_ALARMDATEWEEKDAYSEL_DATE)
mbed_official 87:085cde657901 825 {
mbed_official 87:085cde657901 826 tmpreg = RTC_Bcd2ToByte(sAlarm->AlarmDateWeekDay);
mbed_official 87:085cde657901 827 assert_param(IS_RTC_ALARM_DATE_WEEKDAY_DATE(tmpreg));
mbed_official 87:085cde657901 828 }
mbed_official 87:085cde657901 829 else
mbed_official 87:085cde657901 830 {
mbed_official 87:085cde657901 831 tmpreg = RTC_Bcd2ToByte(sAlarm->AlarmDateWeekDay);
mbed_official 87:085cde657901 832 assert_param(IS_RTC_ALARM_DATE_WEEKDAY_WEEKDAY(tmpreg));
mbed_official 87:085cde657901 833 }
mbed_official 87:085cde657901 834
mbed_official 87:085cde657901 835 tmpreg = (((uint32_t)(sAlarm->AlarmTime.Hours) << 16) | \
mbed_official 87:085cde657901 836 ((uint32_t)(sAlarm->AlarmTime.Minutes) << 8) | \
mbed_official 87:085cde657901 837 ((uint32_t) sAlarm->AlarmTime.Seconds) | \
mbed_official 87:085cde657901 838 ((uint32_t)(sAlarm->AlarmTime.TimeFormat) << 16) | \
mbed_official 87:085cde657901 839 ((uint32_t)(sAlarm->AlarmDateWeekDay) << 24) | \
mbed_official 87:085cde657901 840 ((uint32_t)sAlarm->AlarmDateWeekDaySel) | \
mbed_official 87:085cde657901 841 ((uint32_t)sAlarm->AlarmMask));
mbed_official 87:085cde657901 842 }
mbed_official 87:085cde657901 843
mbed_official 87:085cde657901 844 /* Configure the Alarm A or Alarm B Sub Second registers */
mbed_official 87:085cde657901 845 subsecondtmpreg = (uint32_t)((uint32_t)(sAlarm->AlarmTime.SubSeconds) | (uint32_t)(sAlarm->AlarmSubSecondMask));
mbed_official 87:085cde657901 846
mbed_official 87:085cde657901 847 /* Disable the write protection for RTC registers */
mbed_official 87:085cde657901 848 __HAL_RTC_WRITEPROTECTION_DISABLE(hrtc);
mbed_official 87:085cde657901 849
mbed_official 87:085cde657901 850 /* Configure the Alarm register */
mbed_official 87:085cde657901 851 if(sAlarm->Alarm == RTC_ALARM_A)
mbed_official 87:085cde657901 852 {
mbed_official 87:085cde657901 853 /* Disable the Alarm A interrupt */
mbed_official 87:085cde657901 854 __HAL_RTC_ALARMA_DISABLE(hrtc);
mbed_official 87:085cde657901 855
mbed_official 87:085cde657901 856 /* In case of interrupt mode is used, the interrupt source must disabled */
mbed_official 87:085cde657901 857 __HAL_RTC_ALARM_DISABLE_IT(hrtc, RTC_IT_ALRA);
mbed_official 87:085cde657901 858
mbed_official 87:085cde657901 859 timeout = HAL_GetTick() + RTC_TIMEOUT_VALUE;
mbed_official 87:085cde657901 860 /* Wait till RTC ALRAWF flag is set and if Time out is reached exit */
mbed_official 87:085cde657901 861 while(__HAL_RTC_ALARM_GET_FLAG(hrtc, RTC_FLAG_ALRAWF) == RESET)
mbed_official 87:085cde657901 862 {
mbed_official 87:085cde657901 863 if(HAL_GetTick() >= timeout)
mbed_official 87:085cde657901 864 {
mbed_official 87:085cde657901 865 /* Enable the write protection for RTC registers */
mbed_official 87:085cde657901 866 __HAL_RTC_WRITEPROTECTION_ENABLE(hrtc);
mbed_official 87:085cde657901 867
mbed_official 87:085cde657901 868 hrtc->State = HAL_RTC_STATE_TIMEOUT;
mbed_official 87:085cde657901 869
mbed_official 87:085cde657901 870 /* Process Unlocked */
mbed_official 87:085cde657901 871 __HAL_UNLOCK(hrtc);
mbed_official 87:085cde657901 872
mbed_official 87:085cde657901 873 return HAL_TIMEOUT;
mbed_official 87:085cde657901 874 }
mbed_official 87:085cde657901 875 }
mbed_official 87:085cde657901 876
mbed_official 87:085cde657901 877 hrtc->Instance->ALRMAR = (uint32_t)tmpreg;
mbed_official 87:085cde657901 878 /* Configure the Alarm A Sub Second register */
mbed_official 87:085cde657901 879 hrtc->Instance->ALRMASSR = subsecondtmpreg;
mbed_official 87:085cde657901 880 /* Configure the Alarm state: Enable Alarm */
mbed_official 87:085cde657901 881 __HAL_RTC_ALARMA_ENABLE(hrtc);
mbed_official 87:085cde657901 882 }
mbed_official 87:085cde657901 883 else
mbed_official 87:085cde657901 884 {
mbed_official 87:085cde657901 885 /* Disable the Alarm B interrupt */
mbed_official 87:085cde657901 886 __HAL_RTC_ALARMB_DISABLE(hrtc);
mbed_official 87:085cde657901 887
mbed_official 87:085cde657901 888 /* In case of interrupt mode is used, the interrupt source must disabled */
mbed_official 87:085cde657901 889 __HAL_RTC_ALARM_DISABLE_IT(hrtc, RTC_IT_ALRB);
mbed_official 87:085cde657901 890
mbed_official 87:085cde657901 891 timeout = HAL_GetTick() + RTC_TIMEOUT_VALUE;
mbed_official 87:085cde657901 892 /* Wait till RTC ALRBWF flag is set and if Time out is reached exit */
mbed_official 87:085cde657901 893 while(__HAL_RTC_ALARM_GET_FLAG(hrtc, RTC_FLAG_ALRBWF) == RESET)
mbed_official 87:085cde657901 894 {
mbed_official 87:085cde657901 895 if(HAL_GetTick() >= timeout)
mbed_official 87:085cde657901 896 {
mbed_official 87:085cde657901 897 /* Enable the write protection for RTC registers */
mbed_official 87:085cde657901 898 __HAL_RTC_WRITEPROTECTION_ENABLE(hrtc);
mbed_official 87:085cde657901 899
mbed_official 87:085cde657901 900 hrtc->State = HAL_RTC_STATE_TIMEOUT;
mbed_official 87:085cde657901 901
mbed_official 87:085cde657901 902 /* Process Unlocked */
mbed_official 87:085cde657901 903 __HAL_UNLOCK(hrtc);
mbed_official 87:085cde657901 904
mbed_official 87:085cde657901 905 return HAL_TIMEOUT;
mbed_official 87:085cde657901 906 }
mbed_official 87:085cde657901 907 }
mbed_official 87:085cde657901 908
mbed_official 87:085cde657901 909 hrtc->Instance->ALRMBR = (uint32_t)tmpreg;
mbed_official 87:085cde657901 910 /* Configure the Alarm B Sub Second register */
mbed_official 87:085cde657901 911 hrtc->Instance->ALRMBSSR = subsecondtmpreg;
mbed_official 87:085cde657901 912 /* Configure the Alarm state: Enable Alarm */
mbed_official 87:085cde657901 913 __HAL_RTC_ALARMB_ENABLE(hrtc);
mbed_official 87:085cde657901 914 }
mbed_official 87:085cde657901 915
mbed_official 87:085cde657901 916 /* Enable the write protection for RTC registers */
mbed_official 87:085cde657901 917 __HAL_RTC_WRITEPROTECTION_ENABLE(hrtc);
mbed_official 87:085cde657901 918
mbed_official 87:085cde657901 919 /* Change RTC state */
mbed_official 87:085cde657901 920 hrtc->State = HAL_RTC_STATE_READY;
mbed_official 87:085cde657901 921
mbed_official 87:085cde657901 922 /* Process Unlocked */
mbed_official 87:085cde657901 923 __HAL_UNLOCK(hrtc);
mbed_official 87:085cde657901 924
mbed_official 87:085cde657901 925 return HAL_OK;
mbed_official 87:085cde657901 926 }
mbed_official 87:085cde657901 927
mbed_official 87:085cde657901 928 /**
mbed_official 87:085cde657901 929 * @brief Sets the specified RTC Alarm with Interrupt
mbed_official 226:b062af740e40 930 * @param hrtc: pointer to a RTC_HandleTypeDef structure that contains
mbed_official 226:b062af740e40 931 * the configuration information for RTC.
mbed_official 87:085cde657901 932 * @param sAlarm: Pointer to Alarm structure
mbed_official 87:085cde657901 933 * @param Format: Specifies the format of the entered parameters.
mbed_official 87:085cde657901 934 * This parameter can be one of the following values:
mbed_official 226:b062af740e40 935 * @arg FORMAT_BIN: Binary data format
mbed_official 226:b062af740e40 936 * @arg FORMAT_BCD: BCD data format
mbed_official 87:085cde657901 937 * @retval HAL status
mbed_official 87:085cde657901 938 */
mbed_official 87:085cde657901 939 HAL_StatusTypeDef HAL_RTC_SetAlarm_IT(RTC_HandleTypeDef *hrtc, RTC_AlarmTypeDef *sAlarm, uint32_t Format)
mbed_official 87:085cde657901 940 {
mbed_official 87:085cde657901 941 uint32_t timeout = 0;
mbed_official 87:085cde657901 942 uint32_t tmpreg = 0, subsecondtmpreg = 0;
mbed_official 87:085cde657901 943
mbed_official 87:085cde657901 944 /* Check the parameters */
mbed_official 87:085cde657901 945 assert_param(IS_RTC_FORMAT(Format));
mbed_official 87:085cde657901 946 assert_param(IS_ALARM(sAlarm->Alarm));
mbed_official 87:085cde657901 947 assert_param(IS_ALARM_MASK(sAlarm->AlarmMask));
mbed_official 87:085cde657901 948 assert_param(IS_RTC_ALARM_DATE_WEEKDAY_SEL(sAlarm->AlarmDateWeekDaySel));
mbed_official 87:085cde657901 949 assert_param(IS_RTC_ALARM_SUB_SECOND_VALUE(sAlarm->AlarmTime.SubSeconds));
mbed_official 87:085cde657901 950 assert_param(IS_RTC_ALARM_SUB_SECOND_MASK(sAlarm->AlarmSubSecondMask));
mbed_official 87:085cde657901 951
mbed_official 87:085cde657901 952 /* Process Locked */
mbed_official 87:085cde657901 953 __HAL_LOCK(hrtc);
mbed_official 87:085cde657901 954
mbed_official 87:085cde657901 955 hrtc->State = HAL_RTC_STATE_BUSY;
mbed_official 87:085cde657901 956
mbed_official 87:085cde657901 957 if(Format == FORMAT_BIN)
mbed_official 87:085cde657901 958 {
mbed_official 87:085cde657901 959 if((hrtc->Instance->CR & RTC_CR_FMT) != (uint32_t)RESET)
mbed_official 87:085cde657901 960 {
mbed_official 87:085cde657901 961 assert_param(IS_RTC_HOUR12(sAlarm->AlarmTime.Hours));
mbed_official 87:085cde657901 962 assert_param(IS_RTC_HOURFORMAT12(sAlarm->AlarmTime.TimeFormat));
mbed_official 87:085cde657901 963 }
mbed_official 87:085cde657901 964 else
mbed_official 87:085cde657901 965 {
mbed_official 87:085cde657901 966 sAlarm->AlarmTime.TimeFormat = 0x00;
mbed_official 87:085cde657901 967 assert_param(IS_RTC_HOUR24(sAlarm->AlarmTime.Hours));
mbed_official 87:085cde657901 968 }
mbed_official 87:085cde657901 969 assert_param(IS_RTC_MINUTES(sAlarm->AlarmTime.Minutes));
mbed_official 87:085cde657901 970 assert_param(IS_RTC_SECONDS(sAlarm->AlarmTime.Seconds));
mbed_official 87:085cde657901 971
mbed_official 87:085cde657901 972 if(sAlarm->AlarmDateWeekDaySel == RTC_ALARMDATEWEEKDAYSEL_DATE)
mbed_official 87:085cde657901 973 {
mbed_official 87:085cde657901 974 assert_param(IS_RTC_ALARM_DATE_WEEKDAY_DATE(sAlarm->AlarmDateWeekDay));
mbed_official 87:085cde657901 975 }
mbed_official 87:085cde657901 976 else
mbed_official 87:085cde657901 977 {
mbed_official 87:085cde657901 978 assert_param(IS_RTC_ALARM_DATE_WEEKDAY_WEEKDAY(sAlarm->AlarmDateWeekDay));
mbed_official 87:085cde657901 979 }
mbed_official 87:085cde657901 980 tmpreg = (((uint32_t)RTC_ByteToBcd2(sAlarm->AlarmTime.Hours) << 16) | \
mbed_official 87:085cde657901 981 ((uint32_t)RTC_ByteToBcd2(sAlarm->AlarmTime.Minutes) << 8) | \
mbed_official 87:085cde657901 982 ((uint32_t)RTC_ByteToBcd2(sAlarm->AlarmTime.Seconds)) | \
mbed_official 87:085cde657901 983 ((uint32_t)(sAlarm->AlarmTime.TimeFormat) << 16) | \
mbed_official 87:085cde657901 984 ((uint32_t)RTC_ByteToBcd2(sAlarm->AlarmDateWeekDay) << 24) | \
mbed_official 87:085cde657901 985 ((uint32_t)sAlarm->AlarmDateWeekDaySel) | \
mbed_official 87:085cde657901 986 ((uint32_t)sAlarm->AlarmMask));
mbed_official 87:085cde657901 987 }
mbed_official 87:085cde657901 988 else
mbed_official 87:085cde657901 989 {
mbed_official 87:085cde657901 990 if((hrtc->Instance->CR & RTC_CR_FMT) != (uint32_t)RESET)
mbed_official 87:085cde657901 991 {
mbed_official 87:085cde657901 992 tmpreg = RTC_Bcd2ToByte(sAlarm->AlarmTime.Hours);
mbed_official 87:085cde657901 993 assert_param(IS_RTC_HOUR12(tmpreg));
mbed_official 87:085cde657901 994 assert_param(IS_RTC_HOURFORMAT12(sAlarm->AlarmTime.TimeFormat));
mbed_official 87:085cde657901 995 }
mbed_official 87:085cde657901 996 else
mbed_official 87:085cde657901 997 {
mbed_official 87:085cde657901 998 sAlarm->AlarmTime.TimeFormat = 0x00;
mbed_official 87:085cde657901 999 assert_param(IS_RTC_HOUR24(RTC_Bcd2ToByte(sAlarm->AlarmTime.Hours)));
mbed_official 87:085cde657901 1000 }
mbed_official 87:085cde657901 1001
mbed_official 87:085cde657901 1002 assert_param(IS_RTC_MINUTES(RTC_Bcd2ToByte(sAlarm->AlarmTime.Minutes)));
mbed_official 87:085cde657901 1003 assert_param(IS_RTC_SECONDS(RTC_Bcd2ToByte(sAlarm->AlarmTime.Seconds)));
mbed_official 87:085cde657901 1004
mbed_official 87:085cde657901 1005 if(sAlarm->AlarmDateWeekDaySel == RTC_ALARMDATEWEEKDAYSEL_DATE)
mbed_official 87:085cde657901 1006 {
mbed_official 87:085cde657901 1007 tmpreg = RTC_Bcd2ToByte(sAlarm->AlarmDateWeekDay);
mbed_official 87:085cde657901 1008 assert_param(IS_RTC_ALARM_DATE_WEEKDAY_DATE(tmpreg));
mbed_official 87:085cde657901 1009 }
mbed_official 87:085cde657901 1010 else
mbed_official 87:085cde657901 1011 {
mbed_official 87:085cde657901 1012 tmpreg = RTC_Bcd2ToByte(sAlarm->AlarmDateWeekDay);
mbed_official 87:085cde657901 1013 assert_param(IS_RTC_ALARM_DATE_WEEKDAY_WEEKDAY(tmpreg));
mbed_official 87:085cde657901 1014 }
mbed_official 87:085cde657901 1015 tmpreg = (((uint32_t)(sAlarm->AlarmTime.Hours) << 16) | \
mbed_official 87:085cde657901 1016 ((uint32_t)(sAlarm->AlarmTime.Minutes) << 8) | \
mbed_official 87:085cde657901 1017 ((uint32_t) sAlarm->AlarmTime.Seconds) | \
mbed_official 87:085cde657901 1018 ((uint32_t)(sAlarm->AlarmTime.TimeFormat) << 16) | \
mbed_official 87:085cde657901 1019 ((uint32_t)(sAlarm->AlarmDateWeekDay) << 24) | \
mbed_official 87:085cde657901 1020 ((uint32_t)sAlarm->AlarmDateWeekDaySel) | \
mbed_official 87:085cde657901 1021 ((uint32_t)sAlarm->AlarmMask));
mbed_official 87:085cde657901 1022 }
mbed_official 87:085cde657901 1023 /* Configure the Alarm A or Alarm B Sub Second registers */
mbed_official 87:085cde657901 1024 subsecondtmpreg = (uint32_t)((uint32_t)(sAlarm->AlarmTime.SubSeconds) | (uint32_t)(sAlarm->AlarmSubSecondMask));
mbed_official 87:085cde657901 1025
mbed_official 87:085cde657901 1026 /* Disable the write protection for RTC registers */
mbed_official 87:085cde657901 1027 __HAL_RTC_WRITEPROTECTION_DISABLE(hrtc);
mbed_official 87:085cde657901 1028
mbed_official 87:085cde657901 1029 /* Configure the Alarm register */
mbed_official 87:085cde657901 1030 if(sAlarm->Alarm == RTC_ALARM_A)
mbed_official 87:085cde657901 1031 {
mbed_official 87:085cde657901 1032 /* Disable the Alarm A interrupt */
mbed_official 87:085cde657901 1033 __HAL_RTC_ALARMA_DISABLE(hrtc);
mbed_official 106:ced8cbb51063 1034
mbed_official 106:ced8cbb51063 1035 /* Clear flag alarm A */
mbed_official 106:ced8cbb51063 1036 __HAL_RTC_ALARM_CLEAR_FLAG(hrtc, RTC_FLAG_ALRAF);
mbed_official 106:ced8cbb51063 1037
mbed_official 87:085cde657901 1038 timeout = HAL_GetTick() + RTC_TIMEOUT_VALUE;
mbed_official 87:085cde657901 1039 /* Wait till RTC ALRAWF flag is set and if Time out is reached exit */
mbed_official 87:085cde657901 1040 while(__HAL_RTC_ALARM_GET_FLAG(hrtc, RTC_FLAG_ALRAWF) == RESET)
mbed_official 87:085cde657901 1041 {
mbed_official 87:085cde657901 1042 if(HAL_GetTick() >= timeout)
mbed_official 87:085cde657901 1043 {
mbed_official 87:085cde657901 1044 /* Enable the write protection for RTC registers */
mbed_official 87:085cde657901 1045 __HAL_RTC_WRITEPROTECTION_ENABLE(hrtc);
mbed_official 87:085cde657901 1046
mbed_official 87:085cde657901 1047 hrtc->State = HAL_RTC_STATE_TIMEOUT;
mbed_official 87:085cde657901 1048
mbed_official 87:085cde657901 1049 /* Process Unlocked */
mbed_official 87:085cde657901 1050 __HAL_UNLOCK(hrtc);
mbed_official 87:085cde657901 1051
mbed_official 87:085cde657901 1052 return HAL_TIMEOUT;
mbed_official 87:085cde657901 1053 }
mbed_official 87:085cde657901 1054 }
mbed_official 87:085cde657901 1055
mbed_official 87:085cde657901 1056 hrtc->Instance->ALRMAR = (uint32_t)tmpreg;
mbed_official 87:085cde657901 1057 /* Configure the Alarm A Sub Second register */
mbed_official 87:085cde657901 1058 hrtc->Instance->ALRMASSR = subsecondtmpreg;
mbed_official 87:085cde657901 1059 /* Configure the Alarm state: Enable Alarm */
mbed_official 87:085cde657901 1060 __HAL_RTC_ALARMA_ENABLE(hrtc);
mbed_official 87:085cde657901 1061 /* Configure the Alarm interrupt */
mbed_official 87:085cde657901 1062 __HAL_RTC_ALARM_ENABLE_IT(hrtc,RTC_IT_ALRA);
mbed_official 87:085cde657901 1063 }
mbed_official 87:085cde657901 1064 else
mbed_official 87:085cde657901 1065 {
mbed_official 87:085cde657901 1066 /* Disable the Alarm B interrupt */
mbed_official 87:085cde657901 1067 __HAL_RTC_ALARMB_DISABLE(hrtc);
mbed_official 106:ced8cbb51063 1068
mbed_official 106:ced8cbb51063 1069 /* Clear flag alarm B */
mbed_official 106:ced8cbb51063 1070 __HAL_RTC_ALARM_CLEAR_FLAG(hrtc, RTC_FLAG_ALRBF);
mbed_official 106:ced8cbb51063 1071
mbed_official 87:085cde657901 1072 timeout = HAL_GetTick() + RTC_TIMEOUT_VALUE;
mbed_official 87:085cde657901 1073 /* Wait till RTC ALRBWF flag is set and if Time out is reached exit */
mbed_official 87:085cde657901 1074 while(__HAL_RTC_ALARM_GET_FLAG(hrtc, RTC_FLAG_ALRBWF) == RESET)
mbed_official 87:085cde657901 1075 {
mbed_official 87:085cde657901 1076 if(HAL_GetTick() >= timeout)
mbed_official 87:085cde657901 1077 {
mbed_official 87:085cde657901 1078 /* Enable the write protection for RTC registers */
mbed_official 87:085cde657901 1079 __HAL_RTC_WRITEPROTECTION_ENABLE(hrtc);
mbed_official 87:085cde657901 1080
mbed_official 87:085cde657901 1081 hrtc->State = HAL_RTC_STATE_TIMEOUT;
mbed_official 87:085cde657901 1082
mbed_official 87:085cde657901 1083 /* Process Unlocked */
mbed_official 87:085cde657901 1084 __HAL_UNLOCK(hrtc);
mbed_official 87:085cde657901 1085
mbed_official 87:085cde657901 1086 return HAL_TIMEOUT;
mbed_official 87:085cde657901 1087 }
mbed_official 87:085cde657901 1088 }
mbed_official 87:085cde657901 1089
mbed_official 87:085cde657901 1090 hrtc->Instance->ALRMBR = (uint32_t)tmpreg;
mbed_official 87:085cde657901 1091 /* Configure the Alarm B Sub Second register */
mbed_official 87:085cde657901 1092 hrtc->Instance->ALRMBSSR = subsecondtmpreg;
mbed_official 87:085cde657901 1093 /* Configure the Alarm state: Enable Alarm */
mbed_official 87:085cde657901 1094 __HAL_RTC_ALARMB_ENABLE(hrtc);
mbed_official 87:085cde657901 1095 /* Configure the Alarm interrupt */
mbed_official 87:085cde657901 1096 __HAL_RTC_ALARM_ENABLE_IT(hrtc, RTC_IT_ALRB);
mbed_official 87:085cde657901 1097 }
mbed_official 87:085cde657901 1098
mbed_official 87:085cde657901 1099 /* RTC Alarm Interrupt Configuration: EXTI configuration */
mbed_official 87:085cde657901 1100 __HAL_RTC_ENABLE_IT(RTC_EXTI_LINE_ALARM_EVENT);
mbed_official 87:085cde657901 1101
mbed_official 87:085cde657901 1102 EXTI->RTSR |= RTC_EXTI_LINE_ALARM_EVENT;
mbed_official 87:085cde657901 1103
mbed_official 87:085cde657901 1104 /* Enable the write protection for RTC registers */
mbed_official 87:085cde657901 1105 __HAL_RTC_WRITEPROTECTION_ENABLE(hrtc);
mbed_official 87:085cde657901 1106
mbed_official 87:085cde657901 1107 hrtc->State = HAL_RTC_STATE_READY;
mbed_official 87:085cde657901 1108
mbed_official 87:085cde657901 1109 /* Process Unlocked */
mbed_official 87:085cde657901 1110 __HAL_UNLOCK(hrtc);
mbed_official 87:085cde657901 1111
mbed_official 87:085cde657901 1112 return HAL_OK;
mbed_official 87:085cde657901 1113 }
mbed_official 87:085cde657901 1114
mbed_official 87:085cde657901 1115 /**
mbed_official 87:085cde657901 1116 * @brief Deactive the specified RTC Alarm
mbed_official 226:b062af740e40 1117 * @param hrtc: pointer to a RTC_HandleTypeDef structure that contains
mbed_official 226:b062af740e40 1118 * the configuration information for RTC.
mbed_official 87:085cde657901 1119 * @param Alarm: Specifies the Alarm.
mbed_official 87:085cde657901 1120 * This parameter can be one of the following values:
mbed_official 226:b062af740e40 1121 * @arg RTC_ALARM_A: AlarmA
mbed_official 226:b062af740e40 1122 * @arg RTC_ALARM_B: AlarmB
mbed_official 87:085cde657901 1123 * @retval HAL status
mbed_official 87:085cde657901 1124 */
mbed_official 87:085cde657901 1125 HAL_StatusTypeDef HAL_RTC_DeactivateAlarm(RTC_HandleTypeDef *hrtc, uint32_t Alarm)
mbed_official 87:085cde657901 1126 {
mbed_official 87:085cde657901 1127 uint32_t timeout = 0;
mbed_official 87:085cde657901 1128
mbed_official 87:085cde657901 1129 /* Check the parameters */
mbed_official 87:085cde657901 1130 assert_param(IS_ALARM(Alarm));
mbed_official 87:085cde657901 1131
mbed_official 87:085cde657901 1132 /* Process Locked */
mbed_official 87:085cde657901 1133 __HAL_LOCK(hrtc);
mbed_official 87:085cde657901 1134
mbed_official 87:085cde657901 1135 hrtc->State = HAL_RTC_STATE_BUSY;
mbed_official 87:085cde657901 1136
mbed_official 87:085cde657901 1137 /* Disable the write protection for RTC registers */
mbed_official 87:085cde657901 1138 __HAL_RTC_WRITEPROTECTION_DISABLE(hrtc);
mbed_official 87:085cde657901 1139
mbed_official 87:085cde657901 1140 if(Alarm == RTC_ALARM_A)
mbed_official 87:085cde657901 1141 {
mbed_official 87:085cde657901 1142 /* AlarmA */
mbed_official 87:085cde657901 1143 __HAL_RTC_ALARMA_DISABLE(hrtc);
mbed_official 87:085cde657901 1144
mbed_official 87:085cde657901 1145 /* In case of interrupt mode is used, the interrupt source must disabled */
mbed_official 87:085cde657901 1146 __HAL_RTC_ALARM_DISABLE_IT(hrtc, RTC_IT_ALRA);
mbed_official 87:085cde657901 1147
mbed_official 87:085cde657901 1148 timeout = HAL_GetTick() + RTC_TIMEOUT_VALUE;
mbed_official 87:085cde657901 1149
mbed_official 87:085cde657901 1150 /* Wait till RTC ALRxWF flag is set and if Time out is reached exit */
mbed_official 87:085cde657901 1151 while(__HAL_RTC_ALARM_GET_FLAG(hrtc, RTC_FLAG_ALRAWF) == RESET)
mbed_official 87:085cde657901 1152 {
mbed_official 87:085cde657901 1153 if(HAL_GetTick() >= timeout)
mbed_official 87:085cde657901 1154 {
mbed_official 87:085cde657901 1155 /* Enable the write protection for RTC registers */
mbed_official 87:085cde657901 1156 __HAL_RTC_WRITEPROTECTION_ENABLE(hrtc);
mbed_official 87:085cde657901 1157
mbed_official 87:085cde657901 1158 hrtc->State = HAL_RTC_STATE_TIMEOUT;
mbed_official 87:085cde657901 1159
mbed_official 87:085cde657901 1160 /* Process Unlocked */
mbed_official 87:085cde657901 1161 __HAL_UNLOCK(hrtc);
mbed_official 87:085cde657901 1162
mbed_official 87:085cde657901 1163 return HAL_TIMEOUT;
mbed_official 87:085cde657901 1164 }
mbed_official 87:085cde657901 1165 }
mbed_official 87:085cde657901 1166 }
mbed_official 87:085cde657901 1167 else
mbed_official 87:085cde657901 1168 {
mbed_official 87:085cde657901 1169 /* AlarmB */
mbed_official 87:085cde657901 1170 __HAL_RTC_ALARMB_DISABLE(hrtc);
mbed_official 87:085cde657901 1171
mbed_official 87:085cde657901 1172 /* In case of interrupt mode is used, the interrupt source must disabled */
mbed_official 87:085cde657901 1173 __HAL_RTC_ALARM_DISABLE_IT(hrtc,RTC_IT_ALRB);
mbed_official 87:085cde657901 1174
mbed_official 87:085cde657901 1175 timeout = HAL_GetTick() + RTC_TIMEOUT_VALUE;
mbed_official 87:085cde657901 1176
mbed_official 87:085cde657901 1177 /* Wait till RTC ALRxWF flag is set and if Time out is reached exit */
mbed_official 87:085cde657901 1178 while(__HAL_RTC_ALARM_GET_FLAG(hrtc, RTC_FLAG_ALRBWF) == RESET)
mbed_official 87:085cde657901 1179 {
mbed_official 87:085cde657901 1180 if(HAL_GetTick() >= timeout)
mbed_official 87:085cde657901 1181 {
mbed_official 87:085cde657901 1182 /* Enable the write protection for RTC registers */
mbed_official 87:085cde657901 1183 __HAL_RTC_WRITEPROTECTION_ENABLE(hrtc);
mbed_official 87:085cde657901 1184
mbed_official 87:085cde657901 1185 hrtc->State = HAL_RTC_STATE_TIMEOUT;
mbed_official 87:085cde657901 1186
mbed_official 87:085cde657901 1187 /* Process Unlocked */
mbed_official 87:085cde657901 1188 __HAL_UNLOCK(hrtc);
mbed_official 87:085cde657901 1189
mbed_official 87:085cde657901 1190 return HAL_TIMEOUT;
mbed_official 87:085cde657901 1191 }
mbed_official 87:085cde657901 1192 }
mbed_official 87:085cde657901 1193 }
mbed_official 87:085cde657901 1194 /* Enable the write protection for RTC registers */
mbed_official 87:085cde657901 1195 __HAL_RTC_WRITEPROTECTION_ENABLE(hrtc);
mbed_official 87:085cde657901 1196
mbed_official 87:085cde657901 1197 hrtc->State = HAL_RTC_STATE_READY;
mbed_official 87:085cde657901 1198
mbed_official 87:085cde657901 1199 /* Process Unlocked */
mbed_official 87:085cde657901 1200 __HAL_UNLOCK(hrtc);
mbed_official 87:085cde657901 1201
mbed_official 87:085cde657901 1202 return HAL_OK;
mbed_official 87:085cde657901 1203 }
mbed_official 87:085cde657901 1204
mbed_official 87:085cde657901 1205 /**
mbed_official 87:085cde657901 1206 * @brief Gets the RTC Alarm value and masks.
mbed_official 226:b062af740e40 1207 * @param hrtc: pointer to a RTC_HandleTypeDef structure that contains
mbed_official 226:b062af740e40 1208 * the configuration information for RTC.
mbed_official 87:085cde657901 1209 * @param sAlarm: Pointer to Date structure
mbed_official 226:b062af740e40 1210 * @param Alarm: Specifies the Alarm.
mbed_official 87:085cde657901 1211 * This parameter can be one of the following values:
mbed_official 226:b062af740e40 1212 * @arg RTC_ALARM_A: AlarmA
mbed_official 226:b062af740e40 1213 * @arg RTC_ALARM_B: AlarmB
mbed_official 87:085cde657901 1214 * @param Format: Specifies the format of the entered parameters.
mbed_official 87:085cde657901 1215 * This parameter can be one of the following values:
mbed_official 226:b062af740e40 1216 * @arg FORMAT_BIN: Binary data format
mbed_official 226:b062af740e40 1217 * @arg FORMAT_BCD: BCD data format
mbed_official 87:085cde657901 1218 * @retval HAL status
mbed_official 87:085cde657901 1219 */
mbed_official 87:085cde657901 1220 HAL_StatusTypeDef HAL_RTC_GetAlarm(RTC_HandleTypeDef *hrtc, RTC_AlarmTypeDef *sAlarm, uint32_t Alarm, uint32_t Format)
mbed_official 87:085cde657901 1221 {
mbed_official 87:085cde657901 1222 uint32_t tmpreg = 0, subsecondtmpreg = 0;
mbed_official 87:085cde657901 1223
mbed_official 87:085cde657901 1224 /* Check the parameters */
mbed_official 87:085cde657901 1225 assert_param(IS_RTC_FORMAT(Format));
mbed_official 87:085cde657901 1226 assert_param(IS_ALARM(Alarm));
mbed_official 87:085cde657901 1227
mbed_official 87:085cde657901 1228 if(Alarm == RTC_ALARM_A)
mbed_official 87:085cde657901 1229 {
mbed_official 87:085cde657901 1230 /* AlarmA */
mbed_official 87:085cde657901 1231 sAlarm->Alarm = RTC_ALARM_A;
mbed_official 87:085cde657901 1232
mbed_official 87:085cde657901 1233 tmpreg = (uint32_t)(hrtc->Instance->ALRMAR);
mbed_official 87:085cde657901 1234 subsecondtmpreg = (uint32_t)((hrtc->Instance->ALRMASSR ) & RTC_ALRMASSR_SS);
mbed_official 87:085cde657901 1235 }
mbed_official 87:085cde657901 1236 else
mbed_official 87:085cde657901 1237 {
mbed_official 87:085cde657901 1238 sAlarm->Alarm = RTC_ALARM_B;
mbed_official 87:085cde657901 1239
mbed_official 87:085cde657901 1240 tmpreg = (uint32_t)(hrtc->Instance->ALRMBR);
mbed_official 87:085cde657901 1241 subsecondtmpreg = (uint32_t)((hrtc->Instance->ALRMBSSR) & RTC_ALRMBSSR_SS);
mbed_official 87:085cde657901 1242 }
mbed_official 87:085cde657901 1243
mbed_official 87:085cde657901 1244 /* Fill the structure with the read parameters */
mbed_official 87:085cde657901 1245 sAlarm->AlarmTime.Hours = (uint32_t)((tmpreg & (RTC_ALRMAR_HT | RTC_ALRMAR_HU)) >> 16);
mbed_official 87:085cde657901 1246 sAlarm->AlarmTime.Minutes = (uint32_t)((tmpreg & (RTC_ALRMAR_MNT | RTC_ALRMAR_MNU)) >> 8);
mbed_official 87:085cde657901 1247 sAlarm->AlarmTime.Seconds = (uint32_t)(tmpreg & (RTC_ALRMAR_ST | RTC_ALRMAR_SU));
mbed_official 87:085cde657901 1248 sAlarm->AlarmTime.TimeFormat = (uint32_t)((tmpreg & RTC_ALRMAR_PM) >> 16);
mbed_official 87:085cde657901 1249 sAlarm->AlarmTime.SubSeconds = (uint32_t) subsecondtmpreg;
mbed_official 87:085cde657901 1250 sAlarm->AlarmDateWeekDay = (uint32_t)((tmpreg & (RTC_ALRMAR_DT | RTC_ALRMAR_DU)) >> 24);
mbed_official 87:085cde657901 1251 sAlarm->AlarmDateWeekDaySel = (uint32_t)(tmpreg & RTC_ALRMAR_WDSEL);
mbed_official 87:085cde657901 1252 sAlarm->AlarmMask = (uint32_t)(tmpreg & RTC_ALARMMASK_ALL);
mbed_official 87:085cde657901 1253
mbed_official 87:085cde657901 1254 if(Format == FORMAT_BIN)
mbed_official 87:085cde657901 1255 {
mbed_official 87:085cde657901 1256 sAlarm->AlarmTime.Hours = RTC_Bcd2ToByte(sAlarm->AlarmTime.Hours);
mbed_official 87:085cde657901 1257 sAlarm->AlarmTime.Minutes = RTC_Bcd2ToByte(sAlarm->AlarmTime.Minutes);
mbed_official 87:085cde657901 1258 sAlarm->AlarmTime.Seconds = RTC_Bcd2ToByte(sAlarm->AlarmTime.Seconds);
mbed_official 87:085cde657901 1259 sAlarm->AlarmDateWeekDay = RTC_Bcd2ToByte(sAlarm->AlarmDateWeekDay);
mbed_official 87:085cde657901 1260 }
mbed_official 87:085cde657901 1261
mbed_official 87:085cde657901 1262 return HAL_OK;
mbed_official 87:085cde657901 1263 }
mbed_official 87:085cde657901 1264
mbed_official 87:085cde657901 1265 /**
mbed_official 87:085cde657901 1266 * @brief This function handles Alarm interrupt request.
mbed_official 226:b062af740e40 1267 * @param hrtc: pointer to a RTC_HandleTypeDef structure that contains
mbed_official 226:b062af740e40 1268 * the configuration information for RTC.
mbed_official 87:085cde657901 1269 * @retval None
mbed_official 87:085cde657901 1270 */
mbed_official 87:085cde657901 1271 void HAL_RTC_AlarmIRQHandler(RTC_HandleTypeDef* hrtc)
mbed_official 87:085cde657901 1272 {
mbed_official 87:085cde657901 1273 if(__HAL_RTC_ALARM_GET_IT(hrtc, RTC_IT_ALRA))
mbed_official 87:085cde657901 1274 {
mbed_official 87:085cde657901 1275 /* Get the status of the Interrupt */
mbed_official 87:085cde657901 1276 if((uint32_t)(hrtc->Instance->CR & RTC_IT_ALRA) != (uint32_t)RESET)
mbed_official 87:085cde657901 1277 {
mbed_official 87:085cde657901 1278 /* AlarmA callback */
mbed_official 87:085cde657901 1279 HAL_RTC_AlarmAEventCallback(hrtc);
mbed_official 87:085cde657901 1280
mbed_official 87:085cde657901 1281 /* Clear the Alarm interrupt pending bit */
mbed_official 87:085cde657901 1282 __HAL_RTC_ALARM_CLEAR_FLAG(hrtc,RTC_FLAG_ALRAF);
mbed_official 87:085cde657901 1283 }
mbed_official 87:085cde657901 1284 }
mbed_official 87:085cde657901 1285
mbed_official 87:085cde657901 1286 if(__HAL_RTC_ALARM_GET_IT(hrtc, RTC_IT_ALRB))
mbed_official 87:085cde657901 1287 {
mbed_official 87:085cde657901 1288 /* Get the status of the Interrupt */
mbed_official 87:085cde657901 1289 if((uint32_t)(hrtc->Instance->CR & RTC_IT_ALRB) != (uint32_t)RESET)
mbed_official 87:085cde657901 1290 {
mbed_official 87:085cde657901 1291 /* AlarmB callback */
mbed_official 87:085cde657901 1292 HAL_RTCEx_AlarmBEventCallback(hrtc);
mbed_official 87:085cde657901 1293
mbed_official 87:085cde657901 1294 /* Clear the Alarm interrupt pending bit */
mbed_official 87:085cde657901 1295 __HAL_RTC_ALARM_CLEAR_FLAG(hrtc,RTC_FLAG_ALRBF);
mbed_official 87:085cde657901 1296 }
mbed_official 87:085cde657901 1297 }
mbed_official 87:085cde657901 1298
mbed_official 87:085cde657901 1299 /* Clear the EXTI's line Flag for RTC Alarm */
mbed_official 87:085cde657901 1300 __HAL_RTC_CLEAR_FLAG(RTC_EXTI_LINE_ALARM_EVENT);
mbed_official 87:085cde657901 1301
mbed_official 87:085cde657901 1302 /* Change RTC state */
mbed_official 87:085cde657901 1303 hrtc->State = HAL_RTC_STATE_READY;
mbed_official 87:085cde657901 1304 }
mbed_official 87:085cde657901 1305
mbed_official 87:085cde657901 1306 /**
mbed_official 87:085cde657901 1307 * @brief Alarm A callback.
mbed_official 226:b062af740e40 1308 * @param hrtc: pointer to a RTC_HandleTypeDef structure that contains
mbed_official 226:b062af740e40 1309 * the configuration information for RTC.
mbed_official 87:085cde657901 1310 * @retval None
mbed_official 87:085cde657901 1311 */
mbed_official 87:085cde657901 1312 __weak void HAL_RTC_AlarmAEventCallback(RTC_HandleTypeDef *hrtc)
mbed_official 87:085cde657901 1313 {
mbed_official 87:085cde657901 1314 /* NOTE : This function Should not be modified, when the callback is needed,
mbed_official 87:085cde657901 1315 the HAL_RTC_AlarmAEventCallback could be implemented in the user file
mbed_official 87:085cde657901 1316 */
mbed_official 87:085cde657901 1317 }
mbed_official 87:085cde657901 1318
mbed_official 87:085cde657901 1319 /**
mbed_official 87:085cde657901 1320 * @brief This function handles AlarmA Polling request.
mbed_official 226:b062af740e40 1321 * @param hrtc: pointer to a RTC_HandleTypeDef structure that contains
mbed_official 226:b062af740e40 1322 * the configuration information for RTC.
mbed_official 87:085cde657901 1323 * @param Timeout: Timeout duration
mbed_official 87:085cde657901 1324 * @retval HAL status
mbed_official 87:085cde657901 1325 */
mbed_official 87:085cde657901 1326 HAL_StatusTypeDef HAL_RTC_PollForAlarmAEvent(RTC_HandleTypeDef *hrtc, uint32_t Timeout)
mbed_official 87:085cde657901 1327 {
mbed_official 87:085cde657901 1328
mbed_official 87:085cde657901 1329 uint32_t timeout = 0;
mbed_official 87:085cde657901 1330
mbed_official 87:085cde657901 1331 /* Get Timeout value */
mbed_official 87:085cde657901 1332 timeout = HAL_GetTick() + Timeout;
mbed_official 87:085cde657901 1333
mbed_official 87:085cde657901 1334 while(__HAL_RTC_ALARM_GET_FLAG(hrtc, RTC_FLAG_ALRAF) == RESET)
mbed_official 87:085cde657901 1335 {
mbed_official 87:085cde657901 1336 if(Timeout != HAL_MAX_DELAY)
mbed_official 87:085cde657901 1337 {
mbed_official 87:085cde657901 1338 if(HAL_GetTick() >= timeout)
mbed_official 87:085cde657901 1339 {
mbed_official 87:085cde657901 1340 hrtc->State = HAL_RTC_STATE_TIMEOUT;
mbed_official 87:085cde657901 1341 return HAL_TIMEOUT;
mbed_official 87:085cde657901 1342 }
mbed_official 87:085cde657901 1343 }
mbed_official 87:085cde657901 1344 }
mbed_official 87:085cde657901 1345
mbed_official 87:085cde657901 1346 /* Clear the Alarm interrupt pending bit */
mbed_official 87:085cde657901 1347 __HAL_RTC_ALARM_CLEAR_FLAG(hrtc, RTC_FLAG_ALRAF);
mbed_official 87:085cde657901 1348
mbed_official 87:085cde657901 1349 /* Change RTC state */
mbed_official 87:085cde657901 1350 hrtc->State = HAL_RTC_STATE_READY;
mbed_official 87:085cde657901 1351
mbed_official 87:085cde657901 1352 return HAL_OK;
mbed_official 87:085cde657901 1353 }
mbed_official 87:085cde657901 1354
mbed_official 87:085cde657901 1355 /**
mbed_official 87:085cde657901 1356 * @}
mbed_official 87:085cde657901 1357 */
mbed_official 87:085cde657901 1358
mbed_official 87:085cde657901 1359 /** @defgroup RTC_Group4 Peripheral Control functions
mbed_official 87:085cde657901 1360 * @brief Peripheral Control functions
mbed_official 87:085cde657901 1361 *
mbed_official 87:085cde657901 1362 @verbatim
mbed_official 87:085cde657901 1363 ===============================================================================
mbed_official 87:085cde657901 1364 ##### Peripheral Control functions #####
mbed_official 87:085cde657901 1365 ===============================================================================
mbed_official 87:085cde657901 1366 [..]
mbed_official 87:085cde657901 1367 This subsection provides functions allowing to
mbed_official 87:085cde657901 1368 (+) Wait for RTC Time and Date Synchronization
mbed_official 87:085cde657901 1369
mbed_official 87:085cde657901 1370 @endverbatim
mbed_official 87:085cde657901 1371 * @{
mbed_official 87:085cde657901 1372 */
mbed_official 87:085cde657901 1373
mbed_official 87:085cde657901 1374 /**
mbed_official 87:085cde657901 1375 * @brief Waits until the RTC Time and Date registers (RTC_TR and RTC_DR) are
mbed_official 87:085cde657901 1376 * synchronized with RTC APB clock.
mbed_official 87:085cde657901 1377 * @note The RTC Resynchronization mode is write protected, use the
mbed_official 87:085cde657901 1378 * __HAL_RTC_WRITEPROTECTION_DISABLE() before calling this function.
mbed_official 87:085cde657901 1379 * @note To read the calendar through the shadow registers after Calendar
mbed_official 87:085cde657901 1380 * initialization, calendar update or after wakeup from low power modes
mbed_official 87:085cde657901 1381 * the software must first clear the RSF flag.
mbed_official 87:085cde657901 1382 * The software must then wait until it is set again before reading
mbed_official 87:085cde657901 1383 * the calendar, which means that the calendar registers have been
mbed_official 87:085cde657901 1384 * correctly copied into the RTC_TR and RTC_DR shadow registers.
mbed_official 226:b062af740e40 1385 * @param hrtc: pointer to a RTC_HandleTypeDef structure that contains
mbed_official 226:b062af740e40 1386 * the configuration information for RTC.
mbed_official 87:085cde657901 1387 * @retval HAL status
mbed_official 87:085cde657901 1388 */
mbed_official 87:085cde657901 1389 HAL_StatusTypeDef HAL_RTC_WaitForSynchro(RTC_HandleTypeDef* hrtc)
mbed_official 87:085cde657901 1390 {
mbed_official 87:085cde657901 1391 uint32_t timeout = 0;
mbed_official 87:085cde657901 1392
mbed_official 87:085cde657901 1393 /* Clear RSF flag */
mbed_official 87:085cde657901 1394 hrtc->Instance->ISR &= (uint32_t)RTC_RSF_MASK;
mbed_official 87:085cde657901 1395
mbed_official 87:085cde657901 1396 timeout = HAL_GetTick() + RTC_TIMEOUT_VALUE;
mbed_official 87:085cde657901 1397
mbed_official 87:085cde657901 1398 /* Wait the registers to be synchronised */
mbed_official 87:085cde657901 1399 while((hrtc->Instance->ISR & RTC_ISR_RSF) == (uint32_t)RESET)
mbed_official 87:085cde657901 1400 {
mbed_official 87:085cde657901 1401 if(HAL_GetTick() >= timeout)
mbed_official 87:085cde657901 1402 {
mbed_official 87:085cde657901 1403 return HAL_TIMEOUT;
mbed_official 87:085cde657901 1404 }
mbed_official 87:085cde657901 1405 }
mbed_official 87:085cde657901 1406
mbed_official 87:085cde657901 1407 return HAL_OK;
mbed_official 87:085cde657901 1408 }
mbed_official 87:085cde657901 1409
mbed_official 87:085cde657901 1410 /** @defgroup RTC_Group5 Peripheral State functions
mbed_official 87:085cde657901 1411 * @brief Peripheral State functions
mbed_official 87:085cde657901 1412 *
mbed_official 87:085cde657901 1413 @verbatim
mbed_official 87:085cde657901 1414 ===============================================================================
mbed_official 87:085cde657901 1415 ##### Peripheral State functions #####
mbed_official 87:085cde657901 1416 ===============================================================================
mbed_official 87:085cde657901 1417 [..]
mbed_official 87:085cde657901 1418 This subsection provides functions allowing to
mbed_official 87:085cde657901 1419 (+) Get RTC state
mbed_official 87:085cde657901 1420
mbed_official 87:085cde657901 1421 @endverbatim
mbed_official 87:085cde657901 1422 * @{
mbed_official 87:085cde657901 1423 */
mbed_official 87:085cde657901 1424 /**
mbed_official 226:b062af740e40 1425 * @brief Returns the RTC state.
mbed_official 226:b062af740e40 1426 * @param hrtc: pointer to a RTC_HandleTypeDef structure that contains
mbed_official 226:b062af740e40 1427 * the configuration information for RTC.
mbed_official 87:085cde657901 1428 * @retval HAL state
mbed_official 87:085cde657901 1429 */
mbed_official 87:085cde657901 1430 HAL_RTCStateTypeDef HAL_RTC_GetState(RTC_HandleTypeDef* hrtc)
mbed_official 87:085cde657901 1431 {
mbed_official 87:085cde657901 1432 return hrtc->State;
mbed_official 87:085cde657901 1433 }
mbed_official 87:085cde657901 1434
mbed_official 87:085cde657901 1435 /**
mbed_official 87:085cde657901 1436 * @}
mbed_official 87:085cde657901 1437 */
mbed_official 87:085cde657901 1438
mbed_official 87:085cde657901 1439 /**
mbed_official 87:085cde657901 1440 * @brief Enters the RTC Initialization mode.
mbed_official 87:085cde657901 1441 * @note The RTC Initialization mode is write protected, use the
mbed_official 87:085cde657901 1442 * __HAL_RTC_WRITEPROTECTION_DISABLE() before calling this function.
mbed_official 226:b062af740e40 1443 * @param hrtc: pointer to a RTC_HandleTypeDef structure that contains
mbed_official 226:b062af740e40 1444 * the configuration information for RTC.
mbed_official 87:085cde657901 1445 * @retval HAL status
mbed_official 87:085cde657901 1446 */
mbed_official 87:085cde657901 1447 HAL_StatusTypeDef RTC_EnterInitMode(RTC_HandleTypeDef* hrtc)
mbed_official 87:085cde657901 1448 {
mbed_official 87:085cde657901 1449 uint32_t timeout = 0;
mbed_official 87:085cde657901 1450
mbed_official 87:085cde657901 1451 /* Check if the Initialization mode is set */
mbed_official 87:085cde657901 1452 if((hrtc->Instance->ISR & RTC_ISR_INITF) == (uint32_t)RESET)
mbed_official 87:085cde657901 1453 {
mbed_official 87:085cde657901 1454 /* Set the Initialization mode */
mbed_official 87:085cde657901 1455 hrtc->Instance->ISR = (uint32_t)RTC_INIT_MASK;
mbed_official 87:085cde657901 1456
mbed_official 87:085cde657901 1457 timeout = HAL_GetTick() + RTC_TIMEOUT_VALUE;
mbed_official 87:085cde657901 1458 /* Wait till RTC is in INIT state and if Time out is reached exit */
mbed_official 87:085cde657901 1459 while((hrtc->Instance->ISR & RTC_ISR_INITF) == (uint32_t)RESET)
mbed_official 87:085cde657901 1460 {
mbed_official 87:085cde657901 1461 if(HAL_GetTick() >= timeout)
mbed_official 87:085cde657901 1462 {
mbed_official 87:085cde657901 1463 return HAL_TIMEOUT;
mbed_official 87:085cde657901 1464 }
mbed_official 87:085cde657901 1465 }
mbed_official 87:085cde657901 1466 }
mbed_official 87:085cde657901 1467
mbed_official 87:085cde657901 1468 return HAL_OK;
mbed_official 87:085cde657901 1469 }
mbed_official 87:085cde657901 1470
mbed_official 87:085cde657901 1471
mbed_official 87:085cde657901 1472 /**
mbed_official 87:085cde657901 1473 * @brief Converts a 2 digit decimal to BCD format.
mbed_official 87:085cde657901 1474 * @param Value: Byte to be converted
mbed_official 87:085cde657901 1475 * @retval Converted byte
mbed_official 87:085cde657901 1476 */
mbed_official 87:085cde657901 1477 uint8_t RTC_ByteToBcd2(uint8_t Value)
mbed_official 87:085cde657901 1478 {
mbed_official 87:085cde657901 1479 uint32_t bcdhigh = 0;
mbed_official 87:085cde657901 1480
mbed_official 87:085cde657901 1481 while(Value >= 10)
mbed_official 87:085cde657901 1482 {
mbed_official 87:085cde657901 1483 bcdhigh++;
mbed_official 87:085cde657901 1484 Value -= 10;
mbed_official 87:085cde657901 1485 }
mbed_official 87:085cde657901 1486
mbed_official 87:085cde657901 1487 return ((uint8_t)(bcdhigh << 4) | Value);
mbed_official 87:085cde657901 1488 }
mbed_official 87:085cde657901 1489
mbed_official 87:085cde657901 1490 /**
mbed_official 87:085cde657901 1491 * @brief Converts from 2 digit BCD to Binary.
mbed_official 87:085cde657901 1492 * @param Value: BCD value to be converted
mbed_official 87:085cde657901 1493 * @retval Converted word
mbed_official 87:085cde657901 1494 */
mbed_official 87:085cde657901 1495 uint8_t RTC_Bcd2ToByte(uint8_t Value)
mbed_official 87:085cde657901 1496 {
mbed_official 87:085cde657901 1497 uint32_t tmp = 0;
mbed_official 87:085cde657901 1498 tmp = ((uint8_t)(Value & (uint8_t)0xF0) >> (uint8_t)0x4) * 10;
mbed_official 87:085cde657901 1499 return (tmp + (Value & (uint8_t)0x0F));
mbed_official 87:085cde657901 1500 }
mbed_official 87:085cde657901 1501
mbed_official 87:085cde657901 1502 /**
mbed_official 87:085cde657901 1503 * @}
mbed_official 87:085cde657901 1504 */
mbed_official 87:085cde657901 1505
mbed_official 87:085cde657901 1506 #endif /* HAL_RTC_MODULE_ENABLED */
mbed_official 87:085cde657901 1507 /**
mbed_official 87:085cde657901 1508 * @}
mbed_official 87:085cde657901 1509 */
mbed_official 87:085cde657901 1510
mbed_official 87:085cde657901 1511 /**
mbed_official 87:085cde657901 1512 * @}
mbed_official 87:085cde657901 1513 */
mbed_official 87:085cde657901 1514
mbed_official 87:085cde657901 1515 /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/