Fork of the official mbed C/C SDK provides the software platform and libraries to build your applications for RenBED.

Dependents:   1-RenBuggyTimed RenBED_RGB RenBED_RGB_PWM RenBED_RGB

Fork of mbed by mbed official

Committer:
elijahorr
Date:
Thu Apr 14 07:28:54 2016 +0000
Revision:
121:672067c3ada4
Parent:
110:165afa46840b
.

Who changed what in which revision?

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