mbed-dev | Mbed

Users » 1050186 » Code » mbed-dev

targets/cmsis/TARGET_STM/TARGET_STM32F3XX/stm32f30x_rtc.c@103:493a29d2d4d7, 2016-03-30 (annotated)

Committer:: 1050186
Date:: Wed Mar 30 11:41:25 2016 +0000
Revision:: 103:493a29d2d4d7
Parent:: 0:9b334a45a8ff

GR-PEACH runs on RAM.

Who changed what in which revision?

User	Revision	Line number	New contents of line
bogdanm	0:9b334a45a8ff	1	/**
bogdanm	0:9b334a45a8ff	2	******************************************************************************
bogdanm	0:9b334a45a8ff	3	* @file stm32f30x_rtc.c
bogdanm	0:9b334a45a8ff	4	* @author MCD Application Team
bogdanm	0:9b334a45a8ff	5	* @version V1.1.0
bogdanm	0:9b334a45a8ff	6	* @date 27-February-2014
bogdanm	0:9b334a45a8ff	7	* @brief This file provides firmware functions to manage the following
bogdanm	0:9b334a45a8ff	8	* functionalities of the Real-Time Clock (RTC) peripheral:
bogdanm	0:9b334a45a8ff	9	* + Initialization
bogdanm	0:9b334a45a8ff	10	* + Calendar (Time and Date) configuration
bogdanm	0:9b334a45a8ff	11	* + Alarms (Alarm A and Alarm B) configuration
bogdanm	0:9b334a45a8ff	12	* + WakeUp Timer configuration
bogdanm	0:9b334a45a8ff	13	* + Daylight Saving configuration
bogdanm	0:9b334a45a8ff	14	* + Output pin Configuration
bogdanm	0:9b334a45a8ff	15	* + Smooth digital Calibration configuration
bogdanm	0:9b334a45a8ff	16	* + TimeStamp configuration
bogdanm	0:9b334a45a8ff	17	* + Tampers configuration
bogdanm	0:9b334a45a8ff	18	* + Backup Data Registers configuration
bogdanm	0:9b334a45a8ff	19	* + Output Type Config configuration
bogdanm	0:9b334a45a8ff	20	* + Shift control synchronisation
bogdanm	0:9b334a45a8ff	21	* + Interrupts and flags management
bogdanm	0:9b334a45a8ff	22	*
bogdanm	0:9b334a45a8ff	23	@verbatim
bogdanm	0:9b334a45a8ff	24
bogdanm	0:9b334a45a8ff	25	===============================================================================
bogdanm	0:9b334a45a8ff	26	##### RTC Operating Condition #####
bogdanm	0:9b334a45a8ff	27	===============================================================================
bogdanm	0:9b334a45a8ff	28	[..] The real-time clock (RTC) and the RTC backup registers can be powered
bogdanm	0:9b334a45a8ff	29	from the VBAT voltage when the main VDD supply is powered off.
bogdanm	0:9b334a45a8ff	30	To retain the content of the RTC backup registers and supply the RTC
bogdanm	0:9b334a45a8ff	31	when VDD is turned off, VBAT pin can be connected to an optional
bogdanm	0:9b334a45a8ff	32	standby voltage supplied by a battery or by another source.
bogdanm	0:9b334a45a8ff	33
bogdanm	0:9b334a45a8ff	34	[..] To allow the RTC to operate even when the main digital supply (VDD)
bogdanm	0:9b334a45a8ff	35	is turned off, the VBAT pin powers the following blocks:
bogdanm	0:9b334a45a8ff	36	(#) The RTC
bogdanm	0:9b334a45a8ff	37	(#) The LSE oscillator
bogdanm	0:9b334a45a8ff	38	(#) PC13 to PC15 I/Os (when available)
bogdanm	0:9b334a45a8ff	39
bogdanm	0:9b334a45a8ff	40	[..] When the backup domain is supplied by VDD (analog switch connected
bogdanm	0:9b334a45a8ff	41	to VDD), the following functions are available:
bogdanm	0:9b334a45a8ff	42	(#) PC14 and PC15 can be used as either GPIO or LSE pins
bogdanm	0:9b334a45a8ff	43	(#) PC13 can be used as a GPIO or as the RTC_AF pin
bogdanm	0:9b334a45a8ff	44
bogdanm	0:9b334a45a8ff	45	[..] When the backup domain is supplied by VBAT (analog switch connected
bogdanm	0:9b334a45a8ff	46	to VBAT because VDD is not present), the following functions are available:
bogdanm	0:9b334a45a8ff	47	(#) PC14 and PC15 can be used as LSE pins only
bogdanm	0:9b334a45a8ff	48	(#) PC13 can be used as the RTC_AF pin
bogdanm	0:9b334a45a8ff	49
bogdanm	0:9b334a45a8ff	50	##### Backup Domain Reset #####
bogdanm	0:9b334a45a8ff	51	===============================================================================
bogdanm	0:9b334a45a8ff	52	[..] The backup domain reset sets all RTC registers and the RCC_BDCR
bogdanm	0:9b334a45a8ff	53	register to their reset values.
bogdanm	0:9b334a45a8ff	54	A backup domain reset is generated when one of the following events
bogdanm	0:9b334a45a8ff	55	occurs:
bogdanm	0:9b334a45a8ff	56	(#) Software reset, triggered by setting the BDRST bit in the
bogdanm	0:9b334a45a8ff	57	RCC Backup domain control register (RCC_BDCR). You can use the
bogdanm	0:9b334a45a8ff	58	RCC_BackupResetCmd().
bogdanm	0:9b334a45a8ff	59	(#) VDD or VBAT power on, if both supplies have previously been
bogdanm	0:9b334a45a8ff	60	powered off.
bogdanm	0:9b334a45a8ff	61
bogdanm	0:9b334a45a8ff	62	##### Backup Domain Access #####
bogdanm	0:9b334a45a8ff	63	===============================================================================
bogdanm	0:9b334a45a8ff	64	[..] After reset, the backup domain (RTC registers and RTC backup data
bogdanm	0:9b334a45a8ff	65	registers) is protected against possible unwanted write accesses.
bogdanm	0:9b334a45a8ff	66	[..] To enable access to the Backup Domain and RTC registers, proceed as follows:
bogdanm	0:9b334a45a8ff	67	(#) Enable the Power Controller (PWR) APB1 interface clock using the
bogdanm	0:9b334a45a8ff	68	RCC_APB1PeriphClockCmd() function.
bogdanm	0:9b334a45a8ff	69	(#) Enable access to Backup domain using the PWR_BackupAccessCmd() function.
bogdanm	0:9b334a45a8ff	70	(#) Select the RTC clock source using the RCC_RTCCLKConfig() function.
bogdanm	0:9b334a45a8ff	71	(#) Enable RTC Clock using the RCC_RTCCLKCmd() function.
bogdanm	0:9b334a45a8ff	72
bogdanm	0:9b334a45a8ff	73	##### How to use this driver #####
bogdanm	0:9b334a45a8ff	74	===============================================================================
bogdanm	0:9b334a45a8ff	75	[..]
bogdanm	0:9b334a45a8ff	76	(+) Enable the backup domain access (see description in the section above)
bogdanm	0:9b334a45a8ff	77	(+) Configure the RTC Prescaler (Asynchronous and Synchronous) and
bogdanm	0:9b334a45a8ff	78	RTC hour format using the RTC_Init() function.
bogdanm	0:9b334a45a8ff	79
bogdanm	0:9b334a45a8ff	80	* Time and Date configuration *
bogdanm	0:9b334a45a8ff	81	===================================
bogdanm	0:9b334a45a8ff	82	[..]
bogdanm	0:9b334a45a8ff	83	(+) To configure the RTC Calendar (Time and Date) use the RTC_SetTime()
bogdanm	0:9b334a45a8ff	84	and RTC_SetDate() functions.
bogdanm	0:9b334a45a8ff	85	(+) To read the RTC Calendar, use the RTC_GetTime() and RTC_GetDate()
bogdanm	0:9b334a45a8ff	86	functions.
bogdanm	0:9b334a45a8ff	87	(+) To read the RTC subsecond, use the RTC_GetSubSecond() function.
bogdanm	0:9b334a45a8ff	88	(+) Use the RTC_DayLightSavingConfig() function to add or sub one
bogdanm	0:9b334a45a8ff	89	hour to the RTC Calendar.
bogdanm	0:9b334a45a8ff	90
bogdanm	0:9b334a45a8ff	91	* Alarm configuration *
bogdanm	0:9b334a45a8ff	92	===========================
bogdanm	0:9b334a45a8ff	93	[..]
bogdanm	0:9b334a45a8ff	94	(+) To configure the RTC Alarm use the RTC_SetAlarm() function.
bogdanm	0:9b334a45a8ff	95	(+) Enable the selected RTC Alarm using the RTC_AlarmCmd() function.
bogdanm	0:9b334a45a8ff	96	(+) To read the RTC Alarm, use the RTC_GetAlarm() function.
bogdanm	0:9b334a45a8ff	97	(+) To read the RTC alarm SubSecond, use the RTC_GetAlarmSubSecond() function.
bogdanm	0:9b334a45a8ff	98
bogdanm	0:9b334a45a8ff	99	* RTC Wakeup configuration *
bogdanm	0:9b334a45a8ff	100	================================
bogdanm	0:9b334a45a8ff	101	[..]
bogdanm	0:9b334a45a8ff	102	(+) Configure the RTC Wakeup Clock source use the RTC_WakeUpClockConfig()
bogdanm	0:9b334a45a8ff	103	function.
bogdanm	0:9b334a45a8ff	104	(+) Configure the RTC WakeUp Counter using the RTC_SetWakeUpCounter()
bogdanm	0:9b334a45a8ff	105	function
bogdanm	0:9b334a45a8ff	106	(+) Enable the RTC WakeUp using the RTC_WakeUpCmd() function
bogdanm	0:9b334a45a8ff	107	(+) To read the RTC WakeUp Counter register, use the RTC_GetWakeUpCounter()
bogdanm	0:9b334a45a8ff	108	function.
bogdanm	0:9b334a45a8ff	109
bogdanm	0:9b334a45a8ff	110	* Outputs configuration *
bogdanm	0:9b334a45a8ff	111	=============================
bogdanm	0:9b334a45a8ff	112	[..] The RTC has 2 different outputs:
bogdanm	0:9b334a45a8ff	113	(+) AFO_ALARM: this output is used to manage the RTC Alarm A, Alarm B
bogdanm	0:9b334a45a8ff	114	and WaKeUp signals.
bogdanm	0:9b334a45a8ff	115	To output the selected RTC signal on RTC_AF pin, use the
bogdanm	0:9b334a45a8ff	116	RTC_OutputConfig() function.
bogdanm	0:9b334a45a8ff	117	(+) AFO_CALIB: this output is 512Hz signal or 1Hz .
bogdanm	0:9b334a45a8ff	118	To output the RTC Clock on RTC_AF pin, use the RTC_CalibOutputCmd()
bogdanm	0:9b334a45a8ff	119	function.
bogdanm	0:9b334a45a8ff	120
bogdanm	0:9b334a45a8ff	121	* Smooth digital Calibration configuration *
bogdanm	0:9b334a45a8ff	122	================================================
bogdanm	0:9b334a45a8ff	123	[..]
bogdanm	0:9b334a45a8ff	124	(+) Configure the RTC Original Digital Calibration Value and the corresponding
bogdanm	0:9b334a45a8ff	125	calibration cycle period (32s,16s and 8s) using the RTC_SmoothCalibConfig()
bogdanm	0:9b334a45a8ff	126	function.
bogdanm	0:9b334a45a8ff	127
bogdanm	0:9b334a45a8ff	128	* TimeStamp configuration *
bogdanm	0:9b334a45a8ff	129	===============================
bogdanm	0:9b334a45a8ff	130	[..]
bogdanm	0:9b334a45a8ff	131	(+) Configure the RTC_AF trigger and enables the RTC TimeStamp
bogdanm	0:9b334a45a8ff	132	using the RTC_TimeStampCmd() function.
bogdanm	0:9b334a45a8ff	133	(+) To read the RTC TimeStamp Time and Date register, use the
bogdanm	0:9b334a45a8ff	134	RTC_GetTimeStamp() function.
bogdanm	0:9b334a45a8ff	135	(+) To read the RTC TimeStamp SubSecond register, use the
bogdanm	0:9b334a45a8ff	136	RTC_GetTimeStampSubSecond() function.
bogdanm	0:9b334a45a8ff	137
bogdanm	0:9b334a45a8ff	138	* Tamper configuration *
bogdanm	0:9b334a45a8ff	139	============================
bogdanm	0:9b334a45a8ff	140	[..]
bogdanm	0:9b334a45a8ff	141	(+) Configure the Tamper filter count using RTC_TamperFilterConfig()
bogdanm	0:9b334a45a8ff	142	function.
bogdanm	0:9b334a45a8ff	143	(+) Configure the RTC Tamper trigger Edge or Level according to the Tamper
bogdanm	0:9b334a45a8ff	144	filter (if equal to 0 Edge else Level) value using the RTC_TamperConfig() function.
bogdanm	0:9b334a45a8ff	145	(+) Configure the Tamper sampling frequency using RTC_TamperSamplingFreqConfig()
bogdanm	0:9b334a45a8ff	146	function.
bogdanm	0:9b334a45a8ff	147	(+) Configure the Tamper precharge or discharge duration using
bogdanm	0:9b334a45a8ff	148	RTC_TamperPinsPrechargeDuration() function.
bogdanm	0:9b334a45a8ff	149	(+) Enable the Tamper Pull-UP using RTC_TamperPullUpDisableCmd() function.
bogdanm	0:9b334a45a8ff	150	(+) Enable the RTC Tamper using the RTC_TamperCmd() function.
bogdanm	0:9b334a45a8ff	151	(+) Enable the Time stamp on Tamper detection event using
bogdanm	0:9b334a45a8ff	152	RTC_TSOnTamperDetecCmd() function.
bogdanm	0:9b334a45a8ff	153
bogdanm	0:9b334a45a8ff	154	* Backup Data Registers configuration *
bogdanm	0:9b334a45a8ff	155	===========================================
bogdanm	0:9b334a45a8ff	156	[..]
bogdanm	0:9b334a45a8ff	157	(+) To write to the RTC Backup Data registers, use the RTC_WriteBackupRegister()
bogdanm	0:9b334a45a8ff	158	function.
bogdanm	0:9b334a45a8ff	159	(+) To read the RTC Backup Data registers, use the RTC_ReadBackupRegister()
bogdanm	0:9b334a45a8ff	160	function.
bogdanm	0:9b334a45a8ff	161
bogdanm	0:9b334a45a8ff	162	##### RTC and low power modes #####
bogdanm	0:9b334a45a8ff	163	===============================================================================
bogdanm	0:9b334a45a8ff	164	[..] The MCU can be woken up from a low power mode by an RTC alternate
bogdanm	0:9b334a45a8ff	165	function.
bogdanm	0:9b334a45a8ff	166	[..] The RTC alternate functions are the RTC alarms (Alarm A and Alarm B),
bogdanm	0:9b334a45a8ff	167	RTC wakeup, RTC tamper event detection and RTC time stamp event detection.
bogdanm	0:9b334a45a8ff	168	These RTC alternate functions can wake up the system from the Stop
bogdanm	0:9b334a45a8ff	169	and Standby lowpower modes.
bogdanm	0:9b334a45a8ff	170	The system can also wake up from low power modes without depending
bogdanm	0:9b334a45a8ff	171	on an external interrupt (Auto-wakeup mode), by using the RTC alarm
bogdanm	0:9b334a45a8ff	172	or the RTC wakeup events.
bogdanm	0:9b334a45a8ff	173	[..] The RTC provides a programmable time base for waking up from the
bogdanm	0:9b334a45a8ff	174	Stop or Standby mode at regular intervals.
bogdanm	0:9b334a45a8ff	175	Wakeup from STOP and Standby modes is possible only when the RTC
bogdanm	0:9b334a45a8ff	176	clock source is LSE or LSI.
bogdanm	0:9b334a45a8ff	177
bogdanm	0:9b334a45a8ff	178	##### Selection of RTC_AF alternate functions #####
bogdanm	0:9b334a45a8ff	179	===============================================================================
bogdanm	0:9b334a45a8ff	180	[..] The RTC_AF pin (PC13) can be used for the following purposes:
bogdanm	0:9b334a45a8ff	181	(+) Wakeup pin 2 (WKUP2) using the PWR_WakeUpPinCmd() function.
bogdanm	0:9b334a45a8ff	182	(+) AFO_ALARM output
bogdanm	0:9b334a45a8ff	183	(+) AFO_CALIB output
bogdanm	0:9b334a45a8ff	184	(+) AFI_TAMPER
bogdanm	0:9b334a45a8ff	185	(+) AFI_TIMESTAMP
bogdanm	0:9b334a45a8ff	186
bogdanm	0:9b334a45a8ff	187	+------------------------------------------------------------------------------------------+
bogdanm	0:9b334a45a8ff	188	\| Pin \|RTC ALARM \|RTC CALIB \|RTC TAMPER \|RTC TIMESTAMP \|PC13MODE\| PC13VALUE \|
bogdanm	0:9b334a45a8ff	189	\| configuration \| OUTPUT \| OUTPUT \| INPUT \| INPUT \| bit \| bit \|
bogdanm	0:9b334a45a8ff	190	\| and function \| ENABLED \| ENABLED \| ENABLED \| ENABLED \| \| \|
bogdanm	0:9b334a45a8ff	191	\|-----------------\|----------\|----------\|-----------\|--------------\|--------\|--------------\|
bogdanm	0:9b334a45a8ff	192	\| Alarm out \| \| \| \| \| Don't \| \|
bogdanm	0:9b334a45a8ff	193	\| output OD \| 1 \|Don't care\|Don't care \| Don't care \| care \| 0 \|
bogdanm	0:9b334a45a8ff	194	\|-----------------\|----------\|----------\|-----------\|--------------\|--------\|--------------\|
bogdanm	0:9b334a45a8ff	195	\| Alarm out \| \| \| \| \| Don't \| \|
bogdanm	0:9b334a45a8ff	196	\| output PP \| 1 \|Don't care\|Don't care \| Don't care \| care \| 1 \|
bogdanm	0:9b334a45a8ff	197	\|-----------------\|----------\|----------\|-----------\|--------------\|--------\|--------------\|
bogdanm	0:9b334a45a8ff	198	\| Calibration out \| \| \| \| \| Don't \| \|
bogdanm	0:9b334a45a8ff	199	\| output PP \| 0 \| 1 \|Don't care \| Don't care \| care \| Don't care \|
bogdanm	0:9b334a45a8ff	200	\|-----------------\|----------\|----------\|-----------\|--------------\|--------\|--------------\|
bogdanm	0:9b334a45a8ff	201	\| TAMPER input \| \| \| \| \| Don't \| \|
bogdanm	0:9b334a45a8ff	202	\| floating \| 0 \| 0 \| 1 \| 0 \| care \| Don't care \|
bogdanm	0:9b334a45a8ff	203	\|-----------------\|----------\|----------\|-----------\|--------------\|--------\|--------------\|
bogdanm	0:9b334a45a8ff	204	\| TIMESTAMP and \| \| \| \| \| Don't \| \|
bogdanm	0:9b334a45a8ff	205	\| TAMPER input \| 0 \| 0 \| 1 \| 1 \| care \| Don't care \|
bogdanm	0:9b334a45a8ff	206	\| floating \| \| \| \| \| \| \|
bogdanm	0:9b334a45a8ff	207	\|-----------------\|----------\|----------\|-----------\|--------------\|--------\|--------------\|
bogdanm	0:9b334a45a8ff	208	\| TIMESTAMP input \| \| \| \| \| Don't \| \|
bogdanm	0:9b334a45a8ff	209	\| floating \| 0 \| 0 \| 0 \| 1 \| care \| Don't care \|
bogdanm	0:9b334a45a8ff	210	\|-----------------\|----------\|----------\|-----------\|--------------\|--------\|--------------\|
bogdanm	0:9b334a45a8ff	211	\| Output PP \| 0 \| 0 \| 0 \| 0 \| 1 \| PC13 output \|
bogdanm	0:9b334a45a8ff	212	\| Forced \| \| \| \| \| \| \|
bogdanm	0:9b334a45a8ff	213	\|-----------------\|----------\|----------\|-----------\|--------------\|--------\|--------------\|
bogdanm	0:9b334a45a8ff	214	\| Wakeup Pin or \| 0 \| 0 \| 0 \| 0 \| 0 \| Don't care \|
bogdanm	0:9b334a45a8ff	215	\| Standard GPIO \| \| \| \| \| \| \|
bogdanm	0:9b334a45a8ff	216	+------------------------------------------------------------------------------------------+
bogdanm	0:9b334a45a8ff	217
bogdanm	0:9b334a45a8ff	218	@endverbatim
bogdanm	0:9b334a45a8ff	219
bogdanm	0:9b334a45a8ff	220	******************************************************************************
bogdanm	0:9b334a45a8ff	221	* @attention
bogdanm	0:9b334a45a8ff	222	*
bogdanm	0:9b334a45a8ff	223	* <h2><center>© COPYRIGHT(c) 2014 STMicroelectronics</center></h2>
bogdanm	0:9b334a45a8ff	224	*
bogdanm	0:9b334a45a8ff	225	* Redistribution and use in source and binary forms, with or without modification,
bogdanm	0:9b334a45a8ff	226	* are permitted provided that the following conditions are met:
bogdanm	0:9b334a45a8ff	227	* 1. Redistributions of source code must retain the above copyright notice,
bogdanm	0:9b334a45a8ff	228	* this list of conditions and the following disclaimer.
bogdanm	0:9b334a45a8ff	229	* 2. Redistributions in binary form must reproduce the above copyright notice,
bogdanm	0:9b334a45a8ff	230	* this list of conditions and the following disclaimer in the documentation
bogdanm	0:9b334a45a8ff	231	* and/or other materials provided with the distribution.
bogdanm	0:9b334a45a8ff	232	* 3. Neither the name of STMicroelectronics nor the names of its contributors
bogdanm	0:9b334a45a8ff	233	* may be used to endorse or promote products derived from this software
bogdanm	0:9b334a45a8ff	234	* without specific prior written permission.
bogdanm	0:9b334a45a8ff	235	*
bogdanm	0:9b334a45a8ff	236	* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
bogdanm	0:9b334a45a8ff	237	* AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
bogdanm	0:9b334a45a8ff	238	* IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
bogdanm	0:9b334a45a8ff	239	* DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
bogdanm	0:9b334a45a8ff	240	* FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
bogdanm	0:9b334a45a8ff	241	* DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
bogdanm	0:9b334a45a8ff	242	* SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
bogdanm	0:9b334a45a8ff	243	* CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
bogdanm	0:9b334a45a8ff	244	* OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
bogdanm	0:9b334a45a8ff	245	* OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
bogdanm	0:9b334a45a8ff	246	*
bogdanm	0:9b334a45a8ff	247	******************************************************************************
bogdanm	0:9b334a45a8ff	248	*/
bogdanm	0:9b334a45a8ff	249
bogdanm	0:9b334a45a8ff	250	/* Includes ------------------------------------------------------------------*/
bogdanm	0:9b334a45a8ff	251	#include "stm32f30x_rtc.h"
bogdanm	0:9b334a45a8ff	252	#include "stm32f30x_rcc.h"
bogdanm	0:9b334a45a8ff	253
bogdanm	0:9b334a45a8ff	254	/** @addtogroup STM32F30x_StdPeriph_Driver
bogdanm	0:9b334a45a8ff	255	* @{
bogdanm	0:9b334a45a8ff	256	*/
bogdanm	0:9b334a45a8ff	257
bogdanm	0:9b334a45a8ff	258	/** @defgroup RTC
bogdanm	0:9b334a45a8ff	259	* @brief RTC driver modules
bogdanm	0:9b334a45a8ff	260	* @{
bogdanm	0:9b334a45a8ff	261	*/
bogdanm	0:9b334a45a8ff	262
bogdanm	0:9b334a45a8ff	263	/* Private typedef -----------------------------------------------------------*/
bogdanm	0:9b334a45a8ff	264	/* Private define ------------------------------------------------------------*/
bogdanm	0:9b334a45a8ff	265
bogdanm	0:9b334a45a8ff	266	/* Masks Definition */
bogdanm	0:9b334a45a8ff	267	#define RTC_TR_RESERVED_MASK ((uint32_t)0x007F7F7F)
bogdanm	0:9b334a45a8ff	268	#define RTC_DR_RESERVED_MASK ((uint32_t)0x00FFFF3F)
bogdanm	0:9b334a45a8ff	269	#define RTC_INIT_MASK ((uint32_t)0xFFFFFFFF)
bogdanm	0:9b334a45a8ff	270	#define RTC_RSF_MASK ((uint32_t)0xFFFFFF5F)
bogdanm	0:9b334a45a8ff	271	#define RTC_FLAGS_MASK ((uint32_t)(RTC_FLAG_TSOVF \| RTC_FLAG_TSF \| RTC_FLAG_WUTF \| \
bogdanm	0:9b334a45a8ff	272	RTC_FLAG_ALRBF \| RTC_FLAG_ALRAF \| RTC_FLAG_INITF \| \
bogdanm	0:9b334a45a8ff	273	RTC_FLAG_RSF \| RTC_FLAG_INITS \| RTC_FLAG_WUTWF \| \
bogdanm	0:9b334a45a8ff	274	RTC_FLAG_ALRBWF \| RTC_FLAG_ALRAWF \| RTC_FLAG_TAMP1F \| \
bogdanm	0:9b334a45a8ff	275	RTC_FLAG_TAMP2F \| RTC_FLAG_TAMP3F \| RTC_FLAG_RECALPF \| \
bogdanm	0:9b334a45a8ff	276	RTC_FLAG_SHPF))
bogdanm	0:9b334a45a8ff	277
bogdanm	0:9b334a45a8ff	278	#define INITMODE_TIMEOUT ((uint32_t) 0x00002000)
bogdanm	0:9b334a45a8ff	279	#define SYNCHRO_TIMEOUT ((uint32_t) 0x00008000)
bogdanm	0:9b334a45a8ff	280	#define RECALPF_TIMEOUT ((uint32_t) 0x00001000)
bogdanm	0:9b334a45a8ff	281	#define SHPF_TIMEOUT ((uint32_t) 0x00002000)
bogdanm	0:9b334a45a8ff	282
bogdanm	0:9b334a45a8ff	283	/* Private macro -------------------------------------------------------------*/
bogdanm	0:9b334a45a8ff	284	/* Private variables ---------------------------------------------------------*/
bogdanm	0:9b334a45a8ff	285	/* Private function prototypes -----------------------------------------------*/
bogdanm	0:9b334a45a8ff	286	static uint8_t RTC_ByteToBcd2(uint8_t Value);
bogdanm	0:9b334a45a8ff	287	static uint8_t RTC_Bcd2ToByte(uint8_t Value);
bogdanm	0:9b334a45a8ff	288
bogdanm	0:9b334a45a8ff	289	/* Private functions ---------------------------------------------------------*/
bogdanm	0:9b334a45a8ff	290
bogdanm	0:9b334a45a8ff	291	/** @defgroup RTC_Private_Functions
bogdanm	0:9b334a45a8ff	292	* @{
bogdanm	0:9b334a45a8ff	293	*/
bogdanm	0:9b334a45a8ff	294
bogdanm	0:9b334a45a8ff	295	/** @defgroup RTC_Group1 Initialization and Configuration functions
bogdanm	0:9b334a45a8ff	296	* @brief Initialization and Configuration functions
bogdanm	0:9b334a45a8ff	297	*
bogdanm	0:9b334a45a8ff	298	@verbatim
bogdanm	0:9b334a45a8ff	299	===============================================================================
bogdanm	0:9b334a45a8ff	300	##### Initialization and Configuration functions #####
bogdanm	0:9b334a45a8ff	301	===============================================================================
bogdanm	0:9b334a45a8ff	302	[..] This section provide functions allowing to initialize and configure the RTC
bogdanm	0:9b334a45a8ff	303	Prescaler (Synchronous and Asynchronous), RTC Hour format, disable RTC registers
bogdanm	0:9b334a45a8ff	304	Write protection, enter and exit the RTC initialization mode, RTC registers
bogdanm	0:9b334a45a8ff	305	synchronization check and reference clock detection enable.
bogdanm	0:9b334a45a8ff	306	(#) The RTC Prescaler is programmed to generate the RTC 1Hz time base. It is
bogdanm	0:9b334a45a8ff	307	split into 2 programmable prescalers to minimize power consumption.
bogdanm	0:9b334a45a8ff	308	(++) A 7-bit asynchronous prescaler and A 13-bit synchronous prescaler.
bogdanm	0:9b334a45a8ff	309	(++) When both prescalers are used, it is recommended to configure the
bogdanm	0:9b334a45a8ff	310	asynchronous prescaler to a high value to minimize consumption.
bogdanm	0:9b334a45a8ff	311	(#) All RTC registers are Write protected. Writing to the RTC registers
bogdanm	0:9b334a45a8ff	312	is enabled by writing a key into the Write Protection register, RTC_WPR.
bogdanm	0:9b334a45a8ff	313	(#) To Configure the RTC Calendar, user application should enter initialization
bogdanm	0:9b334a45a8ff	314	mode. In this mode, the calendar counter is stopped and its value
bogdanm	0:9b334a45a8ff	315	can be updated. When the initialization sequence is complete, the
bogdanm	0:9b334a45a8ff	316	calendar restarts counting after 4 RTCCLK cycles.
bogdanm	0:9b334a45a8ff	317	(#) To read the calendar through the shadow registers after Calendar
bogdanm	0:9b334a45a8ff	318	initialization, calendar update or after wakeup from low power modes
bogdanm	0:9b334a45a8ff	319	the software must first clear the RSF flag. The software must then
bogdanm	0:9b334a45a8ff	320	wait until it is set again before reading the calendar, which means
bogdanm	0:9b334a45a8ff	321	that the calendar registers have been correctly copied into the RTC_TR
bogdanm	0:9b334a45a8ff	322	and RTC_DR shadow registers. The RTC_WaitForSynchro() function
bogdanm	0:9b334a45a8ff	323	implements the above software sequence (RSF clear and RSF check).
bogdanm	0:9b334a45a8ff	324
bogdanm	0:9b334a45a8ff	325	@endverbatim
bogdanm	0:9b334a45a8ff	326	* @{
bogdanm	0:9b334a45a8ff	327	*/
bogdanm	0:9b334a45a8ff	328
bogdanm	0:9b334a45a8ff	329	/**
bogdanm	0:9b334a45a8ff	330	* @brief Deinitializes the RTC registers to their default reset values.
bogdanm	0:9b334a45a8ff	331	* @note This function doesn't reset the RTC Clock source and RTC Backup Data
bogdanm	0:9b334a45a8ff	332	* registers.
bogdanm	0:9b334a45a8ff	333	* @param None
bogdanm	0:9b334a45a8ff	334	* @retval An ErrorStatus enumeration value:
bogdanm	0:9b334a45a8ff	335	* - SUCCESS: RTC registers are deinitialized
bogdanm	0:9b334a45a8ff	336	* - ERROR: RTC registers are not deinitialized
bogdanm	0:9b334a45a8ff	337	*/
bogdanm	0:9b334a45a8ff	338	ErrorStatus RTC_DeInit(void)
bogdanm	0:9b334a45a8ff	339	{
bogdanm	0:9b334a45a8ff	340	__IO uint32_t wutcounter = 0x00;
bogdanm	0:9b334a45a8ff	341	uint32_t wutwfstatus = 0x00;
bogdanm	0:9b334a45a8ff	342	ErrorStatus status = ERROR;
bogdanm	0:9b334a45a8ff	343
bogdanm	0:9b334a45a8ff	344	/* Disable the write protection for RTC registers */
bogdanm	0:9b334a45a8ff	345	RTC->WPR = 0xCA;
bogdanm	0:9b334a45a8ff	346	RTC->WPR = 0x53;
bogdanm	0:9b334a45a8ff	347
bogdanm	0:9b334a45a8ff	348	/* Set Initialization mode */
bogdanm	0:9b334a45a8ff	349	if (RTC_EnterInitMode() == ERROR)
bogdanm	0:9b334a45a8ff	350	{
bogdanm	0:9b334a45a8ff	351	status = ERROR;
bogdanm	0:9b334a45a8ff	352	}
bogdanm	0:9b334a45a8ff	353	else
bogdanm	0:9b334a45a8ff	354	{
bogdanm	0:9b334a45a8ff	355	/* Reset TR, DR and CR registers */
bogdanm	0:9b334a45a8ff	356	RTC->TR = (uint32_t)0x00000000;
bogdanm	0:9b334a45a8ff	357	RTC->DR = (uint32_t)0x00002101;
bogdanm	0:9b334a45a8ff	358
bogdanm	0:9b334a45a8ff	359	/* Reset All CR bits except CR[2:0] */
bogdanm	0:9b334a45a8ff	360	RTC->CR &= (uint32_t)0x00000007;
bogdanm	0:9b334a45a8ff	361
bogdanm	0:9b334a45a8ff	362	/* Wait till RTC WUTWF flag is set and if Time out is reached exit */
bogdanm	0:9b334a45a8ff	363	do
bogdanm	0:9b334a45a8ff	364	{
bogdanm	0:9b334a45a8ff	365	wutwfstatus = RTC->ISR & RTC_ISR_WUTWF;
bogdanm	0:9b334a45a8ff	366	wutcounter++;
bogdanm	0:9b334a45a8ff	367	} while((wutcounter != INITMODE_TIMEOUT) && (wutwfstatus == 0x00));
bogdanm	0:9b334a45a8ff	368
bogdanm	0:9b334a45a8ff	369	if ((RTC->ISR & RTC_ISR_WUTWF) == RESET)
bogdanm	0:9b334a45a8ff	370	{
bogdanm	0:9b334a45a8ff	371	status = ERROR;
bogdanm	0:9b334a45a8ff	372	}
bogdanm	0:9b334a45a8ff	373	else
bogdanm	0:9b334a45a8ff	374	{
bogdanm	0:9b334a45a8ff	375	/* Reset all RTC CR register bits */
bogdanm	0:9b334a45a8ff	376	RTC->CR &= (uint32_t)0x00000000;
bogdanm	0:9b334a45a8ff	377	RTC->WUTR = (uint32_t)0x0000FFFF;
bogdanm	0:9b334a45a8ff	378	RTC->PRER = (uint32_t)0x007F00FF;
bogdanm	0:9b334a45a8ff	379	RTC->ALRMAR = (uint32_t)0x00000000;
bogdanm	0:9b334a45a8ff	380	RTC->ALRMBR = (uint32_t)0x00000000;
bogdanm	0:9b334a45a8ff	381	RTC->SHIFTR = (uint32_t)0x00000000;
bogdanm	0:9b334a45a8ff	382	RTC->CALR = (uint32_t)0x00000000;
bogdanm	0:9b334a45a8ff	383	RTC->ALRMASSR = (uint32_t)0x00000000;
bogdanm	0:9b334a45a8ff	384	RTC->ALRMBSSR = (uint32_t)0x00000000;
bogdanm	0:9b334a45a8ff	385
bogdanm	0:9b334a45a8ff	386	/* Reset ISR register and exit initialization mode */
bogdanm	0:9b334a45a8ff	387	RTC->ISR = (uint32_t)0x00000000;
bogdanm	0:9b334a45a8ff	388
bogdanm	0:9b334a45a8ff	389	/* Reset Tamper and alternate functions configuration register */
bogdanm	0:9b334a45a8ff	390	RTC->TAFCR = 0x00000000;
bogdanm	0:9b334a45a8ff	391
bogdanm	0:9b334a45a8ff	392	/* Wait till the RTC RSF flag is set */
bogdanm	0:9b334a45a8ff	393	if (RTC_WaitForSynchro() == ERROR)
bogdanm	0:9b334a45a8ff	394	{
bogdanm	0:9b334a45a8ff	395	status = ERROR;
bogdanm	0:9b334a45a8ff	396	}
bogdanm	0:9b334a45a8ff	397	else
bogdanm	0:9b334a45a8ff	398	{
bogdanm	0:9b334a45a8ff	399	status = SUCCESS;
bogdanm	0:9b334a45a8ff	400	}
bogdanm	0:9b334a45a8ff	401	}
bogdanm	0:9b334a45a8ff	402	}
bogdanm	0:9b334a45a8ff	403
bogdanm	0:9b334a45a8ff	404	/* Enable the write protection for RTC registers */
bogdanm	0:9b334a45a8ff	405	RTC->WPR = 0xFF;
bogdanm	0:9b334a45a8ff	406
bogdanm	0:9b334a45a8ff	407	return status;
bogdanm	0:9b334a45a8ff	408	}
bogdanm	0:9b334a45a8ff	409
bogdanm	0:9b334a45a8ff	410	/**
bogdanm	0:9b334a45a8ff	411	* @brief Initializes the RTC registers according to the specified parameters
bogdanm	0:9b334a45a8ff	412	* in RTC_InitStruct.
bogdanm	0:9b334a45a8ff	413	* @param RTC_InitStruct: pointer to a RTC_InitTypeDef structure that contains
bogdanm	0:9b334a45a8ff	414	* the configuration information for the RTC peripheral.
bogdanm	0:9b334a45a8ff	415	* @note The RTC Prescaler register is write protected and can be written in
bogdanm	0:9b334a45a8ff	416	* initialization mode only.
bogdanm	0:9b334a45a8ff	417	* @retval An ErrorStatus enumeration value:
bogdanm	0:9b334a45a8ff	418	* - SUCCESS: RTC registers are initialized
bogdanm	0:9b334a45a8ff	419	* - ERROR: RTC registers are not initialized
bogdanm	0:9b334a45a8ff	420	*/
bogdanm	0:9b334a45a8ff	421	ErrorStatus RTC_Init(RTC_InitTypeDef* RTC_InitStruct)
bogdanm	0:9b334a45a8ff	422	{
bogdanm	0:9b334a45a8ff	423	ErrorStatus status = ERROR;
bogdanm	0:9b334a45a8ff	424
bogdanm	0:9b334a45a8ff	425	/* Check the parameters */
bogdanm	0:9b334a45a8ff	426	assert_param(IS_RTC_HOUR_FORMAT(RTC_InitStruct->RTC_HourFormat));
bogdanm	0:9b334a45a8ff	427	assert_param(IS_RTC_ASYNCH_PREDIV(RTC_InitStruct->RTC_AsynchPrediv));
bogdanm	0:9b334a45a8ff	428	assert_param(IS_RTC_SYNCH_PREDIV(RTC_InitStruct->RTC_SynchPrediv));
bogdanm	0:9b334a45a8ff	429
bogdanm	0:9b334a45a8ff	430	/* Disable the write protection for RTC registers */
bogdanm	0:9b334a45a8ff	431	RTC->WPR = 0xCA;
bogdanm	0:9b334a45a8ff	432	RTC->WPR = 0x53;
bogdanm	0:9b334a45a8ff	433
bogdanm	0:9b334a45a8ff	434	/* Set Initialization mode */
bogdanm	0:9b334a45a8ff	435	if (RTC_EnterInitMode() == ERROR)
bogdanm	0:9b334a45a8ff	436	{
bogdanm	0:9b334a45a8ff	437	status = ERROR;
bogdanm	0:9b334a45a8ff	438	}
bogdanm	0:9b334a45a8ff	439	else
bogdanm	0:9b334a45a8ff	440	{
bogdanm	0:9b334a45a8ff	441	/* Clear RTC CR FMT Bit */
bogdanm	0:9b334a45a8ff	442	RTC->CR &= ((uint32_t)~(RTC_CR_FMT));
bogdanm	0:9b334a45a8ff	443	/* Set RTC_CR register */
bogdanm	0:9b334a45a8ff	444	RTC->CR \|= ((uint32_t)(RTC_InitStruct->RTC_HourFormat));
bogdanm	0:9b334a45a8ff	445
bogdanm	0:9b334a45a8ff	446	/* Configure the RTC PRER */
bogdanm	0:9b334a45a8ff	447	RTC->PRER = (uint32_t)(RTC_InitStruct->RTC_SynchPrediv);
bogdanm	0:9b334a45a8ff	448	RTC->PRER \|= (uint32_t)(RTC_InitStruct->RTC_AsynchPrediv << 16);
bogdanm	0:9b334a45a8ff	449
bogdanm	0:9b334a45a8ff	450	/* Exit Initialization mode */
bogdanm	0:9b334a45a8ff	451	RTC_ExitInitMode();
bogdanm	0:9b334a45a8ff	452
bogdanm	0:9b334a45a8ff	453	status = SUCCESS;
bogdanm	0:9b334a45a8ff	454	}
bogdanm	0:9b334a45a8ff	455	/* Enable the write protection for RTC registers */
bogdanm	0:9b334a45a8ff	456	RTC->WPR = 0xFF;
bogdanm	0:9b334a45a8ff	457
bogdanm	0:9b334a45a8ff	458	return status;
bogdanm	0:9b334a45a8ff	459	}
bogdanm	0:9b334a45a8ff	460
bogdanm	0:9b334a45a8ff	461	/**
bogdanm	0:9b334a45a8ff	462	* @brief Fills each RTC_InitStruct member with its default value.
bogdanm	0:9b334a45a8ff	463	* @param RTC_InitStruct: pointer to a RTC_InitTypeDef structure which will be
bogdanm	0:9b334a45a8ff	464	* initialized.
bogdanm	0:9b334a45a8ff	465	* @retval None
bogdanm	0:9b334a45a8ff	466	*/
bogdanm	0:9b334a45a8ff	467	void RTC_StructInit(RTC_InitTypeDef* RTC_InitStruct)
bogdanm	0:9b334a45a8ff	468	{
bogdanm	0:9b334a45a8ff	469	/* Initialize the RTC_HourFormat member */
bogdanm	0:9b334a45a8ff	470	RTC_InitStruct->RTC_HourFormat = RTC_HourFormat_24;
bogdanm	0:9b334a45a8ff	471
bogdanm	0:9b334a45a8ff	472	/* Initialize the RTC_AsynchPrediv member */
bogdanm	0:9b334a45a8ff	473	RTC_InitStruct->RTC_AsynchPrediv = (uint32_t)0x7F;
bogdanm	0:9b334a45a8ff	474
bogdanm	0:9b334a45a8ff	475	/* Initialize the RTC_SynchPrediv member */
bogdanm	0:9b334a45a8ff	476	RTC_InitStruct->RTC_SynchPrediv = (uint32_t)0xFF;
bogdanm	0:9b334a45a8ff	477	}
bogdanm	0:9b334a45a8ff	478
bogdanm	0:9b334a45a8ff	479	/**
bogdanm	0:9b334a45a8ff	480	* @brief Enables or disables the RTC registers write protection.
bogdanm	0:9b334a45a8ff	481	* @note All the RTC registers are write protected except for RTC_ISR[13:8],
bogdanm	0:9b334a45a8ff	482	* RTC_TAFCR and RTC_BKPxR.
bogdanm	0:9b334a45a8ff	483	* @note Writing a wrong key reactivates the write protection.
bogdanm	0:9b334a45a8ff	484	* @note The protection mechanism is not affected by system reset.
bogdanm	0:9b334a45a8ff	485	* @param NewState: new state of the write protection.
bogdanm	0:9b334a45a8ff	486	* This parameter can be: ENABLE or DISABLE.
bogdanm	0:9b334a45a8ff	487	* @retval None
bogdanm	0:9b334a45a8ff	488	*/
bogdanm	0:9b334a45a8ff	489	void RTC_WriteProtectionCmd(FunctionalState NewState)
bogdanm	0:9b334a45a8ff	490	{
bogdanm	0:9b334a45a8ff	491	/* Check the parameters */
bogdanm	0:9b334a45a8ff	492	assert_param(IS_FUNCTIONAL_STATE(NewState));
bogdanm	0:9b334a45a8ff	493
bogdanm	0:9b334a45a8ff	494	if (NewState != DISABLE)
bogdanm	0:9b334a45a8ff	495	{
bogdanm	0:9b334a45a8ff	496	/* Enable the write protection for RTC registers */
bogdanm	0:9b334a45a8ff	497	RTC->WPR = 0xFF;
bogdanm	0:9b334a45a8ff	498	}
bogdanm	0:9b334a45a8ff	499	else
bogdanm	0:9b334a45a8ff	500	{
bogdanm	0:9b334a45a8ff	501	/* Disable the write protection for RTC registers */
bogdanm	0:9b334a45a8ff	502	RTC->WPR = 0xCA;
bogdanm	0:9b334a45a8ff	503	RTC->WPR = 0x53;
bogdanm	0:9b334a45a8ff	504	}
bogdanm	0:9b334a45a8ff	505	}
bogdanm	0:9b334a45a8ff	506
bogdanm	0:9b334a45a8ff	507	/**
bogdanm	0:9b334a45a8ff	508	* @brief Enters the RTC Initialization mode.
bogdanm	0:9b334a45a8ff	509	* @note The RTC Initialization mode is write protected, use the
bogdanm	0:9b334a45a8ff	510	* RTC_WriteProtectionCmd(DISABLE) before calling this function.
bogdanm	0:9b334a45a8ff	511	* @param None
bogdanm	0:9b334a45a8ff	512	* @retval An ErrorStatus enumeration value:
bogdanm	0:9b334a45a8ff	513	* - SUCCESS: RTC is in Init mode
bogdanm	0:9b334a45a8ff	514	* - ERROR: RTC is not in Init mode
bogdanm	0:9b334a45a8ff	515	*/
bogdanm	0:9b334a45a8ff	516	ErrorStatus RTC_EnterInitMode(void)
bogdanm	0:9b334a45a8ff	517	{
bogdanm	0:9b334a45a8ff	518	__IO uint32_t initcounter = 0x00;
bogdanm	0:9b334a45a8ff	519	ErrorStatus status = ERROR;
bogdanm	0:9b334a45a8ff	520	uint32_t initstatus = 0x00;
bogdanm	0:9b334a45a8ff	521
bogdanm	0:9b334a45a8ff	522	/* Check if the Initialization mode is set */
bogdanm	0:9b334a45a8ff	523	if ((RTC->ISR & RTC_ISR_INITF) == (uint32_t)RESET)
bogdanm	0:9b334a45a8ff	524	{
bogdanm	0:9b334a45a8ff	525	/* Set the Initialization mode */
bogdanm	0:9b334a45a8ff	526	RTC->ISR = (uint32_t)RTC_INIT_MASK;
bogdanm	0:9b334a45a8ff	527
bogdanm	0:9b334a45a8ff	528	/* Wait till RTC is in INIT state and if Time out is reached exit */
bogdanm	0:9b334a45a8ff	529	do
bogdanm	0:9b334a45a8ff	530	{
bogdanm	0:9b334a45a8ff	531	initstatus = RTC->ISR & RTC_ISR_INITF;
bogdanm	0:9b334a45a8ff	532	initcounter++;
bogdanm	0:9b334a45a8ff	533	} while((initcounter != INITMODE_TIMEOUT) && (initstatus == 0x00));
bogdanm	0:9b334a45a8ff	534
bogdanm	0:9b334a45a8ff	535	if ((RTC->ISR & RTC_ISR_INITF) != RESET)
bogdanm	0:9b334a45a8ff	536	{
bogdanm	0:9b334a45a8ff	537	status = SUCCESS;
bogdanm	0:9b334a45a8ff	538	}
bogdanm	0:9b334a45a8ff	539	else
bogdanm	0:9b334a45a8ff	540	{
bogdanm	0:9b334a45a8ff	541	status = ERROR;
bogdanm	0:9b334a45a8ff	542	}
bogdanm	0:9b334a45a8ff	543	}
bogdanm	0:9b334a45a8ff	544	else
bogdanm	0:9b334a45a8ff	545	{
bogdanm	0:9b334a45a8ff	546	status = SUCCESS;
bogdanm	0:9b334a45a8ff	547	}
bogdanm	0:9b334a45a8ff	548
bogdanm	0:9b334a45a8ff	549	return (status);
bogdanm	0:9b334a45a8ff	550	}
bogdanm	0:9b334a45a8ff	551
bogdanm	0:9b334a45a8ff	552	/**
bogdanm	0:9b334a45a8ff	553	* @brief Exits the RTC Initialization mode.
bogdanm	0:9b334a45a8ff	554	* @note When the initialization sequence is complete, the calendar restarts
bogdanm	0:9b334a45a8ff	555	* counting after 4 RTCCLK cycles.
bogdanm	0:9b334a45a8ff	556	* @note The RTC Initialization mode is write protected, use the
bogdanm	0:9b334a45a8ff	557	* RTC_WriteProtectionCmd(DISABLE) before calling this function.
bogdanm	0:9b334a45a8ff	558	* @param None
bogdanm	0:9b334a45a8ff	559	* @retval None
bogdanm	0:9b334a45a8ff	560	*/
bogdanm	0:9b334a45a8ff	561	void RTC_ExitInitMode(void)
bogdanm	0:9b334a45a8ff	562	{
bogdanm	0:9b334a45a8ff	563	/* Exit Initialization mode */
bogdanm	0:9b334a45a8ff	564	RTC->ISR &= (uint32_t)~RTC_ISR_INIT;
bogdanm	0:9b334a45a8ff	565	}
bogdanm	0:9b334a45a8ff	566
bogdanm	0:9b334a45a8ff	567	/**
bogdanm	0:9b334a45a8ff	568	* @brief Waits until the RTC Time and Date registers (RTC_TR and RTC_DR) are
bogdanm	0:9b334a45a8ff	569	* synchronized with RTC APB clock.
bogdanm	0:9b334a45a8ff	570	* @note The RTC Resynchronization mode is write protected, use the
bogdanm	0:9b334a45a8ff	571	* RTC_WriteProtectionCmd(DISABLE) before calling this function.
bogdanm	0:9b334a45a8ff	572	* @note To read the calendar through the shadow registers after Calendar
bogdanm	0:9b334a45a8ff	573	* initialization, calendar update or after wakeup from low power modes
bogdanm	0:9b334a45a8ff	574	* the software must first clear the RSF flag.
bogdanm	0:9b334a45a8ff	575	* The software must then wait until it is set again before reading
bogdanm	0:9b334a45a8ff	576	* the calendar, which means that the calendar registers have been
bogdanm	0:9b334a45a8ff	577	* correctly copied into the RTC_TR and RTC_DR shadow registers.
bogdanm	0:9b334a45a8ff	578	* @param None
bogdanm	0:9b334a45a8ff	579	* @retval An ErrorStatus enumeration value:
bogdanm	0:9b334a45a8ff	580	* - SUCCESS: RTC registers are synchronised
bogdanm	0:9b334a45a8ff	581	* - ERROR: RTC registers are not synchronised
bogdanm	0:9b334a45a8ff	582	*/
bogdanm	0:9b334a45a8ff	583	ErrorStatus RTC_WaitForSynchro(void)
bogdanm	0:9b334a45a8ff	584	{
bogdanm	0:9b334a45a8ff	585	__IO uint32_t synchrocounter = 0;
bogdanm	0:9b334a45a8ff	586	ErrorStatus status = ERROR;
bogdanm	0:9b334a45a8ff	587	uint32_t synchrostatus = 0x00;
bogdanm	0:9b334a45a8ff	588
bogdanm	0:9b334a45a8ff	589	if ((RTC->CR & RTC_CR_BYPSHAD) != RESET)
bogdanm	0:9b334a45a8ff	590	{
bogdanm	0:9b334a45a8ff	591	/* Bypass shadow mode */
bogdanm	0:9b334a45a8ff	592	status = SUCCESS;
bogdanm	0:9b334a45a8ff	593	}
bogdanm	0:9b334a45a8ff	594	else
bogdanm	0:9b334a45a8ff	595	{
bogdanm	0:9b334a45a8ff	596	/* Disable the write protection for RTC registers */
bogdanm	0:9b334a45a8ff	597	RTC->WPR = 0xCA;
bogdanm	0:9b334a45a8ff	598	RTC->WPR = 0x53;
bogdanm	0:9b334a45a8ff	599
bogdanm	0:9b334a45a8ff	600	/* Clear RSF flag */
bogdanm	0:9b334a45a8ff	601	RTC->ISR &= (uint32_t)RTC_RSF_MASK;
bogdanm	0:9b334a45a8ff	602
bogdanm	0:9b334a45a8ff	603	/* Wait the registers to be synchronised */
bogdanm	0:9b334a45a8ff	604	do
bogdanm	0:9b334a45a8ff	605	{
bogdanm	0:9b334a45a8ff	606	synchrostatus = RTC->ISR & RTC_ISR_RSF;
bogdanm	0:9b334a45a8ff	607	synchrocounter++;
bogdanm	0:9b334a45a8ff	608	} while((synchrocounter != SYNCHRO_TIMEOUT) && (synchrostatus == 0x00));
bogdanm	0:9b334a45a8ff	609
bogdanm	0:9b334a45a8ff	610	if ((RTC->ISR & RTC_ISR_RSF) != RESET)
bogdanm	0:9b334a45a8ff	611	{
bogdanm	0:9b334a45a8ff	612	status = SUCCESS;
bogdanm	0:9b334a45a8ff	613	}
bogdanm	0:9b334a45a8ff	614	else
bogdanm	0:9b334a45a8ff	615	{
bogdanm	0:9b334a45a8ff	616	status = ERROR;
bogdanm	0:9b334a45a8ff	617	}
bogdanm	0:9b334a45a8ff	618
bogdanm	0:9b334a45a8ff	619	/* Enable the write protection for RTC registers */
bogdanm	0:9b334a45a8ff	620	RTC->WPR = 0xFF;
bogdanm	0:9b334a45a8ff	621	}
bogdanm	0:9b334a45a8ff	622
bogdanm	0:9b334a45a8ff	623	return (status);
bogdanm	0:9b334a45a8ff	624	}
bogdanm	0:9b334a45a8ff	625
bogdanm	0:9b334a45a8ff	626	/**
bogdanm	0:9b334a45a8ff	627	* @brief Enables or disables the RTC reference clock detection.
bogdanm	0:9b334a45a8ff	628	* @param NewState: new state of the RTC reference clock.
bogdanm	0:9b334a45a8ff	629	* This parameter can be: ENABLE or DISABLE.
bogdanm	0:9b334a45a8ff	630	* @retval An ErrorStatus enumeration value:
bogdanm	0:9b334a45a8ff	631	* - SUCCESS: RTC reference clock detection is enabled
bogdanm	0:9b334a45a8ff	632	* - ERROR: RTC reference clock detection is disabled
bogdanm	0:9b334a45a8ff	633	*/
bogdanm	0:9b334a45a8ff	634	ErrorStatus RTC_RefClockCmd(FunctionalState NewState)
bogdanm	0:9b334a45a8ff	635	{
bogdanm	0:9b334a45a8ff	636	ErrorStatus status = ERROR;
bogdanm	0:9b334a45a8ff	637
bogdanm	0:9b334a45a8ff	638	/* Check the parameters */
bogdanm	0:9b334a45a8ff	639	assert_param(IS_FUNCTIONAL_STATE(NewState));
bogdanm	0:9b334a45a8ff	640
bogdanm	0:9b334a45a8ff	641	/* Disable the write protection for RTC registers */
bogdanm	0:9b334a45a8ff	642	RTC->WPR = 0xCA;
bogdanm	0:9b334a45a8ff	643	RTC->WPR = 0x53;
bogdanm	0:9b334a45a8ff	644
bogdanm	0:9b334a45a8ff	645	/* Set Initialization mode */
bogdanm	0:9b334a45a8ff	646	if (RTC_EnterInitMode() == ERROR)
bogdanm	0:9b334a45a8ff	647	{
bogdanm	0:9b334a45a8ff	648	status = ERROR;
bogdanm	0:9b334a45a8ff	649	}
bogdanm	0:9b334a45a8ff	650	else
bogdanm	0:9b334a45a8ff	651	{
bogdanm	0:9b334a45a8ff	652	if (NewState != DISABLE)
bogdanm	0:9b334a45a8ff	653	{
bogdanm	0:9b334a45a8ff	654	/* Enable the RTC reference clock detection */
bogdanm	0:9b334a45a8ff	655	RTC->CR \|= RTC_CR_REFCKON;
bogdanm	0:9b334a45a8ff	656	}
bogdanm	0:9b334a45a8ff	657	else
bogdanm	0:9b334a45a8ff	658	{
bogdanm	0:9b334a45a8ff	659	/* Disable the RTC reference clock detection */
bogdanm	0:9b334a45a8ff	660	RTC->CR &= ~RTC_CR_REFCKON;
bogdanm	0:9b334a45a8ff	661	}
bogdanm	0:9b334a45a8ff	662	/* Exit Initialization mode */
bogdanm	0:9b334a45a8ff	663	RTC_ExitInitMode();
bogdanm	0:9b334a45a8ff	664
bogdanm	0:9b334a45a8ff	665	status = SUCCESS;
bogdanm	0:9b334a45a8ff	666	}
bogdanm	0:9b334a45a8ff	667
bogdanm	0:9b334a45a8ff	668	/* Enable the write protection for RTC registers */
bogdanm	0:9b334a45a8ff	669	RTC->WPR = 0xFF;
bogdanm	0:9b334a45a8ff	670
bogdanm	0:9b334a45a8ff	671	return status;
bogdanm	0:9b334a45a8ff	672	}
bogdanm	0:9b334a45a8ff	673
bogdanm	0:9b334a45a8ff	674	/**
bogdanm	0:9b334a45a8ff	675	* @brief Enables or Disables the Bypass Shadow feature.
bogdanm	0:9b334a45a8ff	676	* @note When the Bypass Shadow is enabled the calendar value are taken
bogdanm	0:9b334a45a8ff	677	* directly from the Calendar counter.
bogdanm	0:9b334a45a8ff	678	* @param NewState: new state of the Bypass Shadow feature.
bogdanm	0:9b334a45a8ff	679	* This parameter can be: ENABLE or DISABLE.
bogdanm	0:9b334a45a8ff	680	* @retval None
bogdanm	0:9b334a45a8ff	681	*/
bogdanm	0:9b334a45a8ff	682	void RTC_BypassShadowCmd(FunctionalState NewState)
bogdanm	0:9b334a45a8ff	683	{
bogdanm	0:9b334a45a8ff	684	/* Check the parameters */
bogdanm	0:9b334a45a8ff	685	assert_param(IS_FUNCTIONAL_STATE(NewState));
bogdanm	0:9b334a45a8ff	686
bogdanm	0:9b334a45a8ff	687	/* Disable the write protection for RTC registers */
bogdanm	0:9b334a45a8ff	688	RTC->WPR = 0xCA;
bogdanm	0:9b334a45a8ff	689	RTC->WPR = 0x53;
bogdanm	0:9b334a45a8ff	690
bogdanm	0:9b334a45a8ff	691	if (NewState != DISABLE)
bogdanm	0:9b334a45a8ff	692	{
bogdanm	0:9b334a45a8ff	693	/* Set the BYPSHAD bit */
bogdanm	0:9b334a45a8ff	694	RTC->CR \|= (uint8_t)RTC_CR_BYPSHAD;
bogdanm	0:9b334a45a8ff	695	}
bogdanm	0:9b334a45a8ff	696	else
bogdanm	0:9b334a45a8ff	697	{
bogdanm	0:9b334a45a8ff	698	/* Reset the BYPSHAD bit */
bogdanm	0:9b334a45a8ff	699	RTC->CR &= (uint8_t)~RTC_CR_BYPSHAD;
bogdanm	0:9b334a45a8ff	700	}
bogdanm	0:9b334a45a8ff	701
bogdanm	0:9b334a45a8ff	702	/* Enable the write protection for RTC registers */
bogdanm	0:9b334a45a8ff	703	RTC->WPR = 0xFF;
bogdanm	0:9b334a45a8ff	704	}
bogdanm	0:9b334a45a8ff	705
bogdanm	0:9b334a45a8ff	706	/**
bogdanm	0:9b334a45a8ff	707	* @}
bogdanm	0:9b334a45a8ff	708	*/
bogdanm	0:9b334a45a8ff	709
bogdanm	0:9b334a45a8ff	710	/** @defgroup RTC_Group2 Time and Date configuration functions
bogdanm	0:9b334a45a8ff	711	* @brief Time and Date configuration functions
bogdanm	0:9b334a45a8ff	712	*
bogdanm	0:9b334a45a8ff	713	@verbatim
bogdanm	0:9b334a45a8ff	714	===============================================================================
bogdanm	0:9b334a45a8ff	715	##### Time and Date configuration functions #####
bogdanm	0:9b334a45a8ff	716	===============================================================================
bogdanm	0:9b334a45a8ff	717	[..] This section provide functions allowing to program and read the RTC Calendar
bogdanm	0:9b334a45a8ff	718	(Time and Date).
bogdanm	0:9b334a45a8ff	719
bogdanm	0:9b334a45a8ff	720	@endverbatim
bogdanm	0:9b334a45a8ff	721	* @{
bogdanm	0:9b334a45a8ff	722	*/
bogdanm	0:9b334a45a8ff	723
bogdanm	0:9b334a45a8ff	724	/**
bogdanm	0:9b334a45a8ff	725	* @brief Set the RTC current time.
bogdanm	0:9b334a45a8ff	726	* @param RTC_Format: specifies the format of the entered parameters.
bogdanm	0:9b334a45a8ff	727	* This parameter can be one of the following values:
bogdanm	0:9b334a45a8ff	728	* @arg RTC_Format_BIN: Binary data format
bogdanm	0:9b334a45a8ff	729	* @arg RTC_Format_BCD: BCD data format
bogdanm	0:9b334a45a8ff	730	* @param RTC_TimeStruct: pointer to a RTC_TimeTypeDef structure that contains
bogdanm	0:9b334a45a8ff	731	* the time configuration information for the RTC.
bogdanm	0:9b334a45a8ff	732	* @retval An ErrorStatus enumeration value:
bogdanm	0:9b334a45a8ff	733	* - SUCCESS: RTC Time register is configured
bogdanm	0:9b334a45a8ff	734	* - ERROR: RTC Time register is not configured
bogdanm	0:9b334a45a8ff	735	*/
bogdanm	0:9b334a45a8ff	736	ErrorStatus RTC_SetTime(uint32_t RTC_Format, RTC_TimeTypeDef* RTC_TimeStruct)
bogdanm	0:9b334a45a8ff	737	{
bogdanm	0:9b334a45a8ff	738	uint32_t tmpreg = 0;
bogdanm	0:9b334a45a8ff	739	ErrorStatus status = ERROR;
bogdanm	0:9b334a45a8ff	740
bogdanm	0:9b334a45a8ff	741	/* Check the parameters */
bogdanm	0:9b334a45a8ff	742	assert_param(IS_RTC_FORMAT(RTC_Format));
bogdanm	0:9b334a45a8ff	743
bogdanm	0:9b334a45a8ff	744	if (RTC_Format == RTC_Format_BIN)
bogdanm	0:9b334a45a8ff	745	{
bogdanm	0:9b334a45a8ff	746	if ((RTC->CR & RTC_CR_FMT) != (uint32_t)RESET)
bogdanm	0:9b334a45a8ff	747	{
bogdanm	0:9b334a45a8ff	748	assert_param(IS_RTC_HOUR12(RTC_TimeStruct->RTC_Hours));
bogdanm	0:9b334a45a8ff	749	assert_param(IS_RTC_H12(RTC_TimeStruct->RTC_H12));
bogdanm	0:9b334a45a8ff	750	}
bogdanm	0:9b334a45a8ff	751	else
bogdanm	0:9b334a45a8ff	752	{
bogdanm	0:9b334a45a8ff	753	RTC_TimeStruct->RTC_H12 = 0x00;
bogdanm	0:9b334a45a8ff	754	assert_param(IS_RTC_HOUR24(RTC_TimeStruct->RTC_Hours));
bogdanm	0:9b334a45a8ff	755	}
bogdanm	0:9b334a45a8ff	756	assert_param(IS_RTC_MINUTES(RTC_TimeStruct->RTC_Minutes));
bogdanm	0:9b334a45a8ff	757	assert_param(IS_RTC_SECONDS(RTC_TimeStruct->RTC_Seconds));
bogdanm	0:9b334a45a8ff	758	}
bogdanm	0:9b334a45a8ff	759	else
bogdanm	0:9b334a45a8ff	760	{
bogdanm	0:9b334a45a8ff	761	if ((RTC->CR & RTC_CR_FMT) != (uint32_t)RESET)
bogdanm	0:9b334a45a8ff	762	{
bogdanm	0:9b334a45a8ff	763	tmpreg = RTC_Bcd2ToByte(RTC_TimeStruct->RTC_Hours);
bogdanm	0:9b334a45a8ff	764	assert_param(IS_RTC_HOUR12(tmpreg));
bogdanm	0:9b334a45a8ff	765	assert_param(IS_RTC_H12(RTC_TimeStruct->RTC_H12));
bogdanm	0:9b334a45a8ff	766	}
bogdanm	0:9b334a45a8ff	767	else
bogdanm	0:9b334a45a8ff	768	{
bogdanm	0:9b334a45a8ff	769	RTC_TimeStruct->RTC_H12 = 0x00;
bogdanm	0:9b334a45a8ff	770	assert_param(IS_RTC_HOUR24(RTC_Bcd2ToByte(RTC_TimeStruct->RTC_Hours)));
bogdanm	0:9b334a45a8ff	771	}
bogdanm	0:9b334a45a8ff	772	assert_param(IS_RTC_MINUTES(RTC_Bcd2ToByte(RTC_TimeStruct->RTC_Minutes)));
bogdanm	0:9b334a45a8ff	773	assert_param(IS_RTC_SECONDS(RTC_Bcd2ToByte(RTC_TimeStruct->RTC_Seconds)));
bogdanm	0:9b334a45a8ff	774	}
bogdanm	0:9b334a45a8ff	775
bogdanm	0:9b334a45a8ff	776	/* Check the input parameters format */
bogdanm	0:9b334a45a8ff	777	if (RTC_Format != RTC_Format_BIN)
bogdanm	0:9b334a45a8ff	778	{
bogdanm	0:9b334a45a8ff	779	tmpreg = (((uint32_t)(RTC_TimeStruct->RTC_Hours) << 16) \| \
bogdanm	0:9b334a45a8ff	780	((uint32_t)(RTC_TimeStruct->RTC_Minutes) << 8) \| \
bogdanm	0:9b334a45a8ff	781	((uint32_t)RTC_TimeStruct->RTC_Seconds) \| \
bogdanm	0:9b334a45a8ff	782	((uint32_t)(RTC_TimeStruct->RTC_H12) << 16));
bogdanm	0:9b334a45a8ff	783	}
bogdanm	0:9b334a45a8ff	784	else
bogdanm	0:9b334a45a8ff	785	{
bogdanm	0:9b334a45a8ff	786	tmpreg = (uint32_t)(((uint32_t)RTC_ByteToBcd2(RTC_TimeStruct->RTC_Hours) << 16) \| \
bogdanm	0:9b334a45a8ff	787	((uint32_t)RTC_ByteToBcd2(RTC_TimeStruct->RTC_Minutes) << 8) \| \
bogdanm	0:9b334a45a8ff	788	((uint32_t)RTC_ByteToBcd2(RTC_TimeStruct->RTC_Seconds)) \| \
bogdanm	0:9b334a45a8ff	789	(((uint32_t)RTC_TimeStruct->RTC_H12) << 16));
bogdanm	0:9b334a45a8ff	790	}
bogdanm	0:9b334a45a8ff	791
bogdanm	0:9b334a45a8ff	792	/* Disable the write protection for RTC registers */
bogdanm	0:9b334a45a8ff	793	RTC->WPR = 0xCA;
bogdanm	0:9b334a45a8ff	794	RTC->WPR = 0x53;
bogdanm	0:9b334a45a8ff	795
bogdanm	0:9b334a45a8ff	796	/* Set Initialization mode */
bogdanm	0:9b334a45a8ff	797	if (RTC_EnterInitMode() == ERROR)
bogdanm	0:9b334a45a8ff	798	{
bogdanm	0:9b334a45a8ff	799	status = ERROR;
bogdanm	0:9b334a45a8ff	800	}
bogdanm	0:9b334a45a8ff	801	else
bogdanm	0:9b334a45a8ff	802	{
bogdanm	0:9b334a45a8ff	803	/* Set the RTC_TR register */
bogdanm	0:9b334a45a8ff	804	RTC->TR = (uint32_t)(tmpreg & RTC_TR_RESERVED_MASK);
bogdanm	0:9b334a45a8ff	805
bogdanm	0:9b334a45a8ff	806	/* Exit Initialization mode */
bogdanm	0:9b334a45a8ff	807	RTC_ExitInitMode();
bogdanm	0:9b334a45a8ff	808
bogdanm	0:9b334a45a8ff	809	/* If RTC_CR_BYPSHAD bit = 0, wait for synchro else this check is not needed */
bogdanm	0:9b334a45a8ff	810	if ((RTC->CR & RTC_CR_BYPSHAD) == RESET)
bogdanm	0:9b334a45a8ff	811	{
bogdanm	0:9b334a45a8ff	812	if (RTC_WaitForSynchro() == ERROR)
bogdanm	0:9b334a45a8ff	813	{
bogdanm	0:9b334a45a8ff	814	status = ERROR;
bogdanm	0:9b334a45a8ff	815	}
bogdanm	0:9b334a45a8ff	816	else
bogdanm	0:9b334a45a8ff	817	{
bogdanm	0:9b334a45a8ff	818	status = SUCCESS;
bogdanm	0:9b334a45a8ff	819	}
bogdanm	0:9b334a45a8ff	820	}
bogdanm	0:9b334a45a8ff	821	else
bogdanm	0:9b334a45a8ff	822	{
bogdanm	0:9b334a45a8ff	823	status = SUCCESS;
bogdanm	0:9b334a45a8ff	824	}
bogdanm	0:9b334a45a8ff	825
bogdanm	0:9b334a45a8ff	826	}
bogdanm	0:9b334a45a8ff	827	/* Enable the write protection for RTC registers */
bogdanm	0:9b334a45a8ff	828	RTC->WPR = 0xFF;
bogdanm	0:9b334a45a8ff	829
bogdanm	0:9b334a45a8ff	830	return status;
bogdanm	0:9b334a45a8ff	831	}
bogdanm	0:9b334a45a8ff	832
bogdanm	0:9b334a45a8ff	833	/**
bogdanm	0:9b334a45a8ff	834	* @brief Fills each RTC_TimeStruct member with its default value
bogdanm	0:9b334a45a8ff	835	* (Time = 00h:00min:00sec).
bogdanm	0:9b334a45a8ff	836	* @param RTC_TimeStruct: pointer to a RTC_TimeTypeDef structure which will be
bogdanm	0:9b334a45a8ff	837	* initialized.
bogdanm	0:9b334a45a8ff	838	* @retval None
bogdanm	0:9b334a45a8ff	839	*/
bogdanm	0:9b334a45a8ff	840	void RTC_TimeStructInit(RTC_TimeTypeDef* RTC_TimeStruct)
bogdanm	0:9b334a45a8ff	841	{
bogdanm	0:9b334a45a8ff	842	/* Time = 00h:00min:00sec */
bogdanm	0:9b334a45a8ff	843	RTC_TimeStruct->RTC_H12 = RTC_H12_AM;
bogdanm	0:9b334a45a8ff	844	RTC_TimeStruct->RTC_Hours = 0;
bogdanm	0:9b334a45a8ff	845	RTC_TimeStruct->RTC_Minutes = 0;
bogdanm	0:9b334a45a8ff	846	RTC_TimeStruct->RTC_Seconds = 0;
bogdanm	0:9b334a45a8ff	847	}
bogdanm	0:9b334a45a8ff	848
bogdanm	0:9b334a45a8ff	849	/**
bogdanm	0:9b334a45a8ff	850	* @brief Get the RTC current Time.
bogdanm	0:9b334a45a8ff	851	* @param RTC_Format: specifies the format of the returned parameters.
bogdanm	0:9b334a45a8ff	852	* This parameter can be one of the following values:
bogdanm	0:9b334a45a8ff	853	* @arg RTC_Format_BIN: Binary data format
bogdanm	0:9b334a45a8ff	854	* @arg RTC_Format_BCD: BCD data format
bogdanm	0:9b334a45a8ff	855	* @param RTC_TimeStruct: pointer to a RTC_TimeTypeDef structure that will
bogdanm	0:9b334a45a8ff	856	* contain the returned current time configuration.
bogdanm	0:9b334a45a8ff	857	* @retval None
bogdanm	0:9b334a45a8ff	858	*/
bogdanm	0:9b334a45a8ff	859	void RTC_GetTime(uint32_t RTC_Format, RTC_TimeTypeDef* RTC_TimeStruct)
bogdanm	0:9b334a45a8ff	860	{
bogdanm	0:9b334a45a8ff	861	uint32_t tmpreg = 0;
bogdanm	0:9b334a45a8ff	862
bogdanm	0:9b334a45a8ff	863	/* Check the parameters */
bogdanm	0:9b334a45a8ff	864	assert_param(IS_RTC_FORMAT(RTC_Format));
bogdanm	0:9b334a45a8ff	865
bogdanm	0:9b334a45a8ff	866	/* Get the RTC_TR register */
bogdanm	0:9b334a45a8ff	867	tmpreg = (uint32_t)(RTC->TR & RTC_TR_RESERVED_MASK);
bogdanm	0:9b334a45a8ff	868
bogdanm	0:9b334a45a8ff	869	/* Fill the structure fields with the read parameters */
bogdanm	0:9b334a45a8ff	870	RTC_TimeStruct->RTC_Hours = (uint8_t)((tmpreg & (RTC_TR_HT \| RTC_TR_HU)) >> 16);
bogdanm	0:9b334a45a8ff	871	RTC_TimeStruct->RTC_Minutes = (uint8_t)((tmpreg & (RTC_TR_MNT \| RTC_TR_MNU)) >>8);
bogdanm	0:9b334a45a8ff	872	RTC_TimeStruct->RTC_Seconds = (uint8_t)(tmpreg & (RTC_TR_ST \| RTC_TR_SU));
bogdanm	0:9b334a45a8ff	873	RTC_TimeStruct->RTC_H12 = (uint8_t)((tmpreg & (RTC_TR_PM)) >> 16);
bogdanm	0:9b334a45a8ff	874
bogdanm	0:9b334a45a8ff	875	/* Check the input parameters format */
bogdanm	0:9b334a45a8ff	876	if (RTC_Format == RTC_Format_BIN)
bogdanm	0:9b334a45a8ff	877	{
bogdanm	0:9b334a45a8ff	878	/* Convert the structure parameters to Binary format */
bogdanm	0:9b334a45a8ff	879	RTC_TimeStruct->RTC_Hours = (uint8_t)RTC_Bcd2ToByte(RTC_TimeStruct->RTC_Hours);
bogdanm	0:9b334a45a8ff	880	RTC_TimeStruct->RTC_Minutes = (uint8_t)RTC_Bcd2ToByte(RTC_TimeStruct->RTC_Minutes);
bogdanm	0:9b334a45a8ff	881	RTC_TimeStruct->RTC_Seconds = (uint8_t)RTC_Bcd2ToByte(RTC_TimeStruct->RTC_Seconds);
bogdanm	0:9b334a45a8ff	882	}
bogdanm	0:9b334a45a8ff	883	}
bogdanm	0:9b334a45a8ff	884
bogdanm	0:9b334a45a8ff	885	/**
bogdanm	0:9b334a45a8ff	886	* @brief Gets the RTC current Calendar Subseconds value.
bogdanm	0:9b334a45a8ff	887	* @note This function freeze the Time and Date registers after reading the
bogdanm	0:9b334a45a8ff	888	* SSR register.
bogdanm	0:9b334a45a8ff	889	* @param None
bogdanm	0:9b334a45a8ff	890	* @retval RTC current Calendar Subseconds value.
bogdanm	0:9b334a45a8ff	891	*/
bogdanm	0:9b334a45a8ff	892	uint32_t RTC_GetSubSecond(void)
bogdanm	0:9b334a45a8ff	893	{
bogdanm	0:9b334a45a8ff	894	uint32_t tmpreg = 0;
bogdanm	0:9b334a45a8ff	895
bogdanm	0:9b334a45a8ff	896	/* Get subseconds values from the correspondent registers*/
bogdanm	0:9b334a45a8ff	897	tmpreg = (uint32_t)(RTC->SSR);
bogdanm	0:9b334a45a8ff	898
bogdanm	0:9b334a45a8ff	899	/* Read DR register to unfroze calendar registers */
bogdanm	0:9b334a45a8ff	900	(void) (RTC->DR);
bogdanm	0:9b334a45a8ff	901
bogdanm	0:9b334a45a8ff	902	return (tmpreg);
bogdanm	0:9b334a45a8ff	903	}
bogdanm	0:9b334a45a8ff	904
bogdanm	0:9b334a45a8ff	905	/**
bogdanm	0:9b334a45a8ff	906	* @brief Set the RTC current date.
bogdanm	0:9b334a45a8ff	907	* @param RTC_Format: specifies the format of the entered parameters.
bogdanm	0:9b334a45a8ff	908	* This parameter can be one of the following values:
bogdanm	0:9b334a45a8ff	909	* @arg RTC_Format_BIN: Binary data format
bogdanm	0:9b334a45a8ff	910	* @arg RTC_Format_BCD: BCD data format
bogdanm	0:9b334a45a8ff	911	* @param RTC_DateStruct: pointer to a RTC_DateTypeDef structure that contains
bogdanm	0:9b334a45a8ff	912	* the date configuration information for the RTC.
bogdanm	0:9b334a45a8ff	913	* @retval An ErrorStatus enumeration value:
bogdanm	0:9b334a45a8ff	914	* - SUCCESS: RTC Date register is configured
bogdanm	0:9b334a45a8ff	915	* - ERROR: RTC Date register is not configured
bogdanm	0:9b334a45a8ff	916	*/
bogdanm	0:9b334a45a8ff	917	ErrorStatus RTC_SetDate(uint32_t RTC_Format, RTC_DateTypeDef* RTC_DateStruct)
bogdanm	0:9b334a45a8ff	918	{
bogdanm	0:9b334a45a8ff	919	uint32_t tmpreg = 0;
bogdanm	0:9b334a45a8ff	920	ErrorStatus status = ERROR;
bogdanm	0:9b334a45a8ff	921
bogdanm	0:9b334a45a8ff	922	/* Check the parameters */
bogdanm	0:9b334a45a8ff	923	assert_param(IS_RTC_FORMAT(RTC_Format));
bogdanm	0:9b334a45a8ff	924
bogdanm	0:9b334a45a8ff	925	if ((RTC_Format == RTC_Format_BIN) && ((RTC_DateStruct->RTC_Month & 0x10) == 0x10))
bogdanm	0:9b334a45a8ff	926	{
bogdanm	0:9b334a45a8ff	927	RTC_DateStruct->RTC_Month = (RTC_DateStruct->RTC_Month & (uint32_t)~(0x10)) + 0x0A;
bogdanm	0:9b334a45a8ff	928	}
bogdanm	0:9b334a45a8ff	929	if (RTC_Format == RTC_Format_BIN)
bogdanm	0:9b334a45a8ff	930	{
bogdanm	0:9b334a45a8ff	931	assert_param(IS_RTC_YEAR(RTC_DateStruct->RTC_Year));
bogdanm	0:9b334a45a8ff	932	assert_param(IS_RTC_MONTH(RTC_DateStruct->RTC_Month));
bogdanm	0:9b334a45a8ff	933	assert_param(IS_RTC_DATE(RTC_DateStruct->RTC_Date));
bogdanm	0:9b334a45a8ff	934	}
bogdanm	0:9b334a45a8ff	935	else
bogdanm	0:9b334a45a8ff	936	{
bogdanm	0:9b334a45a8ff	937	assert_param(IS_RTC_YEAR(RTC_Bcd2ToByte(RTC_DateStruct->RTC_Year)));
bogdanm	0:9b334a45a8ff	938	tmpreg = RTC_Bcd2ToByte(RTC_DateStruct->RTC_Month);
bogdanm	0:9b334a45a8ff	939	assert_param(IS_RTC_MONTH(tmpreg));
bogdanm	0:9b334a45a8ff	940	tmpreg = RTC_Bcd2ToByte(RTC_DateStruct->RTC_Date);
bogdanm	0:9b334a45a8ff	941	assert_param(IS_RTC_DATE(tmpreg));
bogdanm	0:9b334a45a8ff	942	}
bogdanm	0:9b334a45a8ff	943	assert_param(IS_RTC_WEEKDAY(RTC_DateStruct->RTC_WeekDay));
bogdanm	0:9b334a45a8ff	944
bogdanm	0:9b334a45a8ff	945	/* Check the input parameters format */
bogdanm	0:9b334a45a8ff	946	if (RTC_Format != RTC_Format_BIN)
bogdanm	0:9b334a45a8ff	947	{
bogdanm	0:9b334a45a8ff	948	tmpreg = ((((uint32_t)RTC_DateStruct->RTC_Year) << 16) \| \
bogdanm	0:9b334a45a8ff	949	(((uint32_t)RTC_DateStruct->RTC_Month) << 8) \| \
bogdanm	0:9b334a45a8ff	950	((uint32_t)RTC_DateStruct->RTC_Date) \| \
bogdanm	0:9b334a45a8ff	951	(((uint32_t)RTC_DateStruct->RTC_WeekDay) << 13));
bogdanm	0:9b334a45a8ff	952	}
bogdanm	0:9b334a45a8ff	953	else
bogdanm	0:9b334a45a8ff	954	{
bogdanm	0:9b334a45a8ff	955	tmpreg = (((uint32_t)RTC_ByteToBcd2(RTC_DateStruct->RTC_Year) << 16) \| \
bogdanm	0:9b334a45a8ff	956	((uint32_t)RTC_ByteToBcd2(RTC_DateStruct->RTC_Month) << 8) \| \
bogdanm	0:9b334a45a8ff	957	((uint32_t)RTC_ByteToBcd2(RTC_DateStruct->RTC_Date)) \| \
bogdanm	0:9b334a45a8ff	958	((uint32_t)RTC_DateStruct->RTC_WeekDay << 13));
bogdanm	0:9b334a45a8ff	959	}
bogdanm	0:9b334a45a8ff	960
bogdanm	0:9b334a45a8ff	961	/* Disable the write protection for RTC registers */
bogdanm	0:9b334a45a8ff	962	RTC->WPR = 0xCA;
bogdanm	0:9b334a45a8ff	963	RTC->WPR = 0x53;
bogdanm	0:9b334a45a8ff	964
bogdanm	0:9b334a45a8ff	965	/* Set Initialization mode */
bogdanm	0:9b334a45a8ff	966	if (RTC_EnterInitMode() == ERROR)
bogdanm	0:9b334a45a8ff	967	{
bogdanm	0:9b334a45a8ff	968	status = ERROR;
bogdanm	0:9b334a45a8ff	969	}
bogdanm	0:9b334a45a8ff	970	else
bogdanm	0:9b334a45a8ff	971	{
bogdanm	0:9b334a45a8ff	972	/* Set the RTC_DR register */
bogdanm	0:9b334a45a8ff	973	RTC->DR = (uint32_t)(tmpreg & RTC_DR_RESERVED_MASK);
bogdanm	0:9b334a45a8ff	974
bogdanm	0:9b334a45a8ff	975	/* Exit Initialization mode */
bogdanm	0:9b334a45a8ff	976	RTC_ExitInitMode();
bogdanm	0:9b334a45a8ff	977
bogdanm	0:9b334a45a8ff	978	/* If RTC_CR_BYPSHAD bit = 0, wait for synchro else this check is not needed */
bogdanm	0:9b334a45a8ff	979	if ((RTC->CR & RTC_CR_BYPSHAD) == RESET)
bogdanm	0:9b334a45a8ff	980	{
bogdanm	0:9b334a45a8ff	981	if (RTC_WaitForSynchro() == ERROR)
bogdanm	0:9b334a45a8ff	982	{
bogdanm	0:9b334a45a8ff	983	status = ERROR;
bogdanm	0:9b334a45a8ff	984	}
bogdanm	0:9b334a45a8ff	985	else
bogdanm	0:9b334a45a8ff	986	{
bogdanm	0:9b334a45a8ff	987	status = SUCCESS;
bogdanm	0:9b334a45a8ff	988	}
bogdanm	0:9b334a45a8ff	989	}
bogdanm	0:9b334a45a8ff	990	else
bogdanm	0:9b334a45a8ff	991	{
bogdanm	0:9b334a45a8ff	992	status = SUCCESS;
bogdanm	0:9b334a45a8ff	993	}
bogdanm	0:9b334a45a8ff	994	}
bogdanm	0:9b334a45a8ff	995	/* Enable the write protection for RTC registers */
bogdanm	0:9b334a45a8ff	996	RTC->WPR = 0xFF;
bogdanm	0:9b334a45a8ff	997
bogdanm	0:9b334a45a8ff	998	return status;
bogdanm	0:9b334a45a8ff	999	}
bogdanm	0:9b334a45a8ff	1000
bogdanm	0:9b334a45a8ff	1001	/**
bogdanm	0:9b334a45a8ff	1002	* @brief Fills each RTC_DateStruct member with its default value
bogdanm	0:9b334a45a8ff	1003	* (Monday, January 01 xx00).
bogdanm	0:9b334a45a8ff	1004	* @param RTC_DateStruct: pointer to a RTC_DateTypeDef structure which will be
bogdanm	0:9b334a45a8ff	1005	* initialized.
bogdanm	0:9b334a45a8ff	1006	* @retval None
bogdanm	0:9b334a45a8ff	1007	*/
bogdanm	0:9b334a45a8ff	1008	void RTC_DateStructInit(RTC_DateTypeDef* RTC_DateStruct)
bogdanm	0:9b334a45a8ff	1009	{
bogdanm	0:9b334a45a8ff	1010	/* Monday, January 01 xx00 */
bogdanm	0:9b334a45a8ff	1011	RTC_DateStruct->RTC_WeekDay = RTC_Weekday_Monday;
bogdanm	0:9b334a45a8ff	1012	RTC_DateStruct->RTC_Date = 1;
bogdanm	0:9b334a45a8ff	1013	RTC_DateStruct->RTC_Month = RTC_Month_January;
bogdanm	0:9b334a45a8ff	1014	RTC_DateStruct->RTC_Year = 0;
bogdanm	0:9b334a45a8ff	1015	}
bogdanm	0:9b334a45a8ff	1016
bogdanm	0:9b334a45a8ff	1017	/**
bogdanm	0:9b334a45a8ff	1018	* @brief Get the RTC current date.
bogdanm	0:9b334a45a8ff	1019	* @param RTC_Format: specifies the format of the returned parameters.
bogdanm	0:9b334a45a8ff	1020	* This parameter can be one of the following values:
bogdanm	0:9b334a45a8ff	1021	* @arg RTC_Format_BIN: Binary data format
bogdanm	0:9b334a45a8ff	1022	* @arg RTC_Format_BCD: BCD data format
bogdanm	0:9b334a45a8ff	1023	* @param RTC_DateStruct: pointer to a RTC_DateTypeDef structure that will
bogdanm	0:9b334a45a8ff	1024	* contain the returned current date configuration.
bogdanm	0:9b334a45a8ff	1025	* @retval None
bogdanm	0:9b334a45a8ff	1026	*/
bogdanm	0:9b334a45a8ff	1027	void RTC_GetDate(uint32_t RTC_Format, RTC_DateTypeDef* RTC_DateStruct)
bogdanm	0:9b334a45a8ff	1028	{
bogdanm	0:9b334a45a8ff	1029	uint32_t tmpreg = 0;
bogdanm	0:9b334a45a8ff	1030
bogdanm	0:9b334a45a8ff	1031	/* Check the parameters */
bogdanm	0:9b334a45a8ff	1032	assert_param(IS_RTC_FORMAT(RTC_Format));
bogdanm	0:9b334a45a8ff	1033
bogdanm	0:9b334a45a8ff	1034	/* Get the RTC_TR register */
bogdanm	0:9b334a45a8ff	1035	tmpreg = (uint32_t)(RTC->DR & RTC_DR_RESERVED_MASK);
bogdanm	0:9b334a45a8ff	1036
bogdanm	0:9b334a45a8ff	1037	/* Fill the structure fields with the read parameters */
bogdanm	0:9b334a45a8ff	1038	RTC_DateStruct->RTC_Year = (uint8_t)((tmpreg & (RTC_DR_YT \| RTC_DR_YU)) >> 16);
bogdanm	0:9b334a45a8ff	1039	RTC_DateStruct->RTC_Month = (uint8_t)((tmpreg & (RTC_DR_MT \| RTC_DR_MU)) >> 8);
bogdanm	0:9b334a45a8ff	1040	RTC_DateStruct->RTC_Date = (uint8_t)(tmpreg & (RTC_DR_DT \| RTC_DR_DU));
bogdanm	0:9b334a45a8ff	1041	RTC_DateStruct->RTC_WeekDay = (uint8_t)((tmpreg & (RTC_DR_WDU)) >> 13);
bogdanm	0:9b334a45a8ff	1042
bogdanm	0:9b334a45a8ff	1043	/* Check the input parameters format */
bogdanm	0:9b334a45a8ff	1044	if (RTC_Format == RTC_Format_BIN)
bogdanm	0:9b334a45a8ff	1045	{
bogdanm	0:9b334a45a8ff	1046	/* Convert the structure parameters to Binary format */
bogdanm	0:9b334a45a8ff	1047	RTC_DateStruct->RTC_Year = (uint8_t)RTC_Bcd2ToByte(RTC_DateStruct->RTC_Year);
bogdanm	0:9b334a45a8ff	1048	RTC_DateStruct->RTC_Month = (uint8_t)RTC_Bcd2ToByte(RTC_DateStruct->RTC_Month);
bogdanm	0:9b334a45a8ff	1049	RTC_DateStruct->RTC_Date = (uint8_t)RTC_Bcd2ToByte(RTC_DateStruct->RTC_Date);
bogdanm	0:9b334a45a8ff	1050	RTC_DateStruct->RTC_WeekDay = (uint8_t)(RTC_DateStruct->RTC_WeekDay);
bogdanm	0:9b334a45a8ff	1051	}
bogdanm	0:9b334a45a8ff	1052	}
bogdanm	0:9b334a45a8ff	1053
bogdanm	0:9b334a45a8ff	1054	/**
bogdanm	0:9b334a45a8ff	1055	* @}
bogdanm	0:9b334a45a8ff	1056	*/
bogdanm	0:9b334a45a8ff	1057
bogdanm	0:9b334a45a8ff	1058	/** @defgroup RTC_Group3 Alarms configuration functions
bogdanm	0:9b334a45a8ff	1059	* @brief Alarms (Alarm A and Alarm B) configuration functions
bogdanm	0:9b334a45a8ff	1060	*
bogdanm	0:9b334a45a8ff	1061	@verbatim
bogdanm	0:9b334a45a8ff	1062	===============================================================================
bogdanm	0:9b334a45a8ff	1063	##### Alarms (Alarm A and Alarm B) configuration functions #####
bogdanm	0:9b334a45a8ff	1064	===============================================================================
bogdanm	0:9b334a45a8ff	1065	[..] This section provides functions allowing to program and read the RTC Alarms.
bogdanm	0:9b334a45a8ff	1066
bogdanm	0:9b334a45a8ff	1067	@endverbatim
bogdanm	0:9b334a45a8ff	1068	* @{
bogdanm	0:9b334a45a8ff	1069	*/
bogdanm	0:9b334a45a8ff	1070
bogdanm	0:9b334a45a8ff	1071	/**
bogdanm	0:9b334a45a8ff	1072	* @brief Set the specified RTC Alarm.
bogdanm	0:9b334a45a8ff	1073	* @note The Alarm register can only be written when the corresponding Alarm
bogdanm	0:9b334a45a8ff	1074	* is disabled (Use the RTC_AlarmCmd(DISABLE)).
bogdanm	0:9b334a45a8ff	1075	* @param RTC_Format: specifies the format of the returned parameters.
bogdanm	0:9b334a45a8ff	1076	* This parameter can be one of the following values:
bogdanm	0:9b334a45a8ff	1077	* @arg RTC_Format_BIN: Binary data format
bogdanm	0:9b334a45a8ff	1078	* @arg RTC_Format_BCD: BCD data format
bogdanm	0:9b334a45a8ff	1079	* @param RTC_Alarm: specifies the alarm to be configured.
bogdanm	0:9b334a45a8ff	1080	* This parameter can be one of the following values:
bogdanm	0:9b334a45a8ff	1081	* @arg RTC_Alarm_A: to select Alarm A
bogdanm	0:9b334a45a8ff	1082	* @arg RTC_Alarm_B: to select Alarm B
bogdanm	0:9b334a45a8ff	1083	* @param RTC_AlarmStruct: pointer to a RTC_AlarmTypeDef structure that
bogdanm	0:9b334a45a8ff	1084	* contains the alarm configuration parameters.
bogdanm	0:9b334a45a8ff	1085	* @retval None
bogdanm	0:9b334a45a8ff	1086	*/
bogdanm	0:9b334a45a8ff	1087	void RTC_SetAlarm(uint32_t RTC_Format, uint32_t RTC_Alarm, RTC_AlarmTypeDef* RTC_AlarmStruct)
bogdanm	0:9b334a45a8ff	1088	{
bogdanm	0:9b334a45a8ff	1089	uint32_t tmpreg = 0;
bogdanm	0:9b334a45a8ff	1090
bogdanm	0:9b334a45a8ff	1091	/* Check the parameters */
bogdanm	0:9b334a45a8ff	1092	assert_param(IS_RTC_FORMAT(RTC_Format));
bogdanm	0:9b334a45a8ff	1093	assert_param(IS_RTC_ALARM(RTC_Alarm));
bogdanm	0:9b334a45a8ff	1094	assert_param(IS_ALARM_MASK(RTC_AlarmStruct->RTC_AlarmMask));
bogdanm	0:9b334a45a8ff	1095	assert_param(IS_RTC_ALARM_DATE_WEEKDAY_SEL(RTC_AlarmStruct->RTC_AlarmDateWeekDaySel));
bogdanm	0:9b334a45a8ff	1096
bogdanm	0:9b334a45a8ff	1097	if (RTC_Format == RTC_Format_BIN)
bogdanm	0:9b334a45a8ff	1098	{
bogdanm	0:9b334a45a8ff	1099	if ((RTC->CR & RTC_CR_FMT) != (uint32_t)RESET)
bogdanm	0:9b334a45a8ff	1100	{
bogdanm	0:9b334a45a8ff	1101	assert_param(IS_RTC_HOUR12(RTC_AlarmStruct->RTC_AlarmTime.RTC_Hours));
bogdanm	0:9b334a45a8ff	1102	assert_param(IS_RTC_H12(RTC_AlarmStruct->RTC_AlarmTime.RTC_H12));
bogdanm	0:9b334a45a8ff	1103	}
bogdanm	0:9b334a45a8ff	1104	else
bogdanm	0:9b334a45a8ff	1105	{
bogdanm	0:9b334a45a8ff	1106	RTC_AlarmStruct->RTC_AlarmTime.RTC_H12 = 0x00;
bogdanm	0:9b334a45a8ff	1107	assert_param(IS_RTC_HOUR24(RTC_AlarmStruct->RTC_AlarmTime.RTC_Hours));
bogdanm	0:9b334a45a8ff	1108	}
bogdanm	0:9b334a45a8ff	1109	assert_param(IS_RTC_MINUTES(RTC_AlarmStruct->RTC_AlarmTime.RTC_Minutes));
bogdanm	0:9b334a45a8ff	1110	assert_param(IS_RTC_SECONDS(RTC_AlarmStruct->RTC_AlarmTime.RTC_Seconds));
bogdanm	0:9b334a45a8ff	1111
bogdanm	0:9b334a45a8ff	1112	if(RTC_AlarmStruct->RTC_AlarmDateWeekDaySel == RTC_AlarmDateWeekDaySel_Date)
bogdanm	0:9b334a45a8ff	1113	{
bogdanm	0:9b334a45a8ff	1114	assert_param(IS_RTC_ALARM_DATE_WEEKDAY_DATE(RTC_AlarmStruct->RTC_AlarmDateWeekDay));
bogdanm	0:9b334a45a8ff	1115	}
bogdanm	0:9b334a45a8ff	1116	else
bogdanm	0:9b334a45a8ff	1117	{
bogdanm	0:9b334a45a8ff	1118	assert_param(IS_RTC_ALARM_DATE_WEEKDAY_WEEKDAY(RTC_AlarmStruct->RTC_AlarmDateWeekDay));
bogdanm	0:9b334a45a8ff	1119	}
bogdanm	0:9b334a45a8ff	1120	}
bogdanm	0:9b334a45a8ff	1121	else
bogdanm	0:9b334a45a8ff	1122	{
bogdanm	0:9b334a45a8ff	1123	if ((RTC->CR & RTC_CR_FMT) != (uint32_t)RESET)
bogdanm	0:9b334a45a8ff	1124	{
bogdanm	0:9b334a45a8ff	1125	tmpreg = RTC_Bcd2ToByte(RTC_AlarmStruct->RTC_AlarmTime.RTC_Hours);
bogdanm	0:9b334a45a8ff	1126	assert_param(IS_RTC_HOUR12(tmpreg));
bogdanm	0:9b334a45a8ff	1127	assert_param(IS_RTC_H12(RTC_AlarmStruct->RTC_AlarmTime.RTC_H12));
bogdanm	0:9b334a45a8ff	1128	}
bogdanm	0:9b334a45a8ff	1129	else
bogdanm	0:9b334a45a8ff	1130	{
bogdanm	0:9b334a45a8ff	1131	RTC_AlarmStruct->RTC_AlarmTime.RTC_H12 = 0x00;
bogdanm	0:9b334a45a8ff	1132	assert_param(IS_RTC_HOUR24(RTC_Bcd2ToByte(RTC_AlarmStruct->RTC_AlarmTime.RTC_Hours)));
bogdanm	0:9b334a45a8ff	1133	}
bogdanm	0:9b334a45a8ff	1134
bogdanm	0:9b334a45a8ff	1135	assert_param(IS_RTC_MINUTES(RTC_Bcd2ToByte(RTC_AlarmStruct->RTC_AlarmTime.RTC_Minutes)));
bogdanm	0:9b334a45a8ff	1136	assert_param(IS_RTC_SECONDS(RTC_Bcd2ToByte(RTC_AlarmStruct->RTC_AlarmTime.RTC_Seconds)));
bogdanm	0:9b334a45a8ff	1137
bogdanm	0:9b334a45a8ff	1138	if(RTC_AlarmStruct->RTC_AlarmDateWeekDaySel == RTC_AlarmDateWeekDaySel_Date)
bogdanm	0:9b334a45a8ff	1139	{
bogdanm	0:9b334a45a8ff	1140	tmpreg = RTC_Bcd2ToByte(RTC_AlarmStruct->RTC_AlarmDateWeekDay);
bogdanm	0:9b334a45a8ff	1141	assert_param(IS_RTC_ALARM_DATE_WEEKDAY_DATE(tmpreg));
bogdanm	0:9b334a45a8ff	1142	}
bogdanm	0:9b334a45a8ff	1143	else
bogdanm	0:9b334a45a8ff	1144	{
bogdanm	0:9b334a45a8ff	1145	tmpreg = RTC_Bcd2ToByte(RTC_AlarmStruct->RTC_AlarmDateWeekDay);
bogdanm	0:9b334a45a8ff	1146	assert_param(IS_RTC_ALARM_DATE_WEEKDAY_WEEKDAY(tmpreg));
bogdanm	0:9b334a45a8ff	1147	}
bogdanm	0:9b334a45a8ff	1148	}
bogdanm	0:9b334a45a8ff	1149
bogdanm	0:9b334a45a8ff	1150	/* Check the input parameters format */
bogdanm	0:9b334a45a8ff	1151	if (RTC_Format != RTC_Format_BIN)
bogdanm	0:9b334a45a8ff	1152	{
bogdanm	0:9b334a45a8ff	1153	tmpreg = (((uint32_t)(RTC_AlarmStruct->RTC_AlarmTime.RTC_Hours) << 16) \| \
bogdanm	0:9b334a45a8ff	1154	((uint32_t)(RTC_AlarmStruct->RTC_AlarmTime.RTC_Minutes) << 8) \| \
bogdanm	0:9b334a45a8ff	1155	((uint32_t)RTC_AlarmStruct->RTC_AlarmTime.RTC_Seconds) \| \
bogdanm	0:9b334a45a8ff	1156	((uint32_t)(RTC_AlarmStruct->RTC_AlarmTime.RTC_H12) << 16) \| \
bogdanm	0:9b334a45a8ff	1157	((uint32_t)(RTC_AlarmStruct->RTC_AlarmDateWeekDay) << 24) \| \
bogdanm	0:9b334a45a8ff	1158	((uint32_t)RTC_AlarmStruct->RTC_AlarmDateWeekDaySel) \| \
bogdanm	0:9b334a45a8ff	1159	((uint32_t)RTC_AlarmStruct->RTC_AlarmMask));
bogdanm	0:9b334a45a8ff	1160	}
bogdanm	0:9b334a45a8ff	1161	else
bogdanm	0:9b334a45a8ff	1162	{
bogdanm	0:9b334a45a8ff	1163	tmpreg = (((uint32_t)RTC_ByteToBcd2(RTC_AlarmStruct->RTC_AlarmTime.RTC_Hours) << 16) \| \
bogdanm	0:9b334a45a8ff	1164	((uint32_t)RTC_ByteToBcd2(RTC_AlarmStruct->RTC_AlarmTime.RTC_Minutes) << 8) \| \
bogdanm	0:9b334a45a8ff	1165	((uint32_t)RTC_ByteToBcd2(RTC_AlarmStruct->RTC_AlarmTime.RTC_Seconds)) \| \
bogdanm	0:9b334a45a8ff	1166	((uint32_t)(RTC_AlarmStruct->RTC_AlarmTime.RTC_H12) << 16) \| \
bogdanm	0:9b334a45a8ff	1167	((uint32_t)RTC_ByteToBcd2(RTC_AlarmStruct->RTC_AlarmDateWeekDay) << 24) \| \
bogdanm	0:9b334a45a8ff	1168	((uint32_t)RTC_AlarmStruct->RTC_AlarmDateWeekDaySel) \| \
bogdanm	0:9b334a45a8ff	1169	((uint32_t)RTC_AlarmStruct->RTC_AlarmMask));
bogdanm	0:9b334a45a8ff	1170	}
bogdanm	0:9b334a45a8ff	1171
bogdanm	0:9b334a45a8ff	1172	/* Disable the write protection for RTC registers */
bogdanm	0:9b334a45a8ff	1173	RTC->WPR = 0xCA;
bogdanm	0:9b334a45a8ff	1174	RTC->WPR = 0x53;
bogdanm	0:9b334a45a8ff	1175
bogdanm	0:9b334a45a8ff	1176	/* Configure the Alarm register */
bogdanm	0:9b334a45a8ff	1177	if (RTC_Alarm == RTC_Alarm_A)
bogdanm	0:9b334a45a8ff	1178	{
bogdanm	0:9b334a45a8ff	1179	RTC->ALRMAR = (uint32_t)tmpreg;
bogdanm	0:9b334a45a8ff	1180	}
bogdanm	0:9b334a45a8ff	1181	else
bogdanm	0:9b334a45a8ff	1182	{
bogdanm	0:9b334a45a8ff	1183	RTC->ALRMBR = (uint32_t)tmpreg;
bogdanm	0:9b334a45a8ff	1184	}
bogdanm	0:9b334a45a8ff	1185
bogdanm	0:9b334a45a8ff	1186	/* Enable the write protection for RTC registers */
bogdanm	0:9b334a45a8ff	1187	RTC->WPR = 0xFF;
bogdanm	0:9b334a45a8ff	1188	}
bogdanm	0:9b334a45a8ff	1189
bogdanm	0:9b334a45a8ff	1190	/**
bogdanm	0:9b334a45a8ff	1191	* @brief Fills each RTC_AlarmStruct member with its default value
bogdanm	0:9b334a45a8ff	1192	* (Time = 00h:00mn:00sec / Date = 1st day of the month/Mask =
bogdanm	0:9b334a45a8ff	1193	* all fields are masked).
bogdanm	0:9b334a45a8ff	1194	* @param RTC_AlarmStruct: pointer to a @ref RTC_AlarmTypeDef structure which
bogdanm	0:9b334a45a8ff	1195	* will be initialized.
bogdanm	0:9b334a45a8ff	1196	* @retval None
bogdanm	0:9b334a45a8ff	1197	*/
bogdanm	0:9b334a45a8ff	1198	void RTC_AlarmStructInit(RTC_AlarmTypeDef* RTC_AlarmStruct)
bogdanm	0:9b334a45a8ff	1199	{
bogdanm	0:9b334a45a8ff	1200	/* Alarm Time Settings : Time = 00h:00mn:00sec */
bogdanm	0:9b334a45a8ff	1201	RTC_AlarmStruct->RTC_AlarmTime.RTC_H12 = RTC_H12_AM;
bogdanm	0:9b334a45a8ff	1202	RTC_AlarmStruct->RTC_AlarmTime.RTC_Hours = 0;
bogdanm	0:9b334a45a8ff	1203	RTC_AlarmStruct->RTC_AlarmTime.RTC_Minutes = 0;
bogdanm	0:9b334a45a8ff	1204	RTC_AlarmStruct->RTC_AlarmTime.RTC_Seconds = 0;
bogdanm	0:9b334a45a8ff	1205
bogdanm	0:9b334a45a8ff	1206	/* Alarm Date Settings : Date = 1st day of the month */
bogdanm	0:9b334a45a8ff	1207	RTC_AlarmStruct->RTC_AlarmDateWeekDaySel = RTC_AlarmDateWeekDaySel_Date;
bogdanm	0:9b334a45a8ff	1208	RTC_AlarmStruct->RTC_AlarmDateWeekDay = 1;
bogdanm	0:9b334a45a8ff	1209
bogdanm	0:9b334a45a8ff	1210	/* Alarm Masks Settings : Mask = all fields are not masked */
bogdanm	0:9b334a45a8ff	1211	RTC_AlarmStruct->RTC_AlarmMask = RTC_AlarmMask_None;
bogdanm	0:9b334a45a8ff	1212	}
bogdanm	0:9b334a45a8ff	1213
bogdanm	0:9b334a45a8ff	1214	/**
bogdanm	0:9b334a45a8ff	1215	* @brief Get the RTC Alarm value and masks.
bogdanm	0:9b334a45a8ff	1216	* @param RTC_Format: specifies the format of the output parameters.
bogdanm	0:9b334a45a8ff	1217	* This parameter can be one of the following values:
bogdanm	0:9b334a45a8ff	1218	* @arg RTC_Format_BIN: Binary data format
bogdanm	0:9b334a45a8ff	1219	* @arg RTC_Format_BCD: BCD data format
bogdanm	0:9b334a45a8ff	1220	* @param RTC_Alarm: specifies the alarm to be read.
bogdanm	0:9b334a45a8ff	1221	* This parameter can be one of the following values:
bogdanm	0:9b334a45a8ff	1222	* @arg RTC_Alarm_A: to select Alarm A
bogdanm	0:9b334a45a8ff	1223	* @arg RTC_Alarm_B: to select Alarm B
bogdanm	0:9b334a45a8ff	1224	* @param RTC_AlarmStruct: pointer to a RTC_AlarmTypeDef structure that will
bogdanm	0:9b334a45a8ff	1225	* contains the output alarm configuration values.
bogdanm	0:9b334a45a8ff	1226	* @retval None
bogdanm	0:9b334a45a8ff	1227	*/
bogdanm	0:9b334a45a8ff	1228	void RTC_GetAlarm(uint32_t RTC_Format, uint32_t RTC_Alarm, RTC_AlarmTypeDef* RTC_AlarmStruct)
bogdanm	0:9b334a45a8ff	1229	{
bogdanm	0:9b334a45a8ff	1230	uint32_t tmpreg = 0;
bogdanm	0:9b334a45a8ff	1231
bogdanm	0:9b334a45a8ff	1232	/* Check the parameters */
bogdanm	0:9b334a45a8ff	1233	assert_param(IS_RTC_FORMAT(RTC_Format));
bogdanm	0:9b334a45a8ff	1234	assert_param(IS_RTC_ALARM(RTC_Alarm));
bogdanm	0:9b334a45a8ff	1235
bogdanm	0:9b334a45a8ff	1236	/* Get the RTC_ALRMxR register */
bogdanm	0:9b334a45a8ff	1237	if (RTC_Alarm == RTC_Alarm_A)
bogdanm	0:9b334a45a8ff	1238	{
bogdanm	0:9b334a45a8ff	1239	tmpreg = (uint32_t)(RTC->ALRMAR);
bogdanm	0:9b334a45a8ff	1240	}
bogdanm	0:9b334a45a8ff	1241	else
bogdanm	0:9b334a45a8ff	1242	{
bogdanm	0:9b334a45a8ff	1243	tmpreg = (uint32_t)(RTC->ALRMBR);
bogdanm	0:9b334a45a8ff	1244	}
bogdanm	0:9b334a45a8ff	1245
bogdanm	0:9b334a45a8ff	1246	/* Fill the structure with the read parameters */
bogdanm	0:9b334a45a8ff	1247	RTC_AlarmStruct->RTC_AlarmTime.RTC_Hours = (uint32_t)((tmpreg & (RTC_ALRMAR_HT \| \
bogdanm	0:9b334a45a8ff	1248	RTC_ALRMAR_HU)) >> 16);
bogdanm	0:9b334a45a8ff	1249	RTC_AlarmStruct->RTC_AlarmTime.RTC_Minutes = (uint32_t)((tmpreg & (RTC_ALRMAR_MNT \| \
bogdanm	0:9b334a45a8ff	1250	RTC_ALRMAR_MNU)) >> 8);
bogdanm	0:9b334a45a8ff	1251	RTC_AlarmStruct->RTC_AlarmTime.RTC_Seconds = (uint32_t)(tmpreg & (RTC_ALRMAR_ST \| \
bogdanm	0:9b334a45a8ff	1252	RTC_ALRMAR_SU));
bogdanm	0:9b334a45a8ff	1253	RTC_AlarmStruct->RTC_AlarmTime.RTC_H12 = (uint32_t)((tmpreg & RTC_ALRMAR_PM) >> 16);
bogdanm	0:9b334a45a8ff	1254	RTC_AlarmStruct->RTC_AlarmDateWeekDay = (uint32_t)((tmpreg & (RTC_ALRMAR_DT \| RTC_ALRMAR_DU)) >> 24);
bogdanm	0:9b334a45a8ff	1255	RTC_AlarmStruct->RTC_AlarmDateWeekDaySel = (uint32_t)(tmpreg & RTC_ALRMAR_WDSEL);
bogdanm	0:9b334a45a8ff	1256	RTC_AlarmStruct->RTC_AlarmMask = (uint32_t)(tmpreg & RTC_AlarmMask_All);
bogdanm	0:9b334a45a8ff	1257
bogdanm	0:9b334a45a8ff	1258	if (RTC_Format == RTC_Format_BIN)
bogdanm	0:9b334a45a8ff	1259	{
bogdanm	0:9b334a45a8ff	1260	RTC_AlarmStruct->RTC_AlarmTime.RTC_Hours = RTC_Bcd2ToByte(RTC_AlarmStruct-> \
bogdanm	0:9b334a45a8ff	1261	RTC_AlarmTime.RTC_Hours);
bogdanm	0:9b334a45a8ff	1262	RTC_AlarmStruct->RTC_AlarmTime.RTC_Minutes = RTC_Bcd2ToByte(RTC_AlarmStruct-> \
bogdanm	0:9b334a45a8ff	1263	RTC_AlarmTime.RTC_Minutes);
bogdanm	0:9b334a45a8ff	1264	RTC_AlarmStruct->RTC_AlarmTime.RTC_Seconds = RTC_Bcd2ToByte(RTC_AlarmStruct-> \
bogdanm	0:9b334a45a8ff	1265	RTC_AlarmTime.RTC_Seconds);
bogdanm	0:9b334a45a8ff	1266	RTC_AlarmStruct->RTC_AlarmDateWeekDay = RTC_Bcd2ToByte(RTC_AlarmStruct->RTC_AlarmDateWeekDay);
bogdanm	0:9b334a45a8ff	1267	}
bogdanm	0:9b334a45a8ff	1268	}
bogdanm	0:9b334a45a8ff	1269
bogdanm	0:9b334a45a8ff	1270	/**
bogdanm	0:9b334a45a8ff	1271	* @brief Enables or disables the specified RTC Alarm.
bogdanm	0:9b334a45a8ff	1272	* @param RTC_Alarm: specifies the alarm to be configured.
bogdanm	0:9b334a45a8ff	1273	* This parameter can be any combination of the following values:
bogdanm	0:9b334a45a8ff	1274	* @arg RTC_Alarm_A: to select Alarm A
bogdanm	0:9b334a45a8ff	1275	* @arg RTC_Alarm_B: to select Alarm B
bogdanm	0:9b334a45a8ff	1276	* @param NewState: new state of the specified alarm.
bogdanm	0:9b334a45a8ff	1277	* This parameter can be: ENABLE or DISABLE.
bogdanm	0:9b334a45a8ff	1278	* @retval An ErrorStatus enumeration value:
bogdanm	0:9b334a45a8ff	1279	* - SUCCESS: RTC Alarm is enabled/disabled
bogdanm	0:9b334a45a8ff	1280	* - ERROR: RTC Alarm is not enabled/disabled
bogdanm	0:9b334a45a8ff	1281	*/
bogdanm	0:9b334a45a8ff	1282	ErrorStatus RTC_AlarmCmd(uint32_t RTC_Alarm, FunctionalState NewState)
bogdanm	0:9b334a45a8ff	1283	{
bogdanm	0:9b334a45a8ff	1284	__IO uint32_t alarmcounter = 0x00;
bogdanm	0:9b334a45a8ff	1285	uint32_t alarmstatus = 0x00;
bogdanm	0:9b334a45a8ff	1286	ErrorStatus status = ERROR;
bogdanm	0:9b334a45a8ff	1287
bogdanm	0:9b334a45a8ff	1288	/* Check the parameters */
bogdanm	0:9b334a45a8ff	1289	assert_param(IS_RTC_CMD_ALARM(RTC_Alarm));
bogdanm	0:9b334a45a8ff	1290	assert_param(IS_FUNCTIONAL_STATE(NewState));
bogdanm	0:9b334a45a8ff	1291
bogdanm	0:9b334a45a8ff	1292	/* Disable the write protection for RTC registers */
bogdanm	0:9b334a45a8ff	1293	RTC->WPR = 0xCA;
bogdanm	0:9b334a45a8ff	1294	RTC->WPR = 0x53;
bogdanm	0:9b334a45a8ff	1295
bogdanm	0:9b334a45a8ff	1296	/* Configure the Alarm state */
bogdanm	0:9b334a45a8ff	1297	if (NewState != DISABLE)
bogdanm	0:9b334a45a8ff	1298	{
bogdanm	0:9b334a45a8ff	1299	RTC->CR \|= (uint32_t)RTC_Alarm;
bogdanm	0:9b334a45a8ff	1300
bogdanm	0:9b334a45a8ff	1301	status = SUCCESS;
bogdanm	0:9b334a45a8ff	1302	}
bogdanm	0:9b334a45a8ff	1303	else
bogdanm	0:9b334a45a8ff	1304	{
bogdanm	0:9b334a45a8ff	1305	/* Disable the Alarm in RTC_CR register */
bogdanm	0:9b334a45a8ff	1306	RTC->CR &= (uint32_t)~RTC_Alarm;
bogdanm	0:9b334a45a8ff	1307
bogdanm	0:9b334a45a8ff	1308	/* Wait till RTC ALRxWF flag is set and if Time out is reached exit */
bogdanm	0:9b334a45a8ff	1309	do
bogdanm	0:9b334a45a8ff	1310	{
bogdanm	0:9b334a45a8ff	1311	alarmstatus = RTC->ISR & (RTC_Alarm >> 8);
bogdanm	0:9b334a45a8ff	1312	alarmcounter++;
bogdanm	0:9b334a45a8ff	1313	} while((alarmcounter != INITMODE_TIMEOUT) && (alarmstatus == 0x00));
bogdanm	0:9b334a45a8ff	1314
bogdanm	0:9b334a45a8ff	1315	if ((RTC->ISR & (RTC_Alarm >> 8)) == RESET)
bogdanm	0:9b334a45a8ff	1316	{
bogdanm	0:9b334a45a8ff	1317	status = ERROR;
bogdanm	0:9b334a45a8ff	1318	}
bogdanm	0:9b334a45a8ff	1319	else
bogdanm	0:9b334a45a8ff	1320	{
bogdanm	0:9b334a45a8ff	1321	status = SUCCESS;
bogdanm	0:9b334a45a8ff	1322	}
bogdanm	0:9b334a45a8ff	1323	}
bogdanm	0:9b334a45a8ff	1324
bogdanm	0:9b334a45a8ff	1325	/* Enable the write protection for RTC registers */
bogdanm	0:9b334a45a8ff	1326	RTC->WPR = 0xFF;
bogdanm	0:9b334a45a8ff	1327
bogdanm	0:9b334a45a8ff	1328	return status;
bogdanm	0:9b334a45a8ff	1329	}
bogdanm	0:9b334a45a8ff	1330
bogdanm	0:9b334a45a8ff	1331	/**
bogdanm	0:9b334a45a8ff	1332	* @brief Configures the RTC AlarmA/B Subseconds value and mask.
bogdanm	0:9b334a45a8ff	1333	* @note This function is performed only when the Alarm is disabled.
bogdanm	0:9b334a45a8ff	1334	* @param RTC_Alarm: specifies the alarm to be configured.
bogdanm	0:9b334a45a8ff	1335	* This parameter can be one of the following values:
bogdanm	0:9b334a45a8ff	1336	* @arg RTC_Alarm_A: to select Alarm A
bogdanm	0:9b334a45a8ff	1337	* @arg RTC_Alarm_B: to select Alarm B
bogdanm	0:9b334a45a8ff	1338	* @param RTC_AlarmSubSecondValue: specifies the Subseconds value.
bogdanm	0:9b334a45a8ff	1339	* This parameter can be a value from 0 to 0x00007FFF.
bogdanm	0:9b334a45a8ff	1340	* @param RTC_AlarmSubSecondMask: specifies the Subseconds Mask.
bogdanm	0:9b334a45a8ff	1341	* This parameter can be any combination of the following values:
bogdanm	0:9b334a45a8ff	1342	* @arg RTC_AlarmSubSecondMask_All : All Alarm SS fields are masked.
bogdanm	0:9b334a45a8ff	1343	* There is no comparison on sub seconds for Alarm.
bogdanm	0:9b334a45a8ff	1344	* @arg RTC_AlarmSubSecondMask_SS14_1 : SS[14:1] are don't care in Alarm comparison.
bogdanm	0:9b334a45a8ff	1345	* Only SS[0] is compared
bogdanm	0:9b334a45a8ff	1346	* @arg RTC_AlarmSubSecondMask_SS14_2 : SS[14:2] are don't care in Alarm comparison.
bogdanm	0:9b334a45a8ff	1347	* Only SS[1:0] are compared
bogdanm	0:9b334a45a8ff	1348	* @arg RTC_AlarmSubSecondMask_SS14_3 : SS[14:3] are don't care in Alarm comparison.
bogdanm	0:9b334a45a8ff	1349	* Only SS[2:0] are compared
bogdanm	0:9b334a45a8ff	1350	* @arg RTC_AlarmSubSecondMask_SS14_4 : SS[14:4] are don't care in Alarm comparison.
bogdanm	0:9b334a45a8ff	1351	* Only SS[3:0] are compared
bogdanm	0:9b334a45a8ff	1352	* @arg RTC_AlarmSubSecondMask_SS14_5 : SS[14:5] are don't care in Alarm comparison.
bogdanm	0:9b334a45a8ff	1353	* Only SS[4:0] are compared
bogdanm	0:9b334a45a8ff	1354	* @arg RTC_AlarmSubSecondMask_SS14_6 : SS[14:6] are don't care in Alarm comparison.
bogdanm	0:9b334a45a8ff	1355	* Only SS[5:0] are compared
bogdanm	0:9b334a45a8ff	1356	* @arg RTC_AlarmSubSecondMask_SS14_7 : SS[14:7] are don't care in Alarm comparison.
bogdanm	0:9b334a45a8ff	1357	* Only SS[6:0] are compared
bogdanm	0:9b334a45a8ff	1358	* @arg RTC_AlarmSubSecondMask_SS14_8 : SS[14:8] are don't care in Alarm comparison.
bogdanm	0:9b334a45a8ff	1359	* Only SS[7:0] are compared
bogdanm	0:9b334a45a8ff	1360	* @arg RTC_AlarmSubSecondMask_SS14_9 : SS[14:9] are don't care in Alarm comparison.
bogdanm	0:9b334a45a8ff	1361	* Only SS[8:0] are compared
bogdanm	0:9b334a45a8ff	1362	* @arg RTC_AlarmSubSecondMask_SS14_10: SS[14:10] are don't care in Alarm comparison.
bogdanm	0:9b334a45a8ff	1363	* Only SS[9:0] are compared
bogdanm	0:9b334a45a8ff	1364	* @arg RTC_AlarmSubSecondMask_SS14_11: SS[14:11] are don't care in Alarm comparison.
bogdanm	0:9b334a45a8ff	1365	* Only SS[10:0] are compared
bogdanm	0:9b334a45a8ff	1366	* @arg RTC_AlarmSubSecondMask_SS14_12: SS[14:12] are don't care in Alarm comparison.
bogdanm	0:9b334a45a8ff	1367	* Only SS[11:0] are compared
bogdanm	0:9b334a45a8ff	1368	* @arg RTC_AlarmSubSecondMask_SS14_13: SS[14:13] are don't care in Alarm comparison.
bogdanm	0:9b334a45a8ff	1369	* Only SS[12:0] are compared
bogdanm	0:9b334a45a8ff	1370	* @arg RTC_AlarmSubSecondMask_SS14 : SS[14] is don't care in Alarm comparison.
bogdanm	0:9b334a45a8ff	1371	* Only SS[13:0] are compared
bogdanm	0:9b334a45a8ff	1372	* @arg RTC_AlarmSubSecondMask_None : SS[14:0] are compared and must match
bogdanm	0:9b334a45a8ff	1373	* to activate alarm
bogdanm	0:9b334a45a8ff	1374	* @retval None
bogdanm	0:9b334a45a8ff	1375	*/
bogdanm	0:9b334a45a8ff	1376	void RTC_AlarmSubSecondConfig(uint32_t RTC_Alarm, uint32_t RTC_AlarmSubSecondValue, uint32_t RTC_AlarmSubSecondMask)
bogdanm	0:9b334a45a8ff	1377	{
bogdanm	0:9b334a45a8ff	1378	uint32_t tmpreg = 0;
bogdanm	0:9b334a45a8ff	1379
bogdanm	0:9b334a45a8ff	1380	/* Check the parameters */
bogdanm	0:9b334a45a8ff	1381	assert_param(IS_RTC_ALARM(RTC_Alarm));
bogdanm	0:9b334a45a8ff	1382	assert_param(IS_RTC_ALARM_SUB_SECOND_VALUE(RTC_AlarmSubSecondValue));
bogdanm	0:9b334a45a8ff	1383	assert_param(IS_RTC_ALARM_SUB_SECOND_MASK(RTC_AlarmSubSecondMask));
bogdanm	0:9b334a45a8ff	1384
bogdanm	0:9b334a45a8ff	1385	/* Disable the write protection for RTC registers */
bogdanm	0:9b334a45a8ff	1386	RTC->WPR = 0xCA;
bogdanm	0:9b334a45a8ff	1387	RTC->WPR = 0x53;
bogdanm	0:9b334a45a8ff	1388
bogdanm	0:9b334a45a8ff	1389	/* Configure the Alarm A or Alarm B SubSecond registers */
bogdanm	0:9b334a45a8ff	1390	tmpreg = (uint32_t) (uint32_t)(RTC_AlarmSubSecondValue) \| (uint32_t)(RTC_AlarmSubSecondMask);
bogdanm	0:9b334a45a8ff	1391
bogdanm	0:9b334a45a8ff	1392	if (RTC_Alarm == RTC_Alarm_A)
bogdanm	0:9b334a45a8ff	1393	{
bogdanm	0:9b334a45a8ff	1394	/* Configure the AlarmA SubSecond register */
bogdanm	0:9b334a45a8ff	1395	RTC->ALRMASSR = tmpreg;
bogdanm	0:9b334a45a8ff	1396	}
bogdanm	0:9b334a45a8ff	1397	else
bogdanm	0:9b334a45a8ff	1398	{
bogdanm	0:9b334a45a8ff	1399	/* Configure the Alarm B SubSecond register */
bogdanm	0:9b334a45a8ff	1400	RTC->ALRMBSSR = tmpreg;
bogdanm	0:9b334a45a8ff	1401	}
bogdanm	0:9b334a45a8ff	1402
bogdanm	0:9b334a45a8ff	1403	/* Enable the write protection for RTC registers */
bogdanm	0:9b334a45a8ff	1404	RTC->WPR = 0xFF;
bogdanm	0:9b334a45a8ff	1405
bogdanm	0:9b334a45a8ff	1406	}
bogdanm	0:9b334a45a8ff	1407
bogdanm	0:9b334a45a8ff	1408	/**
bogdanm	0:9b334a45a8ff	1409	* @brief Gets the RTC Alarm Subseconds value.
bogdanm	0:9b334a45a8ff	1410	* @param RTC_Alarm: specifies the alarm to be read.
bogdanm	0:9b334a45a8ff	1411	* This parameter can be one of the following values:
bogdanm	0:9b334a45a8ff	1412	* @arg RTC_Alarm_A: to select Alarm A
bogdanm	0:9b334a45a8ff	1413	* @arg RTC_Alarm_B: to select Alarm B
bogdanm	0:9b334a45a8ff	1414	* @param None
bogdanm	0:9b334a45a8ff	1415	* @retval RTC Alarm Subseconds value.
bogdanm	0:9b334a45a8ff	1416	*/
bogdanm	0:9b334a45a8ff	1417	uint32_t RTC_GetAlarmSubSecond(uint32_t RTC_Alarm)
bogdanm	0:9b334a45a8ff	1418	{
bogdanm	0:9b334a45a8ff	1419	uint32_t tmpreg = 0;
bogdanm	0:9b334a45a8ff	1420
bogdanm	0:9b334a45a8ff	1421	/* Get the RTC_ALRMxR register */
bogdanm	0:9b334a45a8ff	1422	if (RTC_Alarm == RTC_Alarm_A)
bogdanm	0:9b334a45a8ff	1423	{
bogdanm	0:9b334a45a8ff	1424	tmpreg = (uint32_t)((RTC->ALRMASSR) & RTC_ALRMASSR_SS);
bogdanm	0:9b334a45a8ff	1425	}
bogdanm	0:9b334a45a8ff	1426	else
bogdanm	0:9b334a45a8ff	1427	{
bogdanm	0:9b334a45a8ff	1428	tmpreg = (uint32_t)((RTC->ALRMBSSR) & RTC_ALRMBSSR_SS);
bogdanm	0:9b334a45a8ff	1429	}
bogdanm	0:9b334a45a8ff	1430
bogdanm	0:9b334a45a8ff	1431	return (tmpreg);
bogdanm	0:9b334a45a8ff	1432	}
bogdanm	0:9b334a45a8ff	1433
bogdanm	0:9b334a45a8ff	1434	/**
bogdanm	0:9b334a45a8ff	1435	* @}
bogdanm	0:9b334a45a8ff	1436	*/
bogdanm	0:9b334a45a8ff	1437
bogdanm	0:9b334a45a8ff	1438	/** @defgroup RTC_Group4 WakeUp Timer configuration functions
bogdanm	0:9b334a45a8ff	1439	* @brief WakeUp Timer configuration functions
bogdanm	0:9b334a45a8ff	1440	*
bogdanm	0:9b334a45a8ff	1441	@verbatim
bogdanm	0:9b334a45a8ff	1442	===============================================================================
bogdanm	0:9b334a45a8ff	1443	##### WakeUp Timer configuration functions #####
bogdanm	0:9b334a45a8ff	1444	===============================================================================
bogdanm	0:9b334a45a8ff	1445	[..] This section provide functions allowing to program and read the RTC WakeUp.
bogdanm	0:9b334a45a8ff	1446
bogdanm	0:9b334a45a8ff	1447	@endverbatim
bogdanm	0:9b334a45a8ff	1448	* @{
bogdanm	0:9b334a45a8ff	1449	*/
bogdanm	0:9b334a45a8ff	1450
bogdanm	0:9b334a45a8ff	1451	/**
bogdanm	0:9b334a45a8ff	1452	* @brief Configures the RTC Wakeup clock source.
bogdanm	0:9b334a45a8ff	1453	* @note The WakeUp Clock source can only be changed when the RTC WakeUp
bogdanm	0:9b334a45a8ff	1454	* is disabled (Use the RTC_WakeUpCmd(DISABLE)).
bogdanm	0:9b334a45a8ff	1455	* @param RTC_WakeUpClock: Wakeup Clock source.
bogdanm	0:9b334a45a8ff	1456	* This parameter can be one of the following values:
bogdanm	0:9b334a45a8ff	1457	* @arg RTC_WakeUpClock_RTCCLK_Div16: RTC Wakeup Counter Clock = RTCCLK/16
bogdanm	0:9b334a45a8ff	1458	* @arg RTC_WakeUpClock_RTCCLK_Div8: RTC Wakeup Counter Clock = RTCCLK/8
bogdanm	0:9b334a45a8ff	1459	* @arg RTC_WakeUpClock_RTCCLK_Div4: RTC Wakeup Counter Clock = RTCCLK/4
bogdanm	0:9b334a45a8ff	1460	* @arg RTC_WakeUpClock_RTCCLK_Div2: RTC Wakeup Counter Clock = RTCCLK/2
bogdanm	0:9b334a45a8ff	1461	* @arg RTC_WakeUpClock_CK_SPRE_16bits: RTC Wakeup Counter Clock = CK_SPRE
bogdanm	0:9b334a45a8ff	1462	* @arg RTC_WakeUpClock_CK_SPRE_17bits: RTC Wakeup Counter Clock = CK_SPRE
bogdanm	0:9b334a45a8ff	1463	* @retval None
bogdanm	0:9b334a45a8ff	1464	*/
bogdanm	0:9b334a45a8ff	1465	void RTC_WakeUpClockConfig(uint32_t RTC_WakeUpClock)
bogdanm	0:9b334a45a8ff	1466	{
bogdanm	0:9b334a45a8ff	1467	/* Check the parameters */
bogdanm	0:9b334a45a8ff	1468	assert_param(IS_RTC_WAKEUP_CLOCK(RTC_WakeUpClock));
bogdanm	0:9b334a45a8ff	1469
bogdanm	0:9b334a45a8ff	1470	/* Disable the write protection for RTC registers */
bogdanm	0:9b334a45a8ff	1471	RTC->WPR = 0xCA;
bogdanm	0:9b334a45a8ff	1472	RTC->WPR = 0x53;
bogdanm	0:9b334a45a8ff	1473
bogdanm	0:9b334a45a8ff	1474	/* Clear the Wakeup Timer clock source bits in CR register */
bogdanm	0:9b334a45a8ff	1475	RTC->CR &= (uint32_t)~RTC_CR_WUCKSEL;
bogdanm	0:9b334a45a8ff	1476
bogdanm	0:9b334a45a8ff	1477	/* Configure the clock source */
bogdanm	0:9b334a45a8ff	1478	RTC->CR \|= (uint32_t)RTC_WakeUpClock;
bogdanm	0:9b334a45a8ff	1479
bogdanm	0:9b334a45a8ff	1480	/* Enable the write protection for RTC registers */
bogdanm	0:9b334a45a8ff	1481	RTC->WPR = 0xFF;
bogdanm	0:9b334a45a8ff	1482	}
bogdanm	0:9b334a45a8ff	1483
bogdanm	0:9b334a45a8ff	1484	/**
bogdanm	0:9b334a45a8ff	1485	* @brief Configures the RTC Wakeup counter.
bogdanm	0:9b334a45a8ff	1486	* @note The RTC WakeUp counter can only be written when the RTC WakeUp
bogdanm	0:9b334a45a8ff	1487	* is disabled (Use the RTC_WakeUpCmd(DISABLE)).
bogdanm	0:9b334a45a8ff	1488	* @param RTC_WakeUpCounter: specifies the WakeUp counter.
bogdanm	0:9b334a45a8ff	1489	* This parameter can be a value from 0x0000 to 0xFFFF.
bogdanm	0:9b334a45a8ff	1490	* @retval None
bogdanm	0:9b334a45a8ff	1491	*/
bogdanm	0:9b334a45a8ff	1492	void RTC_SetWakeUpCounter(uint32_t RTC_WakeUpCounter)
bogdanm	0:9b334a45a8ff	1493	{
bogdanm	0:9b334a45a8ff	1494	/* Check the parameters */
bogdanm	0:9b334a45a8ff	1495	assert_param(IS_RTC_WAKEUP_COUNTER(RTC_WakeUpCounter));
bogdanm	0:9b334a45a8ff	1496
bogdanm	0:9b334a45a8ff	1497	/* Disable the write protection for RTC registers */
bogdanm	0:9b334a45a8ff	1498	RTC->WPR = 0xCA;
bogdanm	0:9b334a45a8ff	1499	RTC->WPR = 0x53;
bogdanm	0:9b334a45a8ff	1500
bogdanm	0:9b334a45a8ff	1501	/* Configure the Wakeup Timer counter */
bogdanm	0:9b334a45a8ff	1502	RTC->WUTR = (uint32_t)RTC_WakeUpCounter;
bogdanm	0:9b334a45a8ff	1503
bogdanm	0:9b334a45a8ff	1504	/* Enable the write protection for RTC registers */
bogdanm	0:9b334a45a8ff	1505	RTC->WPR = 0xFF;
bogdanm	0:9b334a45a8ff	1506	}
bogdanm	0:9b334a45a8ff	1507
bogdanm	0:9b334a45a8ff	1508	/**
bogdanm	0:9b334a45a8ff	1509	* @brief Returns the RTC WakeUp timer counter value.
bogdanm	0:9b334a45a8ff	1510	* @param None
bogdanm	0:9b334a45a8ff	1511	* @retval The RTC WakeUp Counter value.
bogdanm	0:9b334a45a8ff	1512	*/
bogdanm	0:9b334a45a8ff	1513	uint32_t RTC_GetWakeUpCounter(void)
bogdanm	0:9b334a45a8ff	1514	{
bogdanm	0:9b334a45a8ff	1515	/* Get the counter value */
bogdanm	0:9b334a45a8ff	1516	return ((uint32_t)(RTC->WUTR & RTC_WUTR_WUT));
bogdanm	0:9b334a45a8ff	1517	}
bogdanm	0:9b334a45a8ff	1518
bogdanm	0:9b334a45a8ff	1519	/**
bogdanm	0:9b334a45a8ff	1520	* @brief Enables or Disables the RTC WakeUp timer.
bogdanm	0:9b334a45a8ff	1521	* @param NewState: new state of the WakeUp timer.
bogdanm	0:9b334a45a8ff	1522	* This parameter can be: ENABLE or DISABLE.
bogdanm	0:9b334a45a8ff	1523	* @retval None
bogdanm	0:9b334a45a8ff	1524	*/
bogdanm	0:9b334a45a8ff	1525	ErrorStatus RTC_WakeUpCmd(FunctionalState NewState)
bogdanm	0:9b334a45a8ff	1526	{
bogdanm	0:9b334a45a8ff	1527	__IO uint32_t wutcounter = 0x00;
bogdanm	0:9b334a45a8ff	1528	uint32_t wutwfstatus = 0x00;
bogdanm	0:9b334a45a8ff	1529	ErrorStatus status = ERROR;
bogdanm	0:9b334a45a8ff	1530
bogdanm	0:9b334a45a8ff	1531	/* Check the parameters */
bogdanm	0:9b334a45a8ff	1532	assert_param(IS_FUNCTIONAL_STATE(NewState));
bogdanm	0:9b334a45a8ff	1533
bogdanm	0:9b334a45a8ff	1534	/* Disable the write protection for RTC registers */
bogdanm	0:9b334a45a8ff	1535	RTC->WPR = 0xCA;
bogdanm	0:9b334a45a8ff	1536	RTC->WPR = 0x53;
bogdanm	0:9b334a45a8ff	1537
bogdanm	0:9b334a45a8ff	1538	if (NewState != DISABLE)
bogdanm	0:9b334a45a8ff	1539	{
bogdanm	0:9b334a45a8ff	1540	/* Enable the Wakeup Timer */
bogdanm	0:9b334a45a8ff	1541	RTC->CR \|= (uint32_t)RTC_CR_WUTE;
bogdanm	0:9b334a45a8ff	1542	status = SUCCESS;
bogdanm	0:9b334a45a8ff	1543	}
bogdanm	0:9b334a45a8ff	1544	else
bogdanm	0:9b334a45a8ff	1545	{
bogdanm	0:9b334a45a8ff	1546	/* Disable the Wakeup Timer */
bogdanm	0:9b334a45a8ff	1547	RTC->CR &= (uint32_t)~RTC_CR_WUTE;
bogdanm	0:9b334a45a8ff	1548	/* Wait till RTC WUTWF flag is set and if Time out is reached exit */
bogdanm	0:9b334a45a8ff	1549	do
bogdanm	0:9b334a45a8ff	1550	{
bogdanm	0:9b334a45a8ff	1551	wutwfstatus = RTC->ISR & RTC_ISR_WUTWF;
bogdanm	0:9b334a45a8ff	1552	wutcounter++;
bogdanm	0:9b334a45a8ff	1553	} while((wutcounter != INITMODE_TIMEOUT) && (wutwfstatus == 0x00));
bogdanm	0:9b334a45a8ff	1554
bogdanm	0:9b334a45a8ff	1555	if ((RTC->ISR & RTC_ISR_WUTWF) == RESET)
bogdanm	0:9b334a45a8ff	1556	{
bogdanm	0:9b334a45a8ff	1557	status = ERROR;
bogdanm	0:9b334a45a8ff	1558	}
bogdanm	0:9b334a45a8ff	1559	else
bogdanm	0:9b334a45a8ff	1560	{
bogdanm	0:9b334a45a8ff	1561	status = SUCCESS;
bogdanm	0:9b334a45a8ff	1562	}
bogdanm	0:9b334a45a8ff	1563	}
bogdanm	0:9b334a45a8ff	1564
bogdanm	0:9b334a45a8ff	1565	/* Enable the write protection for RTC registers */
bogdanm	0:9b334a45a8ff	1566	RTC->WPR = 0xFF;
bogdanm	0:9b334a45a8ff	1567
bogdanm	0:9b334a45a8ff	1568	return status;
bogdanm	0:9b334a45a8ff	1569	}
bogdanm	0:9b334a45a8ff	1570
bogdanm	0:9b334a45a8ff	1571	/**
bogdanm	0:9b334a45a8ff	1572	* @}
bogdanm	0:9b334a45a8ff	1573	*/
bogdanm	0:9b334a45a8ff	1574
bogdanm	0:9b334a45a8ff	1575	/** @defgroup RTC_Group5 Daylight Saving configuration functions
bogdanm	0:9b334a45a8ff	1576	* @brief Daylight Saving configuration functions
bogdanm	0:9b334a45a8ff	1577	*
bogdanm	0:9b334a45a8ff	1578	@verbatim
bogdanm	0:9b334a45a8ff	1579	===============================================================================
bogdanm	0:9b334a45a8ff	1580	##### Daylight Saving configuration functions #####
bogdanm	0:9b334a45a8ff	1581	===============================================================================
bogdanm	0:9b334a45a8ff	1582	[..] This section provide functions allowing to configure the RTC DayLight Saving.
bogdanm	0:9b334a45a8ff	1583
bogdanm	0:9b334a45a8ff	1584	@endverbatim
bogdanm	0:9b334a45a8ff	1585	* @{
bogdanm	0:9b334a45a8ff	1586	*/
bogdanm	0:9b334a45a8ff	1587
bogdanm	0:9b334a45a8ff	1588	/**
bogdanm	0:9b334a45a8ff	1589	* @brief Adds or substract one hour from the current time.
bogdanm	0:9b334a45a8ff	1590	* @param RTC_DayLightSaveOperation: the value of hour adjustment.
bogdanm	0:9b334a45a8ff	1591	* This parameter can be one of the following values:
bogdanm	0:9b334a45a8ff	1592	* @arg RTC_DayLightSaving_SUB1H: Substract one hour (winter time)
bogdanm	0:9b334a45a8ff	1593	* @arg RTC_DayLightSaving_ADD1H: Add one hour (summer time)
bogdanm	0:9b334a45a8ff	1594	* @param RTC_StoreOperation: Specifies the value to be written in the BCK bit
bogdanm	0:9b334a45a8ff	1595	* in CR register to store the operation.
bogdanm	0:9b334a45a8ff	1596	* This parameter can be one of the following values:
bogdanm	0:9b334a45a8ff	1597	* @arg RTC_StoreOperation_Reset: BCK Bit Reset
bogdanm	0:9b334a45a8ff	1598	* @arg RTC_StoreOperation_Set: BCK Bit Set
bogdanm	0:9b334a45a8ff	1599	* @retval None
bogdanm	0:9b334a45a8ff	1600	*/
bogdanm	0:9b334a45a8ff	1601	void RTC_DayLightSavingConfig(uint32_t RTC_DayLightSaving, uint32_t RTC_StoreOperation)
bogdanm	0:9b334a45a8ff	1602	{
bogdanm	0:9b334a45a8ff	1603	/* Check the parameters */
bogdanm	0:9b334a45a8ff	1604	assert_param(IS_RTC_DAYLIGHT_SAVING(RTC_DayLightSaving));
bogdanm	0:9b334a45a8ff	1605	assert_param(IS_RTC_STORE_OPERATION(RTC_StoreOperation));
bogdanm	0:9b334a45a8ff	1606
bogdanm	0:9b334a45a8ff	1607	/* Disable the write protection for RTC registers */
bogdanm	0:9b334a45a8ff	1608	RTC->WPR = 0xCA;
bogdanm	0:9b334a45a8ff	1609	RTC->WPR = 0x53;
bogdanm	0:9b334a45a8ff	1610
bogdanm	0:9b334a45a8ff	1611	/* Clear the bits to be configured */
bogdanm	0:9b334a45a8ff	1612	RTC->CR &= (uint32_t)~(RTC_CR_BCK);
bogdanm	0:9b334a45a8ff	1613
bogdanm	0:9b334a45a8ff	1614	/* Configure the RTC_CR register */
bogdanm	0:9b334a45a8ff	1615	RTC->CR \|= (uint32_t)(RTC_DayLightSaving \| RTC_StoreOperation);
bogdanm	0:9b334a45a8ff	1616
bogdanm	0:9b334a45a8ff	1617	/* Enable the write protection for RTC registers */
bogdanm	0:9b334a45a8ff	1618	RTC->WPR = 0xFF;
bogdanm	0:9b334a45a8ff	1619	}
bogdanm	0:9b334a45a8ff	1620
bogdanm	0:9b334a45a8ff	1621	/**
bogdanm	0:9b334a45a8ff	1622	* @brief Returns the RTC Day Light Saving stored operation.
bogdanm	0:9b334a45a8ff	1623	* @param None
bogdanm	0:9b334a45a8ff	1624	* @retval RTC Day Light Saving stored operation.
bogdanm	0:9b334a45a8ff	1625	* - RTC_StoreOperation_Reset
bogdanm	0:9b334a45a8ff	1626	* - RTC_StoreOperation_Set
bogdanm	0:9b334a45a8ff	1627	*/
bogdanm	0:9b334a45a8ff	1628	uint32_t RTC_GetStoreOperation(void)
bogdanm	0:9b334a45a8ff	1629	{
bogdanm	0:9b334a45a8ff	1630	return (RTC->CR & RTC_CR_BCK);
bogdanm	0:9b334a45a8ff	1631	}
bogdanm	0:9b334a45a8ff	1632
bogdanm	0:9b334a45a8ff	1633	/**
bogdanm	0:9b334a45a8ff	1634	* @}
bogdanm	0:9b334a45a8ff	1635	*/
bogdanm	0:9b334a45a8ff	1636
bogdanm	0:9b334a45a8ff	1637	/** @defgroup RTC_Group6 Output pin Configuration function
bogdanm	0:9b334a45a8ff	1638	* @brief Output pin Configuration function
bogdanm	0:9b334a45a8ff	1639	*
bogdanm	0:9b334a45a8ff	1640	@verbatim
bogdanm	0:9b334a45a8ff	1641	===============================================================================
bogdanm	0:9b334a45a8ff	1642	##### Output pin Configuration function #####
bogdanm	0:9b334a45a8ff	1643	===============================================================================
bogdanm	0:9b334a45a8ff	1644	[..] This section provide functions allowing to configure the RTC Output source.
bogdanm	0:9b334a45a8ff	1645
bogdanm	0:9b334a45a8ff	1646	@endverbatim
bogdanm	0:9b334a45a8ff	1647	* @{
bogdanm	0:9b334a45a8ff	1648	*/
bogdanm	0:9b334a45a8ff	1649
bogdanm	0:9b334a45a8ff	1650	/**
bogdanm	0:9b334a45a8ff	1651	* @brief Configures the RTC output source (AFO_ALARM).
bogdanm	0:9b334a45a8ff	1652	* @param RTC_Output: Specifies which signal will be routed to the RTC output.
bogdanm	0:9b334a45a8ff	1653	* This parameter can be one of the following values:
bogdanm	0:9b334a45a8ff	1654	* @arg RTC_Output_Disable: No output selected
bogdanm	0:9b334a45a8ff	1655	* @arg RTC_Output_AlarmA: signal of AlarmA mapped to output
bogdanm	0:9b334a45a8ff	1656	* @arg RTC_Output_AlarmB: signal of AlarmB mapped to output
bogdanm	0:9b334a45a8ff	1657	* @arg RTC_Output_WakeUp: signal of WakeUp mapped to output
bogdanm	0:9b334a45a8ff	1658	* @param RTC_OutputPolarity: Specifies the polarity of the output signal.
bogdanm	0:9b334a45a8ff	1659	* This parameter can be one of the following:
bogdanm	0:9b334a45a8ff	1660	* @arg RTC_OutputPolarity_High: The output pin is high when the
bogdanm	0:9b334a45a8ff	1661	* ALRAF/ALRBF/WUTF is high (depending on OSEL)
bogdanm	0:9b334a45a8ff	1662	* @arg RTC_OutputPolarity_Low: The output pin is low when the
bogdanm	0:9b334a45a8ff	1663	* ALRAF/ALRBF/WUTF is high (depending on OSEL)
bogdanm	0:9b334a45a8ff	1664	* @retval None
bogdanm	0:9b334a45a8ff	1665	*/
bogdanm	0:9b334a45a8ff	1666	void RTC_OutputConfig(uint32_t RTC_Output, uint32_t RTC_OutputPolarity)
bogdanm	0:9b334a45a8ff	1667	{
bogdanm	0:9b334a45a8ff	1668	/* Check the parameters */
bogdanm	0:9b334a45a8ff	1669	assert_param(IS_RTC_OUTPUT(RTC_Output));
bogdanm	0:9b334a45a8ff	1670	assert_param(IS_RTC_OUTPUT_POL(RTC_OutputPolarity));
bogdanm	0:9b334a45a8ff	1671
bogdanm	0:9b334a45a8ff	1672	/* Disable the write protection for RTC registers */
bogdanm	0:9b334a45a8ff	1673	RTC->WPR = 0xCA;
bogdanm	0:9b334a45a8ff	1674	RTC->WPR = 0x53;
bogdanm	0:9b334a45a8ff	1675
bogdanm	0:9b334a45a8ff	1676	/* Clear the bits to be configured */
bogdanm	0:9b334a45a8ff	1677	RTC->CR &= (uint32_t)~(RTC_CR_OSEL \| RTC_CR_POL);
bogdanm	0:9b334a45a8ff	1678
bogdanm	0:9b334a45a8ff	1679	/* Configure the output selection and polarity */
bogdanm	0:9b334a45a8ff	1680	RTC->CR \|= (uint32_t)(RTC_Output \| RTC_OutputPolarity);
bogdanm	0:9b334a45a8ff	1681
bogdanm	0:9b334a45a8ff	1682	/* Enable the write protection for RTC registers */
bogdanm	0:9b334a45a8ff	1683	RTC->WPR = 0xFF;
bogdanm	0:9b334a45a8ff	1684	}
bogdanm	0:9b334a45a8ff	1685
bogdanm	0:9b334a45a8ff	1686	/**
bogdanm	0:9b334a45a8ff	1687	* @}
bogdanm	0:9b334a45a8ff	1688	*/
bogdanm	0:9b334a45a8ff	1689
bogdanm	0:9b334a45a8ff	1690	/** @defgroup RTC_Group7 Digital Calibration configuration functions
bogdanm	0:9b334a45a8ff	1691	* @brief Digital Calibration configuration functions
bogdanm	0:9b334a45a8ff	1692	*
bogdanm	0:9b334a45a8ff	1693	@verbatim
bogdanm	0:9b334a45a8ff	1694	===============================================================================
bogdanm	0:9b334a45a8ff	1695	##### Digital Calibration configuration functions #####
bogdanm	0:9b334a45a8ff	1696	===============================================================================
bogdanm	0:9b334a45a8ff	1697
bogdanm	0:9b334a45a8ff	1698	@endverbatim
bogdanm	0:9b334a45a8ff	1699	* @{
bogdanm	0:9b334a45a8ff	1700	*/
bogdanm	0:9b334a45a8ff	1701
bogdanm	0:9b334a45a8ff	1702	/**
bogdanm	0:9b334a45a8ff	1703	* @brief Enables or disables the RTC clock to be output through the relative
bogdanm	0:9b334a45a8ff	1704	* pin.
bogdanm	0:9b334a45a8ff	1705	* @param NewState: new state of the digital calibration Output.
bogdanm	0:9b334a45a8ff	1706	* This parameter can be: ENABLE or DISABLE.
bogdanm	0:9b334a45a8ff	1707	* @retval None
bogdanm	0:9b334a45a8ff	1708	*/
bogdanm	0:9b334a45a8ff	1709	void RTC_CalibOutputCmd(FunctionalState NewState)
bogdanm	0:9b334a45a8ff	1710	{
bogdanm	0:9b334a45a8ff	1711	/* Check the parameters */
bogdanm	0:9b334a45a8ff	1712	assert_param(IS_FUNCTIONAL_STATE(NewState));
bogdanm	0:9b334a45a8ff	1713
bogdanm	0:9b334a45a8ff	1714	/* Disable the write protection for RTC registers */
bogdanm	0:9b334a45a8ff	1715	RTC->WPR = 0xCA;
bogdanm	0:9b334a45a8ff	1716	RTC->WPR = 0x53;
bogdanm	0:9b334a45a8ff	1717
bogdanm	0:9b334a45a8ff	1718	if (NewState != DISABLE)
bogdanm	0:9b334a45a8ff	1719	{
bogdanm	0:9b334a45a8ff	1720	/* Enable the RTC clock output */
bogdanm	0:9b334a45a8ff	1721	RTC->CR \|= (uint32_t)RTC_CR_COE;
bogdanm	0:9b334a45a8ff	1722	}
bogdanm	0:9b334a45a8ff	1723	else
bogdanm	0:9b334a45a8ff	1724	{
bogdanm	0:9b334a45a8ff	1725	/* Disable the RTC clock output */
bogdanm	0:9b334a45a8ff	1726	RTC->CR &= (uint32_t)~RTC_CR_COE;
bogdanm	0:9b334a45a8ff	1727	}
bogdanm	0:9b334a45a8ff	1728
bogdanm	0:9b334a45a8ff	1729	/* Enable the write protection for RTC registers */
bogdanm	0:9b334a45a8ff	1730	RTC->WPR = 0xFF;
bogdanm	0:9b334a45a8ff	1731	}
bogdanm	0:9b334a45a8ff	1732
bogdanm	0:9b334a45a8ff	1733	/**
bogdanm	0:9b334a45a8ff	1734	* @brief Configures the Calibration Pinout (RTC_CALIB) Selection (1Hz or 512Hz).
bogdanm	0:9b334a45a8ff	1735	* @param RTC_CalibOutput : Select the Calibration output Selection .
bogdanm	0:9b334a45a8ff	1736	* This parameter can be one of the following values:
bogdanm	0:9b334a45a8ff	1737	* @arg RTC_CalibOutput_512Hz: A signal has a regular waveform at 512Hz.
bogdanm	0:9b334a45a8ff	1738	* @arg RTC_CalibOutput_1Hz : A signal has a regular waveform at 1Hz.
bogdanm	0:9b334a45a8ff	1739	* @retval None
bogdanm	0:9b334a45a8ff	1740	*/
bogdanm	0:9b334a45a8ff	1741	void RTC_CalibOutputConfig(uint32_t RTC_CalibOutput)
bogdanm	0:9b334a45a8ff	1742	{
bogdanm	0:9b334a45a8ff	1743	/* Check the parameters */
bogdanm	0:9b334a45a8ff	1744	assert_param(IS_RTC_CALIB_OUTPUT(RTC_CalibOutput));
bogdanm	0:9b334a45a8ff	1745
bogdanm	0:9b334a45a8ff	1746	/* Disable the write protection for RTC registers */
bogdanm	0:9b334a45a8ff	1747	RTC->WPR = 0xCA;
bogdanm	0:9b334a45a8ff	1748	RTC->WPR = 0x53;
bogdanm	0:9b334a45a8ff	1749
bogdanm	0:9b334a45a8ff	1750	/clear flags before config/
bogdanm	0:9b334a45a8ff	1751	RTC->CR &= (uint32_t)~(RTC_CR_COSEL);
bogdanm	0:9b334a45a8ff	1752
bogdanm	0:9b334a45a8ff	1753	/* Configure the RTC_CR register */
bogdanm	0:9b334a45a8ff	1754	RTC->CR \|= (uint32_t)RTC_CalibOutput;
bogdanm	0:9b334a45a8ff	1755
bogdanm	0:9b334a45a8ff	1756	/* Enable the write protection for RTC registers */
bogdanm	0:9b334a45a8ff	1757	RTC->WPR = 0xFF;
bogdanm	0:9b334a45a8ff	1758	}
bogdanm	0:9b334a45a8ff	1759
bogdanm	0:9b334a45a8ff	1760	/**
bogdanm	0:9b334a45a8ff	1761	* @brief Configures the Smooth Calibration Settings.
bogdanm	0:9b334a45a8ff	1762	* @param RTC_SmoothCalibPeriod : Select the Smooth Calibration Period.
bogdanm	0:9b334a45a8ff	1763	* This parameter can be can be one of the following values:
bogdanm	0:9b334a45a8ff	1764	* @arg RTC_SmoothCalibPeriod_32sec : The smooth calibration periode is 32s.
bogdanm	0:9b334a45a8ff	1765	* @arg RTC_SmoothCalibPeriod_16sec : The smooth calibration periode is 16s.
bogdanm	0:9b334a45a8ff	1766	* @arg RTC_SmoothCalibPeriod_8sec : The smooth calibartion periode is 8s.
bogdanm	0:9b334a45a8ff	1767	* @param RTC_SmoothCalibPlusPulses : Select to Set or reset the CALP bit.
bogdanm	0:9b334a45a8ff	1768	* This parameter can be one of the following values:
bogdanm	0:9b334a45a8ff	1769	* @arg RTC_SmoothCalibPlusPulses_Set : Add one RTCCLK puls every 2**11 pulses.
bogdanm	0:9b334a45a8ff	1770	* @arg RTC_SmoothCalibPlusPulses_Reset: No RTCCLK pulses are added.
bogdanm	0:9b334a45a8ff	1771	* @param RTC_SmouthCalibMinusPulsesValue: Select the value of CALM[8:0] bits.
bogdanm	0:9b334a45a8ff	1772	* This parameter can be one any value from 0 to 0x000001FF.
bogdanm	0:9b334a45a8ff	1773	* @retval An ErrorStatus enumeration value:
bogdanm	0:9b334a45a8ff	1774	* - SUCCESS: RTC Calib registers are configured
bogdanm	0:9b334a45a8ff	1775	* - ERROR: RTC Calib registers are not configured
bogdanm	0:9b334a45a8ff	1776	*/
bogdanm	0:9b334a45a8ff	1777	ErrorStatus RTC_SmoothCalibConfig(uint32_t RTC_SmoothCalibPeriod,
bogdanm	0:9b334a45a8ff	1778	uint32_t RTC_SmoothCalibPlusPulses,
bogdanm	0:9b334a45a8ff	1779	uint32_t RTC_SmouthCalibMinusPulsesValue)
bogdanm	0:9b334a45a8ff	1780	{
bogdanm	0:9b334a45a8ff	1781	ErrorStatus status = ERROR;
bogdanm	0:9b334a45a8ff	1782	uint32_t recalpfcount = 0;
bogdanm	0:9b334a45a8ff	1783
bogdanm	0:9b334a45a8ff	1784	/* Check the parameters */
bogdanm	0:9b334a45a8ff	1785	assert_param(IS_RTC_SMOOTH_CALIB_PERIOD(RTC_SmoothCalibPeriod));
bogdanm	0:9b334a45a8ff	1786	assert_param(IS_RTC_SMOOTH_CALIB_PLUS(RTC_SmoothCalibPlusPulses));
bogdanm	0:9b334a45a8ff	1787	assert_param(IS_RTC_SMOOTH_CALIB_MINUS(RTC_SmouthCalibMinusPulsesValue));
bogdanm	0:9b334a45a8ff	1788
bogdanm	0:9b334a45a8ff	1789	/* Disable the write protection for RTC registers */
bogdanm	0:9b334a45a8ff	1790	RTC->WPR = 0xCA;
bogdanm	0:9b334a45a8ff	1791	RTC->WPR = 0x53;
bogdanm	0:9b334a45a8ff	1792
bogdanm	0:9b334a45a8ff	1793	/* check if a calibration is pending*/
bogdanm	0:9b334a45a8ff	1794	if ((RTC->ISR & RTC_ISR_RECALPF) != RESET)
bogdanm	0:9b334a45a8ff	1795	{
bogdanm	0:9b334a45a8ff	1796	/* wait until the Calibration is completed*/
bogdanm	0:9b334a45a8ff	1797	while (((RTC->ISR & RTC_ISR_RECALPF) != RESET) && (recalpfcount != RECALPF_TIMEOUT))
bogdanm	0:9b334a45a8ff	1798	{
bogdanm	0:9b334a45a8ff	1799	recalpfcount++;
bogdanm	0:9b334a45a8ff	1800	}
bogdanm	0:9b334a45a8ff	1801	}
bogdanm	0:9b334a45a8ff	1802
bogdanm	0:9b334a45a8ff	1803	/* check if the calibration pending is completed or if there is no calibration operation at all*/
bogdanm	0:9b334a45a8ff	1804	if ((RTC->ISR & RTC_ISR_RECALPF) == RESET)
bogdanm	0:9b334a45a8ff	1805	{
bogdanm	0:9b334a45a8ff	1806	/* Configure the Smooth calibration settings */
bogdanm	0:9b334a45a8ff	1807	RTC->CALR = (uint32_t)((uint32_t)RTC_SmoothCalibPeriod \| (uint32_t)RTC_SmoothCalibPlusPulses \| (uint32_t)RTC_SmouthCalibMinusPulsesValue);
bogdanm	0:9b334a45a8ff	1808
bogdanm	0:9b334a45a8ff	1809	status = SUCCESS;
bogdanm	0:9b334a45a8ff	1810	}
bogdanm	0:9b334a45a8ff	1811	else
bogdanm	0:9b334a45a8ff	1812	{
bogdanm	0:9b334a45a8ff	1813	status = ERROR;
bogdanm	0:9b334a45a8ff	1814	}
bogdanm	0:9b334a45a8ff	1815
bogdanm	0:9b334a45a8ff	1816	/* Enable the write protection for RTC registers */
bogdanm	0:9b334a45a8ff	1817	RTC->WPR = 0xFF;
bogdanm	0:9b334a45a8ff	1818
bogdanm	0:9b334a45a8ff	1819	return (ErrorStatus)(status);
bogdanm	0:9b334a45a8ff	1820	}
bogdanm	0:9b334a45a8ff	1821
bogdanm	0:9b334a45a8ff	1822	/**
bogdanm	0:9b334a45a8ff	1823	* @}
bogdanm	0:9b334a45a8ff	1824	*/
bogdanm	0:9b334a45a8ff	1825
bogdanm	0:9b334a45a8ff	1826
bogdanm	0:9b334a45a8ff	1827	/** @defgroup RTC_Group8 TimeStamp configuration functions
bogdanm	0:9b334a45a8ff	1828	* @brief TimeStamp configuration functions
bogdanm	0:9b334a45a8ff	1829	*
bogdanm	0:9b334a45a8ff	1830	@verbatim
bogdanm	0:9b334a45a8ff	1831	===============================================================================
bogdanm	0:9b334a45a8ff	1832	##### TimeStamp configuration functions #####
bogdanm	0:9b334a45a8ff	1833	===============================================================================
bogdanm	0:9b334a45a8ff	1834
bogdanm	0:9b334a45a8ff	1835	@endverbatim
bogdanm	0:9b334a45a8ff	1836	* @{
bogdanm	0:9b334a45a8ff	1837	*/
bogdanm	0:9b334a45a8ff	1838
bogdanm	0:9b334a45a8ff	1839	/**
bogdanm	0:9b334a45a8ff	1840	* @brief Enables or Disables the RTC TimeStamp functionality with the
bogdanm	0:9b334a45a8ff	1841	* specified time stamp pin stimulating edge.
bogdanm	0:9b334a45a8ff	1842	* @param RTC_TimeStampEdge: Specifies the pin edge on which the TimeStamp is
bogdanm	0:9b334a45a8ff	1843	* activated.
bogdanm	0:9b334a45a8ff	1844	* This parameter can be one of the following:
bogdanm	0:9b334a45a8ff	1845	* @arg RTC_TimeStampEdge_Rising: the Time stamp event occurs on the rising
bogdanm	0:9b334a45a8ff	1846	* edge of the related pin.
bogdanm	0:9b334a45a8ff	1847	* @arg RTC_TimeStampEdge_Falling: the Time stamp event occurs on the
bogdanm	0:9b334a45a8ff	1848	* falling edge of the related pin.
bogdanm	0:9b334a45a8ff	1849	* @param NewState: new state of the TimeStamp.
bogdanm	0:9b334a45a8ff	1850	* This parameter can be: ENABLE or DISABLE.
bogdanm	0:9b334a45a8ff	1851	* @retval None
bogdanm	0:9b334a45a8ff	1852	*/
bogdanm	0:9b334a45a8ff	1853	void RTC_TimeStampCmd(uint32_t RTC_TimeStampEdge, FunctionalState NewState)
bogdanm	0:9b334a45a8ff	1854	{
bogdanm	0:9b334a45a8ff	1855	uint32_t tmpreg = 0;
bogdanm	0:9b334a45a8ff	1856
bogdanm	0:9b334a45a8ff	1857	/* Check the parameters */
bogdanm	0:9b334a45a8ff	1858	assert_param(IS_RTC_TIMESTAMP_EDGE(RTC_TimeStampEdge));
bogdanm	0:9b334a45a8ff	1859	assert_param(IS_FUNCTIONAL_STATE(NewState));
bogdanm	0:9b334a45a8ff	1860
bogdanm	0:9b334a45a8ff	1861	/* Get the RTC_CR register and clear the bits to be configured */
bogdanm	0:9b334a45a8ff	1862	tmpreg = (uint32_t)(RTC->CR & (uint32_t)~(RTC_CR_TSEDGE \| RTC_CR_TSE));
bogdanm	0:9b334a45a8ff	1863
bogdanm	0:9b334a45a8ff	1864	/* Get the new configuration */
bogdanm	0:9b334a45a8ff	1865	if (NewState != DISABLE)
bogdanm	0:9b334a45a8ff	1866	{
bogdanm	0:9b334a45a8ff	1867	tmpreg \|= (uint32_t)(RTC_TimeStampEdge \| RTC_CR_TSE);
bogdanm	0:9b334a45a8ff	1868	}
bogdanm	0:9b334a45a8ff	1869	else
bogdanm	0:9b334a45a8ff	1870	{
bogdanm	0:9b334a45a8ff	1871	tmpreg \|= (uint32_t)(RTC_TimeStampEdge);
bogdanm	0:9b334a45a8ff	1872	}
bogdanm	0:9b334a45a8ff	1873
bogdanm	0:9b334a45a8ff	1874	/* Disable the write protection for RTC registers */
bogdanm	0:9b334a45a8ff	1875	RTC->WPR = 0xCA;
bogdanm	0:9b334a45a8ff	1876	RTC->WPR = 0x53;
bogdanm	0:9b334a45a8ff	1877
bogdanm	0:9b334a45a8ff	1878	/* Configure the Time Stamp TSEDGE and Enable bits */
bogdanm	0:9b334a45a8ff	1879	RTC->CR = (uint32_t)tmpreg;
bogdanm	0:9b334a45a8ff	1880
bogdanm	0:9b334a45a8ff	1881	/* Enable the write protection for RTC registers */
bogdanm	0:9b334a45a8ff	1882	RTC->WPR = 0xFF;
bogdanm	0:9b334a45a8ff	1883	}
bogdanm	0:9b334a45a8ff	1884
bogdanm	0:9b334a45a8ff	1885	/**
bogdanm	0:9b334a45a8ff	1886	* @brief Gets the RTC TimeStamp value and masks.
bogdanm	0:9b334a45a8ff	1887	* @param RTC_Format: specifies the format of the output parameters.
bogdanm	0:9b334a45a8ff	1888	* This parameter can be one of the following values:
bogdanm	0:9b334a45a8ff	1889	* @arg RTC_Format_BIN: Binary data format
bogdanm	0:9b334a45a8ff	1890	* @arg RTC_Format_BCD: BCD data format
bogdanm	0:9b334a45a8ff	1891	* @param RTC_StampTimeStruct: pointer to a RTC_TimeTypeDef structure that will
bogdanm	0:9b334a45a8ff	1892	* contains the TimeStamp time values.
bogdanm	0:9b334a45a8ff	1893	* @param RTC_StampDateStruct: pointer to a RTC_DateTypeDef structure that will
bogdanm	0:9b334a45a8ff	1894	* contains the TimeStamp date values.
bogdanm	0:9b334a45a8ff	1895	* @retval None
bogdanm	0:9b334a45a8ff	1896	*/
bogdanm	0:9b334a45a8ff	1897	void RTC_GetTimeStamp(uint32_t RTC_Format, RTC_TimeTypeDef* RTC_StampTimeStruct,
bogdanm	0:9b334a45a8ff	1898	RTC_DateTypeDef* RTC_StampDateStruct)
bogdanm	0:9b334a45a8ff	1899	{
bogdanm	0:9b334a45a8ff	1900	uint32_t tmptime = 0, tmpdate = 0;
bogdanm	0:9b334a45a8ff	1901
bogdanm	0:9b334a45a8ff	1902	/* Check the parameters */
bogdanm	0:9b334a45a8ff	1903	assert_param(IS_RTC_FORMAT(RTC_Format));
bogdanm	0:9b334a45a8ff	1904
bogdanm	0:9b334a45a8ff	1905	/* Get the TimeStamp time and date registers values */
bogdanm	0:9b334a45a8ff	1906	tmptime = (uint32_t)(RTC->TSTR & RTC_TR_RESERVED_MASK);
bogdanm	0:9b334a45a8ff	1907	tmpdate = (uint32_t)(RTC->TSDR & RTC_DR_RESERVED_MASK);
bogdanm	0:9b334a45a8ff	1908
bogdanm	0:9b334a45a8ff	1909	/* Fill the Time structure fields with the read parameters */
bogdanm	0:9b334a45a8ff	1910	RTC_StampTimeStruct->RTC_Hours = (uint8_t)((tmptime & (RTC_TR_HT \| RTC_TR_HU)) >> 16);
bogdanm	0:9b334a45a8ff	1911	RTC_StampTimeStruct->RTC_Minutes = (uint8_t)((tmptime & (RTC_TR_MNT \| RTC_TR_MNU)) >> 8);
bogdanm	0:9b334a45a8ff	1912	RTC_StampTimeStruct->RTC_Seconds = (uint8_t)(tmptime & (RTC_TR_ST \| RTC_TR_SU));
bogdanm	0:9b334a45a8ff	1913	RTC_StampTimeStruct->RTC_H12 = (uint8_t)((tmptime & (RTC_TR_PM)) >> 16);
bogdanm	0:9b334a45a8ff	1914
bogdanm	0:9b334a45a8ff	1915	/* Fill the Date structure fields with the read parameters */
bogdanm	0:9b334a45a8ff	1916	RTC_StampDateStruct->RTC_Year = 0;
bogdanm	0:9b334a45a8ff	1917	RTC_StampDateStruct->RTC_Month = (uint8_t)((tmpdate & (RTC_DR_MT \| RTC_DR_MU)) >> 8);
bogdanm	0:9b334a45a8ff	1918	RTC_StampDateStruct->RTC_Date = (uint8_t)(tmpdate & (RTC_DR_DT \| RTC_DR_DU));
bogdanm	0:9b334a45a8ff	1919	RTC_StampDateStruct->RTC_WeekDay = (uint8_t)((tmpdate & (RTC_DR_WDU)) >> 13);
bogdanm	0:9b334a45a8ff	1920
bogdanm	0:9b334a45a8ff	1921	/* Check the input parameters format */
bogdanm	0:9b334a45a8ff	1922	if (RTC_Format == RTC_Format_BIN)
bogdanm	0:9b334a45a8ff	1923	{
bogdanm	0:9b334a45a8ff	1924	/* Convert the Time structure parameters to Binary format */
bogdanm	0:9b334a45a8ff	1925	RTC_StampTimeStruct->RTC_Hours = (uint8_t)RTC_Bcd2ToByte(RTC_StampTimeStruct->RTC_Hours);
bogdanm	0:9b334a45a8ff	1926	RTC_StampTimeStruct->RTC_Minutes = (uint8_t)RTC_Bcd2ToByte(RTC_StampTimeStruct->RTC_Minutes);
bogdanm	0:9b334a45a8ff	1927	RTC_StampTimeStruct->RTC_Seconds = (uint8_t)RTC_Bcd2ToByte(RTC_StampTimeStruct->RTC_Seconds);
bogdanm	0:9b334a45a8ff	1928
bogdanm	0:9b334a45a8ff	1929	/* Convert the Date structure parameters to Binary format */
bogdanm	0:9b334a45a8ff	1930	RTC_StampDateStruct->RTC_Month = (uint8_t)RTC_Bcd2ToByte(RTC_StampDateStruct->RTC_Month);
bogdanm	0:9b334a45a8ff	1931	RTC_StampDateStruct->RTC_Date = (uint8_t)RTC_Bcd2ToByte(RTC_StampDateStruct->RTC_Date);
bogdanm	0:9b334a45a8ff	1932	RTC_StampDateStruct->RTC_WeekDay = (uint8_t)RTC_Bcd2ToByte(RTC_StampDateStruct->RTC_WeekDay);
bogdanm	0:9b334a45a8ff	1933	}
bogdanm	0:9b334a45a8ff	1934	}
bogdanm	0:9b334a45a8ff	1935
bogdanm	0:9b334a45a8ff	1936	/**
bogdanm	0:9b334a45a8ff	1937	* @brief Gets the RTC timestamp Subseconds value.
bogdanm	0:9b334a45a8ff	1938	* @param None
bogdanm	0:9b334a45a8ff	1939	* @retval RTC current timestamp Subseconds value.
bogdanm	0:9b334a45a8ff	1940	*/
bogdanm	0:9b334a45a8ff	1941	uint32_t RTC_GetTimeStampSubSecond(void)
bogdanm	0:9b334a45a8ff	1942	{
bogdanm	0:9b334a45a8ff	1943	/* Get timestamp subseconds values from the correspondent registers */
bogdanm	0:9b334a45a8ff	1944	return (uint32_t)(RTC->TSSSR);
bogdanm	0:9b334a45a8ff	1945	}
bogdanm	0:9b334a45a8ff	1946
bogdanm	0:9b334a45a8ff	1947	/**
bogdanm	0:9b334a45a8ff	1948	* @}
bogdanm	0:9b334a45a8ff	1949	*/
bogdanm	0:9b334a45a8ff	1950
bogdanm	0:9b334a45a8ff	1951	/** @defgroup RTC_Group9 Tampers configuration functions
bogdanm	0:9b334a45a8ff	1952	* @brief Tampers configuration functions
bogdanm	0:9b334a45a8ff	1953	*
bogdanm	0:9b334a45a8ff	1954	@verbatim
bogdanm	0:9b334a45a8ff	1955	===============================================================================
bogdanm	0:9b334a45a8ff	1956	##### Tampers configuration functions #####
bogdanm	0:9b334a45a8ff	1957	===============================================================================
bogdanm	0:9b334a45a8ff	1958
bogdanm	0:9b334a45a8ff	1959	@endverbatim
bogdanm	0:9b334a45a8ff	1960	* @{
bogdanm	0:9b334a45a8ff	1961	*/
bogdanm	0:9b334a45a8ff	1962
bogdanm	0:9b334a45a8ff	1963	/**
bogdanm	0:9b334a45a8ff	1964	* @brief Configures the select Tamper pin edge.
bogdanm	0:9b334a45a8ff	1965	* @param RTC_Tamper: Selected tamper pin.
bogdanm	0:9b334a45a8ff	1966	* This parameter can be any combination of the following values:
bogdanm	0:9b334a45a8ff	1967	* @arg RTC_Tamper_1: Select Tamper 1.
bogdanm	0:9b334a45a8ff	1968	* @arg RTC_Tamper_2: Select Tamper 2.
bogdanm	0:9b334a45a8ff	1969	* @arg RTC_Tamper_3: Select Tamper 3.
bogdanm	0:9b334a45a8ff	1970	* @param RTC_TamperTrigger: Specifies the trigger on the tamper pin that
bogdanm	0:9b334a45a8ff	1971	* stimulates tamper event.
bogdanm	0:9b334a45a8ff	1972	* This parameter can be one of the following values:
bogdanm	0:9b334a45a8ff	1973	* @arg RTC_TamperTrigger_RisingEdge: Rising Edge of the tamper pin causes tamper event.
bogdanm	0:9b334a45a8ff	1974	* @arg RTC_TamperTrigger_FallingEdge: Falling Edge of the tamper pin causes tamper event.
bogdanm	0:9b334a45a8ff	1975	* @arg RTC_TamperTrigger_LowLevel: Low Level of the tamper pin causes tamper event.
bogdanm	0:9b334a45a8ff	1976	* @arg RTC_TamperTrigger_HighLevel: High Level of the tamper pin causes tamper event.
bogdanm	0:9b334a45a8ff	1977	* @retval None
bogdanm	0:9b334a45a8ff	1978	*/
bogdanm	0:9b334a45a8ff	1979	void RTC_TamperTriggerConfig(uint32_t RTC_Tamper, uint32_t RTC_TamperTrigger)
bogdanm	0:9b334a45a8ff	1980	{
bogdanm	0:9b334a45a8ff	1981	/* Check the parameters */
bogdanm	0:9b334a45a8ff	1982	assert_param(IS_RTC_TAMPER(RTC_Tamper));
bogdanm	0:9b334a45a8ff	1983	assert_param(IS_RTC_TAMPER_TRIGGER(RTC_TamperTrigger));
bogdanm	0:9b334a45a8ff	1984
bogdanm	0:9b334a45a8ff	1985	/* Check if the active level for Tamper is rising edge (Low level)*/
bogdanm	0:9b334a45a8ff	1986	if (RTC_TamperTrigger == RTC_TamperTrigger_RisingEdge)
bogdanm	0:9b334a45a8ff	1987	{
bogdanm	0:9b334a45a8ff	1988	/* Configure the RTC_TAFCR register */
bogdanm	0:9b334a45a8ff	1989	RTC->TAFCR &= (uint32_t)((uint32_t)~(RTC_Tamper << 1));
bogdanm	0:9b334a45a8ff	1990	}
bogdanm	0:9b334a45a8ff	1991	else
bogdanm	0:9b334a45a8ff	1992	{
bogdanm	0:9b334a45a8ff	1993	/* Configure the RTC_TAFCR register */
bogdanm	0:9b334a45a8ff	1994	RTC->TAFCR \|= (uint32_t)(RTC_Tamper << 1);
bogdanm	0:9b334a45a8ff	1995	}
bogdanm	0:9b334a45a8ff	1996	}
bogdanm	0:9b334a45a8ff	1997
bogdanm	0:9b334a45a8ff	1998	/**
bogdanm	0:9b334a45a8ff	1999	* @brief Enables or Disables the Tamper detection.
bogdanm	0:9b334a45a8ff	2000	* @param RTC_Tamper: Selected tamper pin.
bogdanm	0:9b334a45a8ff	2001	* This parameter can be any combination of the following values:
bogdanm	0:9b334a45a8ff	2002	* @arg RTC_Tamper_1: Select Tamper 1.
bogdanm	0:9b334a45a8ff	2003	* @arg RTC_Tamper_2: Select Tamper 2.
bogdanm	0:9b334a45a8ff	2004	* @arg RTC_Tamper_3: Select Tamper 3.
bogdanm	0:9b334a45a8ff	2005	* @param NewState: new state of the tamper pin.
bogdanm	0:9b334a45a8ff	2006	* This parameter can be: ENABLE or DISABLE.
bogdanm	0:9b334a45a8ff	2007	* @retval None
bogdanm	0:9b334a45a8ff	2008	*/
bogdanm	0:9b334a45a8ff	2009	void RTC_TamperCmd(uint32_t RTC_Tamper, FunctionalState NewState)
bogdanm	0:9b334a45a8ff	2010	{
bogdanm	0:9b334a45a8ff	2011	/* Check the parameters */
bogdanm	0:9b334a45a8ff	2012	assert_param(IS_RTC_TAMPER(RTC_Tamper));
bogdanm	0:9b334a45a8ff	2013	assert_param(IS_FUNCTIONAL_STATE(NewState));
bogdanm	0:9b334a45a8ff	2014
bogdanm	0:9b334a45a8ff	2015	if (NewState != DISABLE)
bogdanm	0:9b334a45a8ff	2016	{
bogdanm	0:9b334a45a8ff	2017	/* Enable the selected Tamper pin */
bogdanm	0:9b334a45a8ff	2018	RTC->TAFCR \|= (uint32_t)RTC_Tamper;
bogdanm	0:9b334a45a8ff	2019	}
bogdanm	0:9b334a45a8ff	2020	else
bogdanm	0:9b334a45a8ff	2021	{
bogdanm	0:9b334a45a8ff	2022	/* Disable the selected Tamper pin */
bogdanm	0:9b334a45a8ff	2023	RTC->TAFCR &= (uint32_t)~RTC_Tamper;
bogdanm	0:9b334a45a8ff	2024	}
bogdanm	0:9b334a45a8ff	2025	}
bogdanm	0:9b334a45a8ff	2026
bogdanm	0:9b334a45a8ff	2027	/**
bogdanm	0:9b334a45a8ff	2028	* @brief Configures the Tampers Filter.
bogdanm	0:9b334a45a8ff	2029	* @param RTC_TamperFilter: Specifies the tampers filter.
bogdanm	0:9b334a45a8ff	2030	* This parameter can be one of the following values:
bogdanm	0:9b334a45a8ff	2031	* @arg RTC_TamperFilter_Disable: Tamper filter is disabled.
bogdanm	0:9b334a45a8ff	2032	* @arg RTC_TamperFilter_2Sample: Tamper is activated after 2 consecutive
bogdanm	0:9b334a45a8ff	2033	* samples at the active level
bogdanm	0:9b334a45a8ff	2034	* @arg RTC_TamperFilter_4Sample: Tamper is activated after 4 consecutive
bogdanm	0:9b334a45a8ff	2035	* samples at the active level
bogdanm	0:9b334a45a8ff	2036	* @arg RTC_TamperFilter_8Sample: Tamper is activated after 8 consecutive
bogdanm	0:9b334a45a8ff	2037	* samples at the active level
bogdanm	0:9b334a45a8ff	2038	* @retval None
bogdanm	0:9b334a45a8ff	2039	*/
bogdanm	0:9b334a45a8ff	2040	void RTC_TamperFilterConfig(uint32_t RTC_TamperFilter)
bogdanm	0:9b334a45a8ff	2041	{
bogdanm	0:9b334a45a8ff	2042	/* Check the parameters */
bogdanm	0:9b334a45a8ff	2043	assert_param(IS_RTC_TAMPER_FILTER(RTC_TamperFilter));
bogdanm	0:9b334a45a8ff	2044
bogdanm	0:9b334a45a8ff	2045	/* Clear TAMPFLT[1:0] bits in the RTC_TAFCR register */
bogdanm	0:9b334a45a8ff	2046	RTC->TAFCR &= (uint32_t)~(RTC_TAFCR_TAMPFLT);
bogdanm	0:9b334a45a8ff	2047
bogdanm	0:9b334a45a8ff	2048	/* Configure the RTC_TAFCR register */
bogdanm	0:9b334a45a8ff	2049	RTC->TAFCR \|= (uint32_t)RTC_TamperFilter;
bogdanm	0:9b334a45a8ff	2050	}
bogdanm	0:9b334a45a8ff	2051
bogdanm	0:9b334a45a8ff	2052	/**
bogdanm	0:9b334a45a8ff	2053	* @brief Configures the Tampers Sampling Frequency.
bogdanm	0:9b334a45a8ff	2054	* @param RTC_TamperSamplingFreq: Specifies the tampers Sampling Frequency.
bogdanm	0:9b334a45a8ff	2055	* This parameter can be one of the following values:
bogdanm	0:9b334a45a8ff	2056	* @arg RTC_TamperSamplingFreq_RTCCLK_Div32768: Each of the tamper inputs are sampled
bogdanm	0:9b334a45a8ff	2057	* with a frequency = RTCCLK / 32768
bogdanm	0:9b334a45a8ff	2058	* @arg RTC_TamperSamplingFreq_RTCCLK_Div16384: Each of the tamper inputs are sampled
bogdanm	0:9b334a45a8ff	2059	* with a frequency = RTCCLK / 16384
bogdanm	0:9b334a45a8ff	2060	* @arg RTC_TamperSamplingFreq_RTCCLK_Div8192: Each of the tamper inputs are sampled
bogdanm	0:9b334a45a8ff	2061	* with a frequency = RTCCLK / 8192
bogdanm	0:9b334a45a8ff	2062	* @arg RTC_TamperSamplingFreq_RTCCLK_Div4096: Each of the tamper inputs are sampled
bogdanm	0:9b334a45a8ff	2063	* with a frequency = RTCCLK / 4096
bogdanm	0:9b334a45a8ff	2064	* @arg RTC_TamperSamplingFreq_RTCCLK_Div2048: Each of the tamper inputs are sampled
bogdanm	0:9b334a45a8ff	2065	* with a frequency = RTCCLK / 2048
bogdanm	0:9b334a45a8ff	2066	* @arg RTC_TamperSamplingFreq_RTCCLK_Div1024: Each of the tamper inputs are sampled
bogdanm	0:9b334a45a8ff	2067	* with a frequency = RTCCLK / 1024
bogdanm	0:9b334a45a8ff	2068	* @arg RTC_TamperSamplingFreq_RTCCLK_Div512: Each of the tamper inputs are sampled
bogdanm	0:9b334a45a8ff	2069	* with a frequency = RTCCLK / 512
bogdanm	0:9b334a45a8ff	2070	* @arg RTC_TamperSamplingFreq_RTCCLK_Div256: Each of the tamper inputs are sampled
bogdanm	0:9b334a45a8ff	2071	* with a frequency = RTCCLK / 256
bogdanm	0:9b334a45a8ff	2072	* @retval None
bogdanm	0:9b334a45a8ff	2073	*/
bogdanm	0:9b334a45a8ff	2074	void RTC_TamperSamplingFreqConfig(uint32_t RTC_TamperSamplingFreq)
bogdanm	0:9b334a45a8ff	2075	{
bogdanm	0:9b334a45a8ff	2076	/* Check the parameters */
bogdanm	0:9b334a45a8ff	2077	assert_param(IS_RTC_TAMPER_SAMPLING_FREQ(RTC_TamperSamplingFreq));
bogdanm	0:9b334a45a8ff	2078
bogdanm	0:9b334a45a8ff	2079	/* Clear TAMPFREQ[2:0] bits in the RTC_TAFCR register */
bogdanm	0:9b334a45a8ff	2080	RTC->TAFCR &= (uint32_t)~(RTC_TAFCR_TAMPFREQ);
bogdanm	0:9b334a45a8ff	2081
bogdanm	0:9b334a45a8ff	2082	/* Configure the RTC_TAFCR register */
bogdanm	0:9b334a45a8ff	2083	RTC->TAFCR \|= (uint32_t)RTC_TamperSamplingFreq;
bogdanm	0:9b334a45a8ff	2084	}
bogdanm	0:9b334a45a8ff	2085
bogdanm	0:9b334a45a8ff	2086	/**
bogdanm	0:9b334a45a8ff	2087	* @brief Configures the Tampers Pins input Precharge Duration.
bogdanm	0:9b334a45a8ff	2088	* @param RTC_TamperPrechargeDuration: Specifies the Tampers Pins input
bogdanm	0:9b334a45a8ff	2089	* Precharge Duration.
bogdanm	0:9b334a45a8ff	2090	* This parameter can be one of the following values:
bogdanm	0:9b334a45a8ff	2091	* @arg RTC_TamperPrechargeDuration_1RTCCLK: Tamper pins are pre-charged before sampling during 1 RTCCLK cycle
bogdanm	0:9b334a45a8ff	2092	* @arg RTC_TamperPrechargeDuration_2RTCCLK: Tamper pins are pre-charged before sampling during 2 RTCCLK cycle
bogdanm	0:9b334a45a8ff	2093	* @arg RTC_TamperPrechargeDuration_4RTCCLK: Tamper pins are pre-charged before sampling during 4 RTCCLK cycle
bogdanm	0:9b334a45a8ff	2094	* @arg RTC_TamperPrechargeDuration_8RTCCLK: Tamper pins are pre-charged before sampling during 8 RTCCLK cycle
bogdanm	0:9b334a45a8ff	2095	* @retval None
bogdanm	0:9b334a45a8ff	2096	*/
bogdanm	0:9b334a45a8ff	2097	void RTC_TamperPinsPrechargeDuration(uint32_t RTC_TamperPrechargeDuration)
bogdanm	0:9b334a45a8ff	2098	{
bogdanm	0:9b334a45a8ff	2099	/* Check the parameters */
bogdanm	0:9b334a45a8ff	2100	assert_param(IS_RTC_TAMPER_PRECHARGE_DURATION(RTC_TamperPrechargeDuration));
bogdanm	0:9b334a45a8ff	2101
bogdanm	0:9b334a45a8ff	2102	/* Clear TAMPPRCH[1:0] bits in the RTC_TAFCR register */
bogdanm	0:9b334a45a8ff	2103	RTC->TAFCR &= (uint32_t)~(RTC_TAFCR_TAMPPRCH);
bogdanm	0:9b334a45a8ff	2104
bogdanm	0:9b334a45a8ff	2105	/* Configure the RTC_TAFCR register */
bogdanm	0:9b334a45a8ff	2106	RTC->TAFCR \|= (uint32_t)RTC_TamperPrechargeDuration;
bogdanm	0:9b334a45a8ff	2107	}
bogdanm	0:9b334a45a8ff	2108
bogdanm	0:9b334a45a8ff	2109	/**
bogdanm	0:9b334a45a8ff	2110	* @brief Enables or Disables the TimeStamp on Tamper Detection Event.
bogdanm	0:9b334a45a8ff	2111	* @note The timestamp is valid even the TSE bit in tamper control register
bogdanm	0:9b334a45a8ff	2112	* is reset.
bogdanm	0:9b334a45a8ff	2113	* @param NewState: new state of the timestamp on tamper event.
bogdanm	0:9b334a45a8ff	2114	* This parameter can be: ENABLE or DISABLE.
bogdanm	0:9b334a45a8ff	2115	* @retval None
bogdanm	0:9b334a45a8ff	2116	*/
bogdanm	0:9b334a45a8ff	2117	void RTC_TimeStampOnTamperDetectionCmd(FunctionalState NewState)
bogdanm	0:9b334a45a8ff	2118	{
bogdanm	0:9b334a45a8ff	2119	/* Check the parameters */
bogdanm	0:9b334a45a8ff	2120	assert_param(IS_FUNCTIONAL_STATE(NewState));
bogdanm	0:9b334a45a8ff	2121
bogdanm	0:9b334a45a8ff	2122	if (NewState != DISABLE)
bogdanm	0:9b334a45a8ff	2123	{
bogdanm	0:9b334a45a8ff	2124	/* Save timestamp on tamper detection event */
bogdanm	0:9b334a45a8ff	2125	RTC->TAFCR \|= (uint32_t)RTC_TAFCR_TAMPTS;
bogdanm	0:9b334a45a8ff	2126	}
bogdanm	0:9b334a45a8ff	2127	else
bogdanm	0:9b334a45a8ff	2128	{
bogdanm	0:9b334a45a8ff	2129	/* Tamper detection does not cause a timestamp to be saved */
bogdanm	0:9b334a45a8ff	2130	RTC->TAFCR &= (uint32_t)~RTC_TAFCR_TAMPTS;
bogdanm	0:9b334a45a8ff	2131	}
bogdanm	0:9b334a45a8ff	2132	}
bogdanm	0:9b334a45a8ff	2133
bogdanm	0:9b334a45a8ff	2134	/**
bogdanm	0:9b334a45a8ff	2135	* @brief Enables or Disables the Precharge of Tamper pin.
bogdanm	0:9b334a45a8ff	2136	* @param NewState: new state of tamper pull up.
bogdanm	0:9b334a45a8ff	2137	* This parameter can be: ENABLE or DISABLE.
bogdanm	0:9b334a45a8ff	2138	* @retval None
bogdanm	0:9b334a45a8ff	2139	*/
bogdanm	0:9b334a45a8ff	2140	void RTC_TamperPullUpCmd(FunctionalState NewState)
bogdanm	0:9b334a45a8ff	2141	{
bogdanm	0:9b334a45a8ff	2142	/* Check the parameters */
bogdanm	0:9b334a45a8ff	2143	assert_param(IS_FUNCTIONAL_STATE(NewState));
bogdanm	0:9b334a45a8ff	2144
bogdanm	0:9b334a45a8ff	2145	if (NewState != DISABLE)
bogdanm	0:9b334a45a8ff	2146	{
bogdanm	0:9b334a45a8ff	2147	/* Enable precharge of the selected Tamper pin */
bogdanm	0:9b334a45a8ff	2148	RTC->TAFCR &= (uint32_t)~RTC_TAFCR_TAMPPUDIS;
bogdanm	0:9b334a45a8ff	2149	}
bogdanm	0:9b334a45a8ff	2150	else
bogdanm	0:9b334a45a8ff	2151	{
bogdanm	0:9b334a45a8ff	2152	/* Disable precharge of the selected Tamper pin */
bogdanm	0:9b334a45a8ff	2153	RTC->TAFCR \|= (uint32_t)RTC_TAFCR_TAMPPUDIS;
bogdanm	0:9b334a45a8ff	2154	}
bogdanm	0:9b334a45a8ff	2155	}
bogdanm	0:9b334a45a8ff	2156
bogdanm	0:9b334a45a8ff	2157	/**
bogdanm	0:9b334a45a8ff	2158	* @}
bogdanm	0:9b334a45a8ff	2159	*/
bogdanm	0:9b334a45a8ff	2160
bogdanm	0:9b334a45a8ff	2161	/** @defgroup RTC_Group10 Backup Data Registers configuration functions
bogdanm	0:9b334a45a8ff	2162	* @brief Backup Data Registers configuration functions
bogdanm	0:9b334a45a8ff	2163	*
bogdanm	0:9b334a45a8ff	2164	@verbatim
bogdanm	0:9b334a45a8ff	2165	===============================================================================
bogdanm	0:9b334a45a8ff	2166	##### Backup Data Registers configuration functions #####
bogdanm	0:9b334a45a8ff	2167	===============================================================================
bogdanm	0:9b334a45a8ff	2168
bogdanm	0:9b334a45a8ff	2169	@endverbatim
bogdanm	0:9b334a45a8ff	2170	* @{
bogdanm	0:9b334a45a8ff	2171	*/
bogdanm	0:9b334a45a8ff	2172
bogdanm	0:9b334a45a8ff	2173	/**
bogdanm	0:9b334a45a8ff	2174	* @brief Writes a data in a specified RTC Backup data register.
bogdanm	0:9b334a45a8ff	2175	* @param RTC_BKP_DR: RTC Backup data Register number.
bogdanm	0:9b334a45a8ff	2176	* This parameter can be: RTC_BKP_DRx where x can be from 0 to 15 to
bogdanm	0:9b334a45a8ff	2177	* specify the register.
bogdanm	0:9b334a45a8ff	2178	* @param Data: Data to be written in the specified RTC Backup data register.
bogdanm	0:9b334a45a8ff	2179	* @retval None
bogdanm	0:9b334a45a8ff	2180	*/
bogdanm	0:9b334a45a8ff	2181	void RTC_WriteBackupRegister(uint32_t RTC_BKP_DR, uint32_t Data)
bogdanm	0:9b334a45a8ff	2182	{
bogdanm	0:9b334a45a8ff	2183	__IO uint32_t tmp = 0;
bogdanm	0:9b334a45a8ff	2184
bogdanm	0:9b334a45a8ff	2185	/* Check the parameters */
bogdanm	0:9b334a45a8ff	2186	assert_param(IS_RTC_BKP(RTC_BKP_DR));
bogdanm	0:9b334a45a8ff	2187
bogdanm	0:9b334a45a8ff	2188	tmp = RTC_BASE + 0x50;
bogdanm	0:9b334a45a8ff	2189	tmp += (RTC_BKP_DR * 4);
bogdanm	0:9b334a45a8ff	2190
bogdanm	0:9b334a45a8ff	2191	/* Write the specified register */
bogdanm	0:9b334a45a8ff	2192	(__IO uint32_t )tmp = (uint32_t)Data;
bogdanm	0:9b334a45a8ff	2193	}
bogdanm	0:9b334a45a8ff	2194
bogdanm	0:9b334a45a8ff	2195	/**
bogdanm	0:9b334a45a8ff	2196	* @brief Reads data from the specified RTC Backup data Register.
bogdanm	0:9b334a45a8ff	2197	* @param RTC_BKP_DR: RTC Backup data Register number.
bogdanm	0:9b334a45a8ff	2198	* This parameter can be: RTC_BKP_DRx where x can be from 0 to 15 to
bogdanm	0:9b334a45a8ff	2199	* specify the register.
bogdanm	0:9b334a45a8ff	2200	* @retval None
bogdanm	0:9b334a45a8ff	2201	*/
bogdanm	0:9b334a45a8ff	2202	uint32_t RTC_ReadBackupRegister(uint32_t RTC_BKP_DR)
bogdanm	0:9b334a45a8ff	2203	{
bogdanm	0:9b334a45a8ff	2204	__IO uint32_t tmp = 0;
bogdanm	0:9b334a45a8ff	2205
bogdanm	0:9b334a45a8ff	2206	/* Check the parameters */
bogdanm	0:9b334a45a8ff	2207	assert_param(IS_RTC_BKP(RTC_BKP_DR));
bogdanm	0:9b334a45a8ff	2208
bogdanm	0:9b334a45a8ff	2209	tmp = RTC_BASE + 0x50;
bogdanm	0:9b334a45a8ff	2210	tmp += (RTC_BKP_DR * 4);
bogdanm	0:9b334a45a8ff	2211
bogdanm	0:9b334a45a8ff	2212	/* Read the specified register */
bogdanm	0:9b334a45a8ff	2213	return ((__IO uint32_t )tmp);
bogdanm	0:9b334a45a8ff	2214	}
bogdanm	0:9b334a45a8ff	2215
bogdanm	0:9b334a45a8ff	2216	/**
bogdanm	0:9b334a45a8ff	2217	* @}
bogdanm	0:9b334a45a8ff	2218	*/
bogdanm	0:9b334a45a8ff	2219
bogdanm	0:9b334a45a8ff	2220	/** @defgroup RTC_Group11 Output Type Config configuration functions
bogdanm	0:9b334a45a8ff	2221	* @brief Output Type Config configuration functions
bogdanm	0:9b334a45a8ff	2222	*
bogdanm	0:9b334a45a8ff	2223	@verbatim
bogdanm	0:9b334a45a8ff	2224	===============================================================================
bogdanm	0:9b334a45a8ff	2225	##### Output Type Config configuration functions #####
bogdanm	0:9b334a45a8ff	2226	===============================================================================
bogdanm	0:9b334a45a8ff	2227
bogdanm	0:9b334a45a8ff	2228	@endverbatim
bogdanm	0:9b334a45a8ff	2229	* @{
bogdanm	0:9b334a45a8ff	2230	*/
bogdanm	0:9b334a45a8ff	2231
bogdanm	0:9b334a45a8ff	2232	/**
bogdanm	0:9b334a45a8ff	2233	* @brief Configures the RTC Output Pin mode.
bogdanm	0:9b334a45a8ff	2234	* @param RTC_OutputType: specifies the RTC Output (PC13) pin mode.
bogdanm	0:9b334a45a8ff	2235	* This parameter can be one of the following values:
bogdanm	0:9b334a45a8ff	2236	* @arg RTC_OutputType_OpenDrain: RTC Output (PC13) is configured in
bogdanm	0:9b334a45a8ff	2237	* Open Drain mode.
bogdanm	0:9b334a45a8ff	2238	* @arg RTC_OutputType_PushPull: RTC Output (PC13) is configured in
bogdanm	0:9b334a45a8ff	2239	* Push Pull mode.
bogdanm	0:9b334a45a8ff	2240	* @retval None
bogdanm	0:9b334a45a8ff	2241	*/
bogdanm	0:9b334a45a8ff	2242	void RTC_OutputTypeConfig(uint32_t RTC_OutputType)
bogdanm	0:9b334a45a8ff	2243	{
bogdanm	0:9b334a45a8ff	2244	/* Check the parameters */
bogdanm	0:9b334a45a8ff	2245	assert_param(IS_RTC_OUTPUT_TYPE(RTC_OutputType));
bogdanm	0:9b334a45a8ff	2246
bogdanm	0:9b334a45a8ff	2247	RTC->TAFCR &= (uint32_t)~(RTC_TAFCR_ALARMOUTTYPE);
bogdanm	0:9b334a45a8ff	2248	RTC->TAFCR \|= (uint32_t)(RTC_OutputType);
bogdanm	0:9b334a45a8ff	2249	}
bogdanm	0:9b334a45a8ff	2250
bogdanm	0:9b334a45a8ff	2251	/**
bogdanm	0:9b334a45a8ff	2252	* @}
bogdanm	0:9b334a45a8ff	2253	*/
bogdanm	0:9b334a45a8ff	2254
bogdanm	0:9b334a45a8ff	2255	/** @defgroup RTC_Group12 Shift control synchronisation functions
bogdanm	0:9b334a45a8ff	2256	* @brief Shift control synchronisation functions
bogdanm	0:9b334a45a8ff	2257	*
bogdanm	0:9b334a45a8ff	2258	@verbatim
bogdanm	0:9b334a45a8ff	2259	===============================================================================
bogdanm	0:9b334a45a8ff	2260	##### Shift control synchronisation functions #####
bogdanm	0:9b334a45a8ff	2261	===============================================================================
bogdanm	0:9b334a45a8ff	2262
bogdanm	0:9b334a45a8ff	2263	@endverbatim
bogdanm	0:9b334a45a8ff	2264	* @{
bogdanm	0:9b334a45a8ff	2265	*/
bogdanm	0:9b334a45a8ff	2266
bogdanm	0:9b334a45a8ff	2267	/**
bogdanm	0:9b334a45a8ff	2268	* @brief Configures the Synchronization Shift Control Settings.
bogdanm	0:9b334a45a8ff	2269	* @note When REFCKON is set, firmware must not write to Shift control register
bogdanm	0:9b334a45a8ff	2270	* @param RTC_ShiftAdd1S : Select to add or not 1 second to the time Calendar.
bogdanm	0:9b334a45a8ff	2271	* This parameter can be one of the following values :
bogdanm	0:9b334a45a8ff	2272	* @arg RTC_ShiftAdd1S_Set : Add one second to the clock calendar.
bogdanm	0:9b334a45a8ff	2273	* @arg RTC_ShiftAdd1S_Reset: No effect.
bogdanm	0:9b334a45a8ff	2274	* @param RTC_ShiftSubFS: Select the number of Second Fractions to Substitute.
bogdanm	0:9b334a45a8ff	2275	* This parameter can be one any value from 0 to 0x7FFF.
bogdanm	0:9b334a45a8ff	2276	* @retval An ErrorStatus enumeration value:
bogdanm	0:9b334a45a8ff	2277	* - SUCCESS: RTC Shift registers are configured
bogdanm	0:9b334a45a8ff	2278	* - ERROR: RTC Shift registers are not configured
bogdanm	0:9b334a45a8ff	2279	*/
bogdanm	0:9b334a45a8ff	2280	ErrorStatus RTC_SynchroShiftConfig(uint32_t RTC_ShiftAdd1S, uint32_t RTC_ShiftSubFS)
bogdanm	0:9b334a45a8ff	2281	{
bogdanm	0:9b334a45a8ff	2282	ErrorStatus status = ERROR;
bogdanm	0:9b334a45a8ff	2283	uint32_t shpfcount = 0;
bogdanm	0:9b334a45a8ff	2284
bogdanm	0:9b334a45a8ff	2285	/* Check the parameters */
bogdanm	0:9b334a45a8ff	2286	assert_param(IS_RTC_SHIFT_ADD1S(RTC_ShiftAdd1S));
bogdanm	0:9b334a45a8ff	2287	assert_param(IS_RTC_SHIFT_SUBFS(RTC_ShiftSubFS));
bogdanm	0:9b334a45a8ff	2288
bogdanm	0:9b334a45a8ff	2289	/* Disable the write protection for RTC registers */
bogdanm	0:9b334a45a8ff	2290	RTC->WPR = 0xCA;
bogdanm	0:9b334a45a8ff	2291	RTC->WPR = 0x53;
bogdanm	0:9b334a45a8ff	2292
bogdanm	0:9b334a45a8ff	2293	/* Check if a Shift is pending*/
bogdanm	0:9b334a45a8ff	2294	if ((RTC->ISR & RTC_ISR_SHPF) != RESET)
bogdanm	0:9b334a45a8ff	2295	{
bogdanm	0:9b334a45a8ff	2296	/* Wait until the shift is completed*/
bogdanm	0:9b334a45a8ff	2297	while (((RTC->ISR & RTC_ISR_SHPF) != RESET) && (shpfcount != SHPF_TIMEOUT))
bogdanm	0:9b334a45a8ff	2298	{
bogdanm	0:9b334a45a8ff	2299	shpfcount++;
bogdanm	0:9b334a45a8ff	2300	}
bogdanm	0:9b334a45a8ff	2301	}
bogdanm	0:9b334a45a8ff	2302
bogdanm	0:9b334a45a8ff	2303	/* Check if the Shift pending is completed or if there is no Shift operation at all*/
bogdanm	0:9b334a45a8ff	2304	if ((RTC->ISR & RTC_ISR_SHPF) == RESET)
bogdanm	0:9b334a45a8ff	2305	{
bogdanm	0:9b334a45a8ff	2306	/* check if the reference clock detection is disabled */
bogdanm	0:9b334a45a8ff	2307	if((RTC->CR & RTC_CR_REFCKON) == RESET)
bogdanm	0:9b334a45a8ff	2308	{
bogdanm	0:9b334a45a8ff	2309	/* Configure the Shift settings */
bogdanm	0:9b334a45a8ff	2310	RTC->SHIFTR = (uint32_t)(uint32_t)(RTC_ShiftSubFS) \| (uint32_t)(RTC_ShiftAdd1S);
bogdanm	0:9b334a45a8ff	2311
bogdanm	0:9b334a45a8ff	2312	if(RTC_WaitForSynchro() == ERROR)
bogdanm	0:9b334a45a8ff	2313	{
bogdanm	0:9b334a45a8ff	2314	status = ERROR;
bogdanm	0:9b334a45a8ff	2315	}
bogdanm	0:9b334a45a8ff	2316	else
bogdanm	0:9b334a45a8ff	2317	{
bogdanm	0:9b334a45a8ff	2318	status = SUCCESS;
bogdanm	0:9b334a45a8ff	2319	}
bogdanm	0:9b334a45a8ff	2320	}
bogdanm	0:9b334a45a8ff	2321	else
bogdanm	0:9b334a45a8ff	2322	{
bogdanm	0:9b334a45a8ff	2323	status = ERROR;
bogdanm	0:9b334a45a8ff	2324	}
bogdanm	0:9b334a45a8ff	2325	}
bogdanm	0:9b334a45a8ff	2326	else
bogdanm	0:9b334a45a8ff	2327	{
bogdanm	0:9b334a45a8ff	2328	status = ERROR;
bogdanm	0:9b334a45a8ff	2329	}
bogdanm	0:9b334a45a8ff	2330
bogdanm	0:9b334a45a8ff	2331	/* Enable the write protection for RTC registers */
bogdanm	0:9b334a45a8ff	2332	RTC->WPR = 0xFF;
bogdanm	0:9b334a45a8ff	2333
bogdanm	0:9b334a45a8ff	2334	return (ErrorStatus)(status);
bogdanm	0:9b334a45a8ff	2335	}
bogdanm	0:9b334a45a8ff	2336
bogdanm	0:9b334a45a8ff	2337	/**
bogdanm	0:9b334a45a8ff	2338	* @}
bogdanm	0:9b334a45a8ff	2339	*/
bogdanm	0:9b334a45a8ff	2340
bogdanm	0:9b334a45a8ff	2341	/** @defgroup RTC_Group13 Interrupts and flags management functions
bogdanm	0:9b334a45a8ff	2342	* @brief Interrupts and flags management functions
bogdanm	0:9b334a45a8ff	2343	*
bogdanm	0:9b334a45a8ff	2344	@verbatim
bogdanm	0:9b334a45a8ff	2345	===============================================================================
bogdanm	0:9b334a45a8ff	2346	##### Interrupts and flags management functions #####
bogdanm	0:9b334a45a8ff	2347	===============================================================================
bogdanm	0:9b334a45a8ff	2348	[..] All RTC interrupts are connected to the EXTI controller.
bogdanm	0:9b334a45a8ff	2349	(+) To enable the RTC Alarm interrupt, the following sequence is required:
bogdanm	0:9b334a45a8ff	2350	(++) Configure and enable the EXTI Line 17 in interrupt mode and select
bogdanm	0:9b334a45a8ff	2351	the rising edge sensitivity using the EXTI_Init() function.
bogdanm	0:9b334a45a8ff	2352	(++) Configure and enable the RTC_Alarm IRQ channel in the NVIC using
bogdanm	0:9b334a45a8ff	2353	the NVIC_Init() function.
bogdanm	0:9b334a45a8ff	2354	(++) Configure the RTC to generate RTC alarms (Alarm A and/or Alarm B)
bogdanm	0:9b334a45a8ff	2355	using the RTC_SetAlarm() and RTC_AlarmCmd() functions.
bogdanm	0:9b334a45a8ff	2356	(+) To enable the RTC Wakeup interrupt, the following sequence is required:
bogdanm	0:9b334a45a8ff	2357	(++) Configure and enable the EXTI Line 20 in interrupt mode and select
bogdanm	0:9b334a45a8ff	2358	the rising edge sensitivity using the EXTI_Init() function.
bogdanm	0:9b334a45a8ff	2359	(++) Configure and enable the RTC_WKUP IRQ channel in the NVIC using
bogdanm	0:9b334a45a8ff	2360	the NVIC_Init() function.
bogdanm	0:9b334a45a8ff	2361	(++) Configure the RTC to generate the RTC wakeup timer event using the
bogdanm	0:9b334a45a8ff	2362	RTC_WakeUpClockConfig(), RTC_SetWakeUpCounter() and RTC_WakeUpCmd()
bogdanm	0:9b334a45a8ff	2363	functions.
bogdanm	0:9b334a45a8ff	2364	(+) To enable the RTC Tamper interrupt, the following sequence is required:
bogdanm	0:9b334a45a8ff	2365	(++) Configure and enable the EXTI Line 19 in interrupt mode and select
bogdanm	0:9b334a45a8ff	2366	the rising edge sensitivity using the EXTI_Init() function.
bogdanm	0:9b334a45a8ff	2367	(++) Configure and enable the TAMP_STAMP IRQ channel in the NVIC using
bogdanm	0:9b334a45a8ff	2368	the NVIC_Init() function.
bogdanm	0:9b334a45a8ff	2369	(++) Configure the RTC to detect the RTC tamper event using the
bogdanm	0:9b334a45a8ff	2370	RTC_TamperTriggerConfig() and RTC_TamperCmd() functions.
bogdanm	0:9b334a45a8ff	2371	(+) To enable the RTC TimeStamp interrupt, the following sequence is required:
bogdanm	0:9b334a45a8ff	2372	(++) Configure and enable the EXTI Line 19 in interrupt mode and select
bogdanm	0:9b334a45a8ff	2373	the rising edge sensitivity using the EXTI_Init() function.
bogdanm	0:9b334a45a8ff	2374	(++) Configure and enable the TAMP_STAMP IRQ channel in the NVIC using
bogdanm	0:9b334a45a8ff	2375	the NVIC_Init() function.
bogdanm	0:9b334a45a8ff	2376	(++) Configure the RTC to detect the RTC time-stamp event using the
bogdanm	0:9b334a45a8ff	2377	RTC_TimeStampCmd() functions.
bogdanm	0:9b334a45a8ff	2378
bogdanm	0:9b334a45a8ff	2379	@endverbatim
bogdanm	0:9b334a45a8ff	2380	* @{
bogdanm	0:9b334a45a8ff	2381	*/
bogdanm	0:9b334a45a8ff	2382
bogdanm	0:9b334a45a8ff	2383	/**
bogdanm	0:9b334a45a8ff	2384	* @brief Enables or disables the specified RTC interrupts.
bogdanm	0:9b334a45a8ff	2385	* @param RTC_IT: specifies the RTC interrupt sources to be enabled or disabled.
bogdanm	0:9b334a45a8ff	2386	* This parameter can be any combination of the following values:
bogdanm	0:9b334a45a8ff	2387	* @arg RTC_IT_TS: Time Stamp interrupt mask
bogdanm	0:9b334a45a8ff	2388	* @arg RTC_IT_WUT: WakeUp Timer interrupt mask
bogdanm	0:9b334a45a8ff	2389	* @arg RTC_IT_ALRB: Alarm B interrupt mask
bogdanm	0:9b334a45a8ff	2390	* @arg RTC_IT_ALRA: Alarm A interrupt mask
bogdanm	0:9b334a45a8ff	2391	* @arg RTC_IT_TAMP: Tamper event interrupt mask
bogdanm	0:9b334a45a8ff	2392	* @param NewState: new state of the specified RTC interrupts.
bogdanm	0:9b334a45a8ff	2393	* This parameter can be: ENABLE or DISABLE.
bogdanm	0:9b334a45a8ff	2394	* @retval None
bogdanm	0:9b334a45a8ff	2395	*/
bogdanm	0:9b334a45a8ff	2396	void RTC_ITConfig(uint32_t RTC_IT, FunctionalState NewState)
bogdanm	0:9b334a45a8ff	2397	{
bogdanm	0:9b334a45a8ff	2398	/* Check the parameters */
bogdanm	0:9b334a45a8ff	2399	assert_param(IS_RTC_CONFIG_IT(RTC_IT));
bogdanm	0:9b334a45a8ff	2400	assert_param(IS_FUNCTIONAL_STATE(NewState));
bogdanm	0:9b334a45a8ff	2401
bogdanm	0:9b334a45a8ff	2402	/* Disable the write protection for RTC registers */
bogdanm	0:9b334a45a8ff	2403	RTC->WPR = 0xCA;
bogdanm	0:9b334a45a8ff	2404	RTC->WPR = 0x53;
bogdanm	0:9b334a45a8ff	2405
bogdanm	0:9b334a45a8ff	2406	if (NewState != DISABLE)
bogdanm	0:9b334a45a8ff	2407	{
bogdanm	0:9b334a45a8ff	2408	/* Configure the Interrupts in the RTC_CR register */
bogdanm	0:9b334a45a8ff	2409	RTC->CR \|= (uint32_t)(RTC_IT & ~RTC_TAFCR_TAMPIE);
bogdanm	0:9b334a45a8ff	2410	/* Configure the Tamper Interrupt in the RTC_TAFCR */
bogdanm	0:9b334a45a8ff	2411	RTC->TAFCR \|= (uint32_t)(RTC_IT & RTC_TAFCR_TAMPIE);
bogdanm	0:9b334a45a8ff	2412	}
bogdanm	0:9b334a45a8ff	2413	else
bogdanm	0:9b334a45a8ff	2414	{
bogdanm	0:9b334a45a8ff	2415	/* Configure the Interrupts in the RTC_CR register */
bogdanm	0:9b334a45a8ff	2416	RTC->CR &= (uint32_t)~(RTC_IT & (uint32_t)~RTC_TAFCR_TAMPIE);
bogdanm	0:9b334a45a8ff	2417	/* Configure the Tamper Interrupt in the RTC_TAFCR */
bogdanm	0:9b334a45a8ff	2418	RTC->TAFCR &= (uint32_t)~(RTC_IT & RTC_TAFCR_TAMPIE);
bogdanm	0:9b334a45a8ff	2419	}
bogdanm	0:9b334a45a8ff	2420	/* Enable the write protection for RTC registers */
bogdanm	0:9b334a45a8ff	2421	RTC->WPR = 0xFF;
bogdanm	0:9b334a45a8ff	2422	}
bogdanm	0:9b334a45a8ff	2423
bogdanm	0:9b334a45a8ff	2424	/**
bogdanm	0:9b334a45a8ff	2425	* @brief Checks whether the specified RTC flag is set or not.
bogdanm	0:9b334a45a8ff	2426	* @param RTC_FLAG: specifies the flag to check.
bogdanm	0:9b334a45a8ff	2427	* This parameter can be one of the following values:
bogdanm	0:9b334a45a8ff	2428	* @arg RTC_FLAG_RECALPF: RECALPF event flag
bogdanm	0:9b334a45a8ff	2429	* @arg RTC_FLAG_TAMP3F: Tamper 3 event flag
bogdanm	0:9b334a45a8ff	2430	* @arg RTC_FLAG_TAMP2F: Tamper 2 event flag
bogdanm	0:9b334a45a8ff	2431	* @arg RTC_FLAG_TAMP1F: Tamper 1 event flag
bogdanm	0:9b334a45a8ff	2432	* @arg RTC_FLAG_TSOVF: Time Stamp OverFlow flag
bogdanm	0:9b334a45a8ff	2433	* @arg RTC_FLAG_TSF: Time Stamp event flag
bogdanm	0:9b334a45a8ff	2434	* @arg RTC_FLAG_WUTF: WakeUp Timer flag
bogdanm	0:9b334a45a8ff	2435	* @arg RTC_FLAG_ALRBF: Alarm B flag
bogdanm	0:9b334a45a8ff	2436	* @arg RTC_FLAG_ALRAF: Alarm A flag
bogdanm	0:9b334a45a8ff	2437	* @arg RTC_FLAG_INITF: Initialization mode flag
bogdanm	0:9b334a45a8ff	2438	* @arg RTC_FLAG_RSF: Registers Synchronized flag
bogdanm	0:9b334a45a8ff	2439	* @arg RTC_FLAG_INITS: Registers Configured flag
bogdanm	0:9b334a45a8ff	2440	* @argRTC_FLAG_SHPF : Shift operation pending flag.
bogdanm	0:9b334a45a8ff	2441	* @arg RTC_FLAG_WUTWF: WakeUp Timer Write flag
bogdanm	0:9b334a45a8ff	2442	* @arg RTC_FLAG_ALRBWF: Alarm B Write flag
bogdanm	0:9b334a45a8ff	2443	* @arg RTC_FLAG_ALRAWF: Alarm A write flag
bogdanm	0:9b334a45a8ff	2444	* @retval The new state of RTC_FLAG (SET or RESET).
bogdanm	0:9b334a45a8ff	2445	*/
bogdanm	0:9b334a45a8ff	2446	FlagStatus RTC_GetFlagStatus(uint32_t RTC_FLAG)
bogdanm	0:9b334a45a8ff	2447	{
bogdanm	0:9b334a45a8ff	2448	FlagStatus bitstatus = RESET;
bogdanm	0:9b334a45a8ff	2449	uint32_t tmpreg = 0;
bogdanm	0:9b334a45a8ff	2450
bogdanm	0:9b334a45a8ff	2451	/* Check the parameters */
bogdanm	0:9b334a45a8ff	2452	assert_param(IS_RTC_GET_FLAG(RTC_FLAG));
bogdanm	0:9b334a45a8ff	2453
bogdanm	0:9b334a45a8ff	2454	/* Get all the flags */
bogdanm	0:9b334a45a8ff	2455	tmpreg = (uint32_t)(RTC->ISR & RTC_FLAGS_MASK);
bogdanm	0:9b334a45a8ff	2456
bogdanm	0:9b334a45a8ff	2457	/* Return the status of the flag */
bogdanm	0:9b334a45a8ff	2458	if ((tmpreg & RTC_FLAG) != (uint32_t)RESET)
bogdanm	0:9b334a45a8ff	2459	{
bogdanm	0:9b334a45a8ff	2460	bitstatus = SET;
bogdanm	0:9b334a45a8ff	2461	}
bogdanm	0:9b334a45a8ff	2462	else
bogdanm	0:9b334a45a8ff	2463	{
bogdanm	0:9b334a45a8ff	2464	bitstatus = RESET;
bogdanm	0:9b334a45a8ff	2465	}
bogdanm	0:9b334a45a8ff	2466	return bitstatus;
bogdanm	0:9b334a45a8ff	2467	}
bogdanm	0:9b334a45a8ff	2468
bogdanm	0:9b334a45a8ff	2469	/**
bogdanm	0:9b334a45a8ff	2470	* @brief Clears the RTC's pending flags.
bogdanm	0:9b334a45a8ff	2471	* @param RTC_FLAG: specifies the RTC flag to clear.
bogdanm	0:9b334a45a8ff	2472	* This parameter can be any combination of the following values:
bogdanm	0:9b334a45a8ff	2473	* @arg RTC_FLAG_TAMP3F: Tamper 3 event flag
bogdanm	0:9b334a45a8ff	2474	* @arg RTC_FLAG_TAMP2F: Tamper 2 event flag
bogdanm	0:9b334a45a8ff	2475	* @arg RTC_FLAG_TAMP1F: Tamper 1 event flag
bogdanm	0:9b334a45a8ff	2476	* @arg RTC_FLAG_TSOVF: Time Stamp Overflow flag
bogdanm	0:9b334a45a8ff	2477	* @arg RTC_FLAG_TSF: Time Stamp event flag
bogdanm	0:9b334a45a8ff	2478	* @arg RTC_FLAG_WUTF: WakeUp Timer flag
bogdanm	0:9b334a45a8ff	2479	* @arg RTC_FLAG_ALRBF: Alarm B flag
bogdanm	0:9b334a45a8ff	2480	* @arg RTC_FLAG_ALRAF: Alarm A flag
bogdanm	0:9b334a45a8ff	2481	* @arg RTC_FLAG_RSF: Registers Synchronized flag
bogdanm	0:9b334a45a8ff	2482	* @retval None
bogdanm	0:9b334a45a8ff	2483	*/
bogdanm	0:9b334a45a8ff	2484	void RTC_ClearFlag(uint32_t RTC_FLAG)
bogdanm	0:9b334a45a8ff	2485	{
bogdanm	0:9b334a45a8ff	2486	/* Check the parameters */
bogdanm	0:9b334a45a8ff	2487	assert_param(IS_RTC_CLEAR_FLAG(RTC_FLAG));
bogdanm	0:9b334a45a8ff	2488
bogdanm	0:9b334a45a8ff	2489	/* Clear the Flags in the RTC_ISR register */
bogdanm	0:9b334a45a8ff	2490	RTC->ISR = (uint32_t)((uint32_t)(~((RTC_FLAG \| RTC_ISR_INIT)& 0x0001FFFF) \| (uint32_t)(RTC->ISR & RTC_ISR_INIT)));
bogdanm	0:9b334a45a8ff	2491	}
bogdanm	0:9b334a45a8ff	2492
bogdanm	0:9b334a45a8ff	2493	/**
bogdanm	0:9b334a45a8ff	2494	* @brief Checks whether the specified RTC interrupt has occurred or not.
bogdanm	0:9b334a45a8ff	2495	* @param RTC_IT: specifies the RTC interrupt source to check.
bogdanm	0:9b334a45a8ff	2496	* This parameter can be one of the following values:
bogdanm	0:9b334a45a8ff	2497	* @arg RTC_IT_TS: Time Stamp interrupt
bogdanm	0:9b334a45a8ff	2498	* @arg RTC_IT_WUT: WakeUp Timer interrupt
bogdanm	0:9b334a45a8ff	2499	* @arg RTC_IT_ALRB: Alarm B interrupt
bogdanm	0:9b334a45a8ff	2500	* @arg RTC_IT_ALRA: Alarm A interrupt
bogdanm	0:9b334a45a8ff	2501	* @arg RTC_IT_TAMP1: Tamper1 event interrupt
bogdanm	0:9b334a45a8ff	2502	* @arg RTC_IT_TAMP2: Tamper2 event interrupt
bogdanm	0:9b334a45a8ff	2503	* @arg RTC_IT_TAMP3: Tamper3 event interrupt
bogdanm	0:9b334a45a8ff	2504	* @retval The new state of RTC_IT (SET or RESET).
bogdanm	0:9b334a45a8ff	2505	*/
bogdanm	0:9b334a45a8ff	2506	ITStatus RTC_GetITStatus(uint32_t RTC_IT)
bogdanm	0:9b334a45a8ff	2507	{
bogdanm	0:9b334a45a8ff	2508	ITStatus bitstatus = RESET;
bogdanm	0:9b334a45a8ff	2509	uint32_t tmpreg = 0, enablestatus = 0;
bogdanm	0:9b334a45a8ff	2510
bogdanm	0:9b334a45a8ff	2511	/* Check the parameters */
bogdanm	0:9b334a45a8ff	2512	assert_param(IS_RTC_GET_IT(RTC_IT));
bogdanm	0:9b334a45a8ff	2513
bogdanm	0:9b334a45a8ff	2514	/* Get the TAMPER Interrupt enable bit and pending bit */
bogdanm	0:9b334a45a8ff	2515	tmpreg = (uint32_t)(RTC->TAFCR & (RTC_TAFCR_TAMPIE));
bogdanm	0:9b334a45a8ff	2516
bogdanm	0:9b334a45a8ff	2517	/* Get the Interrupt enable Status */
bogdanm	0:9b334a45a8ff	2518	enablestatus = (uint32_t)((RTC->CR & RTC_IT) \| (tmpreg & ((RTC_IT >> (RTC_IT >> 18)) >> 15)));
bogdanm	0:9b334a45a8ff	2519
bogdanm	0:9b334a45a8ff	2520	/* Get the Interrupt pending bit */
bogdanm	0:9b334a45a8ff	2521	tmpreg = (uint32_t)((RTC->ISR & (uint32_t)(RTC_IT >> 4)));
bogdanm	0:9b334a45a8ff	2522
bogdanm	0:9b334a45a8ff	2523	/* Get the status of the Interrupt */
bogdanm	0:9b334a45a8ff	2524	if ((enablestatus != (uint32_t)RESET) && ((tmpreg & 0x0000FFFF) != (uint32_t)RESET))
bogdanm	0:9b334a45a8ff	2525	{
bogdanm	0:9b334a45a8ff	2526	bitstatus = SET;
bogdanm	0:9b334a45a8ff	2527	}
bogdanm	0:9b334a45a8ff	2528	else
bogdanm	0:9b334a45a8ff	2529	{
bogdanm	0:9b334a45a8ff	2530	bitstatus = RESET;
bogdanm	0:9b334a45a8ff	2531	}
bogdanm	0:9b334a45a8ff	2532	return bitstatus;
bogdanm	0:9b334a45a8ff	2533	}
bogdanm	0:9b334a45a8ff	2534
bogdanm	0:9b334a45a8ff	2535	/**
bogdanm	0:9b334a45a8ff	2536	* @brief Clears the RTC's interrupt pending bits.
bogdanm	0:9b334a45a8ff	2537	* @param RTC_IT: specifies the RTC interrupt pending bit to clear.
bogdanm	0:9b334a45a8ff	2538	* This parameter can be any combination of the following values:
bogdanm	0:9b334a45a8ff	2539	* @arg RTC_IT_TS: Time Stamp interrupt
bogdanm	0:9b334a45a8ff	2540	* @arg RTC_IT_WUT: WakeUp Timer interrupt
bogdanm	0:9b334a45a8ff	2541	* @arg RTC_IT_ALRB: Alarm B interrupt
bogdanm	0:9b334a45a8ff	2542	* @arg RTC_IT_ALRA: Alarm A interrupt
bogdanm	0:9b334a45a8ff	2543	* @arg RTC_IT_TAMP1: Tamper1 event interrupt
bogdanm	0:9b334a45a8ff	2544	* @arg RTC_IT_TAMP2: Tamper2 event interrupt
bogdanm	0:9b334a45a8ff	2545	* @arg RTC_IT_TAMP3: Tamper3 event interrupt
bogdanm	0:9b334a45a8ff	2546	* @retval None
bogdanm	0:9b334a45a8ff	2547	*/
bogdanm	0:9b334a45a8ff	2548	void RTC_ClearITPendingBit(uint32_t RTC_IT)
bogdanm	0:9b334a45a8ff	2549	{
bogdanm	0:9b334a45a8ff	2550	uint32_t tmpreg = 0;
bogdanm	0:9b334a45a8ff	2551
bogdanm	0:9b334a45a8ff	2552	/* Check the parameters */
bogdanm	0:9b334a45a8ff	2553	assert_param(IS_RTC_CLEAR_IT(RTC_IT));
bogdanm	0:9b334a45a8ff	2554
bogdanm	0:9b334a45a8ff	2555	/* Get the RTC_ISR Interrupt pending bits mask */
bogdanm	0:9b334a45a8ff	2556	tmpreg = (uint32_t)(RTC_IT >> 4);
bogdanm	0:9b334a45a8ff	2557
bogdanm	0:9b334a45a8ff	2558	/* Clear the interrupt pending bits in the RTC_ISR register */
bogdanm	0:9b334a45a8ff	2559	RTC->ISR = (uint32_t)((uint32_t)(~((tmpreg \| RTC_ISR_INIT)& 0x0000FFFF) \| (uint32_t)(RTC->ISR & RTC_ISR_INIT)));
bogdanm	0:9b334a45a8ff	2560	}
bogdanm	0:9b334a45a8ff	2561
bogdanm	0:9b334a45a8ff	2562	/**
bogdanm	0:9b334a45a8ff	2563	* @}
bogdanm	0:9b334a45a8ff	2564	*/
bogdanm	0:9b334a45a8ff	2565
bogdanm	0:9b334a45a8ff	2566	/**
bogdanm	0:9b334a45a8ff	2567	* @brief Converts a 2 digit decimal to BCD format.
bogdanm	0:9b334a45a8ff	2568	* @param Value: Byte to be converted.
bogdanm	0:9b334a45a8ff	2569	* @retval Converted byte
bogdanm	0:9b334a45a8ff	2570	*/
bogdanm	0:9b334a45a8ff	2571	static uint8_t RTC_ByteToBcd2(uint8_t Value)
bogdanm	0:9b334a45a8ff	2572	{
bogdanm	0:9b334a45a8ff	2573	uint8_t bcdhigh = 0;
bogdanm	0:9b334a45a8ff	2574
bogdanm	0:9b334a45a8ff	2575	while (Value >= 10)
bogdanm	0:9b334a45a8ff	2576	{
bogdanm	0:9b334a45a8ff	2577	bcdhigh++;
bogdanm	0:9b334a45a8ff	2578	Value -= 10;
bogdanm	0:9b334a45a8ff	2579	}
bogdanm	0:9b334a45a8ff	2580
bogdanm	0:9b334a45a8ff	2581	return ((uint8_t)(bcdhigh << 4) \| Value);
bogdanm	0:9b334a45a8ff	2582	}
bogdanm	0:9b334a45a8ff	2583
bogdanm	0:9b334a45a8ff	2584	/**
bogdanm	0:9b334a45a8ff	2585	* @brief Convert from 2 digit BCD to Binary.
bogdanm	0:9b334a45a8ff	2586	* @param Value: BCD value to be converted.
bogdanm	0:9b334a45a8ff	2587	* @retval Converted word
bogdanm	0:9b334a45a8ff	2588	*/
bogdanm	0:9b334a45a8ff	2589	static uint8_t RTC_Bcd2ToByte(uint8_t Value)
bogdanm	0:9b334a45a8ff	2590	{
bogdanm	0:9b334a45a8ff	2591	uint8_t tmp = 0;
bogdanm	0:9b334a45a8ff	2592	tmp = ((uint8_t)(Value & (uint8_t)0xF0) >> (uint8_t)0x4) * 10;
bogdanm	0:9b334a45a8ff	2593	return (tmp + (Value & (uint8_t)0x0F));
bogdanm	0:9b334a45a8ff	2594	}
bogdanm	0:9b334a45a8ff	2595
bogdanm	0:9b334a45a8ff	2596	/**
bogdanm	0:9b334a45a8ff	2597	* @}
bogdanm	0:9b334a45a8ff	2598	*/
bogdanm	0:9b334a45a8ff	2599
bogdanm	0:9b334a45a8ff	2600	/**
bogdanm	0:9b334a45a8ff	2601	* @}
bogdanm	0:9b334a45a8ff	2602	*/
bogdanm	0:9b334a45a8ff	2603
bogdanm	0:9b334a45a8ff	2604	/**
bogdanm	0:9b334a45a8ff	2605	* @}
bogdanm	0:9b334a45a8ff	2606	*/
bogdanm	0:9b334a45a8ff	2607
bogdanm	0:9b334a45a8ff	2608	/********************** (C) COPYRIGHT STMicroelectronics *END OF FILE**/

Repository toolbox

Repository details

Type:	Library
Created:	30 Mar 2016
Imports:	4
Forks:	0
Commits:	104
Dependents:	0
Dependencies:	0
Followers:	1

Important changes to repositories hosted on mbed.com

targets/cmsis/TARGET_STM/TARGET_STM32F3XX/stm32f30x_rtc.c@103:493a29d2d4d7, 2016-03-30 (annotated)

Who changed what in which revision?

Repository toolbox

Repository details

Important Information for this Arm website

Important changes to repositories hosted on mbed.com

targets/cmsis/TARGET_STM/TARGET_STM32F3XX/stm32f30x_rtc.c@103:493a29d2d4d7, 2016-03-30 (annotated)

Who changed what in which revision?

Repository toolbox

Repository details

Important Information for this Arm website

Access Warning