mbed library sources. Supersedes mbed-src.

Dependents:   Nucleo_Hello_Encoder BLE_iBeaconScan AM1805_DEMO DISCO-F429ZI_ExportTemplate1 ... more

Committer:
AnnaBridge
Date:
Wed Feb 20 22:31:08 2019 +0000
Revision:
189:f392fc9709a3
mbed library release version 165

Who changed what in which revision?

UserRevisionLine numberNew contents of line
AnnaBridge 189:f392fc9709a3 1 /**
AnnaBridge 189:f392fc9709a3 2 ******************************************************************************
AnnaBridge 189:f392fc9709a3 3 * @file stm32l0xx_hal_rtc.h
AnnaBridge 189:f392fc9709a3 4 * @author MCD Application Team
AnnaBridge 189:f392fc9709a3 5 * @brief Header file of RTC HAL module.
AnnaBridge 189:f392fc9709a3 6 ******************************************************************************
AnnaBridge 189:f392fc9709a3 7 * @attention
AnnaBridge 189:f392fc9709a3 8 *
AnnaBridge 189:f392fc9709a3 9 * <h2><center>&copy; COPYRIGHT(c) 2016 STMicroelectronics</center></h2>
AnnaBridge 189:f392fc9709a3 10 *
AnnaBridge 189:f392fc9709a3 11 * Redistribution and use in source and binary forms, with or without modification,
AnnaBridge 189:f392fc9709a3 12 * are permitted provided that the following conditions are met:
AnnaBridge 189:f392fc9709a3 13 * 1. Redistributions of source code must retain the above copyright notice,
AnnaBridge 189:f392fc9709a3 14 * this list of conditions and the following disclaimer.
AnnaBridge 189:f392fc9709a3 15 * 2. Redistributions in binary form must reproduce the above copyright notice,
AnnaBridge 189:f392fc9709a3 16 * this list of conditions and the following disclaimer in the documentation
AnnaBridge 189:f392fc9709a3 17 * and/or other materials provided with the distribution.
AnnaBridge 189:f392fc9709a3 18 * 3. Neither the name of STMicroelectronics nor the names of its contributors
AnnaBridge 189:f392fc9709a3 19 * may be used to endorse or promote products derived from this software
AnnaBridge 189:f392fc9709a3 20 * without specific prior written permission.
AnnaBridge 189:f392fc9709a3 21 *
AnnaBridge 189:f392fc9709a3 22 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
AnnaBridge 189:f392fc9709a3 23 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
AnnaBridge 189:f392fc9709a3 24 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
AnnaBridge 189:f392fc9709a3 25 * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
AnnaBridge 189:f392fc9709a3 26 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
AnnaBridge 189:f392fc9709a3 27 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
AnnaBridge 189:f392fc9709a3 28 * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
AnnaBridge 189:f392fc9709a3 29 * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
AnnaBridge 189:f392fc9709a3 30 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
AnnaBridge 189:f392fc9709a3 31 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
AnnaBridge 189:f392fc9709a3 32 *
AnnaBridge 189:f392fc9709a3 33 ******************************************************************************
AnnaBridge 189:f392fc9709a3 34 */
AnnaBridge 189:f392fc9709a3 35
AnnaBridge 189:f392fc9709a3 36 /* Define to prevent recursive inclusion -------------------------------------*/
AnnaBridge 189:f392fc9709a3 37 #ifndef __STM32L0xx_HAL_RTC_H
AnnaBridge 189:f392fc9709a3 38 #define __STM32L0xx_HAL_RTC_H
AnnaBridge 189:f392fc9709a3 39
AnnaBridge 189:f392fc9709a3 40 #ifdef __cplusplus
AnnaBridge 189:f392fc9709a3 41 extern "C" {
AnnaBridge 189:f392fc9709a3 42 #endif
AnnaBridge 189:f392fc9709a3 43
AnnaBridge 189:f392fc9709a3 44 /* Includes ------------------------------------------------------------------*/
AnnaBridge 189:f392fc9709a3 45 #include "stm32l0xx_hal_def.h"
AnnaBridge 189:f392fc9709a3 46 #include "stm32l0xx_ll_rtc.h"
AnnaBridge 189:f392fc9709a3 47
AnnaBridge 189:f392fc9709a3 48 /** @addtogroup STM32L0xx_HAL_Driver
AnnaBridge 189:f392fc9709a3 49 * @{
AnnaBridge 189:f392fc9709a3 50 */
AnnaBridge 189:f392fc9709a3 51
AnnaBridge 189:f392fc9709a3 52 /** @defgroup RTC RTC
AnnaBridge 189:f392fc9709a3 53 * @{
AnnaBridge 189:f392fc9709a3 54 */
AnnaBridge 189:f392fc9709a3 55
AnnaBridge 189:f392fc9709a3 56 /* Exported types ------------------------------------------------------------*/
AnnaBridge 189:f392fc9709a3 57 /** @defgroup RTC_Exported_Types RTC Exported Types
AnnaBridge 189:f392fc9709a3 58 * @{
AnnaBridge 189:f392fc9709a3 59 */
AnnaBridge 189:f392fc9709a3 60
AnnaBridge 189:f392fc9709a3 61 /**
AnnaBridge 189:f392fc9709a3 62 * @brief HAL State structures definition
AnnaBridge 189:f392fc9709a3 63 */
AnnaBridge 189:f392fc9709a3 64 typedef enum
AnnaBridge 189:f392fc9709a3 65 {
AnnaBridge 189:f392fc9709a3 66 HAL_RTC_STATE_RESET = 0x00U, /*!< RTC not yet initialized or disabled */
AnnaBridge 189:f392fc9709a3 67 HAL_RTC_STATE_READY = 0x01U, /*!< RTC initialized and ready for use */
AnnaBridge 189:f392fc9709a3 68 HAL_RTC_STATE_BUSY = 0x02U, /*!< RTC process is ongoing */
AnnaBridge 189:f392fc9709a3 69 HAL_RTC_STATE_TIMEOUT = 0x03U, /*!< RTC timeout state */
AnnaBridge 189:f392fc9709a3 70 HAL_RTC_STATE_ERROR = 0x04U /*!< RTC error state */
AnnaBridge 189:f392fc9709a3 71
AnnaBridge 189:f392fc9709a3 72 }HAL_RTCStateTypeDef;
AnnaBridge 189:f392fc9709a3 73
AnnaBridge 189:f392fc9709a3 74 /**
AnnaBridge 189:f392fc9709a3 75 * @brief RTC Configuration Structure definition
AnnaBridge 189:f392fc9709a3 76 */
AnnaBridge 189:f392fc9709a3 77 typedef struct
AnnaBridge 189:f392fc9709a3 78 {
AnnaBridge 189:f392fc9709a3 79 uint32_t HourFormat; /*!< Specifies the RTC Hour Format.
AnnaBridge 189:f392fc9709a3 80 This parameter can be a value of @ref RTC_Hour_Formats */
AnnaBridge 189:f392fc9709a3 81
AnnaBridge 189:f392fc9709a3 82 uint32_t AsynchPrediv; /*!< Specifies the RTC Asynchronous Predivider value.
AnnaBridge 189:f392fc9709a3 83 This parameter must be a number between Min_Data = 0x00 and Max_Data = 0x7F */
AnnaBridge 189:f392fc9709a3 84
AnnaBridge 189:f392fc9709a3 85 uint32_t SynchPrediv; /*!< Specifies the RTC Synchronous Predivider value.
AnnaBridge 189:f392fc9709a3 86 This parameter must be a number between Min_Data = 0x00 and Max_Data = 0x7FFF */
AnnaBridge 189:f392fc9709a3 87
AnnaBridge 189:f392fc9709a3 88 uint32_t OutPut; /*!< Specifies which signal will be routed to the RTC output.
AnnaBridge 189:f392fc9709a3 89 This parameter can be a value of @ref RTCEx_Output_selection_Definitions */
AnnaBridge 189:f392fc9709a3 90
AnnaBridge 189:f392fc9709a3 91 uint32_t OutPutRemap; /*!< Specifies the remap for RTC output.
AnnaBridge 189:f392fc9709a3 92 This parameter can be a value of @ref RTC_Output_ALARM_OUT_Remap */
AnnaBridge 189:f392fc9709a3 93
AnnaBridge 189:f392fc9709a3 94 uint32_t OutPutPolarity; /*!< Specifies the polarity of the output signal.
AnnaBridge 189:f392fc9709a3 95 This parameter can be a value of @ref RTC_Output_Polarity_Definitions */
AnnaBridge 189:f392fc9709a3 96
AnnaBridge 189:f392fc9709a3 97 uint32_t OutPutType; /*!< Specifies the RTC Output Pin mode.
AnnaBridge 189:f392fc9709a3 98 This parameter can be a value of @ref RTC_Output_Type_ALARM_OUT */
AnnaBridge 189:f392fc9709a3 99 }RTC_InitTypeDef;
AnnaBridge 189:f392fc9709a3 100
AnnaBridge 189:f392fc9709a3 101 /**
AnnaBridge 189:f392fc9709a3 102 * @brief RTC Time structure definition
AnnaBridge 189:f392fc9709a3 103 */
AnnaBridge 189:f392fc9709a3 104 typedef struct
AnnaBridge 189:f392fc9709a3 105 {
AnnaBridge 189:f392fc9709a3 106 uint8_t Hours; /*!< Specifies the RTC Time Hour.
AnnaBridge 189:f392fc9709a3 107 This parameter must be a number between Min_Data = 0 and Max_Data = 12 if the RTC_HourFormat_12 is selected.
AnnaBridge 189:f392fc9709a3 108 This parameter must be a number between Min_Data = 0 and Max_Data = 23 if the RTC_HourFormat_24 is selected */
AnnaBridge 189:f392fc9709a3 109
AnnaBridge 189:f392fc9709a3 110 uint8_t Minutes; /*!< Specifies the RTC Time Minutes.
AnnaBridge 189:f392fc9709a3 111 This parameter must be a number between Min_Data = 0 and Max_Data = 59 */
AnnaBridge 189:f392fc9709a3 112
AnnaBridge 189:f392fc9709a3 113 uint8_t Seconds; /*!< Specifies the RTC Time Seconds.
AnnaBridge 189:f392fc9709a3 114 This parameter must be a number between Min_Data = 0 and Max_Data = 59 */
AnnaBridge 189:f392fc9709a3 115
AnnaBridge 189:f392fc9709a3 116 uint8_t TimeFormat; /*!< Specifies the RTC AM/PM Time.
AnnaBridge 189:f392fc9709a3 117 This parameter can be a value of @ref RTC_AM_PM_Definitions */
AnnaBridge 189:f392fc9709a3 118
AnnaBridge 189:f392fc9709a3 119 uint32_t SubSeconds; /*!< Specifies the RTC_SSR RTC Sub Second register content.
AnnaBridge 189:f392fc9709a3 120 This parameter corresponds to a time unit range between [0-1] Second
AnnaBridge 189:f392fc9709a3 121 with [1 Sec / SecondFraction +1] granularity */
AnnaBridge 189:f392fc9709a3 122
AnnaBridge 189:f392fc9709a3 123 uint32_t SecondFraction; /*!< Specifies the range or granularity of Sub Second register content
AnnaBridge 189:f392fc9709a3 124 corresponding to Synchronous pre-scaler factor value (PREDIV_S)
AnnaBridge 189:f392fc9709a3 125 This parameter corresponds to a time unit range between [0-1] Second
AnnaBridge 189:f392fc9709a3 126 with [1 Sec / SecondFraction +1] granularity.
AnnaBridge 189:f392fc9709a3 127 This field will be used only by HAL_RTC_GetTime function */
AnnaBridge 189:f392fc9709a3 128
AnnaBridge 189:f392fc9709a3 129 uint32_t DayLightSaving; /*!< Specifies RTC_DayLightSaveOperation: the value of hour adjustment.
AnnaBridge 189:f392fc9709a3 130 This parameter can be a value of @ref RTC_DayLightSaving_Definitions */
AnnaBridge 189:f392fc9709a3 131
AnnaBridge 189:f392fc9709a3 132 uint32_t StoreOperation; /*!< Specifies RTC_StoreOperation value to be written in the BCK bit
AnnaBridge 189:f392fc9709a3 133 in CR register to store the operation.
AnnaBridge 189:f392fc9709a3 134 This parameter can be a value of @ref RTC_StoreOperation_Definitions */
AnnaBridge 189:f392fc9709a3 135 }RTC_TimeTypeDef;
AnnaBridge 189:f392fc9709a3 136
AnnaBridge 189:f392fc9709a3 137 /**
AnnaBridge 189:f392fc9709a3 138 * @brief RTC Date structure definition
AnnaBridge 189:f392fc9709a3 139 */
AnnaBridge 189:f392fc9709a3 140 typedef struct
AnnaBridge 189:f392fc9709a3 141 {
AnnaBridge 189:f392fc9709a3 142 uint8_t WeekDay; /*!< Specifies the RTC Date WeekDay.
AnnaBridge 189:f392fc9709a3 143 This parameter can be a value of @ref RTC_WeekDay_Definitions */
AnnaBridge 189:f392fc9709a3 144
AnnaBridge 189:f392fc9709a3 145 uint8_t Month; /*!< Specifies the RTC Date Month (in BCD format).
AnnaBridge 189:f392fc9709a3 146 This parameter can be a value of @ref RTC_Month_Date_Definitions */
AnnaBridge 189:f392fc9709a3 147
AnnaBridge 189:f392fc9709a3 148 uint8_t Date; /*!< Specifies the RTC Date.
AnnaBridge 189:f392fc9709a3 149 This parameter must be a number between Min_Data = 1 and Max_Data = 31 */
AnnaBridge 189:f392fc9709a3 150
AnnaBridge 189:f392fc9709a3 151 uint8_t Year; /*!< Specifies the RTC Date Year.
AnnaBridge 189:f392fc9709a3 152 This parameter must be a number between Min_Data = 0 and Max_Data = 99 */
AnnaBridge 189:f392fc9709a3 153
AnnaBridge 189:f392fc9709a3 154 }RTC_DateTypeDef;
AnnaBridge 189:f392fc9709a3 155
AnnaBridge 189:f392fc9709a3 156 /**
AnnaBridge 189:f392fc9709a3 157 * @brief RTC Alarm structure definition
AnnaBridge 189:f392fc9709a3 158 */
AnnaBridge 189:f392fc9709a3 159 typedef struct
AnnaBridge 189:f392fc9709a3 160 {
AnnaBridge 189:f392fc9709a3 161 RTC_TimeTypeDef AlarmTime; /*!< Specifies the RTC Alarm Time members */
AnnaBridge 189:f392fc9709a3 162
AnnaBridge 189:f392fc9709a3 163 uint32_t AlarmMask; /*!< Specifies the RTC Alarm Masks.
AnnaBridge 189:f392fc9709a3 164 This parameter can be a value of @ref RTC_AlarmMask_Definitions */
AnnaBridge 189:f392fc9709a3 165
AnnaBridge 189:f392fc9709a3 166 uint32_t AlarmSubSecondMask; /*!< Specifies the RTC Alarm SubSeconds Masks.
AnnaBridge 189:f392fc9709a3 167 This parameter can be a value of @ref RTC_Alarm_Sub_Seconds_Masks_Definitions */
AnnaBridge 189:f392fc9709a3 168
AnnaBridge 189:f392fc9709a3 169 uint32_t AlarmDateWeekDaySel; /*!< Specifies the RTC Alarm is on Date or WeekDay.
AnnaBridge 189:f392fc9709a3 170 This parameter can be a value of @ref RTC_AlarmDateWeekDay_Definitions */
AnnaBridge 189:f392fc9709a3 171
AnnaBridge 189:f392fc9709a3 172 uint8_t AlarmDateWeekDay; /*!< Specifies the RTC Alarm Date/WeekDay.
AnnaBridge 189:f392fc9709a3 173 If the Alarm Date is selected, this parameter must be set to a value in the 1-31 range.
AnnaBridge 189:f392fc9709a3 174 If the Alarm WeekDay is selected, this parameter can be a value of @ref RTC_WeekDay_Definitions */
AnnaBridge 189:f392fc9709a3 175
AnnaBridge 189:f392fc9709a3 176 uint32_t Alarm; /*!< Specifies the alarm .
AnnaBridge 189:f392fc9709a3 177 This parameter can be a value of @ref RTC_Alarms_Definitions */
AnnaBridge 189:f392fc9709a3 178 }RTC_AlarmTypeDef;
AnnaBridge 189:f392fc9709a3 179
AnnaBridge 189:f392fc9709a3 180 /**
AnnaBridge 189:f392fc9709a3 181 * @brief RTC Handle Structure definition
AnnaBridge 189:f392fc9709a3 182 */
AnnaBridge 189:f392fc9709a3 183 typedef struct
AnnaBridge 189:f392fc9709a3 184 {
AnnaBridge 189:f392fc9709a3 185 RTC_TypeDef *Instance; /*!< Register base address */
AnnaBridge 189:f392fc9709a3 186
AnnaBridge 189:f392fc9709a3 187 RTC_InitTypeDef Init; /*!< RTC required parameters */
AnnaBridge 189:f392fc9709a3 188
AnnaBridge 189:f392fc9709a3 189 HAL_LockTypeDef Lock; /*!< RTC locking object */
AnnaBridge 189:f392fc9709a3 190
AnnaBridge 189:f392fc9709a3 191 __IO HAL_RTCStateTypeDef State; /*!< Time communication state */
AnnaBridge 189:f392fc9709a3 192
AnnaBridge 189:f392fc9709a3 193 }RTC_HandleTypeDef;
AnnaBridge 189:f392fc9709a3 194 /**
AnnaBridge 189:f392fc9709a3 195 * @}
AnnaBridge 189:f392fc9709a3 196 */
AnnaBridge 189:f392fc9709a3 197
AnnaBridge 189:f392fc9709a3 198 /* Exported constants --------------------------------------------------------*/
AnnaBridge 189:f392fc9709a3 199 /** @defgroup RTC_Exported_Constants RTC Exported Constants
AnnaBridge 189:f392fc9709a3 200 * @{
AnnaBridge 189:f392fc9709a3 201 */
AnnaBridge 189:f392fc9709a3 202
AnnaBridge 189:f392fc9709a3 203 /** @defgroup RTC_Hour_Formats RTC Hour Formats
AnnaBridge 189:f392fc9709a3 204 * @{
AnnaBridge 189:f392fc9709a3 205 */
AnnaBridge 189:f392fc9709a3 206 #define RTC_HOURFORMAT_24 ((uint32_t)0x00000000U)
AnnaBridge 189:f392fc9709a3 207 #define RTC_HOURFORMAT_12 ((uint32_t)RTC_CR_FMT)
AnnaBridge 189:f392fc9709a3 208
AnnaBridge 189:f392fc9709a3 209 /**
AnnaBridge 189:f392fc9709a3 210 * @}
AnnaBridge 189:f392fc9709a3 211 */
AnnaBridge 189:f392fc9709a3 212
AnnaBridge 189:f392fc9709a3 213
AnnaBridge 189:f392fc9709a3 214 /** @defgroup RTC_Output_Polarity_Definitions RTC Output Polarity Definitions
AnnaBridge 189:f392fc9709a3 215 * @{
AnnaBridge 189:f392fc9709a3 216 */
AnnaBridge 189:f392fc9709a3 217 #define RTC_OUTPUT_POLARITY_HIGH ((uint32_t)0x00000000U)
AnnaBridge 189:f392fc9709a3 218 #define RTC_OUTPUT_POLARITY_LOW ((uint32_t)RTC_CR_POL)
AnnaBridge 189:f392fc9709a3 219
AnnaBridge 189:f392fc9709a3 220 /**
AnnaBridge 189:f392fc9709a3 221 * @}
AnnaBridge 189:f392fc9709a3 222 */
AnnaBridge 189:f392fc9709a3 223
AnnaBridge 189:f392fc9709a3 224 /** @defgroup RTC_Output_Type_ALARM_OUT RTC Output Type ALARM OUT
AnnaBridge 189:f392fc9709a3 225 * @{
AnnaBridge 189:f392fc9709a3 226 */
AnnaBridge 189:f392fc9709a3 227 #define RTC_OUTPUT_TYPE_OPENDRAIN ((uint32_t)0x00000000U)
AnnaBridge 189:f392fc9709a3 228 #define RTC_OUTPUT_TYPE_PUSHPULL ((uint32_t)RTC_OR_ALARMOUTTYPE)
AnnaBridge 189:f392fc9709a3 229
AnnaBridge 189:f392fc9709a3 230 /**
AnnaBridge 189:f392fc9709a3 231 * @}
AnnaBridge 189:f392fc9709a3 232 */
AnnaBridge 189:f392fc9709a3 233
AnnaBridge 189:f392fc9709a3 234 /** @defgroup RTC_Output_ALARM_OUT_Remap RTC Output ALARM OUT Remap
AnnaBridge 189:f392fc9709a3 235 * @{
AnnaBridge 189:f392fc9709a3 236 */
AnnaBridge 189:f392fc9709a3 237 #define RTC_OUTPUT_REMAP_NONE ((uint32_t)0x00000000U)
AnnaBridge 189:f392fc9709a3 238 #define RTC_OUTPUT_REMAP_POS1 ((uint32_t)RTC_OR_OUT_RMP)
AnnaBridge 189:f392fc9709a3 239 /**
AnnaBridge 189:f392fc9709a3 240 * @}
AnnaBridge 189:f392fc9709a3 241 */
AnnaBridge 189:f392fc9709a3 242
AnnaBridge 189:f392fc9709a3 243 /** @defgroup RTC_AM_PM_Definitions RTC AM PM Definitions
AnnaBridge 189:f392fc9709a3 244 * @{
AnnaBridge 189:f392fc9709a3 245 */
AnnaBridge 189:f392fc9709a3 246 #define RTC_HOURFORMAT12_AM ((uint8_t)0x00U)
AnnaBridge 189:f392fc9709a3 247 #define RTC_HOURFORMAT12_PM ((uint8_t)0x40U)
AnnaBridge 189:f392fc9709a3 248
AnnaBridge 189:f392fc9709a3 249 /**
AnnaBridge 189:f392fc9709a3 250 * @}
AnnaBridge 189:f392fc9709a3 251 */
AnnaBridge 189:f392fc9709a3 252
AnnaBridge 189:f392fc9709a3 253 /** @defgroup RTC_DayLightSaving_Definitions RTC DayLightSaving Definitions
AnnaBridge 189:f392fc9709a3 254 * @{
AnnaBridge 189:f392fc9709a3 255 */
AnnaBridge 189:f392fc9709a3 256 #define RTC_DAYLIGHTSAVING_SUB1H ((uint32_t)RTC_CR_SUB1H)
AnnaBridge 189:f392fc9709a3 257 #define RTC_DAYLIGHTSAVING_ADD1H ((uint32_t)RTC_CR_ADD1H)
AnnaBridge 189:f392fc9709a3 258 #define RTC_DAYLIGHTSAVING_NONE ((uint32_t)0x00000000U)
AnnaBridge 189:f392fc9709a3 259
AnnaBridge 189:f392fc9709a3 260 /**
AnnaBridge 189:f392fc9709a3 261 * @}
AnnaBridge 189:f392fc9709a3 262 */
AnnaBridge 189:f392fc9709a3 263
AnnaBridge 189:f392fc9709a3 264 /** @defgroup RTC_StoreOperation_Definitions RTC StoreOperation Definitions
AnnaBridge 189:f392fc9709a3 265 * @{
AnnaBridge 189:f392fc9709a3 266 */
AnnaBridge 189:f392fc9709a3 267 #define RTC_STOREOPERATION_RESET ((uint32_t)0x00000000U)
AnnaBridge 189:f392fc9709a3 268 #define RTC_STOREOPERATION_SET ((uint32_t)RTC_CR_BCK)
AnnaBridge 189:f392fc9709a3 269
AnnaBridge 189:f392fc9709a3 270 /**
AnnaBridge 189:f392fc9709a3 271 * @}
AnnaBridge 189:f392fc9709a3 272 */
AnnaBridge 189:f392fc9709a3 273
AnnaBridge 189:f392fc9709a3 274 /** @defgroup RTC_Input_parameter_format_definitions RTC Input Parameter Format Definitions
AnnaBridge 189:f392fc9709a3 275 * @{
AnnaBridge 189:f392fc9709a3 276 */
AnnaBridge 189:f392fc9709a3 277 #define RTC_FORMAT_BIN ((uint32_t)0x000000000U)
AnnaBridge 189:f392fc9709a3 278 #define RTC_FORMAT_BCD ((uint32_t)0x000000001U)
AnnaBridge 189:f392fc9709a3 279
AnnaBridge 189:f392fc9709a3 280 /**
AnnaBridge 189:f392fc9709a3 281 * @}
AnnaBridge 189:f392fc9709a3 282 */
AnnaBridge 189:f392fc9709a3 283
AnnaBridge 189:f392fc9709a3 284 /** @defgroup RTC_Month_Date_Definitions RTC Month Date Definitions
AnnaBridge 189:f392fc9709a3 285 * @{
AnnaBridge 189:f392fc9709a3 286 */
AnnaBridge 189:f392fc9709a3 287
AnnaBridge 189:f392fc9709a3 288 /* Coded in BCD format */
AnnaBridge 189:f392fc9709a3 289 #define RTC_MONTH_JANUARY ((uint8_t)0x01U)
AnnaBridge 189:f392fc9709a3 290 #define RTC_MONTH_FEBRUARY ((uint8_t)0x02U)
AnnaBridge 189:f392fc9709a3 291 #define RTC_MONTH_MARCH ((uint8_t)0x03U)
AnnaBridge 189:f392fc9709a3 292 #define RTC_MONTH_APRIL ((uint8_t)0x04U)
AnnaBridge 189:f392fc9709a3 293 #define RTC_MONTH_MAY ((uint8_t)0x05U)
AnnaBridge 189:f392fc9709a3 294 #define RTC_MONTH_JUNE ((uint8_t)0x06U)
AnnaBridge 189:f392fc9709a3 295 #define RTC_MONTH_JULY ((uint8_t)0x07U)
AnnaBridge 189:f392fc9709a3 296 #define RTC_MONTH_AUGUST ((uint8_t)0x08U)
AnnaBridge 189:f392fc9709a3 297 #define RTC_MONTH_SEPTEMBER ((uint8_t)0x09U)
AnnaBridge 189:f392fc9709a3 298 #define RTC_MONTH_OCTOBER ((uint8_t)0x10U)
AnnaBridge 189:f392fc9709a3 299 #define RTC_MONTH_NOVEMBER ((uint8_t)0x11U)
AnnaBridge 189:f392fc9709a3 300 #define RTC_MONTH_DECEMBER ((uint8_t)0x12U)
AnnaBridge 189:f392fc9709a3 301
AnnaBridge 189:f392fc9709a3 302 /**
AnnaBridge 189:f392fc9709a3 303 * @}
AnnaBridge 189:f392fc9709a3 304 */
AnnaBridge 189:f392fc9709a3 305
AnnaBridge 189:f392fc9709a3 306 /** @defgroup RTC_WeekDay_Definitions RTC WeekDay Definitions
AnnaBridge 189:f392fc9709a3 307 * @{
AnnaBridge 189:f392fc9709a3 308 */
AnnaBridge 189:f392fc9709a3 309 #define RTC_WEEKDAY_MONDAY ((uint8_t)0x01U)
AnnaBridge 189:f392fc9709a3 310 #define RTC_WEEKDAY_TUESDAY ((uint8_t)0x02U)
AnnaBridge 189:f392fc9709a3 311 #define RTC_WEEKDAY_WEDNESDAY ((uint8_t)0x03U)
AnnaBridge 189:f392fc9709a3 312 #define RTC_WEEKDAY_THURSDAY ((uint8_t)0x04U)
AnnaBridge 189:f392fc9709a3 313 #define RTC_WEEKDAY_FRIDAY ((uint8_t)0x05U)
AnnaBridge 189:f392fc9709a3 314 #define RTC_WEEKDAY_SATURDAY ((uint8_t)0x06U)
AnnaBridge 189:f392fc9709a3 315 #define RTC_WEEKDAY_SUNDAY ((uint8_t)0x07U)
AnnaBridge 189:f392fc9709a3 316
AnnaBridge 189:f392fc9709a3 317 /**
AnnaBridge 189:f392fc9709a3 318 * @}
AnnaBridge 189:f392fc9709a3 319 */
AnnaBridge 189:f392fc9709a3 320
AnnaBridge 189:f392fc9709a3 321 /** @defgroup RTC_AlarmDateWeekDay_Definitions RTC AlarmDateWeekDay Definitions
AnnaBridge 189:f392fc9709a3 322 * @{
AnnaBridge 189:f392fc9709a3 323 */
AnnaBridge 189:f392fc9709a3 324 #define RTC_ALARMDATEWEEKDAYSEL_DATE ((uint32_t)0x00000000U)
AnnaBridge 189:f392fc9709a3 325 #define RTC_ALARMDATEWEEKDAYSEL_WEEKDAY RTC_ALRMAR_WDSEL
AnnaBridge 189:f392fc9709a3 326
AnnaBridge 189:f392fc9709a3 327 /**
AnnaBridge 189:f392fc9709a3 328 * @}
AnnaBridge 189:f392fc9709a3 329 */
AnnaBridge 189:f392fc9709a3 330
AnnaBridge 189:f392fc9709a3 331 /** @defgroup RTC_AlarmMask_Definitions RTC AlarmMask Definitions
AnnaBridge 189:f392fc9709a3 332 * @{
AnnaBridge 189:f392fc9709a3 333 */
AnnaBridge 189:f392fc9709a3 334 #define RTC_ALARMMASK_NONE ((uint32_t)0x00000000U)
AnnaBridge 189:f392fc9709a3 335 #define RTC_ALARMMASK_DATEWEEKDAY RTC_ALRMAR_MSK4
AnnaBridge 189:f392fc9709a3 336 #define RTC_ALARMMASK_HOURS RTC_ALRMAR_MSK3
AnnaBridge 189:f392fc9709a3 337 #define RTC_ALARMMASK_MINUTES RTC_ALRMAR_MSK2
AnnaBridge 189:f392fc9709a3 338 #define RTC_ALARMMASK_SECONDS RTC_ALRMAR_MSK1
AnnaBridge 189:f392fc9709a3 339 #define RTC_ALARMMASK_ALL ((uint32_t) (RTC_ALARMMASK_NONE | \
AnnaBridge 189:f392fc9709a3 340 RTC_ALARMMASK_DATEWEEKDAY | \
AnnaBridge 189:f392fc9709a3 341 RTC_ALARMMASK_HOURS | \
AnnaBridge 189:f392fc9709a3 342 RTC_ALARMMASK_MINUTES | \
AnnaBridge 189:f392fc9709a3 343 RTC_ALARMMASK_SECONDS))
AnnaBridge 189:f392fc9709a3 344
AnnaBridge 189:f392fc9709a3 345 /**
AnnaBridge 189:f392fc9709a3 346 * @}
AnnaBridge 189:f392fc9709a3 347 */
AnnaBridge 189:f392fc9709a3 348
AnnaBridge 189:f392fc9709a3 349 /** @defgroup RTC_Alarms_Definitions RTC Alarms Definitions
AnnaBridge 189:f392fc9709a3 350 * @{
AnnaBridge 189:f392fc9709a3 351 */
AnnaBridge 189:f392fc9709a3 352 #define RTC_ALARM_A RTC_CR_ALRAE
AnnaBridge 189:f392fc9709a3 353 #define RTC_ALARM_B RTC_CR_ALRBE
AnnaBridge 189:f392fc9709a3 354
AnnaBridge 189:f392fc9709a3 355 /**
AnnaBridge 189:f392fc9709a3 356 * @}
AnnaBridge 189:f392fc9709a3 357 */
AnnaBridge 189:f392fc9709a3 358
AnnaBridge 189:f392fc9709a3 359
AnnaBridge 189:f392fc9709a3 360 /** @defgroup RTC_Alarm_Sub_Seconds_Masks_Definitions RTC Alarm Sub Seconds Masks Definitions
AnnaBridge 189:f392fc9709a3 361 * @{
AnnaBridge 189:f392fc9709a3 362 */
AnnaBridge 189:f392fc9709a3 363 #define RTC_ALARMSUBSECONDMASK_ALL ((uint32_t)0x00000000U) /*!< All Alarm SS fields are masked.
AnnaBridge 189:f392fc9709a3 364 There is no comparison on sub seconds
AnnaBridge 189:f392fc9709a3 365 for Alarm */
AnnaBridge 189:f392fc9709a3 366 #define RTC_ALARMSUBSECONDMASK_SS14_1 RTC_ALRMASSR_MASKSS_0 /*!< SS[14:1] are don't care in Alarm
AnnaBridge 189:f392fc9709a3 367 comparison. Only SS[0] is compared. */
AnnaBridge 189:f392fc9709a3 368 #define RTC_ALARMSUBSECONDMASK_SS14_2 RTC_ALRMASSR_MASKSS_1 /*!< SS[14:2] are don't care in Alarm
AnnaBridge 189:f392fc9709a3 369 comparison. Only SS[1:0] are compared */
AnnaBridge 189:f392fc9709a3 370 #define RTC_ALARMSUBSECONDMASK_SS14_3 ((uint32_t) (RTC_ALRMASSR_MASKSS_0 | RTC_ALRMASSR_MASKSS_1)) /*!< SS[14:3] are don't care in Alarm
AnnaBridge 189:f392fc9709a3 371 comparison. Only SS[2:0] are compared */
AnnaBridge 189:f392fc9709a3 372 #define RTC_ALARMSUBSECONDMASK_SS14_4 RTC_ALRMASSR_MASKSS_2 /*!< SS[14:4] are don't care in Alarm
AnnaBridge 189:f392fc9709a3 373 comparison. Only SS[3:0] are compared */
AnnaBridge 189:f392fc9709a3 374 #define RTC_ALARMSUBSECONDMASK_SS14_5 ((uint32_t) (RTC_ALRMASSR_MASKSS_0 | RTC_ALRMASSR_MASKSS_2)) /*!< SS[14:5] are don't care in Alarm
AnnaBridge 189:f392fc9709a3 375 comparison. Only SS[4:0] are compared */
AnnaBridge 189:f392fc9709a3 376 #define RTC_ALARMSUBSECONDMASK_SS14_6 ((uint32_t) (RTC_ALRMASSR_MASKSS_1 | RTC_ALRMASSR_MASKSS_2)) /*!< SS[14:6] are don't care in Alarm
AnnaBridge 189:f392fc9709a3 377 comparison. Only SS[5:0] are compared */
AnnaBridge 189:f392fc9709a3 378 #define RTC_ALARMSUBSECONDMASK_SS14_7 ((uint32_t) (RTC_ALRMASSR_MASKSS_0 | RTC_ALRMASSR_MASKSS_1 | RTC_ALRMASSR_MASKSS_2)) /*!< SS[14:7] are don't care in Alarm
AnnaBridge 189:f392fc9709a3 379 ` comparison. Only SS[6:0] are compared */
AnnaBridge 189:f392fc9709a3 380 #define RTC_ALARMSUBSECONDMASK_SS14_8 RTC_ALRMASSR_MASKSS_3 /*!< SS[14:8] are don't care in Alarm
AnnaBridge 189:f392fc9709a3 381 comparison. Only SS[7:0] are compared */
AnnaBridge 189:f392fc9709a3 382 #define RTC_ALARMSUBSECONDMASK_SS14_9 ((uint32_t) (RTC_ALRMASSR_MASKSS_0 | RTC_ALRMASSR_MASKSS_3)) /*!< SS[14:9] are don't care in Alarm
AnnaBridge 189:f392fc9709a3 383 comparison. Only SS[8:0] are compared */
AnnaBridge 189:f392fc9709a3 384 #define RTC_ALARMSUBSECONDMASK_SS14_10 ((uint32_t) (RTC_ALRMASSR_MASKSS_1 | RTC_ALRMASSR_MASKSS_3)) /*!< SS[14:10] are don't care in Alarm
AnnaBridge 189:f392fc9709a3 385 comparison. Only SS[9:0] are compared */
AnnaBridge 189:f392fc9709a3 386 #define RTC_ALARMSUBSECONDMASK_SS14_11 ((uint32_t) (RTC_ALRMASSR_MASKSS_0 | RTC_ALRMASSR_MASKSS_1 | RTC_ALRMASSR_MASKSS_3)) /*!< SS[14:11] are don't care in Alarm
AnnaBridge 189:f392fc9709a3 387 comparison. Only SS[10:0] are compared */
AnnaBridge 189:f392fc9709a3 388 #define RTC_ALARMSUBSECONDMASK_SS14_12 ((uint32_t) (RTC_ALRMASSR_MASKSS_2 | RTC_ALRMASSR_MASKSS_3)) /*!< SS[14:12] are don't care in Alarm
AnnaBridge 189:f392fc9709a3 389 comparison.Only SS[11:0] are compared */
AnnaBridge 189:f392fc9709a3 390 #define RTC_ALARMSUBSECONDMASK_SS14_13 ((uint32_t) (RTC_ALRMASSR_MASKSS_0 | RTC_ALRMASSR_MASKSS_2 | RTC_ALRMASSR_MASKSS_3)) /*!< SS[14:13] are don't care in Alarm
AnnaBridge 189:f392fc9709a3 391 comparison. Only SS[12:0] are compared */
AnnaBridge 189:f392fc9709a3 392 #define RTC_ALARMSUBSECONDMASK_SS14 ((uint32_t) (RTC_ALRMASSR_MASKSS_1 | RTC_ALRMASSR_MASKSS_2 | RTC_ALRMASSR_MASKSS_3)) /*!< SS[14] is don't care in Alarm
AnnaBridge 189:f392fc9709a3 393 comparison.Only SS[13:0] are compared */
AnnaBridge 189:f392fc9709a3 394 #define RTC_ALARMSUBSECONDMASK_NONE RTC_ALRMASSR_MASKSS /*!< SS[14:0] are compared and must match
AnnaBridge 189:f392fc9709a3 395 to activate alarm. */
AnnaBridge 189:f392fc9709a3 396 /**
AnnaBridge 189:f392fc9709a3 397 * @}
AnnaBridge 189:f392fc9709a3 398 */
AnnaBridge 189:f392fc9709a3 399
AnnaBridge 189:f392fc9709a3 400 /** @defgroup RTC_Interrupts_Definitions RTC Interrupts Definitions
AnnaBridge 189:f392fc9709a3 401 * @{
AnnaBridge 189:f392fc9709a3 402 */
AnnaBridge 189:f392fc9709a3 403 #define RTC_IT_TS ((uint32_t)RTC_CR_TSIE) /*!< Enable Timestamp Interrupt */
AnnaBridge 189:f392fc9709a3 404 #define RTC_IT_WUT ((uint32_t)RTC_CR_WUTIE) /*!< Enable Wakeup timer Interrupt */
AnnaBridge 189:f392fc9709a3 405 #define RTC_IT_ALRA ((uint32_t)RTC_CR_ALRAIE) /*!< Enable Alarm A Interrupt */
AnnaBridge 189:f392fc9709a3 406 #define RTC_IT_ALRB ((uint32_t)RTC_CR_ALRBIE) /*!< Enable Alarm B Interrupt */
AnnaBridge 189:f392fc9709a3 407 #define RTC_IT_TAMP ((uint32_t)RTC_TAMPCR_TAMPIE) /*!< Enable all Tamper Interrupt */
AnnaBridge 189:f392fc9709a3 408
AnnaBridge 189:f392fc9709a3 409 #if defined (STM32L063xx) || defined (STM32L062xx) || defined (STM32L061xx) || \
AnnaBridge 189:f392fc9709a3 410 defined (STM32L053xx) || defined (STM32L052xx) || defined (STM32L051xx) ||\
AnnaBridge 189:f392fc9709a3 411 defined (STM32L083xx) || defined (STM32L082xx) || defined (STM32L081xx) || \
AnnaBridge 189:f392fc9709a3 412 defined (STM32L073xx) || defined (STM32L072xx) || defined (STM32L071xx) || \
AnnaBridge 189:f392fc9709a3 413 defined (STM32L031xx) || defined (STM32L041xx)
AnnaBridge 189:f392fc9709a3 414
AnnaBridge 189:f392fc9709a3 415 #define RTC_IT_TAMP1 ((uint32_t)RTC_TAMPCR_TAMP1IE) /*!< Enable Tamper 1 Interrupt */
AnnaBridge 189:f392fc9709a3 416 #endif /* (STM32L063xx) || (STM32L062xx) || (STM32L061xx) ||
AnnaBridge 189:f392fc9709a3 417 * (STM32L053xx) || (STM32L052xx) || (STM32L051xx) ||
AnnaBridge 189:f392fc9709a3 418 * (STM32L083xx) || (STM32L082xx) || (STM32L081xx) ||
AnnaBridge 189:f392fc9709a3 419 * (STM32L073xx) || (STM32L072xx) || (STM32L071xx) ||
AnnaBridge 189:f392fc9709a3 420 * (STM32L031xx) || (STM32L041xx)
AnnaBridge 189:f392fc9709a3 421 */
AnnaBridge 189:f392fc9709a3 422 #define RTC_IT_TAMP2 ((uint32_t)RTC_TAMPCR_TAMP2IE) /*!< Enable Tamper 2 Interrupt */
AnnaBridge 189:f392fc9709a3 423 /**
AnnaBridge 189:f392fc9709a3 424 * @}
AnnaBridge 189:f392fc9709a3 425 */
AnnaBridge 189:f392fc9709a3 426
AnnaBridge 189:f392fc9709a3 427 /** @defgroup RTC_Flags_Definitions RTC Flags Definitions
AnnaBridge 189:f392fc9709a3 428 * @{
AnnaBridge 189:f392fc9709a3 429 */
AnnaBridge 189:f392fc9709a3 430 #define RTC_FLAG_RECALPF ((uint32_t)RTC_ISR_RECALPF)
AnnaBridge 189:f392fc9709a3 431 #define RTC_FLAG_TAMP2F ((uint32_t)RTC_ISR_TAMP2F)
AnnaBridge 189:f392fc9709a3 432
AnnaBridge 189:f392fc9709a3 433 #if defined (STM32L063xx) || defined (STM32L062xx) || defined (STM32L061xx) || \
AnnaBridge 189:f392fc9709a3 434 defined (STM32L053xx) || defined (STM32L052xx) || defined (STM32L051xx) ||\
AnnaBridge 189:f392fc9709a3 435 defined (STM32L083xx) || defined (STM32L082xx) || defined (STM32L081xx) || \
AnnaBridge 189:f392fc9709a3 436 defined (STM32L073xx) || defined (STM32L072xx) || defined (STM32L071xx) || \
AnnaBridge 189:f392fc9709a3 437 defined (STM32L031xx) || defined (STM32L041xx)
AnnaBridge 189:f392fc9709a3 438 #define RTC_FLAG_TAMP1F ((uint32_t)RTC_ISR_TAMP1F)
AnnaBridge 189:f392fc9709a3 439 #endif /* (STM32L063xx) || (STM32L062xx) || (STM32L061xx) ||
AnnaBridge 189:f392fc9709a3 440 * (STM32L053xx) || (STM32L052xx) || (STM32L051xx) ||
AnnaBridge 189:f392fc9709a3 441 * (STM32L083xx) || (STM32L082xx) || (STM32L081xx) ||
AnnaBridge 189:f392fc9709a3 442 * (STM32L073xx) || (STM32L072xx) || (STM32L071xx) ||
AnnaBridge 189:f392fc9709a3 443 * (STM32L031xx) || (STM32L041xx)
AnnaBridge 189:f392fc9709a3 444 */
AnnaBridge 189:f392fc9709a3 445
AnnaBridge 189:f392fc9709a3 446 #define RTC_FLAG_TSOVF ((uint32_t)RTC_ISR_TSOVF)
AnnaBridge 189:f392fc9709a3 447 #define RTC_FLAG_TSF ((uint32_t)RTC_ISR_TSF)
AnnaBridge 189:f392fc9709a3 448 #define RTC_FLAG_WUTF ((uint32_t)RTC_ISR_WUTF)
AnnaBridge 189:f392fc9709a3 449 #define RTC_FLAG_ALRBF ((uint32_t)RTC_ISR_ALRBF)
AnnaBridge 189:f392fc9709a3 450 #define RTC_FLAG_ALRAF ((uint32_t)RTC_ISR_ALRAF)
AnnaBridge 189:f392fc9709a3 451 #define RTC_FLAG_INITF ((uint32_t)RTC_ISR_INITF)
AnnaBridge 189:f392fc9709a3 452 #define RTC_FLAG_RSF ((uint32_t)RTC_ISR_RSF)
AnnaBridge 189:f392fc9709a3 453 #define RTC_FLAG_INITS ((uint32_t)RTC_ISR_INITS)
AnnaBridge 189:f392fc9709a3 454 #define RTC_FLAG_SHPF ((uint32_t)RTC_ISR_SHPF)
AnnaBridge 189:f392fc9709a3 455 #define RTC_FLAG_WUTWF ((uint32_t)RTC_ISR_WUTWF)
AnnaBridge 189:f392fc9709a3 456 #define RTC_FLAG_ALRBWF ((uint32_t)RTC_ISR_ALRBWF)
AnnaBridge 189:f392fc9709a3 457 #define RTC_FLAG_ALRAWF ((uint32_t)RTC_ISR_ALRAWF)
AnnaBridge 189:f392fc9709a3 458 /**
AnnaBridge 189:f392fc9709a3 459 * @}
AnnaBridge 189:f392fc9709a3 460 */
AnnaBridge 189:f392fc9709a3 461
AnnaBridge 189:f392fc9709a3 462 /**
AnnaBridge 189:f392fc9709a3 463 * @}
AnnaBridge 189:f392fc9709a3 464 */
AnnaBridge 189:f392fc9709a3 465
AnnaBridge 189:f392fc9709a3 466 /* Exported macros -----------------------------------------------------------*/
AnnaBridge 189:f392fc9709a3 467 /** @defgroup RTC_Exported_Macros RTC Exported Macros
AnnaBridge 189:f392fc9709a3 468 * @{
AnnaBridge 189:f392fc9709a3 469 */
AnnaBridge 189:f392fc9709a3 470
AnnaBridge 189:f392fc9709a3 471 /** @brief Reset RTC handle state
AnnaBridge 189:f392fc9709a3 472 * @param __HANDLE__: RTC handle.
AnnaBridge 189:f392fc9709a3 473 * @retval None
AnnaBridge 189:f392fc9709a3 474 */
AnnaBridge 189:f392fc9709a3 475 #define __HAL_RTC_RESET_HANDLE_STATE(__HANDLE__) ((__HANDLE__)->State = HAL_RTC_STATE_RESET)
AnnaBridge 189:f392fc9709a3 476
AnnaBridge 189:f392fc9709a3 477 /**
AnnaBridge 189:f392fc9709a3 478 * @brief Disable the write protection for RTC registers.
AnnaBridge 189:f392fc9709a3 479 * @param __HANDLE__: specifies the RTC handle.
AnnaBridge 189:f392fc9709a3 480 * @retval None
AnnaBridge 189:f392fc9709a3 481 */
AnnaBridge 189:f392fc9709a3 482 #define __HAL_RTC_WRITEPROTECTION_DISABLE(__HANDLE__) \
AnnaBridge 189:f392fc9709a3 483 do{ \
AnnaBridge 189:f392fc9709a3 484 (__HANDLE__)->Instance->WPR = 0xCAU; \
AnnaBridge 189:f392fc9709a3 485 (__HANDLE__)->Instance->WPR = 0x53U; \
AnnaBridge 189:f392fc9709a3 486 } while(0U)
AnnaBridge 189:f392fc9709a3 487
AnnaBridge 189:f392fc9709a3 488 /**
AnnaBridge 189:f392fc9709a3 489 * @brief Enable the write protection for RTC registers.
AnnaBridge 189:f392fc9709a3 490 * @param __HANDLE__: specifies the RTC handle.
AnnaBridge 189:f392fc9709a3 491 * @retval None
AnnaBridge 189:f392fc9709a3 492 */
AnnaBridge 189:f392fc9709a3 493 #define __HAL_RTC_WRITEPROTECTION_ENABLE(__HANDLE__) \
AnnaBridge 189:f392fc9709a3 494 do{ \
AnnaBridge 189:f392fc9709a3 495 (__HANDLE__)->Instance->WPR = 0xFFU; \
AnnaBridge 189:f392fc9709a3 496 } while(0U)
AnnaBridge 189:f392fc9709a3 497
AnnaBridge 189:f392fc9709a3 498 /**
AnnaBridge 189:f392fc9709a3 499 * @brief Enable the RTC ALARMA peripheral.
AnnaBridge 189:f392fc9709a3 500 * @param __HANDLE__: specifies the RTC handle.
AnnaBridge 189:f392fc9709a3 501 * @retval None
AnnaBridge 189:f392fc9709a3 502 */
AnnaBridge 189:f392fc9709a3 503 #define __HAL_RTC_ALARMA_ENABLE(__HANDLE__) ((__HANDLE__)->Instance->CR |= (RTC_CR_ALRAE))
AnnaBridge 189:f392fc9709a3 504
AnnaBridge 189:f392fc9709a3 505 /**
AnnaBridge 189:f392fc9709a3 506 * @brief Disable the RTC ALARMA peripheral.
AnnaBridge 189:f392fc9709a3 507 * @param __HANDLE__: specifies the RTC handle.
AnnaBridge 189:f392fc9709a3 508 * @retval None
AnnaBridge 189:f392fc9709a3 509 */
AnnaBridge 189:f392fc9709a3 510 #define __HAL_RTC_ALARMA_DISABLE(__HANDLE__) ((__HANDLE__)->Instance->CR &= ~(RTC_CR_ALRAE))
AnnaBridge 189:f392fc9709a3 511
AnnaBridge 189:f392fc9709a3 512 /**
AnnaBridge 189:f392fc9709a3 513 * @brief Enable the RTC ALARMB peripheral.
AnnaBridge 189:f392fc9709a3 514 * @param __HANDLE__: specifies the RTC handle.
AnnaBridge 189:f392fc9709a3 515 * @retval None
AnnaBridge 189:f392fc9709a3 516 */
AnnaBridge 189:f392fc9709a3 517 #define __HAL_RTC_ALARMB_ENABLE(__HANDLE__) ((__HANDLE__)->Instance->CR |= (RTC_CR_ALRBE))
AnnaBridge 189:f392fc9709a3 518
AnnaBridge 189:f392fc9709a3 519 /**
AnnaBridge 189:f392fc9709a3 520 * @brief Disable the RTC ALARMB peripheral.
AnnaBridge 189:f392fc9709a3 521 * @param __HANDLE__: specifies the RTC handle.
AnnaBridge 189:f392fc9709a3 522 * @retval None
AnnaBridge 189:f392fc9709a3 523 */
AnnaBridge 189:f392fc9709a3 524 #define __HAL_RTC_ALARMB_DISABLE(__HANDLE__) ((__HANDLE__)->Instance->CR &= ~(RTC_CR_ALRBE))
AnnaBridge 189:f392fc9709a3 525
AnnaBridge 189:f392fc9709a3 526 /**
AnnaBridge 189:f392fc9709a3 527 * @brief Enable the RTC Alarm interrupt.
AnnaBridge 189:f392fc9709a3 528 * @param __HANDLE__: specifies the RTC handle.
AnnaBridge 189:f392fc9709a3 529 * @param __INTERRUPT__: specifies the RTC Alarm interrupt sources to be enabled or disabled.
AnnaBridge 189:f392fc9709a3 530 * This parameter can be any combination of the following values:
AnnaBridge 189:f392fc9709a3 531 * @arg RTC_IT_ALRA: Alarm A interrupt
AnnaBridge 189:f392fc9709a3 532 * @arg RTC_IT_ALRB: Alarm B interrupt
AnnaBridge 189:f392fc9709a3 533 * @retval None
AnnaBridge 189:f392fc9709a3 534 */
AnnaBridge 189:f392fc9709a3 535 #define __HAL_RTC_ALARM_ENABLE_IT(__HANDLE__, __INTERRUPT__) ((__HANDLE__)->Instance->CR |= (__INTERRUPT__))
AnnaBridge 189:f392fc9709a3 536
AnnaBridge 189:f392fc9709a3 537 /**
AnnaBridge 189:f392fc9709a3 538 * @brief Disable the RTC Alarm interrupt.
AnnaBridge 189:f392fc9709a3 539 * @param __HANDLE__: specifies the RTC handle.
AnnaBridge 189:f392fc9709a3 540 * @param __INTERRUPT__: specifies the RTC Alarm interrupt sources to be enabled or disabled.
AnnaBridge 189:f392fc9709a3 541 * This parameter can be any combination of the following values:
AnnaBridge 189:f392fc9709a3 542 * @arg RTC_IT_ALRA: Alarm A interrupt
AnnaBridge 189:f392fc9709a3 543 * @arg RTC_IT_ALRB: Alarm B interrupt
AnnaBridge 189:f392fc9709a3 544 * @retval None
AnnaBridge 189:f392fc9709a3 545 */
AnnaBridge 189:f392fc9709a3 546 #define __HAL_RTC_ALARM_DISABLE_IT(__HANDLE__, __INTERRUPT__) ((__HANDLE__)->Instance->CR &= ~(__INTERRUPT__))
AnnaBridge 189:f392fc9709a3 547
AnnaBridge 189:f392fc9709a3 548 /**
AnnaBridge 189:f392fc9709a3 549 * @brief Check whether the specified RTC Alarm interrupt has occurred or not.
AnnaBridge 189:f392fc9709a3 550 * @param __HANDLE__: specifies the RTC handle.
AnnaBridge 189:f392fc9709a3 551 * @param __INTERRUPT__: specifies the RTC Alarm interrupt sources to check.
AnnaBridge 189:f392fc9709a3 552 * This parameter can be:
AnnaBridge 189:f392fc9709a3 553 * @arg RTC_IT_ALRA: Alarm A interrupt
AnnaBridge 189:f392fc9709a3 554 * @arg RTC_IT_ALRB: Alarm B interrupt
AnnaBridge 189:f392fc9709a3 555 * @retval None
AnnaBridge 189:f392fc9709a3 556 */
AnnaBridge 189:f392fc9709a3 557 #define __HAL_RTC_ALARM_GET_IT(__HANDLE__, __INTERRUPT__) (((((__HANDLE__)->Instance->ISR)& ((__INTERRUPT__)>> 4U)) != RESET)? SET : RESET)
AnnaBridge 189:f392fc9709a3 558
AnnaBridge 189:f392fc9709a3 559 /**
AnnaBridge 189:f392fc9709a3 560 * @brief Check whether the specified RTC Alarm interrupt has been enabled or not.
AnnaBridge 189:f392fc9709a3 561 * @param __HANDLE__: specifies the RTC handle.
AnnaBridge 189:f392fc9709a3 562 * @param __INTERRUPT__: specifies the RTC Alarm interrupt sources to check.
AnnaBridge 189:f392fc9709a3 563 * This parameter can be:
AnnaBridge 189:f392fc9709a3 564 * @arg RTC_IT_ALRA: Alarm A interrupt
AnnaBridge 189:f392fc9709a3 565 * @arg RTC_IT_ALRB: Alarm B interrupt
AnnaBridge 189:f392fc9709a3 566 * @retval None
AnnaBridge 189:f392fc9709a3 567 */
AnnaBridge 189:f392fc9709a3 568 #define __HAL_RTC_ALARM_GET_IT_SOURCE(__HANDLE__, __INTERRUPT__) (((((__HANDLE__)->Instance->CR) & (__INTERRUPT__)) != RESET) ? SET : RESET)
AnnaBridge 189:f392fc9709a3 569
AnnaBridge 189:f392fc9709a3 570 /**
AnnaBridge 189:f392fc9709a3 571 * @brief Get the selected RTC Alarm's flag status.
AnnaBridge 189:f392fc9709a3 572 * @param __HANDLE__: specifies the RTC handle.
AnnaBridge 189:f392fc9709a3 573 * @param __FLAG__: specifies the RTC Alarm Flag sources to check.
AnnaBridge 189:f392fc9709a3 574 * This parameter can be:
AnnaBridge 189:f392fc9709a3 575 * @arg RTC_FLAG_ALRAF
AnnaBridge 189:f392fc9709a3 576 * @arg RTC_FLAG_ALRBF
AnnaBridge 189:f392fc9709a3 577 * @arg RTC_FLAG_ALRAWF
AnnaBridge 189:f392fc9709a3 578 * @arg RTC_FLAG_ALRBWF
AnnaBridge 189:f392fc9709a3 579 * @retval None
AnnaBridge 189:f392fc9709a3 580 */
AnnaBridge 189:f392fc9709a3 581 #define __HAL_RTC_ALARM_GET_FLAG(__HANDLE__, __FLAG__) (((((__HANDLE__)->Instance->ISR) & (__FLAG__)) != RESET)? SET : RESET)
AnnaBridge 189:f392fc9709a3 582
AnnaBridge 189:f392fc9709a3 583 /**
AnnaBridge 189:f392fc9709a3 584 * @brief Clear the RTC Alarm's pending flags.
AnnaBridge 189:f392fc9709a3 585 * @param __HANDLE__: specifies the RTC handle.
AnnaBridge 189:f392fc9709a3 586 * @param __FLAG__: specifies the RTC Alarm Flag sources to clear.
AnnaBridge 189:f392fc9709a3 587 * This parameter can be:
AnnaBridge 189:f392fc9709a3 588 * @arg RTC_FLAG_ALRAF
AnnaBridge 189:f392fc9709a3 589 * @arg RTC_FLAG_ALRBF
AnnaBridge 189:f392fc9709a3 590 * @retval None
AnnaBridge 189:f392fc9709a3 591 */
AnnaBridge 189:f392fc9709a3 592 #define __HAL_RTC_ALARM_CLEAR_FLAG(__HANDLE__, __FLAG__) ((__HANDLE__)->Instance->ISR) = (~((__FLAG__) | RTC_ISR_INIT) | ((__HANDLE__)->Instance->ISR & RTC_ISR_INIT))
AnnaBridge 189:f392fc9709a3 593
AnnaBridge 189:f392fc9709a3 594 /**
AnnaBridge 189:f392fc9709a3 595 * @brief Enable interrupt on the RTC Alarm associated Exti line.
AnnaBridge 189:f392fc9709a3 596 * @retval None
AnnaBridge 189:f392fc9709a3 597 */
AnnaBridge 189:f392fc9709a3 598 #define __HAL_RTC_ALARM_EXTI_ENABLE_IT() (EXTI->IMR |= RTC_EXTI_LINE_ALARM_EVENT)
AnnaBridge 189:f392fc9709a3 599
AnnaBridge 189:f392fc9709a3 600 /**
AnnaBridge 189:f392fc9709a3 601 * @brief Disable interrupt on the RTC Alarm associated Exti line.
AnnaBridge 189:f392fc9709a3 602 * @retval None
AnnaBridge 189:f392fc9709a3 603 */
AnnaBridge 189:f392fc9709a3 604 #define __HAL_RTC_ALARM_EXTI_DISABLE_IT() (EXTI->IMR &= ~(RTC_EXTI_LINE_ALARM_EVENT))
AnnaBridge 189:f392fc9709a3 605
AnnaBridge 189:f392fc9709a3 606 /**
AnnaBridge 189:f392fc9709a3 607 * @brief Enable event on the RTC Alarm associated Exti line.
AnnaBridge 189:f392fc9709a3 608 * @retval None.
AnnaBridge 189:f392fc9709a3 609 */
AnnaBridge 189:f392fc9709a3 610 #define __HAL_RTC_ALARM_EXTI_ENABLE_EVENT() (EXTI->EMR |= RTC_EXTI_LINE_ALARM_EVENT)
AnnaBridge 189:f392fc9709a3 611
AnnaBridge 189:f392fc9709a3 612 /**
AnnaBridge 189:f392fc9709a3 613 * @brief Disable event on the RTC Alarm associated Exti line.
AnnaBridge 189:f392fc9709a3 614 * @retval None.
AnnaBridge 189:f392fc9709a3 615 */
AnnaBridge 189:f392fc9709a3 616 #define __HAL_RTC_ALARM_EXTI_DISABLE_EVENT() (EXTI->EMR &= ~(RTC_EXTI_LINE_ALARM_EVENT))
AnnaBridge 189:f392fc9709a3 617
AnnaBridge 189:f392fc9709a3 618 /**
AnnaBridge 189:f392fc9709a3 619 * @brief Enable falling edge trigger on the RTC Alarm associated Exti line.
AnnaBridge 189:f392fc9709a3 620 * @retval None.
AnnaBridge 189:f392fc9709a3 621 */
AnnaBridge 189:f392fc9709a3 622 #define __HAL_RTC_ALARM_EXTI_ENABLE_FALLING_EDGE() (EXTI->FTSR |= RTC_EXTI_LINE_ALARM_EVENT)
AnnaBridge 189:f392fc9709a3 623
AnnaBridge 189:f392fc9709a3 624 /**
AnnaBridge 189:f392fc9709a3 625 * @brief Disable falling edge trigger on the RTC Alarm associated Exti line.
AnnaBridge 189:f392fc9709a3 626 * @retval None.
AnnaBridge 189:f392fc9709a3 627 */
AnnaBridge 189:f392fc9709a3 628 #define __HAL_RTC_ALARM_EXTI_DISABLE_FALLING_EDGE() (EXTI->FTSR &= ~(RTC_EXTI_LINE_ALARM_EVENT))
AnnaBridge 189:f392fc9709a3 629
AnnaBridge 189:f392fc9709a3 630 /**
AnnaBridge 189:f392fc9709a3 631 * @brief Enable rising edge trigger on the RTC Alarm associated Exti line.
AnnaBridge 189:f392fc9709a3 632 * @retval None.
AnnaBridge 189:f392fc9709a3 633 */
AnnaBridge 189:f392fc9709a3 634 #define __HAL_RTC_ALARM_EXTI_ENABLE_RISING_EDGE() (EXTI->RTSR |= RTC_EXTI_LINE_ALARM_EVENT)
AnnaBridge 189:f392fc9709a3 635
AnnaBridge 189:f392fc9709a3 636 /**
AnnaBridge 189:f392fc9709a3 637 * @brief Disable rising edge trigger on the RTC Alarm associated Exti line.
AnnaBridge 189:f392fc9709a3 638 * @retval None.
AnnaBridge 189:f392fc9709a3 639 */
AnnaBridge 189:f392fc9709a3 640 #define __HAL_RTC_ALARM_EXTI_DISABLE_RISING_EDGE() (EXTI->RTSR &= ~(RTC_EXTI_LINE_ALARM_EVENT))
AnnaBridge 189:f392fc9709a3 641
AnnaBridge 189:f392fc9709a3 642 /**
AnnaBridge 189:f392fc9709a3 643 * @brief Enable rising & falling edge trigger on the RTC Alarm associated Exti line.
AnnaBridge 189:f392fc9709a3 644 * @retval None.
AnnaBridge 189:f392fc9709a3 645 */
AnnaBridge 189:f392fc9709a3 646 #define __HAL_RTC_ALARM_EXTI_ENABLE_RISING_FALLING_EDGE() do { \
AnnaBridge 189:f392fc9709a3 647 __HAL_RTC_ALARM_EXTI_ENABLE_RISING_EDGE(); \
AnnaBridge 189:f392fc9709a3 648 __HAL_RTC_ALARM_EXTI_ENABLE_FALLING_EDGE(); \
AnnaBridge 189:f392fc9709a3 649 } while(0U)
AnnaBridge 189:f392fc9709a3 650
AnnaBridge 189:f392fc9709a3 651 /**
AnnaBridge 189:f392fc9709a3 652 * @brief Disable rising & falling edge trigger on the RTC Alarm associated Exti line.
AnnaBridge 189:f392fc9709a3 653 * @retval None.
AnnaBridge 189:f392fc9709a3 654 */
AnnaBridge 189:f392fc9709a3 655 #define __HAL_RTC_ALARM_EXTI_DISABLE_RISING_FALLING_EDGE() do { \
AnnaBridge 189:f392fc9709a3 656 __HAL_RTC_ALARM_EXTI_DISABLE_RISING_EDGE(); \
AnnaBridge 189:f392fc9709a3 657 __HAL_RTC_ALARM_EXTI_DISABLE_FALLING_EDGE(); \
AnnaBridge 189:f392fc9709a3 658 } while(0U)
AnnaBridge 189:f392fc9709a3 659
AnnaBridge 189:f392fc9709a3 660 /**
AnnaBridge 189:f392fc9709a3 661 * @brief Check whether the RTC Alarm associated Exti line interrupt flag is set or not.
AnnaBridge 189:f392fc9709a3 662 * @retval Line Status.
AnnaBridge 189:f392fc9709a3 663 */
AnnaBridge 189:f392fc9709a3 664 #define __HAL_RTC_ALARM_EXTI_GET_FLAG() (EXTI->PR & RTC_EXTI_LINE_ALARM_EVENT)
AnnaBridge 189:f392fc9709a3 665
AnnaBridge 189:f392fc9709a3 666 /**
AnnaBridge 189:f392fc9709a3 667 * @brief Clear the RTC Alarm associated Exti line flag.
AnnaBridge 189:f392fc9709a3 668 * @retval None.
AnnaBridge 189:f392fc9709a3 669 */
AnnaBridge 189:f392fc9709a3 670 #define __HAL_RTC_ALARM_EXTI_CLEAR_FLAG() (EXTI->PR = RTC_EXTI_LINE_ALARM_EVENT)
AnnaBridge 189:f392fc9709a3 671
AnnaBridge 189:f392fc9709a3 672 /**
AnnaBridge 189:f392fc9709a3 673 * @brief Generate a Software interrupt on RTC Alarm associated Exti line.
AnnaBridge 189:f392fc9709a3 674 * @retval None.
AnnaBridge 189:f392fc9709a3 675 */
AnnaBridge 189:f392fc9709a3 676 #define __HAL_RTC_ALARM_EXTI_GENERATE_SWIT() (EXTI->SWIER |= RTC_EXTI_LINE_ALARM_EVENT)
AnnaBridge 189:f392fc9709a3 677
AnnaBridge 189:f392fc9709a3 678 /**
AnnaBridge 189:f392fc9709a3 679 * @}
AnnaBridge 189:f392fc9709a3 680 */
AnnaBridge 189:f392fc9709a3 681
AnnaBridge 189:f392fc9709a3 682 /* Include RTC HAL Extended module */
AnnaBridge 189:f392fc9709a3 683 #include "stm32l0xx_hal_rtc_ex.h"
AnnaBridge 189:f392fc9709a3 684
AnnaBridge 189:f392fc9709a3 685 /* Exported functions --------------------------------------------------------*/
AnnaBridge 189:f392fc9709a3 686 /** @defgroup RTC_Exported_Functions RTC Exported Functions
AnnaBridge 189:f392fc9709a3 687 * @{
AnnaBridge 189:f392fc9709a3 688 */
AnnaBridge 189:f392fc9709a3 689
AnnaBridge 189:f392fc9709a3 690 /** @defgroup RTC_Exported_Functions_Group1 Initialization and de-initialization functions
AnnaBridge 189:f392fc9709a3 691 * @{
AnnaBridge 189:f392fc9709a3 692 */
AnnaBridge 189:f392fc9709a3 693 /* Initialization and de-initialization functions ****************************/
AnnaBridge 189:f392fc9709a3 694 HAL_StatusTypeDef HAL_RTC_Init(RTC_HandleTypeDef *hrtc);
AnnaBridge 189:f392fc9709a3 695 HAL_StatusTypeDef HAL_RTC_DeInit(RTC_HandleTypeDef *hrtc);
AnnaBridge 189:f392fc9709a3 696 void HAL_RTC_MspInit(RTC_HandleTypeDef *hrtc);
AnnaBridge 189:f392fc9709a3 697 void HAL_RTC_MspDeInit(RTC_HandleTypeDef *hrtc);
AnnaBridge 189:f392fc9709a3 698 /**
AnnaBridge 189:f392fc9709a3 699 * @}
AnnaBridge 189:f392fc9709a3 700 */
AnnaBridge 189:f392fc9709a3 701
AnnaBridge 189:f392fc9709a3 702 /** @defgroup RTC_Exported_Functions_Group2 RTC Time and Date functions
AnnaBridge 189:f392fc9709a3 703 * @{
AnnaBridge 189:f392fc9709a3 704 */
AnnaBridge 189:f392fc9709a3 705 /* RTC Time and Date functions ************************************************/
AnnaBridge 189:f392fc9709a3 706 HAL_StatusTypeDef HAL_RTC_SetTime(RTC_HandleTypeDef *hrtc, RTC_TimeTypeDef *sTime, uint32_t Format);
AnnaBridge 189:f392fc9709a3 707 HAL_StatusTypeDef HAL_RTC_GetTime(RTC_HandleTypeDef *hrtc, RTC_TimeTypeDef *sTime, uint32_t Format);
AnnaBridge 189:f392fc9709a3 708 HAL_StatusTypeDef HAL_RTC_SetDate(RTC_HandleTypeDef *hrtc, RTC_DateTypeDef *sDate, uint32_t Format);
AnnaBridge 189:f392fc9709a3 709 HAL_StatusTypeDef HAL_RTC_GetDate(RTC_HandleTypeDef *hrtc, RTC_DateTypeDef *sDate, uint32_t Format);
AnnaBridge 189:f392fc9709a3 710 /**
AnnaBridge 189:f392fc9709a3 711 * @}
AnnaBridge 189:f392fc9709a3 712 */
AnnaBridge 189:f392fc9709a3 713
AnnaBridge 189:f392fc9709a3 714 /** @defgroup RTC_Exported_Functions_Group3 RTC Alarm functions
AnnaBridge 189:f392fc9709a3 715 * @{
AnnaBridge 189:f392fc9709a3 716 */
AnnaBridge 189:f392fc9709a3 717 /* RTC Alarm functions ********************************************************/
AnnaBridge 189:f392fc9709a3 718 HAL_StatusTypeDef HAL_RTC_SetAlarm(RTC_HandleTypeDef *hrtc, RTC_AlarmTypeDef *sAlarm, uint32_t Format);
AnnaBridge 189:f392fc9709a3 719 HAL_StatusTypeDef HAL_RTC_SetAlarm_IT(RTC_HandleTypeDef *hrtc, RTC_AlarmTypeDef *sAlarm, uint32_t Format);
AnnaBridge 189:f392fc9709a3 720 HAL_StatusTypeDef HAL_RTC_DeactivateAlarm(RTC_HandleTypeDef *hrtc, uint32_t Alarm);
AnnaBridge 189:f392fc9709a3 721 HAL_StatusTypeDef HAL_RTC_GetAlarm(RTC_HandleTypeDef *hrtc, RTC_AlarmTypeDef *sAlarm, uint32_t Alarm, uint32_t Format);
AnnaBridge 189:f392fc9709a3 722 void HAL_RTC_AlarmIRQHandler(RTC_HandleTypeDef *hrtc);
AnnaBridge 189:f392fc9709a3 723 HAL_StatusTypeDef HAL_RTC_PollForAlarmAEvent(RTC_HandleTypeDef *hrtc, uint32_t Timeout);
AnnaBridge 189:f392fc9709a3 724 void HAL_RTC_AlarmAEventCallback(RTC_HandleTypeDef *hrtc);
AnnaBridge 189:f392fc9709a3 725 /**
AnnaBridge 189:f392fc9709a3 726 * @}
AnnaBridge 189:f392fc9709a3 727 */
AnnaBridge 189:f392fc9709a3 728
AnnaBridge 189:f392fc9709a3 729 /** @defgroup RTC_Exported_Functions_Group4 Peripheral Control functions
AnnaBridge 189:f392fc9709a3 730 * @{
AnnaBridge 189:f392fc9709a3 731 */
AnnaBridge 189:f392fc9709a3 732 /* Peripheral Control functions ***********************************************/
AnnaBridge 189:f392fc9709a3 733 HAL_StatusTypeDef HAL_RTC_WaitForSynchro(RTC_HandleTypeDef* hrtc);
AnnaBridge 189:f392fc9709a3 734 /**
AnnaBridge 189:f392fc9709a3 735 * @}
AnnaBridge 189:f392fc9709a3 736 */
AnnaBridge 189:f392fc9709a3 737
AnnaBridge 189:f392fc9709a3 738 /** @defgroup RTC_Exported_Functions_Group5 Peripheral State functions
AnnaBridge 189:f392fc9709a3 739 * @{
AnnaBridge 189:f392fc9709a3 740 */
AnnaBridge 189:f392fc9709a3 741 /* Peripheral State functions *************************************************/
AnnaBridge 189:f392fc9709a3 742 HAL_RTCStateTypeDef HAL_RTC_GetState(RTC_HandleTypeDef *hrtc);
AnnaBridge 189:f392fc9709a3 743 /**
AnnaBridge 189:f392fc9709a3 744 * @}
AnnaBridge 189:f392fc9709a3 745 */
AnnaBridge 189:f392fc9709a3 746
AnnaBridge 189:f392fc9709a3 747 /**
AnnaBridge 189:f392fc9709a3 748 * @}
AnnaBridge 189:f392fc9709a3 749 */
AnnaBridge 189:f392fc9709a3 750
AnnaBridge 189:f392fc9709a3 751 /* Private types -------------------------------------------------------------*/
AnnaBridge 189:f392fc9709a3 752 /* Private variables ---------------------------------------------------------*/
AnnaBridge 189:f392fc9709a3 753 /* Private constants ---------------------------------------------------------*/
AnnaBridge 189:f392fc9709a3 754 /** @defgroup RTC_Private_Constants RTC Private Constants
AnnaBridge 189:f392fc9709a3 755 * @{
AnnaBridge 189:f392fc9709a3 756 */
AnnaBridge 189:f392fc9709a3 757 /* Masks Definition */
AnnaBridge 189:f392fc9709a3 758 #define RTC_TR_RESERVED_MASK ((uint32_t) (RTC_TR_PM | RTC_TR_HT | RTC_TR_HU | \
AnnaBridge 189:f392fc9709a3 759 RTC_TR_MNT | RTC_TR_MNU| RTC_TR_ST | \
AnnaBridge 189:f392fc9709a3 760 RTC_TR_SU))
AnnaBridge 189:f392fc9709a3 761 #define RTC_DR_RESERVED_MASK ((uint32_t) (RTC_DR_YT | RTC_DR_YU | RTC_DR_WDU | \
AnnaBridge 189:f392fc9709a3 762 RTC_DR_MT | RTC_DR_MU | RTC_DR_DT | \
AnnaBridge 189:f392fc9709a3 763 RTC_DR_DU))
AnnaBridge 189:f392fc9709a3 764 #define RTC_INIT_MASK ((uint32_t)0xFFFFFFFFU)
AnnaBridge 189:f392fc9709a3 765 #define RTC_RSF_MASK ((uint32_t)~(RTC_ISR_INIT | RTC_ISR_RSF))
AnnaBridge 189:f392fc9709a3 766
AnnaBridge 189:f392fc9709a3 767 #define RTC_TIMEOUT_VALUE 1000U
AnnaBridge 189:f392fc9709a3 768
AnnaBridge 189:f392fc9709a3 769 #define RTC_EXTI_LINE_ALARM_EVENT ((uint32_t)EXTI_IMR_IM17) /*!< External interrupt line 17 Connected to the RTC Alarm event */
AnnaBridge 189:f392fc9709a3 770
AnnaBridge 189:f392fc9709a3 771 /**
AnnaBridge 189:f392fc9709a3 772 * @}
AnnaBridge 189:f392fc9709a3 773 */
AnnaBridge 189:f392fc9709a3 774
AnnaBridge 189:f392fc9709a3 775 /* Private macros ------------------------------------------------------------*/
AnnaBridge 189:f392fc9709a3 776 /** @defgroup RTC_Private_Macros RTC Private Macros
AnnaBridge 189:f392fc9709a3 777 * @{
AnnaBridge 189:f392fc9709a3 778 */
AnnaBridge 189:f392fc9709a3 779
AnnaBridge 189:f392fc9709a3 780 /** @defgroup RTC_IS_RTC_Definitions RTC Private macros to check input parameters
AnnaBridge 189:f392fc9709a3 781 * @{
AnnaBridge 189:f392fc9709a3 782 */
AnnaBridge 189:f392fc9709a3 783
AnnaBridge 189:f392fc9709a3 784 #define IS_RTC_HOUR_FORMAT(FORMAT) (((FORMAT) == RTC_HOURFORMAT_12) || \
AnnaBridge 189:f392fc9709a3 785 ((FORMAT) == RTC_HOURFORMAT_24))
AnnaBridge 189:f392fc9709a3 786
AnnaBridge 189:f392fc9709a3 787 #define IS_RTC_OUTPUT_POL(POL) (((POL) == RTC_OUTPUT_POLARITY_HIGH) || \
AnnaBridge 189:f392fc9709a3 788 ((POL) == RTC_OUTPUT_POLARITY_LOW))
AnnaBridge 189:f392fc9709a3 789
AnnaBridge 189:f392fc9709a3 790 #define IS_RTC_OUTPUT_TYPE(TYPE) (((TYPE) == RTC_OUTPUT_TYPE_OPENDRAIN) || \
AnnaBridge 189:f392fc9709a3 791 ((TYPE) == RTC_OUTPUT_TYPE_PUSHPULL))
AnnaBridge 189:f392fc9709a3 792
AnnaBridge 189:f392fc9709a3 793 #define IS_RTC_OUTPUT_REMAP(REMAP) (((REMAP) == RTC_OUTPUT_REMAP_NONE) || \
AnnaBridge 189:f392fc9709a3 794 ((REMAP) == RTC_OUTPUT_REMAP_POS1))
AnnaBridge 189:f392fc9709a3 795
AnnaBridge 189:f392fc9709a3 796 #define IS_RTC_HOURFORMAT12(PM) (((PM) == RTC_HOURFORMAT12_AM) || \
AnnaBridge 189:f392fc9709a3 797 ((PM) == RTC_HOURFORMAT12_PM))
AnnaBridge 189:f392fc9709a3 798
AnnaBridge 189:f392fc9709a3 799 #define IS_RTC_DAYLIGHT_SAVING(SAVE) (((SAVE) == RTC_DAYLIGHTSAVING_SUB1H) || \
AnnaBridge 189:f392fc9709a3 800 ((SAVE) == RTC_DAYLIGHTSAVING_ADD1H) || \
AnnaBridge 189:f392fc9709a3 801 ((SAVE) == RTC_DAYLIGHTSAVING_NONE))
AnnaBridge 189:f392fc9709a3 802
AnnaBridge 189:f392fc9709a3 803 #define IS_RTC_STORE_OPERATION(OPERATION) (((OPERATION) == RTC_STOREOPERATION_RESET) || \
AnnaBridge 189:f392fc9709a3 804 ((OPERATION) == RTC_STOREOPERATION_SET))
AnnaBridge 189:f392fc9709a3 805
AnnaBridge 189:f392fc9709a3 806 #define IS_RTC_FORMAT(FORMAT) (((FORMAT) == RTC_FORMAT_BIN) || ((FORMAT) == RTC_FORMAT_BCD))
AnnaBridge 189:f392fc9709a3 807
AnnaBridge 189:f392fc9709a3 808 #define IS_RTC_YEAR(YEAR) ((YEAR) <= (uint32_t)99U)
AnnaBridge 189:f392fc9709a3 809
AnnaBridge 189:f392fc9709a3 810 #define IS_RTC_MONTH(MONTH) (((MONTH) >= (uint32_t)1U) && ((MONTH) <= (uint32_t)12U))
AnnaBridge 189:f392fc9709a3 811
AnnaBridge 189:f392fc9709a3 812 #define IS_RTC_DATE(DATE) (((DATE) >= (uint32_t)1U) && ((DATE) <= (uint32_t)31U))
AnnaBridge 189:f392fc9709a3 813
AnnaBridge 189:f392fc9709a3 814 #define IS_RTC_WEEKDAY(WEEKDAY) (((WEEKDAY) == RTC_WEEKDAY_MONDAY) || \
AnnaBridge 189:f392fc9709a3 815 ((WEEKDAY) == RTC_WEEKDAY_TUESDAY) || \
AnnaBridge 189:f392fc9709a3 816 ((WEEKDAY) == RTC_WEEKDAY_WEDNESDAY) || \
AnnaBridge 189:f392fc9709a3 817 ((WEEKDAY) == RTC_WEEKDAY_THURSDAY) || \
AnnaBridge 189:f392fc9709a3 818 ((WEEKDAY) == RTC_WEEKDAY_FRIDAY) || \
AnnaBridge 189:f392fc9709a3 819 ((WEEKDAY) == RTC_WEEKDAY_SATURDAY) || \
AnnaBridge 189:f392fc9709a3 820 ((WEEKDAY) == RTC_WEEKDAY_SUNDAY))
AnnaBridge 189:f392fc9709a3 821
AnnaBridge 189:f392fc9709a3 822 #define IS_RTC_ALARM_DATE_WEEKDAY_DATE(DATE) (((DATE) >(uint32_t)0U) && ((DATE) <= (uint32_t)31U))
AnnaBridge 189:f392fc9709a3 823
AnnaBridge 189:f392fc9709a3 824 #define IS_RTC_ALARM_DATE_WEEKDAY_WEEKDAY(WEEKDAY) (((WEEKDAY) == RTC_WEEKDAY_MONDAY) || \
AnnaBridge 189:f392fc9709a3 825 ((WEEKDAY) == RTC_WEEKDAY_TUESDAY) || \
AnnaBridge 189:f392fc9709a3 826 ((WEEKDAY) == RTC_WEEKDAY_WEDNESDAY) || \
AnnaBridge 189:f392fc9709a3 827 ((WEEKDAY) == RTC_WEEKDAY_THURSDAY) || \
AnnaBridge 189:f392fc9709a3 828 ((WEEKDAY) == RTC_WEEKDAY_FRIDAY) || \
AnnaBridge 189:f392fc9709a3 829 ((WEEKDAY) == RTC_WEEKDAY_SATURDAY) || \
AnnaBridge 189:f392fc9709a3 830 ((WEEKDAY) == RTC_WEEKDAY_SUNDAY))
AnnaBridge 189:f392fc9709a3 831
AnnaBridge 189:f392fc9709a3 832 #define IS_RTC_ALARM_DATE_WEEKDAY_SEL(SEL) (((SEL) == RTC_ALARMDATEWEEKDAYSEL_DATE) || \
AnnaBridge 189:f392fc9709a3 833 ((SEL) == RTC_ALARMDATEWEEKDAYSEL_WEEKDAY))
AnnaBridge 189:f392fc9709a3 834
AnnaBridge 189:f392fc9709a3 835 #define IS_RTC_ALARM_MASK(MASK) (((MASK) & ~(RTC_ALARMMASK_ALL)) == (uint32_t)RESET)
AnnaBridge 189:f392fc9709a3 836
AnnaBridge 189:f392fc9709a3 837 #define IS_RTC_ALARM(ALARM) (((ALARM) == RTC_ALARM_A) || ((ALARM) == RTC_ALARM_B))
AnnaBridge 189:f392fc9709a3 838
AnnaBridge 189:f392fc9709a3 839 #define IS_RTC_ALARM_SUB_SECOND_VALUE(VALUE) ((VALUE) <= RTC_ALRMASSR_SS)
AnnaBridge 189:f392fc9709a3 840
AnnaBridge 189:f392fc9709a3 841 #define IS_RTC_ALARM_SUB_SECOND_MASK(MASK) (((MASK) == RTC_ALARMSUBSECONDMASK_ALL) || \
AnnaBridge 189:f392fc9709a3 842 ((MASK) == RTC_ALARMSUBSECONDMASK_SS14_1) || \
AnnaBridge 189:f392fc9709a3 843 ((MASK) == RTC_ALARMSUBSECONDMASK_SS14_2) || \
AnnaBridge 189:f392fc9709a3 844 ((MASK) == RTC_ALARMSUBSECONDMASK_SS14_3) || \
AnnaBridge 189:f392fc9709a3 845 ((MASK) == RTC_ALARMSUBSECONDMASK_SS14_4) || \
AnnaBridge 189:f392fc9709a3 846 ((MASK) == RTC_ALARMSUBSECONDMASK_SS14_5) || \
AnnaBridge 189:f392fc9709a3 847 ((MASK) == RTC_ALARMSUBSECONDMASK_SS14_6) || \
AnnaBridge 189:f392fc9709a3 848 ((MASK) == RTC_ALARMSUBSECONDMASK_SS14_7) || \
AnnaBridge 189:f392fc9709a3 849 ((MASK) == RTC_ALARMSUBSECONDMASK_SS14_8) || \
AnnaBridge 189:f392fc9709a3 850 ((MASK) == RTC_ALARMSUBSECONDMASK_SS14_9) || \
AnnaBridge 189:f392fc9709a3 851 ((MASK) == RTC_ALARMSUBSECONDMASK_SS14_10) || \
AnnaBridge 189:f392fc9709a3 852 ((MASK) == RTC_ALARMSUBSECONDMASK_SS14_11) || \
AnnaBridge 189:f392fc9709a3 853 ((MASK) == RTC_ALARMSUBSECONDMASK_SS14_12) || \
AnnaBridge 189:f392fc9709a3 854 ((MASK) == RTC_ALARMSUBSECONDMASK_SS14_13) || \
AnnaBridge 189:f392fc9709a3 855 ((MASK) == RTC_ALARMSUBSECONDMASK_SS14) || \
AnnaBridge 189:f392fc9709a3 856 ((MASK) == RTC_ALARMSUBSECONDMASK_NONE))
AnnaBridge 189:f392fc9709a3 857
AnnaBridge 189:f392fc9709a3 858 #define IS_RTC_ASYNCH_PREDIV(PREDIV) ((PREDIV) <= (uint32_t)0x7FU)
AnnaBridge 189:f392fc9709a3 859
AnnaBridge 189:f392fc9709a3 860 #define IS_RTC_SYNCH_PREDIV(PREDIV) ((PREDIV) <= (uint32_t)0x7FFFU)
AnnaBridge 189:f392fc9709a3 861
AnnaBridge 189:f392fc9709a3 862 #define IS_RTC_HOUR12(HOUR) (((HOUR) > (uint32_t)0U) && ((HOUR) <= (uint32_t)12U))
AnnaBridge 189:f392fc9709a3 863
AnnaBridge 189:f392fc9709a3 864 #define IS_RTC_HOUR24(HOUR) ((HOUR) <= (uint32_t)23U)
AnnaBridge 189:f392fc9709a3 865
AnnaBridge 189:f392fc9709a3 866 #define IS_RTC_MINUTES(MINUTES) ((MINUTES) <= (uint32_t)59U)
AnnaBridge 189:f392fc9709a3 867
AnnaBridge 189:f392fc9709a3 868 #define IS_RTC_SECONDS(SECONDS) ((SECONDS) <= (uint32_t)59U)
AnnaBridge 189:f392fc9709a3 869
AnnaBridge 189:f392fc9709a3 870 /**
AnnaBridge 189:f392fc9709a3 871 * @}
AnnaBridge 189:f392fc9709a3 872 */
AnnaBridge 189:f392fc9709a3 873
AnnaBridge 189:f392fc9709a3 874 /**
AnnaBridge 189:f392fc9709a3 875 * @}
AnnaBridge 189:f392fc9709a3 876 */
AnnaBridge 189:f392fc9709a3 877
AnnaBridge 189:f392fc9709a3 878 /* Private functions -------------------------------------------------------------*/
AnnaBridge 189:f392fc9709a3 879 /** @defgroup RTC_Private_Functions RTC Private Functions
AnnaBridge 189:f392fc9709a3 880 * @{
AnnaBridge 189:f392fc9709a3 881 */
AnnaBridge 189:f392fc9709a3 882 HAL_StatusTypeDef RTC_EnterInitMode(RTC_HandleTypeDef* hrtc);
AnnaBridge 189:f392fc9709a3 883 uint8_t RTC_ByteToBcd2(uint8_t Value);
AnnaBridge 189:f392fc9709a3 884 uint8_t RTC_Bcd2ToByte(uint8_t Value);
AnnaBridge 189:f392fc9709a3 885 /**
AnnaBridge 189:f392fc9709a3 886 * @}
AnnaBridge 189:f392fc9709a3 887 */
AnnaBridge 189:f392fc9709a3 888
AnnaBridge 189:f392fc9709a3 889
AnnaBridge 189:f392fc9709a3 890 /**
AnnaBridge 189:f392fc9709a3 891 * @}
AnnaBridge 189:f392fc9709a3 892 */
AnnaBridge 189:f392fc9709a3 893
AnnaBridge 189:f392fc9709a3 894 /**
AnnaBridge 189:f392fc9709a3 895 * @}
AnnaBridge 189:f392fc9709a3 896 */
AnnaBridge 189:f392fc9709a3 897
AnnaBridge 189:f392fc9709a3 898 #ifdef __cplusplus
AnnaBridge 189:f392fc9709a3 899 }
AnnaBridge 189:f392fc9709a3 900 #endif
AnnaBridge 189:f392fc9709a3 901
AnnaBridge 189:f392fc9709a3 902 #endif /* __STM32L0xx_HAL_RTC_H */
AnnaBridge 189:f392fc9709a3 903
AnnaBridge 189:f392fc9709a3 904 /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/
AnnaBridge 189:f392fc9709a3 905