frederic blanc / mbed

/TARGET_K64F/TARGET_Freescale/TARGET_KPSDK_MCUS/TARGET_KPSDK_CODE/hal/adc/fsl_adc_hal.h substitute line 894 extern } by }

Fork of mbed by mbed official

TARGET_ARCH_MAX/stm32f4xx_hal_rtc.h@93:9dd889aeda0e, 2014-12-05 (annotated)

Committer:
fblanc
Date:
Fri Dec 05 15:42:32 2014 +0000
Revision:
93:9dd889aeda0e
Parent:
92:4fc01daae5a5 
substitute line 894 extern } by }; /TARGET_K64F/TARGET_Freescale/TARGET_KPSDK_MCUS/TARGET_KPSDK_CODE/hal/adc/fsl_adc_hal.h

Who changed what in which revision?

UserRevisionLine numberNew contents of line
bogdanm 89:552587b429a1 1 /**
bogdanm 89:552587b429a1 2 ******************************************************************************
bogdanm 89:552587b429a1 3 * @file stm32f4xx_hal_rtc.h
bogdanm 89:552587b429a1 4 * @author MCD Application Team
bogdanm 92:4fc01daae5a5 5 * @version V1.1.0
bogdanm 92:4fc01daae5a5 6 * @date 19-June-2014
bogdanm 89:552587b429a1 7 * @brief Header file of RTC HAL module.
bogdanm 89:552587b429a1 8 ******************************************************************************
bogdanm 89:552587b429a1 9 * @attention
bogdanm 89:552587b429a1 10 *
bogdanm 89:552587b429a1 11 * <h2><center>&copy; COPYRIGHT(c) 2014 STMicroelectronics</center></h2>
bogdanm 89:552587b429a1 12 *
bogdanm 89:552587b429a1 13 * Redistribution and use in source and binary forms, with or without modification,
bogdanm 89:552587b429a1 14 * are permitted provided that the following conditions are met:
bogdanm 89:552587b429a1 15 * 1. Redistributions of source code must retain the above copyright notice,
bogdanm 89:552587b429a1 16 * this list of conditions and the following disclaimer.
bogdanm 89:552587b429a1 17 * 2. Redistributions in binary form must reproduce the above copyright notice,
bogdanm 89:552587b429a1 18 * this list of conditions and the following disclaimer in the documentation
bogdanm 89:552587b429a1 19 * and/or other materials provided with the distribution.
bogdanm 89:552587b429a1 20 * 3. Neither the name of STMicroelectronics nor the names of its contributors
bogdanm 89:552587b429a1 21 * may be used to endorse or promote products derived from this software
bogdanm 89:552587b429a1 22 * without specific prior written permission.
bogdanm 89:552587b429a1 23 *
bogdanm 89:552587b429a1 24 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
bogdanm 89:552587b429a1 25 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
bogdanm 89:552587b429a1 26 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
bogdanm 89:552587b429a1 27 * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
bogdanm 89:552587b429a1 28 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
bogdanm 89:552587b429a1 29 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
bogdanm 89:552587b429a1 30 * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
bogdanm 89:552587b429a1 31 * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
bogdanm 89:552587b429a1 32 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
bogdanm 89:552587b429a1 33 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
bogdanm 89:552587b429a1 34 *
bogdanm 89:552587b429a1 35 ******************************************************************************
bogdanm 89:552587b429a1 36 */
bogdanm 89:552587b429a1 37
bogdanm 89:552587b429a1 38 /* Define to prevent recursive inclusion -------------------------------------*/
bogdanm 89:552587b429a1 39 #ifndef __STM32F4xx_HAL_RTC_H
bogdanm 89:552587b429a1 40 #define __STM32F4xx_HAL_RTC_H
bogdanm 89:552587b429a1 41
bogdanm 89:552587b429a1 42 #ifdef __cplusplus
bogdanm 89:552587b429a1 43 extern "C" {
bogdanm 89:552587b429a1 44 #endif
bogdanm 89:552587b429a1 45
bogdanm 89:552587b429a1 46 /* Includes ------------------------------------------------------------------*/
bogdanm 89:552587b429a1 47 #include "stm32f4xx_hal_def.h"
bogdanm 89:552587b429a1 48
bogdanm 89:552587b429a1 49 /** @addtogroup STM32F4xx_HAL_Driver
bogdanm 89:552587b429a1 50 * @{
bogdanm 89:552587b429a1 51 */
bogdanm 89:552587b429a1 52
bogdanm 89:552587b429a1 53 /** @addtogroup RTC
bogdanm 89:552587b429a1 54 * @{
bogdanm 89:552587b429a1 55 */
bogdanm 89:552587b429a1 56
bogdanm 89:552587b429a1 57 /* Exported types ------------------------------------------------------------*/
bogdanm 89:552587b429a1 58 /**
bogdanm 89:552587b429a1 59 * @brief HAL State structures definition
bogdanm 89:552587b429a1 60 */
bogdanm 89:552587b429a1 61 typedef enum
bogdanm 89:552587b429a1 62 {
bogdanm 89:552587b429a1 63 HAL_RTC_STATE_RESET = 0x00, /*!< RTC not yet initialized or disabled */
bogdanm 89:552587b429a1 64 HAL_RTC_STATE_READY = 0x01, /*!< RTC initialized and ready for use */
bogdanm 89:552587b429a1 65 HAL_RTC_STATE_BUSY = 0x02, /*!< RTC process is ongoing */
bogdanm 89:552587b429a1 66 HAL_RTC_STATE_TIMEOUT = 0x03, /*!< RTC timeout state */
bogdanm 89:552587b429a1 67 HAL_RTC_STATE_ERROR = 0x04 /*!< RTC error state */
bogdanm 89:552587b429a1 68
bogdanm 89:552587b429a1 69 }HAL_RTCStateTypeDef;
bogdanm 89:552587b429a1 70
bogdanm 89:552587b429a1 71 /**
bogdanm 89:552587b429a1 72 * @brief RTC Configuration Structure definition
bogdanm 89:552587b429a1 73 */
bogdanm 89:552587b429a1 74 typedef struct
bogdanm 89:552587b429a1 75 {
bogdanm 89:552587b429a1 76 uint32_t HourFormat; /*!< Specifies the RTC Hour Format.
bogdanm 89:552587b429a1 77 This parameter can be a value of @ref RTC_Hour_Formats */
bogdanm 89:552587b429a1 78
bogdanm 89:552587b429a1 79 uint32_t AsynchPrediv; /*!< Specifies the RTC Asynchronous Predivider value.
bogdanm 89:552587b429a1 80 This parameter must be a number between Min_Data = 0x00 and Max_Data = 0x7F */
bogdanm 89:552587b429a1 81
bogdanm 89:552587b429a1 82 uint32_t SynchPrediv; /*!< Specifies the RTC Synchronous Predivider value.
bogdanm 89:552587b429a1 83 This parameter must be a number between Min_Data = 0x00 and Max_Data = 0x7FFF */
bogdanm 89:552587b429a1 84
bogdanm 89:552587b429a1 85 uint32_t OutPut; /*!< Specifies which signal will be routed to the RTC output.
bogdanm 89:552587b429a1 86 This parameter can be a value of @ref RTC_Output_selection_Definitions */
bogdanm 89:552587b429a1 87
bogdanm 89:552587b429a1 88 uint32_t OutPutPolarity; /*!< Specifies the polarity of the output signal.
bogdanm 89:552587b429a1 89 This parameter can be a value of @ref RTC_Output_Polarity_Definitions */
bogdanm 89:552587b429a1 90
bogdanm 89:552587b429a1 91 uint32_t OutPutType; /*!< Specifies the RTC Output Pin mode.
bogdanm 89:552587b429a1 92 This parameter can be a value of @ref RTC_Output_Type_ALARM_OUT */
bogdanm 89:552587b429a1 93 }RTC_InitTypeDef;
bogdanm 89:552587b429a1 94
bogdanm 89:552587b429a1 95 /**
bogdanm 89:552587b429a1 96 * @brief RTC Time structure definition
bogdanm 89:552587b429a1 97 */
bogdanm 89:552587b429a1 98 typedef struct
bogdanm 89:552587b429a1 99 {
bogdanm 89:552587b429a1 100 uint8_t Hours; /*!< Specifies the RTC Time Hour.
bogdanm 89:552587b429a1 101 This parameter must be a number between Min_Data = 0 and Max_Data = 12 if the RTC_HourFormat_12 is selected.
bogdanm 89:552587b429a1 102 This parameter must be a number between Min_Data = 0 and Max_Data = 23 if the RTC_HourFormat_24 is selected */
bogdanm 89:552587b429a1 103
bogdanm 89:552587b429a1 104 uint8_t Minutes; /*!< Specifies the RTC Time Minutes.
bogdanm 89:552587b429a1 105 This parameter must be a number between Min_Data = 0 and Max_Data = 59 */
bogdanm 89:552587b429a1 106
bogdanm 89:552587b429a1 107 uint8_t Seconds; /*!< Specifies the RTC Time Seconds.
bogdanm 89:552587b429a1 108 This parameter must be a number between Min_Data = 0 and Max_Data = 59 */
bogdanm 89:552587b429a1 109
bogdanm 89:552587b429a1 110 uint32_t SubSeconds; /*!< Specifies the RTC Time SubSeconds.
bogdanm 89:552587b429a1 111 This parameter must be a number between Min_Data = 0 and Max_Data = 59 */
bogdanm 89:552587b429a1 112
bogdanm 89:552587b429a1 113 uint8_t TimeFormat; /*!< Specifies the RTC AM/PM Time.
bogdanm 89:552587b429a1 114 This parameter can be a value of @ref RTC_AM_PM_Definitions */
bogdanm 89:552587b429a1 115
bogdanm 89:552587b429a1 116 uint32_t DayLightSaving; /*!< Specifies DayLight Save Operation.
bogdanm 89:552587b429a1 117 This parameter can be a value of @ref RTC_DayLightSaving_Definitions */
bogdanm 89:552587b429a1 118
bogdanm 89:552587b429a1 119 uint32_t StoreOperation; /*!< Specifies RTC_StoreOperation value to be written in the BCK bit
bogdanm 89:552587b429a1 120 in CR register to store the operation.
bogdanm 89:552587b429a1 121 This parameter can be a value of @ref RTC_StoreOperation_Definitions */
bogdanm 89:552587b429a1 122 }RTC_TimeTypeDef;
bogdanm 89:552587b429a1 123
bogdanm 89:552587b429a1 124 /**
bogdanm 89:552587b429a1 125 * @brief RTC Date structure definition
bogdanm 89:552587b429a1 126 */
bogdanm 89:552587b429a1 127 typedef struct
bogdanm 89:552587b429a1 128 {
bogdanm 89:552587b429a1 129 uint8_t WeekDay; /*!< Specifies the RTC Date WeekDay.
bogdanm 89:552587b429a1 130 This parameter can be a value of @ref RTC_WeekDay_Definitions */
bogdanm 89:552587b429a1 131
bogdanm 89:552587b429a1 132 uint8_t Month; /*!< Specifies the RTC Date Month (in BCD format).
bogdanm 89:552587b429a1 133 This parameter can be a value of @ref RTC_Month_Date_Definitions */
bogdanm 89:552587b429a1 134
bogdanm 89:552587b429a1 135 uint8_t Date; /*!< Specifies the RTC Date.
bogdanm 89:552587b429a1 136 This parameter must be a number between Min_Data = 1 and Max_Data = 31 */
bogdanm 89:552587b429a1 137
bogdanm 89:552587b429a1 138 uint8_t Year; /*!< Specifies the RTC Date Year.
bogdanm 89:552587b429a1 139 This parameter must be a number between Min_Data = 0 and Max_Data = 99 */
bogdanm 89:552587b429a1 140
bogdanm 89:552587b429a1 141 }RTC_DateTypeDef;
bogdanm 89:552587b429a1 142
bogdanm 89:552587b429a1 143 /**
bogdanm 89:552587b429a1 144 * @brief RTC Alarm structure definition
bogdanm 89:552587b429a1 145 */
bogdanm 89:552587b429a1 146 typedef struct
bogdanm 89:552587b429a1 147 {
bogdanm 89:552587b429a1 148 RTC_TimeTypeDef AlarmTime; /*!< Specifies the RTC Alarm Time members */
bogdanm 89:552587b429a1 149
bogdanm 89:552587b429a1 150 uint32_t AlarmMask; /*!< Specifies the RTC Alarm Masks.
bogdanm 89:552587b429a1 151 This parameter can be a value of @ref RTC_AlarmMask_Definitions */
bogdanm 89:552587b429a1 152
bogdanm 89:552587b429a1 153 uint32_t AlarmSubSecondMask; /*!< Specifies the RTC Alarm SubSeconds Masks.
bogdanm 89:552587b429a1 154 This parameter can be a value of @ref RTC_Alarm_Sub_Seconds_Masks_Definitions */
bogdanm 89:552587b429a1 155
bogdanm 89:552587b429a1 156 uint32_t AlarmDateWeekDaySel; /*!< Specifies the RTC Alarm is on Date or WeekDay.
bogdanm 89:552587b429a1 157 This parameter can be a value of @ref RTC_AlarmDateWeekDay_Definitions */
bogdanm 89:552587b429a1 158
bogdanm 89:552587b429a1 159 uint8_t AlarmDateWeekDay; /*!< Specifies the RTC Alarm Date/WeekDay.
bogdanm 89:552587b429a1 160 If the Alarm Date is selected, this parameter must be set to a value in the 1-31 range.
bogdanm 89:552587b429a1 161 If the Alarm WeekDay is selected, this parameter can be a value of @ref RTC_WeekDay_Definitions */
bogdanm 89:552587b429a1 162
bogdanm 89:552587b429a1 163 uint32_t Alarm; /*!< Specifies the alarm .
bogdanm 89:552587b429a1 164 This parameter can be a value of @ref RTC_Alarms_Definitions */
bogdanm 89:552587b429a1 165 }RTC_AlarmTypeDef;
bogdanm 89:552587b429a1 166
bogdanm 89:552587b429a1 167 /**
bogdanm 89:552587b429a1 168 * @brief Time Handle Structure definition
bogdanm 89:552587b429a1 169 */
bogdanm 89:552587b429a1 170 typedef struct
bogdanm 89:552587b429a1 171 {
bogdanm 89:552587b429a1 172 RTC_TypeDef *Instance; /*!< Register base address */
bogdanm 89:552587b429a1 173
bogdanm 89:552587b429a1 174 RTC_InitTypeDef Init; /*!< RTC required parameters */
bogdanm 89:552587b429a1 175
bogdanm 89:552587b429a1 176 HAL_LockTypeDef Lock; /*!< RTC locking object */
bogdanm 89:552587b429a1 177
bogdanm 89:552587b429a1 178 __IO HAL_RTCStateTypeDef State; /*!< Time communication state */
bogdanm 89:552587b429a1 179
bogdanm 89:552587b429a1 180 }RTC_HandleTypeDef;
bogdanm 89:552587b429a1 181
bogdanm 89:552587b429a1 182 /* Exported constants --------------------------------------------------------*/
bogdanm 89:552587b429a1 183 /** @defgroup RTC_Exported_Constants
bogdanm 89:552587b429a1 184 * @{
bogdanm 89:552587b429a1 185 */
bogdanm 89:552587b429a1 186
bogdanm 89:552587b429a1 187 /* Masks Definition */
bogdanm 89:552587b429a1 188 #define RTC_TR_RESERVED_MASK ((uint32_t)0x007F7F7F)
bogdanm 89:552587b429a1 189 #define RTC_DR_RESERVED_MASK ((uint32_t)0x00FFFF3F)
bogdanm 89:552587b429a1 190 #define RTC_INIT_MASK ((uint32_t)0xFFFFFFFF)
bogdanm 89:552587b429a1 191 #define RTC_RSF_MASK ((uint32_t)0xFFFFFF5F)
bogdanm 89:552587b429a1 192 #define RTC_FLAGS_MASK ((uint32_t)(RTC_FLAG_TSOVF | RTC_FLAG_TSF | RTC_FLAG_WUTF | \
bogdanm 89:552587b429a1 193 RTC_FLAG_ALRBF | RTC_FLAG_ALRAF | RTC_FLAG_INITF | \
bogdanm 89:552587b429a1 194 RTC_FLAG_RSF | RTC_FLAG_INITS | RTC_FLAG_WUTWF | \
bogdanm 89:552587b429a1 195 RTC_FLAG_ALRBWF | RTC_FLAG_ALRAWF | RTC_FLAG_TAMP1F | \
bogdanm 89:552587b429a1 196 RTC_FLAG_RECALPF | RTC_FLAG_SHPF))
bogdanm 89:552587b429a1 197
bogdanm 89:552587b429a1 198 #define RTC_TIMEOUT_VALUE 1000
bogdanm 89:552587b429a1 199
bogdanm 89:552587b429a1 200 /** @defgroup RTC_Hour_Formats
bogdanm 89:552587b429a1 201 * @{
bogdanm 89:552587b429a1 202 */
bogdanm 89:552587b429a1 203 #define RTC_HOURFORMAT_24 ((uint32_t)0x00000000)
bogdanm 89:552587b429a1 204 #define RTC_HOURFORMAT_12 ((uint32_t)0x00000040)
bogdanm 89:552587b429a1 205
bogdanm 89:552587b429a1 206 #define IS_RTC_HOUR_FORMAT(FORMAT) (((FORMAT) == RTC_HOURFORMAT_12) || \
bogdanm 89:552587b429a1 207 ((FORMAT) == RTC_HOURFORMAT_24))
bogdanm 89:552587b429a1 208 /**
bogdanm 89:552587b429a1 209 * @}
bogdanm 89:552587b429a1 210 */
bogdanm 89:552587b429a1 211
bogdanm 89:552587b429a1 212 /** @defgroup RTC_Output_selection_Definitions
bogdanm 89:552587b429a1 213 * @{
bogdanm 89:552587b429a1 214 */
bogdanm 89:552587b429a1 215 #define RTC_OUTPUT_DISABLE ((uint32_t)0x00000000)
bogdanm 89:552587b429a1 216 #define RTC_OUTPUT_ALARMA ((uint32_t)0x00200000)
bogdanm 89:552587b429a1 217 #define RTC_OUTPUT_ALARMB ((uint32_t)0x00400000)
bogdanm 89:552587b429a1 218 #define RTC_OUTPUT_WAKEUP ((uint32_t)0x00600000)
bogdanm 89:552587b429a1 219
bogdanm 89:552587b429a1 220 #define IS_RTC_OUTPUT(OUTPUT) (((OUTPUT) == RTC_OUTPUT_DISABLE) || \
bogdanm 89:552587b429a1 221 ((OUTPUT) == RTC_OUTPUT_ALARMA) || \
bogdanm 89:552587b429a1 222 ((OUTPUT) == RTC_OUTPUT_ALARMB) || \
bogdanm 89:552587b429a1 223 ((OUTPUT) == RTC_OUTPUT_WAKEUP))
bogdanm 89:552587b429a1 224 /**
bogdanm 89:552587b429a1 225 * @}
bogdanm 89:552587b429a1 226 */
bogdanm 89:552587b429a1 227
bogdanm 89:552587b429a1 228 /** @defgroup RTC_Output_Polarity_Definitions
bogdanm 89:552587b429a1 229 * @{
bogdanm 89:552587b429a1 230 */
bogdanm 89:552587b429a1 231 #define RTC_OUTPUT_POLARITY_HIGH ((uint32_t)0x00000000)
bogdanm 89:552587b429a1 232 #define RTC_OUTPUT_POLARITY_LOW ((uint32_t)0x00100000)
bogdanm 89:552587b429a1 233
bogdanm 89:552587b429a1 234 #define IS_RTC_OUTPUT_POL(POL) (((POL) == RTC_OUTPUT_POLARITY_HIGH) || \
bogdanm 89:552587b429a1 235 ((POL) == RTC_OUTPUT_POLARITY_LOW))
bogdanm 89:552587b429a1 236 /**
bogdanm 89:552587b429a1 237 * @}
bogdanm 89:552587b429a1 238 */
bogdanm 89:552587b429a1 239
bogdanm 89:552587b429a1 240 /** @defgroup RTC_Output_Type_ALARM_OUT
bogdanm 89:552587b429a1 241 * @{
bogdanm 89:552587b429a1 242 */
bogdanm 89:552587b429a1 243 #define RTC_OUTPUT_TYPE_OPENDRAIN ((uint32_t)0x00000000)
bogdanm 89:552587b429a1 244 #define RTC_OUTPUT_TYPE_PUSHPULL ((uint32_t)0x00040000)
bogdanm 89:552587b429a1 245
bogdanm 89:552587b429a1 246 #define IS_RTC_OUTPUT_TYPE(TYPE) (((TYPE) == RTC_OUTPUT_TYPE_OPENDRAIN) || \
bogdanm 89:552587b429a1 247 ((TYPE) == RTC_OUTPUT_TYPE_PUSHPULL))
bogdanm 89:552587b429a1 248
bogdanm 89:552587b429a1 249 /**
bogdanm 89:552587b429a1 250 * @}
bogdanm 89:552587b429a1 251 */
bogdanm 89:552587b429a1 252
bogdanm 89:552587b429a1 253 /** @defgroup RTC_Asynchronous_Predivider
bogdanm 89:552587b429a1 254 * @{
bogdanm 89:552587b429a1 255 */
bogdanm 89:552587b429a1 256 #define IS_RTC_ASYNCH_PREDIV(PREDIV) ((PREDIV) <= (uint32_t)0x7F)
bogdanm 89:552587b429a1 257 /**
bogdanm 89:552587b429a1 258 * @}
bogdanm 89:552587b429a1 259 */
bogdanm 89:552587b429a1 260
bogdanm 89:552587b429a1 261
bogdanm 89:552587b429a1 262 /** @defgroup RTC_Synchronous_Predivider
bogdanm 89:552587b429a1 263 * @{
bogdanm 89:552587b429a1 264 */
bogdanm 89:552587b429a1 265 #define IS_RTC_SYNCH_PREDIV(PREDIV) ((PREDIV) <= (uint32_t)0x7FFF)
bogdanm 89:552587b429a1 266 /**
bogdanm 89:552587b429a1 267 * @}
bogdanm 89:552587b429a1 268 */
bogdanm 89:552587b429a1 269
bogdanm 89:552587b429a1 270 /** @defgroup RTC_Time_Definitions
bogdanm 89:552587b429a1 271 * @{
bogdanm 89:552587b429a1 272 */
bogdanm 89:552587b429a1 273 #define IS_RTC_HOUR12(HOUR) (((HOUR) > (uint32_t)0) && ((HOUR) <= (uint32_t)12))
bogdanm 89:552587b429a1 274 #define IS_RTC_HOUR24(HOUR) ((HOUR) <= (uint32_t)23)
bogdanm 89:552587b429a1 275 #define IS_RTC_MINUTES(MINUTES) ((MINUTES) <= (uint32_t)59)
bogdanm 89:552587b429a1 276 #define IS_RTC_SECONDS(SECONDS) ((SECONDS) <= (uint32_t)59)
bogdanm 89:552587b429a1 277 /**
bogdanm 89:552587b429a1 278 * @}
bogdanm 89:552587b429a1 279 */
bogdanm 89:552587b429a1 280
bogdanm 89:552587b429a1 281 /** @defgroup RTC_AM_PM_Definitions
bogdanm 89:552587b429a1 282 * @{
bogdanm 89:552587b429a1 283 */
bogdanm 89:552587b429a1 284 #define RTC_HOURFORMAT12_AM ((uint8_t)0x00)
bogdanm 89:552587b429a1 285 #define RTC_HOURFORMAT12_PM ((uint8_t)0x40)
bogdanm 89:552587b429a1 286
bogdanm 89:552587b429a1 287 #define IS_RTC_HOURFORMAT12(PM) (((PM) == RTC_HOURFORMAT12_AM) || ((PM) == RTC_HOURFORMAT12_PM))
bogdanm 89:552587b429a1 288 /**
bogdanm 89:552587b429a1 289 * @}
bogdanm 89:552587b429a1 290 */
bogdanm 89:552587b429a1 291
bogdanm 89:552587b429a1 292 /** @defgroup RTC_DayLightSaving_Definitions
bogdanm 89:552587b429a1 293 * @{
bogdanm 89:552587b429a1 294 */
bogdanm 89:552587b429a1 295 #define RTC_DAYLIGHTSAVING_SUB1H ((uint32_t)0x00020000)
bogdanm 89:552587b429a1 296 #define RTC_DAYLIGHTSAVING_ADD1H ((uint32_t)0x00010000)
bogdanm 89:552587b429a1 297 #define RTC_DAYLIGHTSAVING_NONE ((uint32_t)0x00000000)
bogdanm 89:552587b429a1 298
bogdanm 89:552587b429a1 299 #define IS_RTC_DAYLIGHT_SAVING(SAVE) (((SAVE) == RTC_DAYLIGHTSAVING_SUB1H) || \
bogdanm 89:552587b429a1 300 ((SAVE) == RTC_DAYLIGHTSAVING_ADD1H) || \
bogdanm 89:552587b429a1 301 ((SAVE) == RTC_DAYLIGHTSAVING_NONE))
bogdanm 89:552587b429a1 302 /**
bogdanm 89:552587b429a1 303 * @}
bogdanm 89:552587b429a1 304 */
bogdanm 89:552587b429a1 305
bogdanm 89:552587b429a1 306 /** @defgroup RTC_StoreOperation_Definitions
bogdanm 89:552587b429a1 307 * @{
bogdanm 89:552587b429a1 308 */
bogdanm 89:552587b429a1 309 #define RTC_STOREOPERATION_RESET ((uint32_t)0x00000000)
bogdanm 89:552587b429a1 310 #define RTC_STOREOPERATION_SET ((uint32_t)0x00040000)
bogdanm 89:552587b429a1 311
bogdanm 89:552587b429a1 312 #define IS_RTC_STORE_OPERATION(OPERATION) (((OPERATION) == RTC_STOREOPERATION_RESET) || \
bogdanm 89:552587b429a1 313 ((OPERATION) == RTC_STOREOPERATION_SET))
bogdanm 89:552587b429a1 314 /**
bogdanm 89:552587b429a1 315 * @}
bogdanm 89:552587b429a1 316 */
bogdanm 89:552587b429a1 317
bogdanm 89:552587b429a1 318 /** @defgroup RTC_Input_parameter_format_definitions
bogdanm 89:552587b429a1 319 * @{
bogdanm 89:552587b429a1 320 */
bogdanm 89:552587b429a1 321 #define FORMAT_BIN ((uint32_t)0x000000000)
bogdanm 89:552587b429a1 322 #define FORMAT_BCD ((uint32_t)0x000000001)
bogdanm 89:552587b429a1 323
bogdanm 89:552587b429a1 324 #define IS_RTC_FORMAT(FORMAT) (((FORMAT) == FORMAT_BIN) || ((FORMAT) == FORMAT_BCD))
bogdanm 89:552587b429a1 325 /**
bogdanm 89:552587b429a1 326 * @}
bogdanm 89:552587b429a1 327 */
bogdanm 89:552587b429a1 328
bogdanm 89:552587b429a1 329 /** @defgroup RTC_Year_Date_Definitions
bogdanm 89:552587b429a1 330 * @{
bogdanm 89:552587b429a1 331 */
bogdanm 89:552587b429a1 332 #define IS_RTC_YEAR(YEAR) ((YEAR) <= (uint32_t)99)
bogdanm 89:552587b429a1 333 /**
bogdanm 89:552587b429a1 334 * @}
bogdanm 89:552587b429a1 335 */
bogdanm 89:552587b429a1 336
bogdanm 89:552587b429a1 337 /** @defgroup RTC_Month_Date_Definitions
bogdanm 89:552587b429a1 338 * @{
bogdanm 89:552587b429a1 339 */
bogdanm 89:552587b429a1 340
bogdanm 89:552587b429a1 341 /* Coded in BCD format */
bogdanm 89:552587b429a1 342 #define RTC_MONTH_JANUARY ((uint8_t)0x01)
bogdanm 89:552587b429a1 343 #define RTC_MONTH_FEBRUARY ((uint8_t)0x02)
bogdanm 89:552587b429a1 344 #define RTC_MONTH_MARCH ((uint8_t)0x03)
bogdanm 89:552587b429a1 345 #define RTC_MONTH_APRIL ((uint8_t)0x04)
bogdanm 89:552587b429a1 346 #define RTC_MONTH_MAY ((uint8_t)0x05)
bogdanm 89:552587b429a1 347 #define RTC_MONTH_JUNE ((uint8_t)0x06)
bogdanm 89:552587b429a1 348 #define RTC_MONTH_JULY ((uint8_t)0x07)
bogdanm 89:552587b429a1 349 #define RTC_MONTH_AUGUST ((uint8_t)0x08)
bogdanm 89:552587b429a1 350 #define RTC_MONTH_SEPTEMBER ((uint8_t)0x09)
bogdanm 89:552587b429a1 351 #define RTC_MONTH_OCTOBER ((uint8_t)0x10)
bogdanm 89:552587b429a1 352 #define RTC_MONTH_NOVEMBER ((uint8_t)0x11)
bogdanm 89:552587b429a1 353 #define RTC_MONTH_DECEMBER ((uint8_t)0x12)
bogdanm 89:552587b429a1 354
bogdanm 89:552587b429a1 355 #define IS_RTC_MONTH(MONTH) (((MONTH) >= (uint32_t)1) && ((MONTH) <= (uint32_t)12))
bogdanm 89:552587b429a1 356 #define IS_RTC_DATE(DATE) (((DATE) >= (uint32_t)1) && ((DATE) <= (uint32_t)31))
bogdanm 89:552587b429a1 357 /**
bogdanm 89:552587b429a1 358 * @}
bogdanm 89:552587b429a1 359 */
bogdanm 89:552587b429a1 360
bogdanm 89:552587b429a1 361 /** @defgroup RTC_WeekDay_Definitions
bogdanm 89:552587b429a1 362 * @{
bogdanm 89:552587b429a1 363 */
bogdanm 89:552587b429a1 364 #define RTC_WEEKDAY_MONDAY ((uint8_t)0x01)
bogdanm 89:552587b429a1 365 #define RTC_WEEKDAY_TUESDAY ((uint8_t)0x02)
bogdanm 89:552587b429a1 366 #define RTC_WEEKDAY_WEDNESDAY ((uint8_t)0x03)
bogdanm 89:552587b429a1 367 #define RTC_WEEKDAY_THURSDAY ((uint8_t)0x04)
bogdanm 89:552587b429a1 368 #define RTC_WEEKDAY_FRIDAY ((uint8_t)0x05)
bogdanm 89:552587b429a1 369 #define RTC_WEEKDAY_SATURDAY ((uint8_t)0x06)
bogdanm 89:552587b429a1 370 #define RTC_WEEKDAY_SUNDAY ((uint8_t)0x07)
bogdanm 89:552587b429a1 371
bogdanm 89:552587b429a1 372 #define IS_RTC_WEEKDAY(WEEKDAY) (((WEEKDAY) == RTC_WEEKDAY_MONDAY) || \
bogdanm 89:552587b429a1 373 ((WEEKDAY) == RTC_WEEKDAY_TUESDAY) || \
bogdanm 89:552587b429a1 374 ((WEEKDAY) == RTC_WEEKDAY_WEDNESDAY) || \
bogdanm 89:552587b429a1 375 ((WEEKDAY) == RTC_WEEKDAY_THURSDAY) || \
bogdanm 89:552587b429a1 376 ((WEEKDAY) == RTC_WEEKDAY_FRIDAY) || \
bogdanm 89:552587b429a1 377 ((WEEKDAY) == RTC_WEEKDAY_SATURDAY) || \
bogdanm 89:552587b429a1 378 ((WEEKDAY) == RTC_WEEKDAY_SUNDAY))
bogdanm 89:552587b429a1 379 /**
bogdanm 89:552587b429a1 380 * @}
bogdanm 89:552587b429a1 381 */
bogdanm 89:552587b429a1 382
bogdanm 89:552587b429a1 383 /** @defgroup RTC_Alarm_Definitions
bogdanm 89:552587b429a1 384 * @{
bogdanm 89:552587b429a1 385 */
bogdanm 89:552587b429a1 386 #define IS_RTC_ALARM_DATE_WEEKDAY_DATE(DATE) (((DATE) >(uint32_t) 0) && ((DATE) <= (uint32_t)31))
bogdanm 89:552587b429a1 387 #define IS_RTC_ALARM_DATE_WEEKDAY_WEEKDAY(WEEKDAY) (((WEEKDAY) == RTC_WEEKDAY_MONDAY) || \
bogdanm 89:552587b429a1 388 ((WEEKDAY) == RTC_WEEKDAY_TUESDAY) || \
bogdanm 89:552587b429a1 389 ((WEEKDAY) == RTC_WEEKDAY_WEDNESDAY) || \
bogdanm 89:552587b429a1 390 ((WEEKDAY) == RTC_WEEKDAY_THURSDAY) || \
bogdanm 89:552587b429a1 391 ((WEEKDAY) == RTC_WEEKDAY_FRIDAY) || \
bogdanm 89:552587b429a1 392 ((WEEKDAY) == RTC_WEEKDAY_SATURDAY) || \
bogdanm 89:552587b429a1 393 ((WEEKDAY) == RTC_WEEKDAY_SUNDAY))
bogdanm 89:552587b429a1 394 /**
bogdanm 89:552587b429a1 395 * @}
bogdanm 89:552587b429a1 396 */
bogdanm 89:552587b429a1 397
bogdanm 89:552587b429a1 398
bogdanm 89:552587b429a1 399 /** @defgroup RTC_AlarmDateWeekDay_Definitions
bogdanm 89:552587b429a1 400 * @{
bogdanm 89:552587b429a1 401 */
bogdanm 89:552587b429a1 402 #define RTC_ALARMDATEWEEKDAYSEL_DATE ((uint32_t)0x00000000)
bogdanm 89:552587b429a1 403 #define RTC_ALARMDATEWEEKDAYSEL_WEEKDAY ((uint32_t)0x40000000)
bogdanm 89:552587b429a1 404
bogdanm 89:552587b429a1 405 #define IS_RTC_ALARM_DATE_WEEKDAY_SEL(SEL) (((SEL) == RTC_ALARMDATEWEEKDAYSEL_DATE) || \
bogdanm 89:552587b429a1 406 ((SEL) == RTC_ALARMDATEWEEKDAYSEL_WEEKDAY))
bogdanm 89:552587b429a1 407 /**
bogdanm 89:552587b429a1 408 * @}
bogdanm 89:552587b429a1 409 */
bogdanm 89:552587b429a1 410
bogdanm 89:552587b429a1 411
bogdanm 89:552587b429a1 412 /** @defgroup RTC_AlarmMask_Definitions
bogdanm 89:552587b429a1 413 * @{
bogdanm 89:552587b429a1 414 */
bogdanm 89:552587b429a1 415 #define RTC_ALARMMASK_NONE ((uint32_t)0x00000000)
bogdanm 89:552587b429a1 416 #define RTC_ALARMMASK_DATEWEEKDAY RTC_ALRMAR_MSK4
bogdanm 89:552587b429a1 417 #define RTC_ALARMMASK_HOURS RTC_ALRMAR_MSK3
bogdanm 89:552587b429a1 418 #define RTC_ALARMMASK_MINUTES RTC_ALRMAR_MSK2
bogdanm 89:552587b429a1 419 #define RTC_ALARMMASK_SECONDS RTC_ALRMAR_MSK1
bogdanm 89:552587b429a1 420 #define RTC_ALARMMASK_ALL ((uint32_t)0x80808080)
bogdanm 89:552587b429a1 421
bogdanm 89:552587b429a1 422 #define IS_ALARM_MASK(MASK) (((MASK) & 0x7F7F7F7F) == (uint32_t)RESET)
bogdanm 89:552587b429a1 423 /**
bogdanm 89:552587b429a1 424 * @}
bogdanm 89:552587b429a1 425 */
bogdanm 89:552587b429a1 426
bogdanm 89:552587b429a1 427 /** @defgroup RTC_Alarms_Definitions
bogdanm 89:552587b429a1 428 * @{
bogdanm 89:552587b429a1 429 */
bogdanm 89:552587b429a1 430 #define RTC_ALARM_A RTC_CR_ALRAE
bogdanm 89:552587b429a1 431 #define RTC_ALARM_B RTC_CR_ALRBE
bogdanm 89:552587b429a1 432
bogdanm 89:552587b429a1 433 #define IS_ALARM(ALARM) (((ALARM) == RTC_ALARM_A) || ((ALARM) == RTC_ALARM_B))
bogdanm 89:552587b429a1 434 /**
bogdanm 89:552587b429a1 435 * @}
bogdanm 89:552587b429a1 436 */
bogdanm 89:552587b429a1 437
bogdanm 89:552587b429a1 438 /** @defgroup RTC_Alarm_Sub_Seconds_Value
bogdanm 89:552587b429a1 439 * @{
bogdanm 89:552587b429a1 440 */
bogdanm 89:552587b429a1 441 #define IS_RTC_ALARM_SUB_SECOND_VALUE(VALUE) ((VALUE) <= (uint32_t)0x00007FFF)
bogdanm 89:552587b429a1 442 /**
bogdanm 89:552587b429a1 443 * @}
bogdanm 89:552587b429a1 444 */
bogdanm 89:552587b429a1 445
bogdanm 89:552587b429a1 446 /** @defgroup RTC_Alarm_Sub_Seconds_Masks_Definitions
bogdanm 89:552587b429a1 447 * @{
bogdanm 89:552587b429a1 448 */
bogdanm 89:552587b429a1 449 #define RTC_ALARMSUBSECONDMASK_ALL ((uint32_t)0x00000000) /*!< All Alarm SS fields are masked.
bogdanm 89:552587b429a1 450 There is no comparison on sub seconds
bogdanm 89:552587b429a1 451 for Alarm */
bogdanm 89:552587b429a1 452 #define RTC_ALARMSUBSECONDMASK_SS14_1 ((uint32_t)0x01000000) /*!< SS[14:1] are don't care in Alarm
bogdanm 89:552587b429a1 453 comparison. Only SS[0] is compared. */
bogdanm 89:552587b429a1 454 #define RTC_ALARMSUBSECONDMASK_SS14_2 ((uint32_t)0x02000000) /*!< SS[14:2] are don't care in Alarm
bogdanm 89:552587b429a1 455 comparison. Only SS[1:0] are compared */
bogdanm 89:552587b429a1 456 #define RTC_ALARMSUBSECONDMASK_SS14_3 ((uint32_t)0x03000000) /*!< SS[14:3] are don't care in Alarm
bogdanm 89:552587b429a1 457 comparison. Only SS[2:0] are compared */
bogdanm 89:552587b429a1 458 #define RTC_ALARMSUBSECONDMASK_SS14_4 ((uint32_t)0x04000000) /*!< SS[14:4] are don't care in Alarm
bogdanm 89:552587b429a1 459 comparison. Only SS[3:0] are compared */
bogdanm 89:552587b429a1 460 #define RTC_ALARMSUBSECONDMASK_SS14_5 ((uint32_t)0x05000000) /*!< SS[14:5] are don't care in Alarm
bogdanm 89:552587b429a1 461 comparison. Only SS[4:0] are compared */
bogdanm 89:552587b429a1 462 #define RTC_ALARMSUBSECONDMASK_SS14_6 ((uint32_t)0x06000000) /*!< SS[14:6] are don't care in Alarm
bogdanm 89:552587b429a1 463 comparison. Only SS[5:0] are compared */
bogdanm 89:552587b429a1 464 #define RTC_ALARMSUBSECONDMASK_SS14_7 ((uint32_t)0x07000000) /*!< SS[14:7] are don't care in Alarm
bogdanm 89:552587b429a1 465 comparison. Only SS[6:0] are compared */
bogdanm 89:552587b429a1 466 #define RTC_ALARMSUBSECONDMASK_SS14_8 ((uint32_t)0x08000000) /*!< SS[14:8] are don't care in Alarm
bogdanm 89:552587b429a1 467 comparison. Only SS[7:0] are compared */
bogdanm 89:552587b429a1 468 #define RTC_ALARMSUBSECONDMASK_SS14_9 ((uint32_t)0x09000000) /*!< SS[14:9] are don't care in Alarm
bogdanm 89:552587b429a1 469 comparison. Only SS[8:0] are compared */
bogdanm 89:552587b429a1 470 #define RTC_ALARMSUBSECONDMASK_SS14_10 ((uint32_t)0x0A000000) /*!< SS[14:10] are don't care in Alarm
bogdanm 89:552587b429a1 471 comparison. Only SS[9:0] are compared */
bogdanm 89:552587b429a1 472 #define RTC_ALARMSUBSECONDMASK_SS14_11 ((uint32_t)0x0B000000) /*!< SS[14:11] are don't care in Alarm
bogdanm 89:552587b429a1 473 comparison. Only SS[10:0] are compared */
bogdanm 89:552587b429a1 474 #define RTC_ALARMSUBSECONDMASK_SS14_12 ((uint32_t)0x0C000000) /*!< SS[14:12] are don't care in Alarm
bogdanm 89:552587b429a1 475 comparison.Only SS[11:0] are compared */
bogdanm 89:552587b429a1 476 #define RTC_ALARMSUBSECONDMASK_SS14_13 ((uint32_t)0x0D000000) /*!< SS[14:13] are don't care in Alarm
bogdanm 89:552587b429a1 477 comparison. Only SS[12:0] are compared */
bogdanm 89:552587b429a1 478 #define RTC_ALARMSUBSECONDMASK_SS14 ((uint32_t)0x0E000000) /*!< SS[14] is don't care in Alarm
bogdanm 89:552587b429a1 479 comparison.Only SS[13:0] are compared */
bogdanm 89:552587b429a1 480 #define RTC_ALARMSUBSECONDMASK_None ((uint32_t)0x0F000000) /*!< SS[14:0] are compared and must match
bogdanm 89:552587b429a1 481 to activate alarm. */
bogdanm 89:552587b429a1 482
bogdanm 89:552587b429a1 483 #define IS_RTC_ALARM_SUB_SECOND_MASK(MASK) (((MASK) == RTC_ALARMSUBSECONDMASK_ALL) || \
bogdanm 89:552587b429a1 484 ((MASK) == RTC_ALARMSUBSECONDMASK_SS14_1) || \
bogdanm 89:552587b429a1 485 ((MASK) == RTC_ALARMSUBSECONDMASK_SS14_2) || \
bogdanm 89:552587b429a1 486 ((MASK) == RTC_ALARMSUBSECONDMASK_SS14_3) || \
bogdanm 89:552587b429a1 487 ((MASK) == RTC_ALARMSUBSECONDMASK_SS14_4) || \
bogdanm 89:552587b429a1 488 ((MASK) == RTC_ALARMSUBSECONDMASK_SS14_5) || \
bogdanm 89:552587b429a1 489 ((MASK) == RTC_ALARMSUBSECONDMASK_SS14_6) || \
bogdanm 89:552587b429a1 490 ((MASK) == RTC_ALARMSUBSECONDMASK_SS14_7) || \
bogdanm 89:552587b429a1 491 ((MASK) == RTC_ALARMSUBSECONDMASK_SS14_8) || \
bogdanm 89:552587b429a1 492 ((MASK) == RTC_ALARMSUBSECONDMASK_SS14_9) || \
bogdanm 89:552587b429a1 493 ((MASK) == RTC_ALARMSUBSECONDMASK_SS14_10) || \
bogdanm 89:552587b429a1 494 ((MASK) == RTC_ALARMSUBSECONDMASK_SS14_11) || \
bogdanm 89:552587b429a1 495 ((MASK) == RTC_ALARMSUBSECONDMASK_SS14_12) || \
bogdanm 89:552587b429a1 496 ((MASK) == RTC_ALARMSUBSECONDMASK_SS14_13) || \
bogdanm 89:552587b429a1 497 ((MASK) == RTC_ALARMSUBSECONDMASK_SS14) || \
bogdanm 89:552587b429a1 498 ((MASK) == RTC_ALARMSUBSECONDMASK_None))
bogdanm 89:552587b429a1 499 /**
bogdanm 89:552587b429a1 500 * @}
bogdanm 89:552587b429a1 501 */
bogdanm 89:552587b429a1 502
bogdanm 89:552587b429a1 503 /** @defgroup RTC_Interrupts_Definitions
bogdanm 89:552587b429a1 504 * @{
bogdanm 89:552587b429a1 505 */
bogdanm 89:552587b429a1 506 #define RTC_IT_TS ((uint32_t)0x00008000)
bogdanm 89:552587b429a1 507 #define RTC_IT_WUT ((uint32_t)0x00004000)
bogdanm 89:552587b429a1 508 #define RTC_IT_ALRB ((uint32_t)0x00002000)
bogdanm 89:552587b429a1 509 #define RTC_IT_ALRA ((uint32_t)0x00001000)
bogdanm 89:552587b429a1 510 #define RTC_IT_TAMP ((uint32_t)0x00000004) /* Used only to Enable the Tamper Interrupt */
bogdanm 89:552587b429a1 511 #define RTC_IT_TAMP1 ((uint32_t)0x00020000)
bogdanm 89:552587b429a1 512 #define RTC_IT_TAMP2 ((uint32_t)0x00040000)
bogdanm 89:552587b429a1 513 /**
bogdanm 89:552587b429a1 514 * @}
bogdanm 89:552587b429a1 515 */
bogdanm 89:552587b429a1 516
bogdanm 89:552587b429a1 517 /** @defgroup RTC_Flags_Definitions
bogdanm 89:552587b429a1 518 * @{
bogdanm 89:552587b429a1 519 */
bogdanm 89:552587b429a1 520 #define RTC_FLAG_RECALPF ((uint32_t)0x00010000)
bogdanm 89:552587b429a1 521 #define RTC_FLAG_TAMP2F ((uint32_t)0x00004000)
bogdanm 89:552587b429a1 522 #define RTC_FLAG_TAMP1F ((uint32_t)0x00002000)
bogdanm 89:552587b429a1 523 #define RTC_FLAG_TSOVF ((uint32_t)0x00001000)
bogdanm 89:552587b429a1 524 #define RTC_FLAG_TSF ((uint32_t)0x00000800)
bogdanm 89:552587b429a1 525 #define RTC_FLAG_WUTF ((uint32_t)0x00000400)
bogdanm 89:552587b429a1 526 #define RTC_FLAG_ALRBF ((uint32_t)0x00000200)
bogdanm 89:552587b429a1 527 #define RTC_FLAG_ALRAF ((uint32_t)0x00000100)
bogdanm 89:552587b429a1 528 #define RTC_FLAG_INITF ((uint32_t)0x00000040)
bogdanm 89:552587b429a1 529 #define RTC_FLAG_RSF ((uint32_t)0x00000020)
bogdanm 89:552587b429a1 530 #define RTC_FLAG_INITS ((uint32_t)0x00000010)
bogdanm 89:552587b429a1 531 #define RTC_FLAG_SHPF ((uint32_t)0x00000008)
bogdanm 89:552587b429a1 532 #define RTC_FLAG_WUTWF ((uint32_t)0x00000004)
bogdanm 89:552587b429a1 533 #define RTC_FLAG_ALRBWF ((uint32_t)0x00000002)
bogdanm 89:552587b429a1 534 #define RTC_FLAG_ALRAWF ((uint32_t)0x00000001)
bogdanm 89:552587b429a1 535 /**
bogdanm 89:552587b429a1 536 * @}
bogdanm 89:552587b429a1 537 */
bogdanm 89:552587b429a1 538
bogdanm 89:552587b429a1 539 /**
bogdanm 89:552587b429a1 540 * @}
bogdanm 89:552587b429a1 541 */
bogdanm 89:552587b429a1 542
bogdanm 89:552587b429a1 543 /* Exported macro ------------------------------------------------------------*/
bogdanm 89:552587b429a1 544
bogdanm 89:552587b429a1 545 /** @brief Reset RTC handle state
bogdanm 89:552587b429a1 546 * @param __HANDLE__: specifies the RTC handle.
bogdanm 89:552587b429a1 547 * @retval None
bogdanm 89:552587b429a1 548 */
bogdanm 89:552587b429a1 549 #define __HAL_RTC_RESET_HANDLE_STATE(__HANDLE__) ((__HANDLE__)->State = HAL_RTC_STATE_RESET)
bogdanm 89:552587b429a1 550
bogdanm 89:552587b429a1 551 /**
bogdanm 89:552587b429a1 552 * @brief Disable the write protection for RTC registers.
bogdanm 89:552587b429a1 553 * @param __HANDLE__: specifies the RTC handle.
bogdanm 89:552587b429a1 554 * @retval None
bogdanm 89:552587b429a1 555 */
bogdanm 89:552587b429a1 556 #define __HAL_RTC_WRITEPROTECTION_DISABLE(__HANDLE__) \
bogdanm 89:552587b429a1 557 do{ \
bogdanm 89:552587b429a1 558 (__HANDLE__)->Instance->WPR = 0xCA; \
bogdanm 89:552587b429a1 559 (__HANDLE__)->Instance->WPR = 0x53; \
bogdanm 89:552587b429a1 560 } while(0)
bogdanm 89:552587b429a1 561
bogdanm 89:552587b429a1 562 /**
bogdanm 89:552587b429a1 563 * @brief Enable the write protection for RTC registers.
bogdanm 89:552587b429a1 564 * @param __HANDLE__: specifies the RTC handle.
bogdanm 89:552587b429a1 565 * @retval None
bogdanm 89:552587b429a1 566 */
bogdanm 89:552587b429a1 567 #define __HAL_RTC_WRITEPROTECTION_ENABLE(__HANDLE__) \
bogdanm 89:552587b429a1 568 do{ \
bogdanm 89:552587b429a1 569 (__HANDLE__)->Instance->WPR = 0xFF; \
bogdanm 89:552587b429a1 570 } while(0)
bogdanm 89:552587b429a1 571
bogdanm 89:552587b429a1 572 /**
bogdanm 89:552587b429a1 573 * @brief Enable the RTC ALARMA peripheral.
bogdanm 89:552587b429a1 574 * @param __HANDLE__: specifies the RTC handle.
bogdanm 89:552587b429a1 575 * @retval None
bogdanm 89:552587b429a1 576 */
bogdanm 89:552587b429a1 577 #define __HAL_RTC_ALARMA_ENABLE(__HANDLE__) ((__HANDLE__)->Instance->CR |= (RTC_CR_ALRAE))
bogdanm 89:552587b429a1 578
bogdanm 89:552587b429a1 579 /**
bogdanm 89:552587b429a1 580 * @brief Disable the RTC ALARMA peripheral.
bogdanm 89:552587b429a1 581 * @param __HANDLE__: specifies the RTC handle.
bogdanm 89:552587b429a1 582 * @retval None
bogdanm 89:552587b429a1 583 */
bogdanm 89:552587b429a1 584 #define __HAL_RTC_ALARMA_DISABLE(__HANDLE__) ((__HANDLE__)->Instance->CR &= ~(RTC_CR_ALRAE))
bogdanm 89:552587b429a1 585
bogdanm 89:552587b429a1 586 /**
bogdanm 89:552587b429a1 587 * @brief Enable the RTC ALARMB peripheral.
bogdanm 89:552587b429a1 588 * @param __HANDLE__: specifies the RTC handle.
bogdanm 89:552587b429a1 589 * @retval None
bogdanm 89:552587b429a1 590 */
bogdanm 89:552587b429a1 591 #define __HAL_RTC_ALARMB_ENABLE(__HANDLE__) ((__HANDLE__)->Instance->CR |= (RTC_CR_ALRBE))
bogdanm 89:552587b429a1 592
bogdanm 89:552587b429a1 593 /**
bogdanm 89:552587b429a1 594 * @brief Disable the RTC ALARMB peripheral.
bogdanm 89:552587b429a1 595 * @param __HANDLE__: specifies the RTC handle.
bogdanm 89:552587b429a1 596 * @retval None
bogdanm 89:552587b429a1 597 */
bogdanm 89:552587b429a1 598 #define __HAL_RTC_ALARMB_DISABLE(__HANDLE__) ((__HANDLE__)->Instance->CR &= ~(RTC_CR_ALRBE))
bogdanm 89:552587b429a1 599
bogdanm 89:552587b429a1 600 /**
bogdanm 89:552587b429a1 601 * @brief Enable the RTC Alarm interrupt.
bogdanm 89:552587b429a1 602 * @param __HANDLE__: specifies the RTC handle.
bogdanm 89:552587b429a1 603 * @param __INTERRUPT__: specifies the RTC Alarm interrupt sources to be enabled or disabled.
bogdanm 89:552587b429a1 604 * This parameter can be any combination of the following values:
bogdanm 89:552587b429a1 605 * @arg RTC_IT_ALRA: Alarm A interrupt
bogdanm 89:552587b429a1 606 * @arg RTC_IT_ALRB: Alarm B interrupt
bogdanm 89:552587b429a1 607 * @retval None
bogdanm 89:552587b429a1 608 */
bogdanm 89:552587b429a1 609 #define __HAL_RTC_ALARM_ENABLE_IT(__HANDLE__, __INTERRUPT__) ((__HANDLE__)->Instance->CR |= (__INTERRUPT__))
bogdanm 89:552587b429a1 610
bogdanm 89:552587b429a1 611 /**
bogdanm 89:552587b429a1 612 * @brief Disable the RTC Alarm interrupt.
bogdanm 89:552587b429a1 613 * @param __HANDLE__: specifies the RTC handle.
bogdanm 89:552587b429a1 614 * @param __INTERRUPT__: specifies the RTC Alarm interrupt sources to be enabled or disabled.
bogdanm 89:552587b429a1 615 * This parameter can be any combination of the following values:
bogdanm 89:552587b429a1 616 * @arg RTC_IT_ALRA: Alarm A interrupt
bogdanm 89:552587b429a1 617 * @arg RTC_IT_ALRB: Alarm B interrupt
bogdanm 89:552587b429a1 618 * @retval None
bogdanm 89:552587b429a1 619 */
bogdanm 89:552587b429a1 620 #define __HAL_RTC_ALARM_DISABLE_IT(__HANDLE__, __INTERRUPT__) ((__HANDLE__)->Instance->CR &= ~(__INTERRUPT__))
bogdanm 89:552587b429a1 621
bogdanm 89:552587b429a1 622 /**
bogdanm 89:552587b429a1 623 * @brief Check whether the specified RTC Alarm interrupt has occurred or not.
bogdanm 89:552587b429a1 624 * @param __HANDLE__: specifies the RTC handle.
bogdanm 89:552587b429a1 625 * @param __FLAG__: specifies the RTC Alarm interrupt sources to be enabled or disabled.
bogdanm 89:552587b429a1 626 * This parameter can be:
bogdanm 89:552587b429a1 627 * @arg RTC_IT_ALRA: Alarm A interrupt
bogdanm 89:552587b429a1 628 * @arg RTC_IT_ALRB: Alarm B interrupt
bogdanm 89:552587b429a1 629 * @retval None
bogdanm 89:552587b429a1 630 */
bogdanm 89:552587b429a1 631 #define __HAL_RTC_ALARM_GET_IT(__HANDLE__, __FLAG__) ((((((__HANDLE__)->Instance->ISR)& ((__FLAG__)>> 4)) & 0x0000FFFF) != RESET)? SET : RESET)
bogdanm 89:552587b429a1 632
bogdanm 89:552587b429a1 633 /**
bogdanm 89:552587b429a1 634 * @brief Get the selected RTC Alarm's flag status.
bogdanm 89:552587b429a1 635 * @param __HANDLE__: specifies the RTC handle.
bogdanm 89:552587b429a1 636 * @param __FLAG__: specifies the RTC Alarm Flag sources to be enabled or disabled.
bogdanm 89:552587b429a1 637 * This parameter can be:
bogdanm 89:552587b429a1 638 * @arg RTC_FLAG_ALRAF
bogdanm 89:552587b429a1 639 * @arg RTC_FLAG_ALRBF
bogdanm 89:552587b429a1 640 * @arg RTC_FLAG_ALRAWF
bogdanm 89:552587b429a1 641 * @arg RTC_FLAG_ALRBWF
bogdanm 89:552587b429a1 642 * @retval None
bogdanm 89:552587b429a1 643 */
bogdanm 89:552587b429a1 644 #define __HAL_RTC_ALARM_GET_FLAG(__HANDLE__, __FLAG__) (((((__HANDLE__)->Instance->ISR) & (__FLAG__)) != RESET)? SET : RESET)
bogdanm 89:552587b429a1 645
bogdanm 89:552587b429a1 646 /**
bogdanm 89:552587b429a1 647 * @brief Clear the RTC Alarm's pending flags.
bogdanm 89:552587b429a1 648 * @param __HANDLE__: specifies the RTC handle.
bogdanm 89:552587b429a1 649 * @param __FLAG__: specifies the RTC Alarm Flag sources to be enabled or disabled.
bogdanm 89:552587b429a1 650 * This parameter can be:
bogdanm 89:552587b429a1 651 * @arg RTC_FLAG_ALRAF
bogdanm 89:552587b429a1 652 * @arg RTC_FLAG_ALRBF
bogdanm 89:552587b429a1 653 * @retval None
bogdanm 89:552587b429a1 654 */
bogdanm 89:552587b429a1 655 #define __HAL_RTC_ALARM_CLEAR_FLAG(__HANDLE__, __FLAG__) ((__HANDLE__)->Instance->ISR) = (~(((__FLAG__) | RTC_ISR_INIT)& 0x0000FFFF)|((__HANDLE__)->Instance->ISR & RTC_ISR_INIT))
bogdanm 89:552587b429a1 656
bogdanm 89:552587b429a1 657
bogdanm 89:552587b429a1 658 #define RTC_EXTI_LINE_ALARM_EVENT ((uint32_t)0x00020000) /*!< External interrupt line 17 Connected to the RTC Alarm event */
bogdanm 89:552587b429a1 659 #define RTC_EXTI_LINE_TAMPER_TIMESTAMP_EVENT ((uint32_t)0x00200000) /*!< External interrupt line 21 Connected to the RTC Tamper and Time Stamp events */
bogdanm 89:552587b429a1 660 #define RTC_EXTI_LINE_WAKEUPTIMER_EVENT ((uint32_t)0x00400000) /*!< External interrupt line 22 Connected to the RTC Wakeup event */
bogdanm 89:552587b429a1 661
bogdanm 89:552587b429a1 662 /**
bogdanm 89:552587b429a1 663 * @brief Enable the RTC Exti line.
bogdanm 89:552587b429a1 664 * @param __EXTILINE__: specifies the RTC Exti sources to be enabled or disabled.
bogdanm 89:552587b429a1 665 * This parameter can be:
bogdanm 92:4fc01daae5a5 666 * @arg RTC_EXTI_LINE_ALARM_EVENT
bogdanm 92:4fc01daae5a5 667 * @arg RTC_EXTI_LINE_TAMPER_TIMESTAMP_EVENT
bogdanm 92:4fc01daae5a5 668 * @arg RTC_EXTI_LINE_WAKEUPTIMER_EVENT
bogdanm 89:552587b429a1 669 * @retval None
bogdanm 92:4fc01daae5a5 670 */
bogdanm 92:4fc01daae5a5 671 #define __HAL_RTC_EXTI_ENABLE_IT(__EXTILINE__) (EXTI->IMR |= (__EXTILINE__))
bogdanm 92:4fc01daae5a5 672
bogdanm 92:4fc01daae5a5 673 /* alias define maintained for legacy */
bogdanm 92:4fc01daae5a5 674 #define __HAL_RTC_ENABLE_IT __HAL_RTC_EXTI_ENABLE_IT
bogdanm 89:552587b429a1 675
bogdanm 89:552587b429a1 676 /**
bogdanm 89:552587b429a1 677 * @brief Disable the RTC Exti line.
bogdanm 89:552587b429a1 678 * @param __EXTILINE__: specifies the RTC Exti sources to be enabled or disabled.
bogdanm 89:552587b429a1 679 * This parameter can be:
bogdanm 92:4fc01daae5a5 680 * @arg RTC_EXTI_LINE_ALARM_EVENT
bogdanm 92:4fc01daae5a5 681 * @arg RTC_EXTI_LINE_TAMPER_TIMESTAMP_EVENT
bogdanm 92:4fc01daae5a5 682 * @arg RTC_EXTI_LINE_WAKEUPTIMER_EVENT
bogdanm 89:552587b429a1 683 * @retval None
bogdanm 89:552587b429a1 684 */
bogdanm 92:4fc01daae5a5 685 #define __HAL_RTC_EXTI_DISABLE_IT(__EXTILINE__) (EXTI->IMR &= ~(__EXTILINE__))
bogdanm 92:4fc01daae5a5 686
bogdanm 92:4fc01daae5a5 687 /* alias define maintained for legacy */
bogdanm 92:4fc01daae5a5 688 #define __HAL_RTC_DISABLE_IT __HAL_RTC_EXTI_DISABLE_IT
bogdanm 92:4fc01daae5a5 689
bogdanm 92:4fc01daae5a5 690 /**
bogdanm 92:4fc01daae5a5 691 * @brief Generates a Software interrupt on selected EXTI line.
bogdanm 92:4fc01daae5a5 692 * @param __EXTILINE__: specifies the RTC Exti sources to be enabled or disabled.
bogdanm 92:4fc01daae5a5 693 * This parameter can be:
bogdanm 92:4fc01daae5a5 694 * @arg RTC_EXTI_LINE_ALARM_EVENT
bogdanm 92:4fc01daae5a5 695 * @arg RTC_EXTI_LINE_TAMPER_TIMESTAMP_EVENT
bogdanm 92:4fc01daae5a5 696 * @arg RTC_EXTI_LINE_WAKEUPTIMER_EVENT
bogdanm 92:4fc01daae5a5 697 * @retval None
bogdanm 92:4fc01daae5a5 698 */
bogdanm 92:4fc01daae5a5 699 #define __HAL_RTC_EXTI_GENERATE_SWIT(__EXTI_LINE__) (EXTI->SWIER |= (__EXTI_LINE__))
bogdanm 89:552587b429a1 700
bogdanm 89:552587b429a1 701 /**
bogdanm 89:552587b429a1 702 * @brief Clear the RTC Exti flags.
bogdanm 89:552587b429a1 703 * @param __FLAG__: specifies the RTC Exti sources to be enabled or disabled.
bogdanm 89:552587b429a1 704 * This parameter can be:
bogdanm 92:4fc01daae5a5 705 * @arg RTC_EXTI_LINE_ALARM_EVENT
bogdanm 92:4fc01daae5a5 706 * @arg RTC_EXTI_LINE_TAMPER_TIMESTAMP_EVENT
bogdanm 92:4fc01daae5a5 707 * @arg RTC_EXTI_LINE_WAKEUPTIMER_EVENT
bogdanm 89:552587b429a1 708 * @retval None
bogdanm 89:552587b429a1 709 */
bogdanm 92:4fc01daae5a5 710 #define __HAL_RTC_EXTI_CLEAR_FLAG(__FLAG__) (EXTI->PR = (__FLAG__))
bogdanm 92:4fc01daae5a5 711
bogdanm 92:4fc01daae5a5 712 /* alias define maintained for legacy */
bogdanm 92:4fc01daae5a5 713 #define __HAL_RTC_CLEAR_FLAG __HAL_RTC_EXTI_CLEAR_FLAG
bogdanm 92:4fc01daae5a5 714
bogdanm 89:552587b429a1 715
bogdanm 89:552587b429a1 716 /* Include RTC HAL Extension module */
bogdanm 89:552587b429a1 717 #include "stm32f4xx_hal_rtc_ex.h"
bogdanm 89:552587b429a1 718
bogdanm 89:552587b429a1 719 /* Exported functions --------------------------------------------------------*/
bogdanm 89:552587b429a1 720
bogdanm 89:552587b429a1 721 /* Initialization and de-initialization functions ****************************/
bogdanm 89:552587b429a1 722 HAL_StatusTypeDef HAL_RTC_Init(RTC_HandleTypeDef *hrtc);
bogdanm 89:552587b429a1 723 HAL_StatusTypeDef HAL_RTC_DeInit(RTC_HandleTypeDef *hrtc);
bogdanm 89:552587b429a1 724 void HAL_RTC_MspInit(RTC_HandleTypeDef *hrtc);
bogdanm 89:552587b429a1 725 void HAL_RTC_MspDeInit(RTC_HandleTypeDef *hrtc);
bogdanm 89:552587b429a1 726
bogdanm 89:552587b429a1 727 /* RTC Time and Date functions ************************************************/
bogdanm 89:552587b429a1 728 HAL_StatusTypeDef HAL_RTC_SetTime(RTC_HandleTypeDef *hrtc, RTC_TimeTypeDef *sTime, uint32_t Format);
bogdanm 89:552587b429a1 729 HAL_StatusTypeDef HAL_RTC_GetTime(RTC_HandleTypeDef *hrtc, RTC_TimeTypeDef *sTime, uint32_t Format);
bogdanm 89:552587b429a1 730 HAL_StatusTypeDef HAL_RTC_SetDate(RTC_HandleTypeDef *hrtc, RTC_DateTypeDef *sDate, uint32_t Format);
bogdanm 89:552587b429a1 731 HAL_StatusTypeDef HAL_RTC_GetDate(RTC_HandleTypeDef *hrtc, RTC_DateTypeDef *sDate, uint32_t Format);
bogdanm 89:552587b429a1 732
bogdanm 89:552587b429a1 733 /* RTC Alarm functions ********************************************************/
bogdanm 89:552587b429a1 734 HAL_StatusTypeDef HAL_RTC_SetAlarm(RTC_HandleTypeDef *hrtc, RTC_AlarmTypeDef *sAlarm, uint32_t Format);
bogdanm 89:552587b429a1 735 HAL_StatusTypeDef HAL_RTC_SetAlarm_IT(RTC_HandleTypeDef *hrtc, RTC_AlarmTypeDef *sAlarm, uint32_t Format);
bogdanm 89:552587b429a1 736 HAL_StatusTypeDef HAL_RTC_DeactivateAlarm(RTC_HandleTypeDef *hrtc, uint32_t Alarm);
bogdanm 89:552587b429a1 737 HAL_StatusTypeDef HAL_RTC_GetAlarm(RTC_HandleTypeDef *hrtc, RTC_AlarmTypeDef *sAlarm, uint32_t Alarm, uint32_t Format);
bogdanm 89:552587b429a1 738 void HAL_RTC_AlarmIRQHandler(RTC_HandleTypeDef *hrtc);
bogdanm 89:552587b429a1 739 HAL_StatusTypeDef HAL_RTC_PollForAlarmAEvent(RTC_HandleTypeDef *hrtc, uint32_t Timeout);
bogdanm 89:552587b429a1 740 void HAL_RTC_AlarmAEventCallback(RTC_HandleTypeDef *hrtc);
bogdanm 89:552587b429a1 741
bogdanm 89:552587b429a1 742 /* Peripheral Control functions ***********************************************/
bogdanm 89:552587b429a1 743 HAL_StatusTypeDef HAL_RTC_WaitForSynchro(RTC_HandleTypeDef* hrtc);
bogdanm 89:552587b429a1 744
bogdanm 89:552587b429a1 745 /* Peripheral State functions *************************************************/
bogdanm 89:552587b429a1 746 HAL_RTCStateTypeDef HAL_RTC_GetState(RTC_HandleTypeDef *hrtc);
bogdanm 89:552587b429a1 747
bogdanm 89:552587b429a1 748 HAL_StatusTypeDef RTC_EnterInitMode(RTC_HandleTypeDef* hrtc);
bogdanm 89:552587b429a1 749 uint8_t RTC_ByteToBcd2(uint8_t Value);
bogdanm 89:552587b429a1 750 uint8_t RTC_Bcd2ToByte(uint8_t Value);
bogdanm 89:552587b429a1 751
bogdanm 89:552587b429a1 752 /**
bogdanm 89:552587b429a1 753 * @}
bogdanm 89:552587b429a1 754 */
bogdanm 89:552587b429a1 755
bogdanm 89:552587b429a1 756 /**
bogdanm 89:552587b429a1 757 * @}
bogdanm 89:552587b429a1 758 */
bogdanm 89:552587b429a1 759
bogdanm 89:552587b429a1 760 #ifdef __cplusplus
bogdanm 89:552587b429a1 761 }
bogdanm 89:552587b429a1 762 #endif
bogdanm 89:552587b429a1 763
bogdanm 89:552587b429a1 764 #endif /* __STM32F4xx_HAL_RTC_H */
bogdanm 89:552587b429a1 765
bogdanm 89:552587b429a1 766 /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/