mbed official / mbed-src

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.

Last commit 20 Feb 2019 by mbed official

targets/cmsis/TARGET_STM/TARGET_STM32L0/stm32l0xx_hal_pwr.c@579:53297373a894, 2015-07-01 (annotated)

Committer:
mbed_official
Date:
Wed Jul 01 09:45:11 2015 +0100
Revision:
579:53297373a894
Parent:
489:119543c9f674 
Synchronized with git revision d5b4d2ab9c47edb4dc5776e7177b0c2263459081



Full URL: https://github.com/mbedmicro/mbed/commit/d5b4d2ab9c47edb4dc5776e7177b0c2263459081/



Initial version of drivers for SAMR21

Who changed what in which revision?

UserRevisionLine numberNew contents of line
mbed_official 376:cb4d9db17537 1 /**
mbed_official 376:cb4d9db17537 2 ******************************************************************************
mbed_official 376:cb4d9db17537 3 * @file stm32l0xx_hal_pwr.c
mbed_official 376:cb4d9db17537 4 * @author MCD Application Team
mbed_official 489:119543c9f674 5 * @version V1.2.0
mbed_official 489:119543c9f674 6 * @date 06-February-2015
mbed_official 376:cb4d9db17537 7 * @brief PWR HAL module driver.
mbed_official 376:cb4d9db17537 8 *
mbed_official 376:cb4d9db17537 9 * This file provides firmware functions to manage the following
mbed_official 376:cb4d9db17537 10 * functionalities of the Power Controller (PWR) peripheral:
mbed_official 376:cb4d9db17537 11 * + Initialization/de-initialization functions
mbed_official 376:cb4d9db17537 12 * + Peripheral Control functions
mbed_official 376:cb4d9db17537 13 *
mbed_official 376:cb4d9db17537 14 ******************************************************************************
mbed_official 376:cb4d9db17537 15 * @attention
mbed_official 376:cb4d9db17537 16 *
mbed_official 489:119543c9f674 17 * <h2><center>&copy; COPYRIGHT(c) 2015 STMicroelectronics</center></h2>
mbed_official 376:cb4d9db17537 18 *
mbed_official 376:cb4d9db17537 19 * Redistribution and use in source and binary forms, with or without modification,
mbed_official 376:cb4d9db17537 20 * are permitted provided that the following conditions are met:
mbed_official 376:cb4d9db17537 21 * 1. Redistributions of source code must retain the above copyright notice,
mbed_official 376:cb4d9db17537 22 * this list of conditions and the following disclaimer.
mbed_official 376:cb4d9db17537 23 * 2. Redistributions in binary form must reproduce the above copyright notice,
mbed_official 376:cb4d9db17537 24 * this list of conditions and the following disclaimer in the documentation
mbed_official 376:cb4d9db17537 25 * and/or other materials provided with the distribution.
mbed_official 376:cb4d9db17537 26 * 3. Neither the name of STMicroelectronics nor the names of its contributors
mbed_official 376:cb4d9db17537 27 * may be used to endorse or promote products derived from this software
mbed_official 376:cb4d9db17537 28 * without specific prior written permission.
mbed_official 376:cb4d9db17537 29 *
mbed_official 376:cb4d9db17537 30 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
mbed_official 376:cb4d9db17537 31 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
mbed_official 376:cb4d9db17537 32 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
mbed_official 376:cb4d9db17537 33 * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
mbed_official 376:cb4d9db17537 34 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
mbed_official 376:cb4d9db17537 35 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
mbed_official 376:cb4d9db17537 36 * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
mbed_official 376:cb4d9db17537 37 * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
mbed_official 376:cb4d9db17537 38 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
mbed_official 376:cb4d9db17537 39 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
mbed_official 376:cb4d9db17537 40 *
mbed_official 376:cb4d9db17537 41 ******************************************************************************
mbed_official 376:cb4d9db17537 42 */
mbed_official 376:cb4d9db17537 43
mbed_official 376:cb4d9db17537 44 /* Includes ------------------------------------------------------------------*/
mbed_official 376:cb4d9db17537 45 #include "stm32l0xx_hal.h"
mbed_official 376:cb4d9db17537 46
mbed_official 489:119543c9f674 47 #ifdef HAL_PWR_MODULE_ENABLED
mbed_official 376:cb4d9db17537 48 /** @addtogroup STM32L0xx_HAL_Driver
mbed_official 376:cb4d9db17537 49 * @{
mbed_official 376:cb4d9db17537 50 */
mbed_official 376:cb4d9db17537 51
mbed_official 489:119543c9f674 52 /** @addtogroup PWR
mbed_official 376:cb4d9db17537 53 * @{
mbed_official 376:cb4d9db17537 54 */
mbed_official 376:cb4d9db17537 55
mbed_official 489:119543c9f674 56 /** @addtogroup PWR_Private_Defines
mbed_official 489:119543c9f674 57 * @{
mbed_official 489:119543c9f674 58 */
mbed_official 489:119543c9f674 59
mbed_official 489:119543c9f674 60 /** @defgroup PWR_PVD_Mode_Mask PWR PVD Mode Mask
mbed_official 489:119543c9f674 61 * @{
mbed_official 489:119543c9f674 62 */
mbed_official 489:119543c9f674 63 #define PVD_MODE_IT ((uint32_t)0x00010000)
mbed_official 489:119543c9f674 64 #define PVD_MODE_EVT ((uint32_t)0x00020000)
mbed_official 489:119543c9f674 65 #define PVD_RISING_EDGE ((uint32_t)0x00000001)
mbed_official 489:119543c9f674 66 #define PVD_FALLING_EDGE ((uint32_t)0x00000002)
mbed_official 489:119543c9f674 67 /**
mbed_official 489:119543c9f674 68 * @}
mbed_official 489:119543c9f674 69 */
mbed_official 376:cb4d9db17537 70
mbed_official 489:119543c9f674 71 /**
mbed_official 489:119543c9f674 72 * @}
mbed_official 489:119543c9f674 73 */
mbed_official 489:119543c9f674 74
mbed_official 376:cb4d9db17537 75
mbed_official 489:119543c9f674 76 /** @addtogroup PWR_Exported_Functions
mbed_official 376:cb4d9db17537 77 * @{
mbed_official 376:cb4d9db17537 78 */
mbed_official 376:cb4d9db17537 79
mbed_official 489:119543c9f674 80 /** @addtogroup PWR_Exported_Functions_Group1
mbed_official 489:119543c9f674 81 * @brief Initialization and de-initialization functions
mbed_official 376:cb4d9db17537 82 *
mbed_official 376:cb4d9db17537 83 @verbatim
mbed_official 376:cb4d9db17537 84 ===============================================================================
mbed_official 376:cb4d9db17537 85 ##### Initialization and de-initialization functions #####
mbed_official 376:cb4d9db17537 86 ===============================================================================
mbed_official 376:cb4d9db17537 87
mbed_official 376:cb4d9db17537 88 @endverbatim
mbed_official 376:cb4d9db17537 89 * @{
mbed_official 376:cb4d9db17537 90 */
mbed_official 376:cb4d9db17537 91
mbed_official 376:cb4d9db17537 92 /**
mbed_official 376:cb4d9db17537 93 * @brief Deinitializes the HAL PWR peripheral registers to their default reset values.
mbed_official 376:cb4d9db17537 94 * @retval None
mbed_official 376:cb4d9db17537 95 */
mbed_official 376:cb4d9db17537 96 void HAL_PWR_DeInit(void)
mbed_official 376:cb4d9db17537 97 {
mbed_official 489:119543c9f674 98 __HAL_RCC_PWR_FORCE_RESET();
mbed_official 489:119543c9f674 99 __HAL_RCC_PWR_RELEASE_RESET();
mbed_official 376:cb4d9db17537 100 }
mbed_official 376:cb4d9db17537 101
mbed_official 376:cb4d9db17537 102 /**
mbed_official 376:cb4d9db17537 103 * @}
mbed_official 376:cb4d9db17537 104 */
mbed_official 376:cb4d9db17537 105
mbed_official 489:119543c9f674 106 /** @addtogroup PWR_Exported_Functions_Group2
mbed_official 489:119543c9f674 107 * @brief Low Power modes configuration functions
mbed_official 376:cb4d9db17537 108 *
mbed_official 376:cb4d9db17537 109 @verbatim
mbed_official 376:cb4d9db17537 110
mbed_official 376:cb4d9db17537 111 ===============================================================================
mbed_official 376:cb4d9db17537 112 ##### Peripheral Control functions #####
mbed_official 376:cb4d9db17537 113 ===============================================================================
mbed_official 376:cb4d9db17537 114
mbed_official 489:119543c9f674 115 *** Backup domain ***
mbed_official 489:119543c9f674 116 =========================
mbed_official 489:119543c9f674 117 [..]
mbed_official 489:119543c9f674 118 After reset, the backup domain (RTC registers, RTC backup data
mbed_official 489:119543c9f674 119 registers) is protected against possible unwanted
mbed_official 489:119543c9f674 120 write accesses.
mbed_official 489:119543c9f674 121 To enable access to the RTC Domain and RTC registers, proceed as follows:
mbed_official 489:119543c9f674 122 (+) Enable the Power Controller (PWR) APB1 interface clock using the
mbed_official 489:119543c9f674 123 __HAL_RCC_PWR_CLK_ENABLE() macro.
mbed_official 489:119543c9f674 124 (+) Enable access to RTC domain using the HAL_PWR_EnableBkUpAccess() function.
mbed_official 489:119543c9f674 125
mbed_official 376:cb4d9db17537 126 *** PVD configuration ***
mbed_official 376:cb4d9db17537 127 =========================
mbed_official 376:cb4d9db17537 128 [..]
mbed_official 376:cb4d9db17537 129 (+) The PVD is used to monitor the VDD power supply by comparing it to a
mbed_official 376:cb4d9db17537 130 threshold selected by the PVD Level (PLS[2:0] bits in the PWR_CR).
mbed_official 376:cb4d9db17537 131 (+) The PVD can use an external input analog voltage (PVD_IN) which is compared
mbed_official 376:cb4d9db17537 132 internally to VREFINT. The PVD_IN (PB7) has to be configured in Analog mode
mbed_official 376:cb4d9db17537 133 when PWR_PVDLevel_7 is selected (PLS[2:0] = 111).
mbed_official 376:cb4d9db17537 134
mbed_official 376:cb4d9db17537 135 (+) A PVDO flag is available to indicate if VDD/VDDA is higher or lower
mbed_official 376:cb4d9db17537 136 than the PVD threshold. This event is internally connected to the EXTI
mbed_official 376:cb4d9db17537 137 line16 and can generate an interrupt if enabled. This is done through
mbed_official 489:119543c9f674 138 __HAL_PWR_PVD_EXTI_ENABLE_IT() macro.
mbed_official 376:cb4d9db17537 139 (+) The PVD is stopped in Standby mode.
mbed_official 376:cb4d9db17537 140
mbed_official 376:cb4d9db17537 141 *** WakeUp pin configuration ***
mbed_official 376:cb4d9db17537 142 ================================
mbed_official 376:cb4d9db17537 143 [..]
mbed_official 376:cb4d9db17537 144 (+) WakeUp pin is used to wake up the system from Standby mode. This pin is
mbed_official 376:cb4d9db17537 145 forced in input pull-down configuration and is active on rising edges.
mbed_official 376:cb4d9db17537 146 (+) There are two WakeUp pins:
mbed_official 376:cb4d9db17537 147 WakeUp Pin 1 on PA.00.
mbed_official 376:cb4d9db17537 148 WakeUp Pin 2 on PC.13.
mbed_official 489:119543c9f674 149 WakeUp Pin 3 on PE.06 .
mbed_official 489:119543c9f674 150
mbed_official 376:cb4d9db17537 151
mbed_official 376:cb4d9db17537 152 [..]
mbed_official 376:cb4d9db17537 153 *** Main and Backup Regulators configuration ***
mbed_official 376:cb4d9db17537 154 ================================================
mbed_official 376:cb4d9db17537 155
mbed_official 376:cb4d9db17537 156 (+) The main internal regulator can be configured to have a tradeoff between
mbed_official 376:cb4d9db17537 157 performance and power consumption when the device does not operate at
mbed_official 376:cb4d9db17537 158 the maximum frequency. This is done through __HAL_PWR_VOLTAGESCALING_CONFIG()
mbed_official 489:119543c9f674 159 macro which configures the two VOS bits in PWR_CR register:
mbed_official 489:119543c9f674 160 (++) PWR_REGULATOR_VOLTAGE_SCALE1 (VOS bits = 01), the regulator voltage output Scale 1 mode selected and
mbed_official 376:cb4d9db17537 161 the System frequency can go up to 32 MHz.
mbed_official 489:119543c9f674 162 (++) PWR_REGULATOR_VOLTAGE_SCALE2 (VOS bits = 10), the regulator voltage output Scale 2 mode selected and
mbed_official 376:cb4d9db17537 163 the System frequency can go up to 16 MHz.
mbed_official 489:119543c9f674 164 (++) PWR_REGULATOR_VOLTAGE_SCALE3 (VOS bits = 11), the regulator voltage output Scale 3 mode selected and
mbed_official 376:cb4d9db17537 165 the System frequency can go up to 4.2 MHz.
mbed_official 376:cb4d9db17537 166
mbed_official 376:cb4d9db17537 167 Refer to the datasheets for more details.
mbed_official 376:cb4d9db17537 168
mbed_official 376:cb4d9db17537 169 *** Low Power modes configuration ***
mbed_official 376:cb4d9db17537 170 =====================================
mbed_official 376:cb4d9db17537 171 [..]
mbed_official 376:cb4d9db17537 172 The device features 5 low-power modes:
mbed_official 376:cb4d9db17537 173 (+) Low power run mode: regulator in low power mode, limited clock frequency,
mbed_official 376:cb4d9db17537 174 limited number of peripherals running.
mbed_official 376:cb4d9db17537 175 (+) Sleep mode: Cortex-M0+ core stopped, peripherals kept running.
mbed_official 376:cb4d9db17537 176 (+) Low power sleep mode: Cortex-M0+ core stopped, limited clock frequency,
mbed_official 376:cb4d9db17537 177 limited number of peripherals running, regulator in low power mode.
mbed_official 376:cb4d9db17537 178 (+) Stop mode: All clocks are stopped, regulator running, regulator in low power mode.
mbed_official 376:cb4d9db17537 179 (+) Standby mode: VCORE domain powered off
mbed_official 376:cb4d9db17537 180
mbed_official 376:cb4d9db17537 181 *** Low power run mode ***
mbed_official 376:cb4d9db17537 182 =========================
mbed_official 376:cb4d9db17537 183 [..]
mbed_official 376:cb4d9db17537 184 To further reduce the consumption when the system is in Run mode, the regulator can be
mbed_official 376:cb4d9db17537 185 configured in low power mode. In this mode, the system frequency should not exceed
mbed_official 376:cb4d9db17537 186 MSI frequency range1.
mbed_official 376:cb4d9db17537 187 In Low power run mode, all I/O pins keep the same state as in Run mode.
mbed_official 376:cb4d9db17537 188
mbed_official 376:cb4d9db17537 189 (+) Entry:
mbed_official 376:cb4d9db17537 190 (++) VCORE in range2
mbed_official 489:119543c9f674 191 (++) Decrease the system frequency not to exceed the frequency of MSI frequency range1.
mbed_official 376:cb4d9db17537 192 (++) The regulator is forced in low power mode using the HAL_PWREx_EnableLowPowerRunMode()
mbed_official 376:cb4d9db17537 193 function.
mbed_official 376:cb4d9db17537 194 (+) Exit:
mbed_official 376:cb4d9db17537 195 (++) The regulator is forced in Main regulator mode using the HAL_PWREx_DisableLowPowerRunMode()
mbed_official 376:cb4d9db17537 196 function.
mbed_official 376:cb4d9db17537 197 (++) Increase the system frequency if needed.
mbed_official 376:cb4d9db17537 198
mbed_official 376:cb4d9db17537 199 *** Sleep mode ***
mbed_official 376:cb4d9db17537 200 ==================
mbed_official 376:cb4d9db17537 201 [..]
mbed_official 376:cb4d9db17537 202 (+) Entry:
mbed_official 376:cb4d9db17537 203 The Sleep mode is entered by using the HAL_PWR_EnterSLEEPMode(PWR_MAINREGULATOR_ON, PWR_SLEEPENTRY_WFx)
mbed_official 376:cb4d9db17537 204 functions with
mbed_official 376:cb4d9db17537 205 (++) PWR_SLEEPENTRY_WFI: enter SLEEP mode with WFI instruction
mbed_official 376:cb4d9db17537 206 (++) PWR_SLEEPENTRY_WFE: enter SLEEP mode with WFE instruction
mbed_official 376:cb4d9db17537 207
mbed_official 376:cb4d9db17537 208 (+) Exit:
mbed_official 376:cb4d9db17537 209 (++) Any peripheral interrupt acknowledged by the nested vectored interrupt
mbed_official 489:119543c9f674 210 controller (NVIC) can wake up the device from Sleep mode. If the WFE instruction was used to enter sleep mode,
mbed_official 489:119543c9f674 211 the MCU exits Sleep mode as soon as an event occurs.
mbed_official 376:cb4d9db17537 212
mbed_official 376:cb4d9db17537 213 *** Low power sleep mode ***
mbed_official 376:cb4d9db17537 214 ============================
mbed_official 376:cb4d9db17537 215 [..]
mbed_official 376:cb4d9db17537 216 (+) Entry:
mbed_official 376:cb4d9db17537 217 The Low power sleep mode is entered by using the HAL_PWR_EnterSLEEPMode(PWR_LOWPOWERREGULATOR_ON, PWR_SLEEPENTRY_WFx)
mbed_official 376:cb4d9db17537 218 functions with
mbed_official 376:cb4d9db17537 219 (++) PWR_SLEEPENTRY_WFI: enter SLEEP mode with WFI instruction
mbed_official 376:cb4d9db17537 220 (++) PWR_SLEEPENTRY_WFE: enter SLEEP mode with WFE instruction
mbed_official 376:cb4d9db17537 221 (+) The Flash memory can be switched off by using the control bits (SLEEP_PD in the FLASH_ACR register.
mbed_official 376:cb4d9db17537 222 This reduces power consumption but increases the wake-up time.
mbed_official 376:cb4d9db17537 223
mbed_official 376:cb4d9db17537 224 (+) Exit:
mbed_official 376:cb4d9db17537 225 (++) If the WFI instruction was used to enter Low power sleep mode, any peripheral interrupt
mbed_official 376:cb4d9db17537 226 acknowledged by the nested vectored interrupt controller (NVIC) can wake up the device
mbed_official 376:cb4d9db17537 227 from Low power sleep mode. If the WFE instruction was used to enter Low power sleep mode,
mbed_official 376:cb4d9db17537 228 the MCU exits Sleep mode as soon as an event occurs.
mbed_official 376:cb4d9db17537 229
mbed_official 376:cb4d9db17537 230 *** Stop mode ***
mbed_official 376:cb4d9db17537 231 =================
mbed_official 376:cb4d9db17537 232 [..]
mbed_official 376:cb4d9db17537 233 The Stop mode is based on the Cortex-M0+ deepsleep mode combined with peripheral
mbed_official 376:cb4d9db17537 234 clock gating. The voltage regulator can be configured either in normal or low-power mode.
mbed_official 376:cb4d9db17537 235 In Stop mode, all clocks in the VCORE domain are stopped, the PLL, the MSI, the HSI and
mbed_official 376:cb4d9db17537 236 the HSE RC oscillators are disabled. Internal SRAM and register contents are preserved.
mbed_official 376:cb4d9db17537 237 To get the lowest consumption in Stop mode, the internal Flash memory also enters low
mbed_official 376:cb4d9db17537 238 power mode. When the Flash memory is in power-down mode, an additional startup delay is
mbed_official 376:cb4d9db17537 239 incurred when waking up from Stop mode.
mbed_official 376:cb4d9db17537 240 To minimize the consumption In Stop mode, VREFINT, the BOR, PVD, and temperature
mbed_official 376:cb4d9db17537 241 sensor can be switched off before entering Stop mode. They can be switched on again by
mbed_official 376:cb4d9db17537 242 software after exiting Stop mode using the ULP bit in the PWR_CR register.
mbed_official 376:cb4d9db17537 243 In Stop mode, all I/O pins keep the same state as in Run mode.
mbed_official 376:cb4d9db17537 244
mbed_official 376:cb4d9db17537 245 (+) Entry:
mbed_official 489:119543c9f674 246 The Stop mode is entered using the HAL_PWR_EnterSTOPMode
mbed_official 376:cb4d9db17537 247 function with:
mbed_official 376:cb4d9db17537 248 (++) Main regulator ON.
mbed_official 376:cb4d9db17537 249 (++) Low Power regulator ON.
mbed_official 376:cb4d9db17537 250 (++) PWR_SLEEPENTRY_WFI: enter SLEEP mode with WFI instruction
mbed_official 376:cb4d9db17537 251 (++) PWR_SLEEPENTRY_WFE: enter SLEEP mode with WFE instruction
mbed_official 376:cb4d9db17537 252 (+) Exit:
mbed_official 376:cb4d9db17537 253 (++) By issuing an interrupt or a wakeup event, the MSI or HSI16 RC
mbed_official 376:cb4d9db17537 254 oscillator is selected as system clock depending the bit STOPWUCK in the RCC_CFGR
mbed_official 376:cb4d9db17537 255 register
mbed_official 376:cb4d9db17537 256
mbed_official 376:cb4d9db17537 257 *** Standby mode ***
mbed_official 376:cb4d9db17537 258 ====================
mbed_official 376:cb4d9db17537 259 [..]
mbed_official 376:cb4d9db17537 260 The Standby mode allows to achieve the lowest power consumption. It is based on the
mbed_official 376:cb4d9db17537 261 Cortex-M0+ deepsleep mode, with the voltage regulator disabled. The VCORE domain is
mbed_official 376:cb4d9db17537 262 consequently powered off. The PLL, the MSI, the HSI oscillator and the HSE oscillator are
mbed_official 376:cb4d9db17537 263 also switched off. SRAM and register contents are lost except for the RTC registers, RTC
mbed_official 376:cb4d9db17537 264 backup registers and Standby circuitry.
mbed_official 376:cb4d9db17537 265
mbed_official 376:cb4d9db17537 266 To minimize the consumption In Standby mode, VREFINT, the BOR, PVD, and temperature
mbed_official 376:cb4d9db17537 267 sensor can be switched off before entering the Standby mode. They can be switched
mbed_official 376:cb4d9db17537 268 on again by software after exiting the Standby mode.
mbed_official 376:cb4d9db17537 269 function.
mbed_official 376:cb4d9db17537 270
mbed_official 376:cb4d9db17537 271 (+) Entry:
mbed_official 376:cb4d9db17537 272 (++) The Standby mode is entered using the HAL_PWR_EnterSTANDBYMode() function.
mbed_official 376:cb4d9db17537 273 (+) Exit:
mbed_official 376:cb4d9db17537 274 (++) WKUP pin rising edge, RTC alarm (Alarm A and Alarm B), RTC wakeup,
mbed_official 376:cb4d9db17537 275 tamper event, time-stamp event, external reset in NRST pin, IWDG reset.
mbed_official 376:cb4d9db17537 276
mbed_official 376:cb4d9db17537 277 *** Auto-wakeup (AWU) from low-power mode ***
mbed_official 376:cb4d9db17537 278 =============================================
mbed_official 376:cb4d9db17537 279 [..]
mbed_official 376:cb4d9db17537 280 The MCU can be woken up from low-power mode by an RTC Alarm event, an RTC
mbed_official 376:cb4d9db17537 281 Wakeup event, a tamper event, a time-stamp event, or a comparator event,
mbed_official 376:cb4d9db17537 282 without depending on an external interrupt (Auto-wakeup mode).
mbed_official 376:cb4d9db17537 283
mbed_official 376:cb4d9db17537 284 (+) RTC auto-wakeup (AWU) from the Stop mode
mbed_official 376:cb4d9db17537 285 (++) To wake up from the Stop mode with an RTC alarm event, it is necessary to:
mbed_official 376:cb4d9db17537 286 (+++) Configure the EXTI Line 17 to be sensitive to rising edges (Interrupt
mbed_official 376:cb4d9db17537 287 or Event modes) using the EXTI_Init() function.
mbed_official 376:cb4d9db17537 288 (+++) Enable the RTC Alarm Interrupt using the RTC_ITConfig() function
mbed_official 376:cb4d9db17537 289 (+++) Configure the RTC to generate the RTC alarm using the RTC_SetAlarm()
mbed_official 376:cb4d9db17537 290 and RTC_AlarmCmd() functions.
mbed_official 376:cb4d9db17537 291 (++) To wake up from the Stop mode with an RTC Tamper or time stamp event, it
mbed_official 376:cb4d9db17537 292 is necessary to:
mbed_official 376:cb4d9db17537 293 (+++) Configure the EXTI Line 19 to be sensitive to rising edges (Interrupt
mbed_official 376:cb4d9db17537 294 or Event modes) using the EXTI_Init() function.
mbed_official 376:cb4d9db17537 295 (+++) Enable the RTC Tamper or time stamp Interrupt using the RTC_ITConfig()
mbed_official 376:cb4d9db17537 296 function.
mbed_official 376:cb4d9db17537 297 (+++) Configure the RTC to detect the tamper or time stamp event using the
mbed_official 376:cb4d9db17537 298 RTC_TimeStampConfig(), RTC_TamperTriggerConfig() and RTC_TamperCmd()
mbed_official 376:cb4d9db17537 299 functions.
mbed_official 376:cb4d9db17537 300 (++) To wake up from the Stop mode with an RTC WakeUp event, it is necessary to:
mbed_official 376:cb4d9db17537 301 (+++) Configure the EXTI Line 20 to be sensitive to rising edges (Interrupt
mbed_official 376:cb4d9db17537 302 or Event modes) using the EXTI_Init() function.
mbed_official 376:cb4d9db17537 303 (+++) Enable the RTC WakeUp Interrupt using the RTC_ITConfig() function.
mbed_official 376:cb4d9db17537 304 (+++) Configure the RTC to generate the RTC WakeUp event using the RTC_WakeUpClockConfig(),
mbed_official 376:cb4d9db17537 305 RTC_SetWakeUpCounter() and RTC_WakeUpCmd() functions.
mbed_official 376:cb4d9db17537 306
mbed_official 376:cb4d9db17537 307 (+) RTC auto-wakeup (AWU) from the Standby mode
mbed_official 376:cb4d9db17537 308 (++) To wake up from the Standby mode with an RTC alarm event, it is necessary to:
mbed_official 376:cb4d9db17537 309 (+++) Enable the RTC Alarm Interrupt using the RTC_ITConfig() function.
mbed_official 376:cb4d9db17537 310 (+++) Configure the RTC to generate the RTC alarm using the RTC_SetAlarm()
mbed_official 376:cb4d9db17537 311 and RTC_AlarmCmd() functions.
mbed_official 376:cb4d9db17537 312 (++) To wake up from the Standby mode with an RTC Tamper or time stamp event, it
mbed_official 376:cb4d9db17537 313 is necessary to:
mbed_official 376:cb4d9db17537 314 (+++) Enable the RTC Tamper or time stamp Interrupt using the RTC_ITConfig()
mbed_official 376:cb4d9db17537 315 function.
mbed_official 376:cb4d9db17537 316 (+++) Configure the RTC to detect the tamper or time stamp event using the
mbed_official 376:cb4d9db17537 317 RTC_TimeStampConfig(), RTC_TamperTriggerConfig() and RTC_TamperCmd()
mbed_official 376:cb4d9db17537 318 functions.
mbed_official 376:cb4d9db17537 319 (++) To wake up from the Standby mode with an RTC WakeUp event, it is necessary to:
mbed_official 376:cb4d9db17537 320 (+++) Enable the RTC WakeUp Interrupt using the RTC_ITConfig() function
mbed_official 376:cb4d9db17537 321 (+++) Configure the RTC to generate the RTC WakeUp event using the RTC_WakeUpClockConfig(),
mbed_official 376:cb4d9db17537 322 RTC_SetWakeUpCounter() and RTC_WakeUpCmd() functions.
mbed_official 376:cb4d9db17537 323
mbed_official 376:cb4d9db17537 324 (+) Comparator auto-wakeup (AWU) from the Stop mode
mbed_official 376:cb4d9db17537 325 (++) To wake up from the Stop mode with an comparator 1 or comparator 2 wakeup
mbed_official 376:cb4d9db17537 326 event, it is necessary to:
mbed_official 376:cb4d9db17537 327 (+++) Configure the EXTI Line 21 for comparator 1 or EXTI Line 22 for comparator 2
mbed_official 376:cb4d9db17537 328 to be sensitive to to the selected edges (falling, rising or falling
mbed_official 376:cb4d9db17537 329 and rising) (Interrupt or Event modes) using the EXTI_Init() function.
mbed_official 376:cb4d9db17537 330 (+++) Configure the comparator to generate the event.
mbed_official 376:cb4d9db17537 331 @endverbatim
mbed_official 376:cb4d9db17537 332 * @{
mbed_official 376:cb4d9db17537 333 */
mbed_official 376:cb4d9db17537 334
mbed_official 376:cb4d9db17537 335 /**
mbed_official 489:119543c9f674 336 * @brief Enables access to the backup domain (RTC registers, RTC
mbed_official 489:119543c9f674 337 * backup data registers ).
mbed_official 489:119543c9f674 338 * @note If the HSE divided by 2, 4, 8 or 16 is used as the RTC clock, the
mbed_official 489:119543c9f674 339 * Backup Domain Access should be kept enabled.
mbed_official 489:119543c9f674 340 * @retval None
mbed_official 489:119543c9f674 341 */
mbed_official 489:119543c9f674 342 void HAL_PWR_EnableBkUpAccess(void)
mbed_official 489:119543c9f674 343 {
mbed_official 489:119543c9f674 344 /* Enable access to RTC and backup registers */
mbed_official 489:119543c9f674 345 SET_BIT(PWR->CR, PWR_CR_DBP);
mbed_official 489:119543c9f674 346 }
mbed_official 489:119543c9f674 347
mbed_official 489:119543c9f674 348 /**
mbed_official 489:119543c9f674 349 * @brief Disables access to the backup domain
mbed_official 489:119543c9f674 350 * @note Applies to RTC registers, RTC backup data registers.
mbed_official 489:119543c9f674 351 * @note If the HSE divided by 2, 4, 8 or 16 is used as the RTC clock, the
mbed_official 489:119543c9f674 352 * Backup Domain Access should be kept enabled.
mbed_official 489:119543c9f674 353 * @retval None
mbed_official 489:119543c9f674 354 */
mbed_official 489:119543c9f674 355 void HAL_PWR_DisableBkUpAccess(void)
mbed_official 489:119543c9f674 356 {
mbed_official 489:119543c9f674 357 /* Disable access to RTC and backup registers */
mbed_official 489:119543c9f674 358 CLEAR_BIT(PWR->CR, PWR_CR_DBP);
mbed_official 489:119543c9f674 359 }
mbed_official 489:119543c9f674 360
mbed_official 489:119543c9f674 361 /**
mbed_official 489:119543c9f674 362 * @brief Configures the voltage threshold detected by the Power Voltage Detector(PVD).
mbed_official 489:119543c9f674 363 * @param sConfigPVD: pointer to an PWR_PVDTypeDef structure that contains the configuration
mbed_official 489:119543c9f674 364 * information for the PVD.
mbed_official 489:119543c9f674 365 * @note Refer to the electrical characteristics of your device datasheet for
mbed_official 376:cb4d9db17537 366 * more details about the voltage threshold corresponding to each
mbed_official 376:cb4d9db17537 367 * detection level.
mbed_official 376:cb4d9db17537 368 * @retval None
mbed_official 376:cb4d9db17537 369 */
mbed_official 489:119543c9f674 370 void HAL_PWR_ConfigPVD(PWR_PVDTypeDef *sConfigPVD)
mbed_official 376:cb4d9db17537 371 {
mbed_official 376:cb4d9db17537 372 /* Check the parameters */
mbed_official 376:cb4d9db17537 373 assert_param(IS_PWR_PVD_LEVEL(sConfigPVD->PVDLevel));
mbed_official 489:119543c9f674 374 assert_param(IS_PWR_PVD_MODE(sConfigPVD->Mode));
mbed_official 376:cb4d9db17537 375
mbed_official 376:cb4d9db17537 376 /* Set PLS[7:5] bits according to PVDLevel value */
mbed_official 489:119543c9f674 377 MODIFY_REG(PWR->CR, PWR_CR_PLS, sConfigPVD->PVDLevel);
mbed_official 489:119543c9f674 378
mbed_official 489:119543c9f674 379 /* Clear any previous config. Keep it clear if no event or IT mode is selected */
mbed_official 489:119543c9f674 380 __HAL_PWR_PVD_EXTI_DISABLE_EVENT();
mbed_official 489:119543c9f674 381 __HAL_PWR_PVD_EXTI_DISABLE_IT();
mbed_official 489:119543c9f674 382 __HAL_PWR_PVD_EXTI_DISABLE_FALLING_EDGE();
mbed_official 489:119543c9f674 383 __HAL_PWR_PVD_EXTI_DISABLE_RISING_EDGE();
mbed_official 376:cb4d9db17537 384
mbed_official 489:119543c9f674 385 /* Configure interrupt mode */
mbed_official 489:119543c9f674 386 if((sConfigPVD->Mode & PVD_MODE_IT) == PVD_MODE_IT)
mbed_official 376:cb4d9db17537 387 {
mbed_official 489:119543c9f674 388 __HAL_PWR_PVD_EXTI_ENABLE_IT();
mbed_official 376:cb4d9db17537 389 }
mbed_official 376:cb4d9db17537 390
mbed_official 489:119543c9f674 391 /* Configure event mode */
mbed_official 489:119543c9f674 392 if((sConfigPVD->Mode & PVD_MODE_EVT) == PVD_MODE_EVT)
mbed_official 376:cb4d9db17537 393 {
mbed_official 489:119543c9f674 394 __HAL_PWR_PVD_EXTI_ENABLE_EVENT();
mbed_official 376:cb4d9db17537 395 }
mbed_official 489:119543c9f674 396
mbed_official 489:119543c9f674 397 /* Configure the edge */
mbed_official 489:119543c9f674 398 if((sConfigPVD->Mode & PVD_RISING_EDGE) == PVD_RISING_EDGE)
mbed_official 376:cb4d9db17537 399 {
mbed_official 489:119543c9f674 400 __HAL_PWR_PVD_EXTI_ENABLE_RISING_EDGE();
mbed_official 489:119543c9f674 401 }
mbed_official 489:119543c9f674 402
mbed_official 489:119543c9f674 403 if((sConfigPVD->Mode & PVD_FALLING_EDGE) == PVD_FALLING_EDGE)
mbed_official 489:119543c9f674 404 {
mbed_official 489:119543c9f674 405 __HAL_PWR_PVD_EXTI_ENABLE_FALLING_EDGE();
mbed_official 376:cb4d9db17537 406 }
mbed_official 376:cb4d9db17537 407 }
mbed_official 376:cb4d9db17537 408
mbed_official 376:cb4d9db17537 409 /**
mbed_official 376:cb4d9db17537 410 * @brief Enables the Power Voltage Detector(PVD).
mbed_official 376:cb4d9db17537 411 * @retval None
mbed_official 376:cb4d9db17537 412 */
mbed_official 376:cb4d9db17537 413 void HAL_PWR_EnablePVD(void)
mbed_official 376:cb4d9db17537 414 {
mbed_official 376:cb4d9db17537 415 /* Enable the power voltage detector */
mbed_official 489:119543c9f674 416 SET_BIT(PWR->CR, PWR_CR_PVDE);
mbed_official 376:cb4d9db17537 417 }
mbed_official 376:cb4d9db17537 418
mbed_official 376:cb4d9db17537 419 /**
mbed_official 376:cb4d9db17537 420 * @brief Disables the Power Voltage Detector(PVD).
mbed_official 376:cb4d9db17537 421 * @retval None
mbed_official 376:cb4d9db17537 422 */
mbed_official 376:cb4d9db17537 423 void HAL_PWR_DisablePVD(void)
mbed_official 376:cb4d9db17537 424 {
mbed_official 376:cb4d9db17537 425 /* Disable the power voltage detector */
mbed_official 489:119543c9f674 426 CLEAR_BIT(PWR->CR, PWR_CR_PVDE);
mbed_official 376:cb4d9db17537 427 }
mbed_official 376:cb4d9db17537 428
mbed_official 376:cb4d9db17537 429 /**
mbed_official 376:cb4d9db17537 430 * @brief Enables the WakeUp PINx functionality.
mbed_official 376:cb4d9db17537 431 * @param WakeUpPinx: Specifies the Power Wake-Up pin to enable.
mbed_official 376:cb4d9db17537 432 * This parameter can be one of the following values:
mbed_official 376:cb4d9db17537 433 * @arg PWR_WAKEUP_PIN1
mbed_official 376:cb4d9db17537 434 * @arg PWR_WAKEUP_PIN2
mbed_official 489:119543c9f674 435 * @arg PWR_WAKEUP_PIN3 for stm32l07xxx and stm32l08xxx devices only.
mbed_official 376:cb4d9db17537 436 * @retval None
mbed_official 376:cb4d9db17537 437 */
mbed_official 376:cb4d9db17537 438 void HAL_PWR_EnableWakeUpPin(uint32_t WakeUpPinx)
mbed_official 376:cb4d9db17537 439 {
mbed_official 376:cb4d9db17537 440 /* Check the parameter */
mbed_official 376:cb4d9db17537 441 assert_param(IS_PWR_WAKEUP_PIN(WakeUpPinx));
mbed_official 376:cb4d9db17537 442 /* Enable the EWUPx pin */
mbed_official 489:119543c9f674 443 SET_BIT(PWR->CSR, WakeUpPinx);
mbed_official 376:cb4d9db17537 444 }
mbed_official 376:cb4d9db17537 445
mbed_official 376:cb4d9db17537 446 /**
mbed_official 376:cb4d9db17537 447 * @brief Disables the WakeUp PINx functionality.
mbed_official 376:cb4d9db17537 448 * @param WakeUpPinx: Specifies the Power Wake-Up pin to disable.
mbed_official 376:cb4d9db17537 449 * This parameter can be one of the following values:
mbed_official 376:cb4d9db17537 450 * @arg PWR_WAKEUP_PIN1
mbed_official 376:cb4d9db17537 451 * @arg PWR_WAKEUP_PIN2
mbed_official 489:119543c9f674 452 * @arg PWR_WAKEUP_PIN3 for stm32l07xxx and stm32l08xxx devices only.
mbed_official 376:cb4d9db17537 453 * @retval None
mbed_official 376:cb4d9db17537 454 */
mbed_official 376:cb4d9db17537 455 void HAL_PWR_DisableWakeUpPin(uint32_t WakeUpPinx)
mbed_official 376:cb4d9db17537 456 {
mbed_official 376:cb4d9db17537 457 /* Check the parameter */
mbed_official 376:cb4d9db17537 458 assert_param(IS_PWR_WAKEUP_PIN(WakeUpPinx));
mbed_official 376:cb4d9db17537 459 /* Disable the EWUPx pin */
mbed_official 489:119543c9f674 460 CLEAR_BIT(PWR->CSR, WakeUpPinx);
mbed_official 376:cb4d9db17537 461 }
mbed_official 376:cb4d9db17537 462
mbed_official 376:cb4d9db17537 463 /**
mbed_official 376:cb4d9db17537 464 * @brief Enters Sleep mode.
mbed_official 376:cb4d9db17537 465 * @note In Sleep mode, all I/O pins keep the same state as in Run mode.
mbed_official 376:cb4d9db17537 466 * @param Regulator: Specifies the regulator state in SLEEP mode.
mbed_official 376:cb4d9db17537 467 * This parameter can be one of the following values:
mbed_official 376:cb4d9db17537 468 * @arg PWR_MAINREGULATOR_ON: SLEEP mode with regulator ON
mbed_official 376:cb4d9db17537 469 * @arg PWR_LOWPOWERREGULATOR_ON: SLEEP mode with low power regulator ON
mbed_official 376:cb4d9db17537 470 * @param SLEEPEntry: Specifies if SLEEP mode is entered with WFI or WFE instruction.
mbed_official 376:cb4d9db17537 471 * When WFI entry is used, tick interrupt have to be disabled if not desired as
mbed_official 376:cb4d9db17537 472 * the interrupt wake up source.
mbed_official 376:cb4d9db17537 473 * This parameter can be one of the following values:
mbed_official 376:cb4d9db17537 474 * @arg PWR_SLEEPENTRY_WFI: enter SLEEP mode with WFI instruction
mbed_official 376:cb4d9db17537 475 * @arg PWR_SLEEPENTRY_WFE: enter SLEEP mode with WFE instruction
mbed_official 376:cb4d9db17537 476 * @retval None
mbed_official 376:cb4d9db17537 477 */
mbed_official 376:cb4d9db17537 478 void HAL_PWR_EnterSLEEPMode(uint32_t Regulator, uint8_t SLEEPEntry)
mbed_official 376:cb4d9db17537 479 {
mbed_official 376:cb4d9db17537 480 uint32_t tmpreg = 0;
mbed_official 376:cb4d9db17537 481 /* Check the parameters */
mbed_official 376:cb4d9db17537 482 assert_param(IS_PWR_REGULATOR(Regulator));
mbed_official 376:cb4d9db17537 483 assert_param(IS_PWR_SLEEP_ENTRY(SLEEPEntry));
mbed_official 376:cb4d9db17537 484
mbed_official 489:119543c9f674 485 /* Select the regulator state in Sleep mode ---------------------------------*/
mbed_official 376:cb4d9db17537 486 tmpreg = PWR->CR;
mbed_official 489:119543c9f674 487
mbed_official 376:cb4d9db17537 488 /* Clear PDDS and LPDS bits */
mbed_official 489:119543c9f674 489 CLEAR_BIT(tmpreg, (PWR_CR_PDDS | PWR_CR_LPSDSR));
mbed_official 376:cb4d9db17537 490
mbed_official 376:cb4d9db17537 491 /* Set LPSDSR bit according to PWR_Regulator value */
mbed_official 489:119543c9f674 492 SET_BIT(tmpreg, Regulator);
mbed_official 376:cb4d9db17537 493
mbed_official 376:cb4d9db17537 494 /* Store the new value */
mbed_official 376:cb4d9db17537 495 PWR->CR = tmpreg;
mbed_official 376:cb4d9db17537 496
mbed_official 376:cb4d9db17537 497 /* Clear SLEEPDEEP bit of Cortex System Control Register */
mbed_official 489:119543c9f674 498 CLEAR_BIT(SCB->SCR, SCB_SCR_SLEEPDEEP_Msk);
mbed_official 376:cb4d9db17537 499
mbed_official 376:cb4d9db17537 500 /* Select SLEEP mode entry -------------------------------------------------*/
mbed_official 376:cb4d9db17537 501 if(SLEEPEntry == PWR_SLEEPENTRY_WFI)
mbed_official 376:cb4d9db17537 502 {
mbed_official 376:cb4d9db17537 503 /* Request Wait For Interrupt */
mbed_official 376:cb4d9db17537 504 __WFI();
mbed_official 376:cb4d9db17537 505 }
mbed_official 376:cb4d9db17537 506 else
mbed_official 376:cb4d9db17537 507 {
mbed_official 376:cb4d9db17537 508 /* Request Wait For Event */
mbed_official 376:cb4d9db17537 509 __SEV();
mbed_official 376:cb4d9db17537 510 __WFE();
mbed_official 376:cb4d9db17537 511 __WFE();
mbed_official 376:cb4d9db17537 512 }
mbed_official 376:cb4d9db17537 513 }
mbed_official 376:cb4d9db17537 514
mbed_official 376:cb4d9db17537 515 /**
mbed_official 376:cb4d9db17537 516 * @brief Enters Stop mode.
mbed_official 376:cb4d9db17537 517 * @note In Stop mode, all I/O pins keep the same state as in Run mode.
mbed_official 376:cb4d9db17537 518 * @note When exiting Stop mode by issuing an interrupt or a wakeup event,
mbed_official 376:cb4d9db17537 519 * MSI or HSI16 RCoscillator is selected as system clock depending
mbed_official 376:cb4d9db17537 520 * the bit STOPWUCK in the RCC_CFGR register.
mbed_official 376:cb4d9db17537 521 * @note When the voltage regulator operates in low power mode, an additional
mbed_official 376:cb4d9db17537 522 * startup delay is incurred when waking up from Stop mode.
mbed_official 376:cb4d9db17537 523 * By keeping the internal regulator ON during Stop mode, the consumption
mbed_official 376:cb4d9db17537 524 * is higher although the startup time is reduced.
mbed_official 376:cb4d9db17537 525 * @param Regulator: Specifies the regulator state in Stop mode.
mbed_official 376:cb4d9db17537 526 * This parameter can be one of the following values:
mbed_official 376:cb4d9db17537 527 * @arg PWR_MAINREGULATOR_ON: Stop mode with regulator ON
mbed_official 376:cb4d9db17537 528 * @arg PWR_LOWPOWERREGULATOR_ON: Stop mode with low power regulator ON
mbed_official 376:cb4d9db17537 529 * @param STOPEntry: Specifies if Stop mode in entered with WFI or WFE instruction.
mbed_official 376:cb4d9db17537 530 * This parameter can be one of the following values:
mbed_official 376:cb4d9db17537 531 * @arg PWR_STOPENTRY_WFI: Enter Stop mode with WFI instruction
mbed_official 376:cb4d9db17537 532 * @arg PWR_STOPENTRY_WFE: Enter Stop mode with WFE instruction
mbed_official 376:cb4d9db17537 533 * @retval None
mbed_official 376:cb4d9db17537 534 */
mbed_official 376:cb4d9db17537 535 void HAL_PWR_EnterSTOPMode(uint32_t Regulator, uint8_t STOPEntry)
mbed_official 376:cb4d9db17537 536 {
mbed_official 376:cb4d9db17537 537 uint32_t tmpreg = 0;
mbed_official 376:cb4d9db17537 538
mbed_official 376:cb4d9db17537 539 /* Check the parameters */
mbed_official 376:cb4d9db17537 540 assert_param(IS_PWR_REGULATOR(Regulator));
mbed_official 376:cb4d9db17537 541 assert_param(IS_PWR_STOP_ENTRY(STOPEntry));
mbed_official 376:cb4d9db17537 542
mbed_official 376:cb4d9db17537 543 /* Select the regulator state in Stop mode ---------------------------------*/
mbed_official 376:cb4d9db17537 544 tmpreg = PWR->CR;
mbed_official 489:119543c9f674 545
mbed_official 376:cb4d9db17537 546 /* Clear PDDS and LPDS bits */
mbed_official 489:119543c9f674 547 CLEAR_BIT(tmpreg, (PWR_CR_PDDS | PWR_CR_LPSDSR));
mbed_official 376:cb4d9db17537 548
mbed_official 376:cb4d9db17537 549 /* Set LPSDSR bit according to PWR_Regulator value */
mbed_official 489:119543c9f674 550 SET_BIT(tmpreg, Regulator);
mbed_official 376:cb4d9db17537 551
mbed_official 376:cb4d9db17537 552 /* Store the new value */
mbed_official 376:cb4d9db17537 553 PWR->CR = tmpreg;
mbed_official 376:cb4d9db17537 554
mbed_official 376:cb4d9db17537 555 /* Set SLEEPDEEP bit of Cortex System Control Register */
mbed_official 489:119543c9f674 556 SET_BIT(SCB->SCR, SCB_SCR_SLEEPDEEP_Msk);
mbed_official 376:cb4d9db17537 557
mbed_official 376:cb4d9db17537 558 /* Select Stop mode entry --------------------------------------------------*/
mbed_official 376:cb4d9db17537 559 if(STOPEntry == PWR_STOPENTRY_WFI)
mbed_official 376:cb4d9db17537 560 {
mbed_official 376:cb4d9db17537 561 /* Request Wait For Interrupt */
mbed_official 376:cb4d9db17537 562 __WFI();
mbed_official 376:cb4d9db17537 563 }
mbed_official 376:cb4d9db17537 564 else
mbed_official 376:cb4d9db17537 565 {
mbed_official 376:cb4d9db17537 566 /* Request Wait For Event */
mbed_official 376:cb4d9db17537 567 __SEV();
mbed_official 376:cb4d9db17537 568 __WFE();
mbed_official 376:cb4d9db17537 569 __WFE();
mbed_official 376:cb4d9db17537 570 }
mbed_official 376:cb4d9db17537 571
mbed_official 376:cb4d9db17537 572 /* Reset SLEEPDEEP bit of Cortex System Control Register */
mbed_official 489:119543c9f674 573 CLEAR_BIT(SCB->SCR, SCB_SCR_SLEEPDEEP_Msk);
mbed_official 489:119543c9f674 574
mbed_official 376:cb4d9db17537 575 }
mbed_official 376:cb4d9db17537 576
mbed_official 376:cb4d9db17537 577 /**
mbed_official 376:cb4d9db17537 578 * @brief Enters Standby mode.
mbed_official 376:cb4d9db17537 579 * @note In Standby mode, all I/O pins are high impedance except for:
mbed_official 376:cb4d9db17537 580 * - Reset pad (still available)
mbed_official 376:cb4d9db17537 581 * - RTC_AF1 pin (PC13) if configured for tamper, time-stamp, RTC
mbed_official 376:cb4d9db17537 582 * Alarm out, or RTC clock calibration out.
mbed_official 376:cb4d9db17537 583 * - RTC_AF2 pin (PC13) if configured for tamper.
mbed_official 489:119543c9f674 584 * - WKUP pin 1 (PA00) if enabled.
mbed_official 376:cb4d9db17537 585 * - WKUP pin 2 (PC13) if enabled.
mbed_official 489:119543c9f674 586 * - WKUP pin 3 (PE06) if enabled, for stm32l07xxx and stm32l08xxx devices only.
mbed_official 489:119543c9f674 587 * - WKUP pin 3 (PA02) if enabled, for stm32l031xx devices only.
mbed_official 376:cb4d9db17537 588 * @retval None
mbed_official 376:cb4d9db17537 589 */
mbed_official 376:cb4d9db17537 590 void HAL_PWR_EnterSTANDBYMode(void)
mbed_official 376:cb4d9db17537 591 {
mbed_official 376:cb4d9db17537 592 /* Select Standby mode */
mbed_official 489:119543c9f674 593 SET_BIT(PWR->CR, PWR_CR_PDDS);
mbed_official 376:cb4d9db17537 594
mbed_official 376:cb4d9db17537 595 /* Set SLEEPDEEP bit of Cortex System Control Register */
mbed_official 489:119543c9f674 596 SET_BIT(SCB->SCR, SCB_SCR_SLEEPDEEP_Msk);
mbed_official 376:cb4d9db17537 597
mbed_official 376:cb4d9db17537 598 /* This option is used to ensure that store operations are completed */
mbed_official 376:cb4d9db17537 599 #if defined ( __CC_ARM)
mbed_official 376:cb4d9db17537 600 __force_stores();
mbed_official 376:cb4d9db17537 601 #endif
mbed_official 376:cb4d9db17537 602 /* Request Wait For Interrupt */
mbed_official 376:cb4d9db17537 603 __WFI();
mbed_official 376:cb4d9db17537 604 }
mbed_official 376:cb4d9db17537 605
mbed_official 376:cb4d9db17537 606 /**
mbed_official 489:119543c9f674 607 * @brief Indicates Sleep-On-Exit when returning from Handler mode to Thread mode.
mbed_official 489:119543c9f674 608 * @note Set SLEEPONEXIT bit of SCR register. When this bit is set, the processor
mbed_official 489:119543c9f674 609 * re-enters SLEEP mode when an interruption handling is over.
mbed_official 489:119543c9f674 610 * Setting this bit is useful when the processor is expected to run only on
mbed_official 489:119543c9f674 611 * interruptions handling.
mbed_official 489:119543c9f674 612 * @retval None
mbed_official 489:119543c9f674 613 */
mbed_official 489:119543c9f674 614 void HAL_PWR_EnableSleepOnExit(void)
mbed_official 489:119543c9f674 615 {
mbed_official 489:119543c9f674 616 /* Set SLEEPONEXIT bit of Cortex System Control Register */
mbed_official 489:119543c9f674 617 SET_BIT(SCB->SCR, ((uint32_t)SCB_SCR_SLEEPONEXIT_Msk));
mbed_official 489:119543c9f674 618 }
mbed_official 489:119543c9f674 619
mbed_official 489:119543c9f674 620
mbed_official 489:119543c9f674 621 /**
mbed_official 489:119543c9f674 622 * @brief Disables Sleep-On-Exit feature when returning from Handler mode to Thread mode.
mbed_official 489:119543c9f674 623 * @note Clears SLEEPONEXIT bit of SCR register. When this bit is set, the processor
mbed_official 489:119543c9f674 624 * re-enters SLEEP mode when an interruption handling is over.
mbed_official 489:119543c9f674 625 * @retval None
mbed_official 489:119543c9f674 626 */
mbed_official 489:119543c9f674 627 void HAL_PWR_DisableSleepOnExit(void)
mbed_official 489:119543c9f674 628 {
mbed_official 489:119543c9f674 629 /* Clear SLEEPONEXIT bit of Cortex System Control Register */
mbed_official 489:119543c9f674 630 CLEAR_BIT(SCB->SCR, ((uint32_t)SCB_SCR_SLEEPONEXIT_Msk));
mbed_official 489:119543c9f674 631 }
mbed_official 489:119543c9f674 632
mbed_official 489:119543c9f674 633
mbed_official 489:119543c9f674 634 /**
mbed_official 489:119543c9f674 635 * @brief Enables CORTEX M0+ SEVONPEND bit.
mbed_official 489:119543c9f674 636 * @note Sets SEVONPEND bit of SCR register. When this bit is set, this causes
mbed_official 489:119543c9f674 637 * WFE to wake up when an interrupt moves from inactive to pended.
mbed_official 489:119543c9f674 638 * @retval None
mbed_official 489:119543c9f674 639 */
mbed_official 489:119543c9f674 640 void HAL_PWR_EnableSEVOnPend(void)
mbed_official 489:119543c9f674 641 {
mbed_official 489:119543c9f674 642 /* Set SEVONPEND bit of Cortex System Control Register */
mbed_official 489:119543c9f674 643 SET_BIT(SCB->SCR, ((uint32_t)SCB_SCR_SEVONPEND_Msk));
mbed_official 489:119543c9f674 644 }
mbed_official 489:119543c9f674 645
mbed_official 489:119543c9f674 646
mbed_official 489:119543c9f674 647 /**
mbed_official 489:119543c9f674 648 * @brief Disables CORTEX M0+ SEVONPEND bit.
mbed_official 489:119543c9f674 649 * @note Clears SEVONPEND bit of SCR register. When this bit is set, this causes
mbed_official 489:119543c9f674 650 * WFE to wake up when an interrupt moves from inactive to pended.
mbed_official 489:119543c9f674 651 * @retval None
mbed_official 489:119543c9f674 652 */
mbed_official 489:119543c9f674 653 void HAL_PWR_DisableSEVOnPend(void)
mbed_official 489:119543c9f674 654 {
mbed_official 489:119543c9f674 655 /* Clear SEVONPEND bit of Cortex System Control Register */
mbed_official 489:119543c9f674 656 CLEAR_BIT(SCB->SCR, ((uint32_t)SCB_SCR_SEVONPEND_Msk));
mbed_official 489:119543c9f674 657 }
mbed_official 489:119543c9f674 658
mbed_official 489:119543c9f674 659 /**
mbed_official 376:cb4d9db17537 660 * @brief This function handles the PWR PVD interrupt request.
mbed_official 376:cb4d9db17537 661 * @note This API should be called under the PVD_IRQHandler().
mbed_official 376:cb4d9db17537 662 * @retval None
mbed_official 376:cb4d9db17537 663 */
mbed_official 376:cb4d9db17537 664 void HAL_PWR_PVD_IRQHandler(void)
mbed_official 376:cb4d9db17537 665 {
mbed_official 376:cb4d9db17537 666 /* Check PWR exti flag */
mbed_official 489:119543c9f674 667 if(__HAL_PWR_PVD_EXTI_GET_FLAG() != RESET)
mbed_official 376:cb4d9db17537 668 {
mbed_official 376:cb4d9db17537 669 /* PWR PVD interrupt user callback */
mbed_official 376:cb4d9db17537 670 HAL_PWR_PVDCallback();
mbed_official 376:cb4d9db17537 671
mbed_official 376:cb4d9db17537 672 /* Clear PWR Exti pending bit */
mbed_official 489:119543c9f674 673 __HAL_PWR_PVD_EXTI_CLEAR_FLAG();
mbed_official 376:cb4d9db17537 674 }
mbed_official 376:cb4d9db17537 675 }
mbed_official 376:cb4d9db17537 676
mbed_official 376:cb4d9db17537 677 /**
mbed_official 376:cb4d9db17537 678 * @brief PWR PVD interrupt callback
mbed_official 376:cb4d9db17537 679 * @retval None
mbed_official 376:cb4d9db17537 680 */
mbed_official 376:cb4d9db17537 681 __weak void HAL_PWR_PVDCallback(void)
mbed_official 376:cb4d9db17537 682 {
mbed_official 376:cb4d9db17537 683 /* NOTE : This function Should not be modified, when the callback is needed,
mbed_official 376:cb4d9db17537 684 the HAL_PWR_PVDCallback could be implemented in the user file
mbed_official 376:cb4d9db17537 685 */
mbed_official 376:cb4d9db17537 686 }
mbed_official 376:cb4d9db17537 687
mbed_official 376:cb4d9db17537 688 /**
mbed_official 376:cb4d9db17537 689 * @}
mbed_official 376:cb4d9db17537 690 */
mbed_official 376:cb4d9db17537 691
mbed_official 376:cb4d9db17537 692 /**
mbed_official 376:cb4d9db17537 693 * @}
mbed_official 376:cb4d9db17537 694 */
mbed_official 376:cb4d9db17537 695
mbed_official 376:cb4d9db17537 696 #endif /* HAL_PWR_MODULE_ENABLED */
mbed_official 376:cb4d9db17537 697 /**
mbed_official 376:cb4d9db17537 698 * @}
mbed_official 376:cb4d9db17537 699 */
mbed_official 376:cb4d9db17537 700
mbed_official 376:cb4d9db17537 701 /**
mbed_official 376:cb4d9db17537 702 * @}
mbed_official 376:cb4d9db17537 703 */
mbed_official 376:cb4d9db17537 704
mbed_official 376:cb4d9db17537 705 /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/
mbed_official 489:119543c9f674 706