MacroRat / MouseCode

Mouse code for the MacroRat

Dependencies:   ITG3200 QEI

mbed-dev/targets/TARGET_STM/TARGET_STM32F2/device/stm32f2xx_hal_pwr_ex.c@18:6a4db94011d3, 2017-05-14 (annotated)

Committer:
sahilmgandhi
Date:
Sun May 14 23:18:57 2017 +0000
Revision:
18:6a4db94011d3
Publishing again

Who changed what in which revision?

UserRevisionLine numberNew contents of line
sahilmgandhi 18:6a4db94011d3 1 /**
sahilmgandhi 18:6a4db94011d3 2 ******************************************************************************
sahilmgandhi 18:6a4db94011d3 3 * @file stm32f2xx_hal_pwr_ex.c
sahilmgandhi 18:6a4db94011d3 4 * @author MCD Application Team
sahilmgandhi 18:6a4db94011d3 5 * @version V1.1.3
sahilmgandhi 18:6a4db94011d3 6 * @date 29-June-2016
sahilmgandhi 18:6a4db94011d3 7 * @brief Extended PWR HAL module driver.
sahilmgandhi 18:6a4db94011d3 8 * This file provides firmware functions to manage the following
sahilmgandhi 18:6a4db94011d3 9 * functionalities of PWR extension peripheral:
sahilmgandhi 18:6a4db94011d3 10 * + Peripheral Extended features functions
sahilmgandhi 18:6a4db94011d3 11 *
sahilmgandhi 18:6a4db94011d3 12 ******************************************************************************
sahilmgandhi 18:6a4db94011d3 13 * @attention
sahilmgandhi 18:6a4db94011d3 14 *
sahilmgandhi 18:6a4db94011d3 15 * <h2><center>&copy; COPYRIGHT(c) 2016 STMicroelectronics</center></h2>
sahilmgandhi 18:6a4db94011d3 16 *
sahilmgandhi 18:6a4db94011d3 17 * Redistribution and use in source and binary forms, with or without modification,
sahilmgandhi 18:6a4db94011d3 18 * are permitted provided that the following conditions are met:
sahilmgandhi 18:6a4db94011d3 19 * 1. Redistributions of source code must retain the above copyright notice,
sahilmgandhi 18:6a4db94011d3 20 * this list of conditions and the following disclaimer.
sahilmgandhi 18:6a4db94011d3 21 * 2. Redistributions in binary form must reproduce the above copyright notice,
sahilmgandhi 18:6a4db94011d3 22 * this list of conditions and the following disclaimer in the documentation
sahilmgandhi 18:6a4db94011d3 23 * and/or other materials provided with the distribution.
sahilmgandhi 18:6a4db94011d3 24 * 3. Neither the name of STMicroelectronics nor the names of its contributors
sahilmgandhi 18:6a4db94011d3 25 * may be used to endorse or promote products derived from this software
sahilmgandhi 18:6a4db94011d3 26 * without specific prior written permission.
sahilmgandhi 18:6a4db94011d3 27 *
sahilmgandhi 18:6a4db94011d3 28 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
sahilmgandhi 18:6a4db94011d3 29 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
sahilmgandhi 18:6a4db94011d3 30 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
sahilmgandhi 18:6a4db94011d3 31 * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
sahilmgandhi 18:6a4db94011d3 32 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
sahilmgandhi 18:6a4db94011d3 33 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
sahilmgandhi 18:6a4db94011d3 34 * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
sahilmgandhi 18:6a4db94011d3 35 * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
sahilmgandhi 18:6a4db94011d3 36 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
sahilmgandhi 18:6a4db94011d3 37 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
sahilmgandhi 18:6a4db94011d3 38 *
sahilmgandhi 18:6a4db94011d3 39 ******************************************************************************
sahilmgandhi 18:6a4db94011d3 40 */
sahilmgandhi 18:6a4db94011d3 41
sahilmgandhi 18:6a4db94011d3 42 /* Includes ------------------------------------------------------------------*/
sahilmgandhi 18:6a4db94011d3 43 #include "stm32f2xx_hal.h"
sahilmgandhi 18:6a4db94011d3 44
sahilmgandhi 18:6a4db94011d3 45 /** @addtogroup STM32F2xx_HAL_Driver
sahilmgandhi 18:6a4db94011d3 46 * @{
sahilmgandhi 18:6a4db94011d3 47 */
sahilmgandhi 18:6a4db94011d3 48
sahilmgandhi 18:6a4db94011d3 49 /** @defgroup PWREx PWREx
sahilmgandhi 18:6a4db94011d3 50 * @brief PWR HAL module driver
sahilmgandhi 18:6a4db94011d3 51 * @{
sahilmgandhi 18:6a4db94011d3 52 */
sahilmgandhi 18:6a4db94011d3 53
sahilmgandhi 18:6a4db94011d3 54 #ifdef HAL_PWR_MODULE_ENABLED
sahilmgandhi 18:6a4db94011d3 55
sahilmgandhi 18:6a4db94011d3 56 /* Private typedef -----------------------------------------------------------*/
sahilmgandhi 18:6a4db94011d3 57 /* Private define ------------------------------------------------------------*/
sahilmgandhi 18:6a4db94011d3 58 /** @addtogroup PWREx_Private_Constants
sahilmgandhi 18:6a4db94011d3 59 * @{
sahilmgandhi 18:6a4db94011d3 60 */
sahilmgandhi 18:6a4db94011d3 61 #define PWR_BKPREG_TIMEOUT_VALUE 1000U
sahilmgandhi 18:6a4db94011d3 62 /**
sahilmgandhi 18:6a4db94011d3 63 * @}
sahilmgandhi 18:6a4db94011d3 64 */
sahilmgandhi 18:6a4db94011d3 65
sahilmgandhi 18:6a4db94011d3 66
sahilmgandhi 18:6a4db94011d3 67 /* Private macro -------------------------------------------------------------*/
sahilmgandhi 18:6a4db94011d3 68 /* Private variables ---------------------------------------------------------*/
sahilmgandhi 18:6a4db94011d3 69 /* Private function prototypes -----------------------------------------------*/
sahilmgandhi 18:6a4db94011d3 70 /* Private functions ---------------------------------------------------------*/
sahilmgandhi 18:6a4db94011d3 71 /** @defgroup PWREx_Exported_Functions PWR Exported Functions
sahilmgandhi 18:6a4db94011d3 72 * @{
sahilmgandhi 18:6a4db94011d3 73 */
sahilmgandhi 18:6a4db94011d3 74
sahilmgandhi 18:6a4db94011d3 75 /** @defgroup PWREx_Exported_Functions_Group1 Peripheral Extended features functions
sahilmgandhi 18:6a4db94011d3 76 * @brief Peripheral Extended features functions
sahilmgandhi 18:6a4db94011d3 77 *
sahilmgandhi 18:6a4db94011d3 78 @verbatim
sahilmgandhi 18:6a4db94011d3 79
sahilmgandhi 18:6a4db94011d3 80 ===============================================================================
sahilmgandhi 18:6a4db94011d3 81 ##### Peripheral extended features functions #####
sahilmgandhi 18:6a4db94011d3 82 ===============================================================================
sahilmgandhi 18:6a4db94011d3 83
sahilmgandhi 18:6a4db94011d3 84 *** Main and Backup Regulators configuration ***
sahilmgandhi 18:6a4db94011d3 85 ================================================
sahilmgandhi 18:6a4db94011d3 86 [..]
sahilmgandhi 18:6a4db94011d3 87 (+) The backup domain includes 4 Kbytes of backup SRAM accessible only from
sahilmgandhi 18:6a4db94011d3 88 the CPU, and address in 32-bit, 16-bit or 8-bit mode. Its content is
sahilmgandhi 18:6a4db94011d3 89 retained even in Standby or VBAT mode when the low power backup regulator
sahilmgandhi 18:6a4db94011d3 90 is enabled. It can be considered as an internal EEPROM when VBAT is
sahilmgandhi 18:6a4db94011d3 91 always present. You can use the HAL_PWREx_EnableBkUpReg() function to
sahilmgandhi 18:6a4db94011d3 92 enable the low power backup regulator.
sahilmgandhi 18:6a4db94011d3 93
sahilmgandhi 18:6a4db94011d3 94 (+) When the backup domain is supplied by VDD (analog switch connected to VDD)
sahilmgandhi 18:6a4db94011d3 95 the backup SRAM is powered from VDD which replaces the VBAT power supply to
sahilmgandhi 18:6a4db94011d3 96 save battery life.
sahilmgandhi 18:6a4db94011d3 97
sahilmgandhi 18:6a4db94011d3 98 (+) The backup SRAM is not mass erased by a tamper event. It is read
sahilmgandhi 18:6a4db94011d3 99 protected to prevent confidential data, such as cryptographic private
sahilmgandhi 18:6a4db94011d3 100 key, from being accessed. The backup SRAM can be erased only through
sahilmgandhi 18:6a4db94011d3 101 the Flash interface when a protection level change from level 1 to
sahilmgandhi 18:6a4db94011d3 102 level 0 is requested.
sahilmgandhi 18:6a4db94011d3 103 -@- Refer to the description of Read protection (RDP) in the Flash
sahilmgandhi 18:6a4db94011d3 104 programming manual.
sahilmgandhi 18:6a4db94011d3 105
sahilmgandhi 18:6a4db94011d3 106 Refer to the product datasheets for more details.
sahilmgandhi 18:6a4db94011d3 107
sahilmgandhi 18:6a4db94011d3 108 *** FLASH Power Down configuration ****
sahilmgandhi 18:6a4db94011d3 109 =======================================
sahilmgandhi 18:6a4db94011d3 110 [..]
sahilmgandhi 18:6a4db94011d3 111 (+) By setting the FPDS bit in the PWR_CR register by using the
sahilmgandhi 18:6a4db94011d3 112 HAL_PWREx_EnableFlashPowerDown() function, the Flash memory also enters power
sahilmgandhi 18:6a4db94011d3 113 down mode when the device enters Stop mode. When the Flash memory
sahilmgandhi 18:6a4db94011d3 114 is in power down mode, an additional startup delay is incurred when
sahilmgandhi 18:6a4db94011d3 115 waking up from Stop mode.
sahilmgandhi 18:6a4db94011d3 116
sahilmgandhi 18:6a4db94011d3 117 @endverbatim
sahilmgandhi 18:6a4db94011d3 118 * @{
sahilmgandhi 18:6a4db94011d3 119 */
sahilmgandhi 18:6a4db94011d3 120
sahilmgandhi 18:6a4db94011d3 121 /**
sahilmgandhi 18:6a4db94011d3 122 * @brief Enables the Backup Regulator.
sahilmgandhi 18:6a4db94011d3 123 * @retval HAL status
sahilmgandhi 18:6a4db94011d3 124 */
sahilmgandhi 18:6a4db94011d3 125 HAL_StatusTypeDef HAL_PWREx_EnableBkUpReg(void)
sahilmgandhi 18:6a4db94011d3 126 {
sahilmgandhi 18:6a4db94011d3 127 uint32_t tickstart = 0U;
sahilmgandhi 18:6a4db94011d3 128
sahilmgandhi 18:6a4db94011d3 129 *(__IO uint32_t *) CSR_BRE_BB = (uint32_t)ENABLE;
sahilmgandhi 18:6a4db94011d3 130
sahilmgandhi 18:6a4db94011d3 131 /* Get tick */
sahilmgandhi 18:6a4db94011d3 132 tickstart = HAL_GetTick();
sahilmgandhi 18:6a4db94011d3 133
sahilmgandhi 18:6a4db94011d3 134 /* Wait till Backup regulator ready flag is set */
sahilmgandhi 18:6a4db94011d3 135 while(__HAL_PWR_GET_FLAG(PWR_FLAG_BRR) == RESET)
sahilmgandhi 18:6a4db94011d3 136 {
sahilmgandhi 18:6a4db94011d3 137 if((HAL_GetTick() - tickstart ) > PWR_BKPREG_TIMEOUT_VALUE)
sahilmgandhi 18:6a4db94011d3 138 {
sahilmgandhi 18:6a4db94011d3 139 return HAL_TIMEOUT;
sahilmgandhi 18:6a4db94011d3 140 }
sahilmgandhi 18:6a4db94011d3 141 }
sahilmgandhi 18:6a4db94011d3 142 return HAL_OK;
sahilmgandhi 18:6a4db94011d3 143 }
sahilmgandhi 18:6a4db94011d3 144
sahilmgandhi 18:6a4db94011d3 145 /**
sahilmgandhi 18:6a4db94011d3 146 * @brief Disables the Backup Regulator.
sahilmgandhi 18:6a4db94011d3 147 * @retval HAL status
sahilmgandhi 18:6a4db94011d3 148 */
sahilmgandhi 18:6a4db94011d3 149 HAL_StatusTypeDef HAL_PWREx_DisableBkUpReg(void)
sahilmgandhi 18:6a4db94011d3 150 {
sahilmgandhi 18:6a4db94011d3 151 uint32_t tickstart = 0U;
sahilmgandhi 18:6a4db94011d3 152
sahilmgandhi 18:6a4db94011d3 153 *(__IO uint32_t *) CSR_BRE_BB = (uint32_t)DISABLE;
sahilmgandhi 18:6a4db94011d3 154
sahilmgandhi 18:6a4db94011d3 155 /* Get tick */
sahilmgandhi 18:6a4db94011d3 156 tickstart = HAL_GetTick();
sahilmgandhi 18:6a4db94011d3 157
sahilmgandhi 18:6a4db94011d3 158 /* Wait till Backup regulator ready flag is set */
sahilmgandhi 18:6a4db94011d3 159 while(__HAL_PWR_GET_FLAG(PWR_FLAG_BRR) != RESET)
sahilmgandhi 18:6a4db94011d3 160 {
sahilmgandhi 18:6a4db94011d3 161 if((HAL_GetTick() - tickstart ) > PWR_BKPREG_TIMEOUT_VALUE)
sahilmgandhi 18:6a4db94011d3 162 {
sahilmgandhi 18:6a4db94011d3 163 return HAL_TIMEOUT;
sahilmgandhi 18:6a4db94011d3 164 }
sahilmgandhi 18:6a4db94011d3 165 }
sahilmgandhi 18:6a4db94011d3 166 return HAL_OK;
sahilmgandhi 18:6a4db94011d3 167 }
sahilmgandhi 18:6a4db94011d3 168
sahilmgandhi 18:6a4db94011d3 169 /**
sahilmgandhi 18:6a4db94011d3 170 * @brief Enables the Flash Power Down in Stop mode.
sahilmgandhi 18:6a4db94011d3 171 * @retval None
sahilmgandhi 18:6a4db94011d3 172 */
sahilmgandhi 18:6a4db94011d3 173 void HAL_PWREx_EnableFlashPowerDown(void)
sahilmgandhi 18:6a4db94011d3 174 {
sahilmgandhi 18:6a4db94011d3 175 *(__IO uint32_t *) CR_FPDS_BB = (uint32_t)ENABLE;
sahilmgandhi 18:6a4db94011d3 176 }
sahilmgandhi 18:6a4db94011d3 177
sahilmgandhi 18:6a4db94011d3 178 /**
sahilmgandhi 18:6a4db94011d3 179 * @brief Disables the Flash Power Down in Stop mode.
sahilmgandhi 18:6a4db94011d3 180 * @retval None
sahilmgandhi 18:6a4db94011d3 181 */
sahilmgandhi 18:6a4db94011d3 182 void HAL_PWREx_DisableFlashPowerDown(void)
sahilmgandhi 18:6a4db94011d3 183 {
sahilmgandhi 18:6a4db94011d3 184 *(__IO uint32_t *) CR_FPDS_BB = (uint32_t)DISABLE;
sahilmgandhi 18:6a4db94011d3 185 }
sahilmgandhi 18:6a4db94011d3 186
sahilmgandhi 18:6a4db94011d3 187 /**
sahilmgandhi 18:6a4db94011d3 188 * @}
sahilmgandhi 18:6a4db94011d3 189 */
sahilmgandhi 18:6a4db94011d3 190
sahilmgandhi 18:6a4db94011d3 191 /**
sahilmgandhi 18:6a4db94011d3 192 * @}
sahilmgandhi 18:6a4db94011d3 193 */
sahilmgandhi 18:6a4db94011d3 194 #endif /* HAL_PWR_MODULE_ENABLED */
sahilmgandhi 18:6a4db94011d3 195 /**
sahilmgandhi 18:6a4db94011d3 196 * @}
sahilmgandhi 18:6a4db94011d3 197 */
sahilmgandhi 18:6a4db94011d3 198
sahilmgandhi 18:6a4db94011d3 199 /**
sahilmgandhi 18:6a4db94011d3 200 * @}
sahilmgandhi 18:6a4db94011d3 201 */
sahilmgandhi 18:6a4db94011d3 202
sahilmgandhi 18:6a4db94011d3 203 /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/