mbed-src - mbed library sources

Users » marcusC » Code » mbed-src

marcus chiou / mbed-src

mbed library sources

Fork of mbed-src by mbed official

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

Committer:: mbed_official
Date:: Thu Aug 20 10:45:13 2015 +0100
Revision:: 613:bc40b8d2aec4
Parent:: 532:fe11edbda85c

Synchronized with git revision 92ca8c7b60a283b6bb60eb65b183dac1599f0ade

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

Nordic: update application start address in GCC linker script

Who changed what in which revision?

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

Repository toolbox

Export to desktop IDE

Repository details

Type:	Library
Created:	27 Oct 2015
Imports:	0
Forks:	0
Commits:	637
Dependents:	0
Dependencies:	0
Followers:	1

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

Who changed what in which revision?

Repository toolbox

Repository details

Important Information for this Arm website

Access Warning