Jhon Plantikow / mbed

.

Dependents:   RTC

TARGET_NUCLEO_F072RB/stm32f0xx_hal_pwr.h@0:88e313c910d0, 2015-08-13 (annotated)

Committer:
jhon309
Date:
Thu Aug 13 00:20:09 2015 +0000
Revision:
0:88e313c910d0
RTC Example

Who changed what in which revision?

UserRevisionLine numberNew contents of line
jhon309 0:88e313c910d0 1 /**
jhon309 0:88e313c910d0 2 ******************************************************************************
jhon309 0:88e313c910d0 3 * @file stm32f0xx_hal_pwr.h
jhon309 0:88e313c910d0 4 * @author MCD Application Team
jhon309 0:88e313c910d0 5 * @version V1.2.0
jhon309 0:88e313c910d0 6 * @date 11-December-2014
jhon309 0:88e313c910d0 7 * @brief Header file of PWR HAL module.
jhon309 0:88e313c910d0 8 ******************************************************************************
jhon309 0:88e313c910d0 9 * @attention
jhon309 0:88e313c910d0 10 *
jhon309 0:88e313c910d0 11 * <h2><center>&copy; COPYRIGHT(c) 2014 STMicroelectronics</center></h2>
jhon309 0:88e313c910d0 12 *
jhon309 0:88e313c910d0 13 * Redistribution and use in source and binary forms, with or without modification,
jhon309 0:88e313c910d0 14 * are permitted provided that the following conditions are met:
jhon309 0:88e313c910d0 15 * 1. Redistributions of source code must retain the above copyright notice,
jhon309 0:88e313c910d0 16 * this list of conditions and the following disclaimer.
jhon309 0:88e313c910d0 17 * 2. Redistributions in binary form must reproduce the above copyright notice,
jhon309 0:88e313c910d0 18 * this list of conditions and the following disclaimer in the documentation
jhon309 0:88e313c910d0 19 * and/or other materials provided with the distribution.
jhon309 0:88e313c910d0 20 * 3. Neither the name of STMicroelectronics nor the names of its contributors
jhon309 0:88e313c910d0 21 * may be used to endorse or promote products derived from this software
jhon309 0:88e313c910d0 22 * without specific prior written permission.
jhon309 0:88e313c910d0 23 *
jhon309 0:88e313c910d0 24 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
jhon309 0:88e313c910d0 25 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
jhon309 0:88e313c910d0 26 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
jhon309 0:88e313c910d0 27 * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
jhon309 0:88e313c910d0 28 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
jhon309 0:88e313c910d0 29 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
jhon309 0:88e313c910d0 30 * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
jhon309 0:88e313c910d0 31 * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
jhon309 0:88e313c910d0 32 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
jhon309 0:88e313c910d0 33 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
jhon309 0:88e313c910d0 34 *
jhon309 0:88e313c910d0 35 ******************************************************************************
jhon309 0:88e313c910d0 36 */
jhon309 0:88e313c910d0 37
jhon309 0:88e313c910d0 38 /* Define to prevent recursive inclusion -------------------------------------*/
jhon309 0:88e313c910d0 39 #ifndef __STM32F0xx_HAL_PWR_H
jhon309 0:88e313c910d0 40 #define __STM32F0xx_HAL_PWR_H
jhon309 0:88e313c910d0 41
jhon309 0:88e313c910d0 42 #ifdef __cplusplus
jhon309 0:88e313c910d0 43 extern "C" {
jhon309 0:88e313c910d0 44 #endif
jhon309 0:88e313c910d0 45
jhon309 0:88e313c910d0 46 /* Includes ------------------------------------------------------------------*/
jhon309 0:88e313c910d0 47 #include "stm32f0xx_hal_def.h"
jhon309 0:88e313c910d0 48
jhon309 0:88e313c910d0 49 /** @addtogroup STM32F0xx_HAL_Driver
jhon309 0:88e313c910d0 50 * @{
jhon309 0:88e313c910d0 51 */
jhon309 0:88e313c910d0 52
jhon309 0:88e313c910d0 53 /** @addtogroup PWR PWR HAL module Driver
jhon309 0:88e313c910d0 54 * @{
jhon309 0:88e313c910d0 55 */
jhon309 0:88e313c910d0 56
jhon309 0:88e313c910d0 57 /* Exported types ------------------------------------------------------------*/
jhon309 0:88e313c910d0 58 /* Exported constants --------------------------------------------------------*/
jhon309 0:88e313c910d0 59
jhon309 0:88e313c910d0 60 /** @defgroup PWR_Exported_Constants PWR Exported Constants
jhon309 0:88e313c910d0 61 * @{
jhon309 0:88e313c910d0 62 */
jhon309 0:88e313c910d0 63
jhon309 0:88e313c910d0 64 /** @defgroup PWR_Regulator_state_in_STOP_mode PWR Regulator state in STOP mode
jhon309 0:88e313c910d0 65 * @{
jhon309 0:88e313c910d0 66 */
jhon309 0:88e313c910d0 67 #define PWR_MAINREGULATOR_ON ((uint32_t)0x00000000)
jhon309 0:88e313c910d0 68 #define PWR_LOWPOWERREGULATOR_ON PWR_CR_LPDS
jhon309 0:88e313c910d0 69
jhon309 0:88e313c910d0 70 #define IS_PWR_REGULATOR(REGULATOR) (((REGULATOR) == PWR_MAINREGULATOR_ON) || \
jhon309 0:88e313c910d0 71 ((REGULATOR) == PWR_LOWPOWERREGULATOR_ON))
jhon309 0:88e313c910d0 72 /**
jhon309 0:88e313c910d0 73 * @}
jhon309 0:88e313c910d0 74 */
jhon309 0:88e313c910d0 75
jhon309 0:88e313c910d0 76 /** @defgroup PWR_SLEEP_mode_entry PWR SLEEP mode entry
jhon309 0:88e313c910d0 77 * @{
jhon309 0:88e313c910d0 78 */
jhon309 0:88e313c910d0 79 #define PWR_SLEEPENTRY_WFI ((uint8_t)0x01)
jhon309 0:88e313c910d0 80 #define PWR_SLEEPENTRY_WFE ((uint8_t)0x02)
jhon309 0:88e313c910d0 81 #define IS_PWR_SLEEP_ENTRY(ENTRY) (((ENTRY) == PWR_SLEEPENTRY_WFI) || ((ENTRY) == PWR_SLEEPENTRY_WFE))
jhon309 0:88e313c910d0 82 /**
jhon309 0:88e313c910d0 83 * @}
jhon309 0:88e313c910d0 84 */
jhon309 0:88e313c910d0 85
jhon309 0:88e313c910d0 86 /** @defgroup PWR_STOP_mode_entry PWR STOP mode entry
jhon309 0:88e313c910d0 87 * @{
jhon309 0:88e313c910d0 88 */
jhon309 0:88e313c910d0 89 #define PWR_STOPENTRY_WFI ((uint8_t)0x01)
jhon309 0:88e313c910d0 90 #define PWR_STOPENTRY_WFE ((uint8_t)0x02)
jhon309 0:88e313c910d0 91 #define IS_PWR_STOP_ENTRY(ENTRY) (((ENTRY) == PWR_STOPENTRY_WFI) || ((ENTRY) == PWR_STOPENTRY_WFE))
jhon309 0:88e313c910d0 92 /**
jhon309 0:88e313c910d0 93 * @}
jhon309 0:88e313c910d0 94 */
jhon309 0:88e313c910d0 95
jhon309 0:88e313c910d0 96
jhon309 0:88e313c910d0 97 /**
jhon309 0:88e313c910d0 98 * @}
jhon309 0:88e313c910d0 99 */
jhon309 0:88e313c910d0 100
jhon309 0:88e313c910d0 101 /* Exported macro ------------------------------------------------------------*/
jhon309 0:88e313c910d0 102 /** @defgroup PWR_Exported_Macro PWR Exported Macro
jhon309 0:88e313c910d0 103 * @{
jhon309 0:88e313c910d0 104 */
jhon309 0:88e313c910d0 105
jhon309 0:88e313c910d0 106 /** @brief Check PWR flag is set or not.
jhon309 0:88e313c910d0 107 * @param __FLAG__: specifies the flag to check.
jhon309 0:88e313c910d0 108 * This parameter can be one of the following values:
jhon309 0:88e313c910d0 109 * @arg PWR_FLAG_WU: Wake Up flag. This flag indicates that a wakeup event
jhon309 0:88e313c910d0 110 * was received from the WKUP pin or from the RTC alarm (Alarm A),
jhon309 0:88e313c910d0 111 * RTC Tamper event, RTC TimeStamp event or RTC Wakeup.
jhon309 0:88e313c910d0 112 * An additional wakeup event is detected if the WKUP pin is enabled
jhon309 0:88e313c910d0 113 * (by setting the EWUP bit) when the WKUP pin level is already high.
jhon309 0:88e313c910d0 114 * @arg PWR_FLAG_SB: StandBy flag. This flag indicates that the system was
jhon309 0:88e313c910d0 115 * resumed from StandBy mode.
jhon309 0:88e313c910d0 116 * @arg PWR_FLAG_PVDO: PVD Output. This flag is valid only if PVD is enabled
jhon309 0:88e313c910d0 117 * by the HAL_PWR_EnablePVD() function. The PVD is stopped by Standby mode
jhon309 0:88e313c910d0 118 * For this reason, this bit is equal to 0 after Standby or reset
jhon309 0:88e313c910d0 119 * until the PVDE bit is set.
jhon309 0:88e313c910d0 120 * Warning: this Flag is not available on STM32F030x8 products
jhon309 0:88e313c910d0 121 * @arg PWR_FLAG_VREFINTRDY: This flag indicates that the internal reference
jhon309 0:88e313c910d0 122 * voltage VREFINT is ready.
jhon309 0:88e313c910d0 123 * Warning: this Flag is not available on STM32F030x8 products
jhon309 0:88e313c910d0 124 * @retval The new state of __FLAG__ (TRUE or FALSE).
jhon309 0:88e313c910d0 125 */
jhon309 0:88e313c910d0 126 #define __HAL_PWR_GET_FLAG(__FLAG__) ((PWR->CSR & (__FLAG__)) == (__FLAG__))
jhon309 0:88e313c910d0 127
jhon309 0:88e313c910d0 128 /** @brief Clear the PWR's pending flags.
jhon309 0:88e313c910d0 129 * @param __FLAG__: specifies the flag to clear.
jhon309 0:88e313c910d0 130 * This parameter can be one of the following values:
jhon309 0:88e313c910d0 131 * @arg PWR_FLAG_WU: Wake Up flag
jhon309 0:88e313c910d0 132 * @arg PWR_FLAG_SB: StandBy flag
jhon309 0:88e313c910d0 133 */
jhon309 0:88e313c910d0 134 #define __HAL_PWR_CLEAR_FLAG(__FLAG__) (PWR->CR |= (__FLAG__) << 2)
jhon309 0:88e313c910d0 135
jhon309 0:88e313c910d0 136
jhon309 0:88e313c910d0 137 /**
jhon309 0:88e313c910d0 138 * @}
jhon309 0:88e313c910d0 139 */
jhon309 0:88e313c910d0 140
jhon309 0:88e313c910d0 141 /* Include PWR HAL Extension module */
jhon309 0:88e313c910d0 142 #include "stm32f0xx_hal_pwr_ex.h"
jhon309 0:88e313c910d0 143
jhon309 0:88e313c910d0 144 /* Exported functions --------------------------------------------------------*/
jhon309 0:88e313c910d0 145
jhon309 0:88e313c910d0 146 /** @addtogroup PWR_Exported_Functions PWR Exported Functions
jhon309 0:88e313c910d0 147 * @{
jhon309 0:88e313c910d0 148 */
jhon309 0:88e313c910d0 149
jhon309 0:88e313c910d0 150 /** @addtogroup PWR_Exported_Functions_Group1 Initialization and de-initialization functions
jhon309 0:88e313c910d0 151 * @{
jhon309 0:88e313c910d0 152 */
jhon309 0:88e313c910d0 153
jhon309 0:88e313c910d0 154 /* Initialization and de-initialization functions *****************************/
jhon309 0:88e313c910d0 155 void HAL_PWR_DeInit(void);
jhon309 0:88e313c910d0 156
jhon309 0:88e313c910d0 157 /**
jhon309 0:88e313c910d0 158 * @}
jhon309 0:88e313c910d0 159 */
jhon309 0:88e313c910d0 160
jhon309 0:88e313c910d0 161 /** @addtogroup PWR_Exported_Functions_Group2 Peripheral Control functions
jhon309 0:88e313c910d0 162 * @{
jhon309 0:88e313c910d0 163 */
jhon309 0:88e313c910d0 164
jhon309 0:88e313c910d0 165 /* Peripheral Control functions **********************************************/
jhon309 0:88e313c910d0 166 void HAL_PWR_EnableBkUpAccess(void);
jhon309 0:88e313c910d0 167 void HAL_PWR_DisableBkUpAccess(void);
jhon309 0:88e313c910d0 168
jhon309 0:88e313c910d0 169 /* WakeUp pins configuration functions ****************************************/
jhon309 0:88e313c910d0 170 void HAL_PWR_EnableWakeUpPin(uint32_t WakeUpPinx);
jhon309 0:88e313c910d0 171 void HAL_PWR_DisableWakeUpPin(uint32_t WakeUpPinx);
jhon309 0:88e313c910d0 172
jhon309 0:88e313c910d0 173 /* Low Power modes configuration functions ************************************/
jhon309 0:88e313c910d0 174 void HAL_PWR_EnterSTOPMode(uint32_t Regulator, uint8_t STOPEntry);
jhon309 0:88e313c910d0 175 void HAL_PWR_EnterSLEEPMode(uint32_t Regulator, uint8_t SLEEPEntry);
jhon309 0:88e313c910d0 176 void HAL_PWR_EnterSTANDBYMode(void);
jhon309 0:88e313c910d0 177
jhon309 0:88e313c910d0 178 void HAL_PWR_EnableSleepOnExit(void);
jhon309 0:88e313c910d0 179 void HAL_PWR_DisableSleepOnExit(void);
jhon309 0:88e313c910d0 180 void HAL_PWR_EnableSEVOnPend(void);
jhon309 0:88e313c910d0 181 void HAL_PWR_DisableSEVOnPend(void);
jhon309 0:88e313c910d0 182
jhon309 0:88e313c910d0 183 /**
jhon309 0:88e313c910d0 184 * @}
jhon309 0:88e313c910d0 185 */
jhon309 0:88e313c910d0 186
jhon309 0:88e313c910d0 187 /**
jhon309 0:88e313c910d0 188 * @}
jhon309 0:88e313c910d0 189 */
jhon309 0:88e313c910d0 190
jhon309 0:88e313c910d0 191 /**
jhon309 0:88e313c910d0 192 * @}
jhon309 0:88e313c910d0 193 */
jhon309 0:88e313c910d0 194
jhon309 0:88e313c910d0 195 /**
jhon309 0:88e313c910d0 196 * @}
jhon309 0:88e313c910d0 197 */
jhon309 0:88e313c910d0 198
jhon309 0:88e313c910d0 199 #ifdef __cplusplus
jhon309 0:88e313c910d0 200 }
jhon309 0:88e313c910d0 201 #endif
jhon309 0:88e313c910d0 202
jhon309 0:88e313c910d0 203
jhon309 0:88e313c910d0 204 #endif /* __STM32F0xx_HAL_PWR_H */
jhon309 0:88e313c910d0 205
jhon309 0:88e313c910d0 206 /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/
jhon309 0:88e313c910d0 207