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_ex.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_ex.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 Extended PWR HAL module driver.
mbed_official 376:cb4d9db17537 8 * This file provides firmware functions to manage the following
mbed_official 376:cb4d9db17537 9 * functionalities of the Power Controller (PWR) peripheral:
mbed_official 376:cb4d9db17537 10 * + Extended Initialization and de-initialization functions
mbed_official 376:cb4d9db17537 11 * + Extended Peripheral Control functions
mbed_official 376:cb4d9db17537 12 *
mbed_official 376:cb4d9db17537 13 ******************************************************************************
mbed_official 376:cb4d9db17537 14 * @attention
mbed_official 376:cb4d9db17537 15 *
mbed_official 489:119543c9f674 16 * <h2><center>&copy; COPYRIGHT(c) 2015 STMicroelectronics</center></h2>
mbed_official 376:cb4d9db17537 17 *
mbed_official 376:cb4d9db17537 18 * Redistribution and use in source and binary forms, with or without modification,
mbed_official 376:cb4d9db17537 19 * are permitted provided that the following conditions are met:
mbed_official 376:cb4d9db17537 20 * 1. Redistributions of source code must retain the above copyright notice,
mbed_official 376:cb4d9db17537 21 * this list of conditions and the following disclaimer.
mbed_official 376:cb4d9db17537 22 * 2. Redistributions in binary form must reproduce the above copyright notice,
mbed_official 376:cb4d9db17537 23 * this list of conditions and the following disclaimer in the documentation
mbed_official 376:cb4d9db17537 24 * and/or other materials provided with the distribution.
mbed_official 376:cb4d9db17537 25 * 3. Neither the name of STMicroelectronics nor the names of its contributors
mbed_official 376:cb4d9db17537 26 * may be used to endorse or promote products derived from this software
mbed_official 376:cb4d9db17537 27 * without specific prior written permission.
mbed_official 376:cb4d9db17537 28 *
mbed_official 376:cb4d9db17537 29 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
mbed_official 376:cb4d9db17537 30 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
mbed_official 376:cb4d9db17537 31 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
mbed_official 376:cb4d9db17537 32 * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
mbed_official 376:cb4d9db17537 33 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
mbed_official 376:cb4d9db17537 34 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
mbed_official 376:cb4d9db17537 35 * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
mbed_official 376:cb4d9db17537 36 * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
mbed_official 376:cb4d9db17537 37 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
mbed_official 376:cb4d9db17537 38 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
mbed_official 376:cb4d9db17537 39 *
mbed_official 376:cb4d9db17537 40 ******************************************************************************
mbed_official 376:cb4d9db17537 41 */
mbed_official 376:cb4d9db17537 42
mbed_official 376:cb4d9db17537 43 /* Includes ------------------------------------------------------------------*/
mbed_official 376:cb4d9db17537 44 #include "stm32l0xx_hal.h"
mbed_official 376:cb4d9db17537 45
mbed_official 489:119543c9f674 46 #ifdef HAL_PWR_MODULE_ENABLED
mbed_official 376:cb4d9db17537 47 /** @addtogroup STM32L0xx_HAL_Driver
mbed_official 376:cb4d9db17537 48 * @{
mbed_official 376:cb4d9db17537 49 */
mbed_official 376:cb4d9db17537 50
mbed_official 489:119543c9f674 51 /** @addtogroup PWREx
mbed_official 376:cb4d9db17537 52 * @{
mbed_official 376:cb4d9db17537 53 */
mbed_official 376:cb4d9db17537 54
mbed_official 489:119543c9f674 55 /** @defgroup PWR_Extended_TimeOut_Value PWR Extended Flag Setting Time Out Value
mbed_official 376:cb4d9db17537 56 * @{
mbed_official 489:119543c9f674 57 */
mbed_official 489:119543c9f674 58 #define PWR_FLAG_SETTING_DELAY_US 50
mbed_official 489:119543c9f674 59 /**
mbed_official 489:119543c9f674 60 * @}
mbed_official 376:cb4d9db17537 61 */
mbed_official 376:cb4d9db17537 62
mbed_official 489:119543c9f674 63
mbed_official 489:119543c9f674 64 /** @addtogroup PWREx_Exported_Functions
mbed_official 489:119543c9f674 65 * @brief Low Power modes configuration functions
mbed_official 376:cb4d9db17537 66 *
mbed_official 376:cb4d9db17537 67 @verbatim
mbed_official 376:cb4d9db17537 68
mbed_official 376:cb4d9db17537 69 ===============================================================================
mbed_official 376:cb4d9db17537 70 ##### Peripheral extended features functions #####
mbed_official 376:cb4d9db17537 71 ===============================================================================
mbed_official 376:cb4d9db17537 72 @endverbatim
mbed_official 376:cb4d9db17537 73 * @{
mbed_official 376:cb4d9db17537 74 */
mbed_official 376:cb4d9db17537 75
mbed_official 376:cb4d9db17537 76 /**
mbed_official 376:cb4d9db17537 77 * @brief Enables the Fast WakeUp from Ultra Low Power mode.
mbed_official 376:cb4d9db17537 78 * @note This bit works in conjunction with ULP bit.
mbed_official 376:cb4d9db17537 79 * Means, when ULP = 1 and FWU = 1 :VREFINT startup time is ignored when
mbed_official 376:cb4d9db17537 80 * exiting from low power mode.
mbed_official 376:cb4d9db17537 81 * @retval None
mbed_official 376:cb4d9db17537 82 */
mbed_official 376:cb4d9db17537 83 void HAL_PWREx_EnableFastWakeUp(void)
mbed_official 376:cb4d9db17537 84 {
mbed_official 376:cb4d9db17537 85 /* Enable the fast wake up */
mbed_official 489:119543c9f674 86 SET_BIT(PWR->CR, PWR_CR_FWU);
mbed_official 376:cb4d9db17537 87 }
mbed_official 376:cb4d9db17537 88
mbed_official 376:cb4d9db17537 89 /**
mbed_official 376:cb4d9db17537 90 * @brief Disables the Fast WakeUp from Ultra Low Power mode.
mbed_official 376:cb4d9db17537 91 * @retval None
mbed_official 376:cb4d9db17537 92 */
mbed_official 376:cb4d9db17537 93 void HAL_PWREx_DisableFastWakeUp(void)
mbed_official 376:cb4d9db17537 94 {
mbed_official 376:cb4d9db17537 95 /* Disable the fast wake up */
mbed_official 489:119543c9f674 96 CLEAR_BIT(PWR->CR, PWR_CR_FWU);
mbed_official 376:cb4d9db17537 97 }
mbed_official 376:cb4d9db17537 98
mbed_official 376:cb4d9db17537 99 /**
mbed_official 376:cb4d9db17537 100 * @brief Enables the Ultra Low Power mode
mbed_official 376:cb4d9db17537 101 * @retval None
mbed_official 376:cb4d9db17537 102 */
mbed_official 376:cb4d9db17537 103 void HAL_PWREx_EnableUltraLowPower(void)
mbed_official 376:cb4d9db17537 104 {
mbed_official 376:cb4d9db17537 105 /* Enable the Ultra Low Power mode */
mbed_official 489:119543c9f674 106 SET_BIT(PWR->CR, PWR_CR_ULP);
mbed_official 376:cb4d9db17537 107 }
mbed_official 376:cb4d9db17537 108
mbed_official 376:cb4d9db17537 109 /**
mbed_official 376:cb4d9db17537 110 * @brief Disables the Ultra Low Power mode
mbed_official 376:cb4d9db17537 111 * @retval None
mbed_official 376:cb4d9db17537 112 */
mbed_official 376:cb4d9db17537 113 void HAL_PWREx_DisableUltraLowPower(void)
mbed_official 376:cb4d9db17537 114 {
mbed_official 376:cb4d9db17537 115 /* Disable the Ultra Low Power mode */
mbed_official 489:119543c9f674 116 CLEAR_BIT(PWR->CR, PWR_CR_ULP);
mbed_official 376:cb4d9db17537 117 }
mbed_official 376:cb4d9db17537 118
mbed_official 376:cb4d9db17537 119 /**
mbed_official 489:119543c9f674 120 * @brief Enable the Low Power Run mode.
mbed_official 376:cb4d9db17537 121 * @note Low power run mode can only be entered when VCORE is in range 2.
mbed_official 376:cb4d9db17537 122 * In addition, the dynamic voltage scaling must not be used when Low
mbed_official 376:cb4d9db17537 123 * power run mode is selected. Only Stop and Sleep modes with regulator
mbed_official 376:cb4d9db17537 124 * configured in Low power mode is allowed when Low power run mode is
mbed_official 376:cb4d9db17537 125 * selected.
mbed_official 489:119543c9f674 126 * @note The frequency of the system clock must be decreased to not exceed the
mbed_official 489:119543c9f674 127 * frequency of RCC_MSIRANGE_1.
mbed_official 376:cb4d9db17537 128 * @note In Low power run mode, all I/O pins keep the same state as in Run mode.
mbed_official 376:cb4d9db17537 129 * @retval None
mbed_official 376:cb4d9db17537 130 */
mbed_official 376:cb4d9db17537 131 void HAL_PWREx_EnableLowPowerRunMode(void)
mbed_official 376:cb4d9db17537 132 {
mbed_official 376:cb4d9db17537 133 /* Enters the Low Power Run mode */
mbed_official 489:119543c9f674 134 SET_BIT(PWR->CR, PWR_CR_LPSDSR);
mbed_official 489:119543c9f674 135 SET_BIT(PWR->CR, PWR_CR_LPRUN);
mbed_official 376:cb4d9db17537 136 }
mbed_official 376:cb4d9db17537 137
mbed_official 376:cb4d9db17537 138 /**
mbed_official 489:119543c9f674 139 * @brief Disable the Low Power Run mode.
mbed_official 489:119543c9f674 140 * @note Before HAL_PWREx_DisableLowPowerRunMode() completion, the function checks that
mbed_official 489:119543c9f674 141 * REGLPF has been properly reset (otherwise, HAL_PWREx_DisableLowPowerRunMode
mbed_official 489:119543c9f674 142 * returns HAL_TIMEOUT status). The system clock frequency can then be
mbed_official 489:119543c9f674 143 * increased above 2 MHz.
mbed_official 489:119543c9f674 144 * @retval HAL_StatusTypeDef
mbed_official 376:cb4d9db17537 145 */
mbed_official 489:119543c9f674 146 HAL_StatusTypeDef HAL_PWREx_DisableLowPowerRunMode(void)
mbed_official 376:cb4d9db17537 147 {
mbed_official 489:119543c9f674 148 uint32_t wait_loop_index = 0;
mbed_official 489:119543c9f674 149
mbed_official 489:119543c9f674 150 /* Exit the Low Power Run mode */
mbed_official 489:119543c9f674 151 CLEAR_BIT(PWR->CR, PWR_CR_LPRUN);
mbed_official 489:119543c9f674 152 CLEAR_BIT(PWR->CR, PWR_CR_LPSDSR);
mbed_official 489:119543c9f674 153
mbed_official 489:119543c9f674 154 /* Wait until REGLPF is reset */
mbed_official 489:119543c9f674 155 wait_loop_index = (PWR_FLAG_SETTING_DELAY_US * (SystemCoreClock / 1000000));
mbed_official 489:119543c9f674 156
mbed_official 489:119543c9f674 157 while ((wait_loop_index != 0) && (HAL_IS_BIT_SET(PWR->CSR, PWR_CSR_REGLPF)))
mbed_official 489:119543c9f674 158 {
mbed_official 489:119543c9f674 159 wait_loop_index--;
mbed_official 489:119543c9f674 160 }
mbed_official 489:119543c9f674 161
mbed_official 489:119543c9f674 162 if (HAL_IS_BIT_SET(PWR->CSR, PWR_CSR_REGLPF))
mbed_official 489:119543c9f674 163 {
mbed_official 489:119543c9f674 164 return HAL_TIMEOUT;
mbed_official 489:119543c9f674 165 }
mbed_official 489:119543c9f674 166
mbed_official 489:119543c9f674 167 return HAL_OK;
mbed_official 376:cb4d9db17537 168 }
mbed_official 376:cb4d9db17537 169
mbed_official 376:cb4d9db17537 170 /**
mbed_official 376:cb4d9db17537 171 * @}
mbed_official 376:cb4d9db17537 172 */
mbed_official 376:cb4d9db17537 173
mbed_official 376:cb4d9db17537 174 /**
mbed_official 376:cb4d9db17537 175 * @}
mbed_official 376:cb4d9db17537 176 */
mbed_official 376:cb4d9db17537 177
mbed_official 376:cb4d9db17537 178 /**
mbed_official 376:cb4d9db17537 179 * @}
mbed_official 376:cb4d9db17537 180 */
mbed_official 489:119543c9f674 181 #endif /* HAL_PWR_MODULE_ENABLED */
mbed_official 376:cb4d9db17537 182
mbed_official 376:cb4d9db17537 183 /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/
mbed_official 489:119543c9f674 184