mbed library sources

Dependents:   Encrypted my_mbed lklk CyaSSL_DTLS_Cellular ... more

Superseded

This library was superseded by mbed-dev - https://os.mbed.com/users/mbed_official/code/mbed-dev/.

Development branch of the mbed library sources. This library is kept in synch with the latest changes from the mbed SDK and it is not guaranteed to work.

If you are looking for a stable and tested release, please import one of the official mbed library releases:

Import librarymbed

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

Committer:
mbed_official
Date:
Wed Aug 06 08:15:07 2014 +0100
Revision:
274:6937b19af361
Parent:
226:b062af740e40
Child:
369:2e96f1b71984
Synchronized with git revision 5b145e4f6c509376173c3ea2aa35a6da879a2124

Full URL: https://github.com/mbedmicro/mbed/commit/5b145e4f6c509376173c3ea2aa35a6da879a2124/

[TARGET_LPC11UXX] PeripheralNames.h and PinMap definitions separation for LPC11UXX platforms

Who changed what in which revision?

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