The official Mbed 2 C/C++ SDK provides the software platform and libraries to build your applications.

Dependents:   hello SerialTestv11 SerialTestv12 Sierpinski ... more

mbed 2

This is the mbed 2 library. If you'd like to learn about Mbed OS please see the mbed-os docs.

Committer:
AnnaBridge
Date:
Thu Nov 08 11:45:42 2018 +0000
Revision:
171:3a7713b1edbc
Parent:
TARGET_NUCLEO_L011K4/TARGET_STM/TARGET_STM32L0/device/stm32l0xx_hal_rtc.h@167:84c0a372a020
Child:
172:65be27845400
mbed library. Release version 164

Who changed what in which revision?

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