Kevin Kadooka / mbed-dev

Important changes to repositories hosted on mbed.com

Mbed hosted mercurial repositories are deprecated and are due to be permanently deleted in July 2026.

To keep a copy of this software download the repository Zip archive or clone locally using Mercurial.

It is also possible to export all your personal repositories from the account settings page.

Fork of mbed-dev by mbed official

targets/cmsis/TARGET_STM/TARGET_STM32L0/stm32l0xx_hal.c@144:ef7eb2e8f9f7, 2016-09-02 (annotated)

Committer:
<>
Date:
Fri Sep 02 15:07:44 2016 +0100
Revision:
144:ef7eb2e8f9f7
Parent:
113:b3775bf36a83 
This updates the lib to the mbed lib v125

Who changed what in which revision?

UserRevisionLine numberNew contents of line
<> 144:ef7eb2e8f9f7 1 /**
<> 144:ef7eb2e8f9f7 2 ******************************************************************************
<> 144:ef7eb2e8f9f7 3 * @file stm32l0xx_hal.c
<> 144:ef7eb2e8f9f7 4 * @author MCD Application Team
<> 144:ef7eb2e8f9f7 5 * @version V1.5.0
<> 144:ef7eb2e8f9f7 6 * @date 8-January-2016
<> 144:ef7eb2e8f9f7 7 * @brief HAL module driver.
<> 144:ef7eb2e8f9f7 8 * This is the common part of the HAL initialization
<> 144:ef7eb2e8f9f7 9 *
<> 144:ef7eb2e8f9f7 10 @verbatim
<> 144:ef7eb2e8f9f7 11 ==============================================================================
<> 144:ef7eb2e8f9f7 12 ##### How to use this driver #####
<> 144:ef7eb2e8f9f7 13 ==============================================================================
<> 144:ef7eb2e8f9f7 14 [..]
<> 144:ef7eb2e8f9f7 15 The common HAL driver contains a set of generic and common APIs that can be
<> 144:ef7eb2e8f9f7 16 used by the PPP peripheral drivers and the user to start using the HAL.
<> 144:ef7eb2e8f9f7 17 [..]
<> 144:ef7eb2e8f9f7 18 The HAL contains two APIs categories:
<> 144:ef7eb2e8f9f7 19 (+) Common HAL APIs
<> 144:ef7eb2e8f9f7 20 (+) Services HAL APIs
<> 144:ef7eb2e8f9f7 21
<> 144:ef7eb2e8f9f7 22 @endverbatim
<> 144:ef7eb2e8f9f7 23 ******************************************************************************
<> 144:ef7eb2e8f9f7 24 * @attention
<> 144:ef7eb2e8f9f7 25 *
<> 144:ef7eb2e8f9f7 26 * <h2><center>&copy; COPYRIGHT(c) 2016 STMicroelectronics</center></h2>
<> 144:ef7eb2e8f9f7 27 *
<> 144:ef7eb2e8f9f7 28 * Redistribution and use in source and binary forms, with or without modification,
<> 144:ef7eb2e8f9f7 29 * are permitted provided that the following conditions are met:
<> 144:ef7eb2e8f9f7 30 * 1. Redistributions of source code must retain the above copyright notice,
<> 144:ef7eb2e8f9f7 31 * this list of conditions and the following disclaimer.
<> 144:ef7eb2e8f9f7 32 * 2. Redistributions in binary form must reproduce the above copyright notice,
<> 144:ef7eb2e8f9f7 33 * this list of conditions and the following disclaimer in the documentation
<> 144:ef7eb2e8f9f7 34 * and/or other materials provided with the distribution.
<> 144:ef7eb2e8f9f7 35 * 3. Neither the name of STMicroelectronics nor the names of its contributors
<> 144:ef7eb2e8f9f7 36 * may be used to endorse or promote products derived from this software
<> 144:ef7eb2e8f9f7 37 * without specific prior written permission.
<> 144:ef7eb2e8f9f7 38 *
<> 144:ef7eb2e8f9f7 39 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
<> 144:ef7eb2e8f9f7 40 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
<> 144:ef7eb2e8f9f7 41 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
<> 144:ef7eb2e8f9f7 42 * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
<> 144:ef7eb2e8f9f7 43 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
<> 144:ef7eb2e8f9f7 44 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
<> 144:ef7eb2e8f9f7 45 * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
<> 144:ef7eb2e8f9f7 46 * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
<> 144:ef7eb2e8f9f7 47 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
<> 144:ef7eb2e8f9f7 48 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
<> 144:ef7eb2e8f9f7 49 *
<> 144:ef7eb2e8f9f7 50 ******************************************************************************
<> 144:ef7eb2e8f9f7 51 */
<> 144:ef7eb2e8f9f7 52
<> 144:ef7eb2e8f9f7 53 /* Includes ------------------------------------------------------------------*/
<> 144:ef7eb2e8f9f7 54 #include "stm32l0xx_hal.h"
<> 144:ef7eb2e8f9f7 55
<> 144:ef7eb2e8f9f7 56 /** @addtogroup STM32L0xx_HAL_Driver
<> 144:ef7eb2e8f9f7 57 * @{
<> 144:ef7eb2e8f9f7 58 */
<> 144:ef7eb2e8f9f7 59
<> 144:ef7eb2e8f9f7 60 #ifdef HAL_MODULE_ENABLED
<> 144:ef7eb2e8f9f7 61
<> 144:ef7eb2e8f9f7 62 /** @addtogroup HAL
<> 144:ef7eb2e8f9f7 63 * @brief HAL module driver.
<> 144:ef7eb2e8f9f7 64 * @{
<> 144:ef7eb2e8f9f7 65 */
<> 144:ef7eb2e8f9f7 66
<> 144:ef7eb2e8f9f7 67 /** @addtogroup HAL_Exported_Constants
<> 144:ef7eb2e8f9f7 68 * @{
<> 144:ef7eb2e8f9f7 69 */
<> 144:ef7eb2e8f9f7 70
<> 144:ef7eb2e8f9f7 71 /** @defgroup HAL_Version HAL Version
<> 144:ef7eb2e8f9f7 72 * @{
<> 144:ef7eb2e8f9f7 73 */
<> 144:ef7eb2e8f9f7 74
<> 144:ef7eb2e8f9f7 75 /**
<> 144:ef7eb2e8f9f7 76 * @brief STM32L0xx HAL Driver version number V1.5.0
<> 144:ef7eb2e8f9f7 77 */
<> 144:ef7eb2e8f9f7 78 #define __STM32L0xx_HAL_VERSION_MAIN (0x01) /*!< [31:24] main version */
<> 144:ef7eb2e8f9f7 79 #define __STM32L0xx_HAL_VERSION_SUB1 (0x05) /*!< [23:16] sub1 version */
<> 144:ef7eb2e8f9f7 80 #define __STM32L0xx_HAL_VERSION_SUB2 (0x00) /*!< [15:8] sub2 version */
<> 144:ef7eb2e8f9f7 81 #define __STM32L0xx_HAL_VERSION_RC (0x00) /*!< [7:0] release candidate */
<> 144:ef7eb2e8f9f7 82 #define __STM32L0xx_HAL_VERSION ((__STM32L0xx_HAL_VERSION_MAIN << 24)\
<> 144:ef7eb2e8f9f7 83 |(__STM32L0xx_HAL_VERSION_SUB1 << 16)\
<> 144:ef7eb2e8f9f7 84 |(__STM32L0xx_HAL_VERSION_SUB2 << 8 )\
<> 144:ef7eb2e8f9f7 85 |(__STM32L0xx_HAL_VERSION_RC))
<> 144:ef7eb2e8f9f7 86
<> 144:ef7eb2e8f9f7 87 #define IDCODE_DEVID_MASK ((uint32_t)0x00000FFF)
<> 144:ef7eb2e8f9f7 88
<> 144:ef7eb2e8f9f7 89 /**
<> 144:ef7eb2e8f9f7 90 * @}
<> 144:ef7eb2e8f9f7 91 */
<> 144:ef7eb2e8f9f7 92
<> 144:ef7eb2e8f9f7 93 /**
<> 144:ef7eb2e8f9f7 94 * @}
<> 144:ef7eb2e8f9f7 95 */
<> 144:ef7eb2e8f9f7 96 /** @defgroup HAL_Private HAL Private
<> 144:ef7eb2e8f9f7 97 * @{
<> 144:ef7eb2e8f9f7 98 */
<> 144:ef7eb2e8f9f7 99 static __IO uint32_t uwTick;
<> 144:ef7eb2e8f9f7 100
<> 144:ef7eb2e8f9f7 101 /**
<> 144:ef7eb2e8f9f7 102 * @}
<> 144:ef7eb2e8f9f7 103 */
<> 144:ef7eb2e8f9f7 104
<> 144:ef7eb2e8f9f7 105 /** @addtogroup HAL_Exported_Functions HAL Exported Functions
<> 144:ef7eb2e8f9f7 106 * @{
<> 144:ef7eb2e8f9f7 107 */
<> 144:ef7eb2e8f9f7 108
<> 144:ef7eb2e8f9f7 109 /** @addtogroup HAL_Exported_Functions_Group1
<> 144:ef7eb2e8f9f7 110 * @brief Initialization and de-initialization functions
<> 144:ef7eb2e8f9f7 111 *
<> 144:ef7eb2e8f9f7 112 @verbatim
<> 144:ef7eb2e8f9f7 113 ===============================================================================
<> 144:ef7eb2e8f9f7 114 ##### Initialization and de-initialization functions #####
<> 144:ef7eb2e8f9f7 115 ===============================================================================
<> 144:ef7eb2e8f9f7 116 [..] This section provides functions allowing to:
<> 144:ef7eb2e8f9f7 117 (+) Initializes the Flash interface, the NVIC allocation and initial clock
<> 144:ef7eb2e8f9f7 118 configuration. It initializes the source of time base also when timeout
<> 144:ef7eb2e8f9f7 119 is needed and the backup domain when enabled.
<> 144:ef7eb2e8f9f7 120 (+) de-Initializes common part of the HAL.
<> 144:ef7eb2e8f9f7 121 (+) Configure The time base source to have 1ms time base with a dedicated
<> 144:ef7eb2e8f9f7 122 Tick interrupt priority.
<> 144:ef7eb2e8f9f7 123 (++) Systick timer is used by default as source of time base, but user
<> 144:ef7eb2e8f9f7 124 can eventually implement his proper time base source (a general purpose
<> 144:ef7eb2e8f9f7 125 timer for example or other time source), keeping in mind that Time base
<> 144:ef7eb2e8f9f7 126 duration should be kept 1ms since PPP_TIMEOUT_VALUEs are defined and
<> 144:ef7eb2e8f9f7 127 handled in milliseconds basis.
<> 144:ef7eb2e8f9f7 128 (++) Time base configuration function (HAL_InitTick ()) is called automatically
<> 144:ef7eb2e8f9f7 129 at the beginning of the program after reset by HAL_Init() or at any time
<> 144:ef7eb2e8f9f7 130 when clock is configured, by HAL_RCC_ClockConfig().
<> 144:ef7eb2e8f9f7 131 (++) Source of time base is configured to generate interrupts at regular
<> 144:ef7eb2e8f9f7 132 time intervals. Care must be taken if HAL_Delay() is called from a
<> 144:ef7eb2e8f9f7 133 peripheral ISR process, the Tick interrupt line must have higher priority
<> 144:ef7eb2e8f9f7 134 (numerically lower) than the peripheral interrupt. Otherwise the caller
<> 144:ef7eb2e8f9f7 135 ISR process will be blocked.
<> 144:ef7eb2e8f9f7 136 (++) functions affecting time base configurations are declared as __weak
<> 144:ef7eb2e8f9f7 137 to make override possible in case of other implementations in user file.
<> 144:ef7eb2e8f9f7 138
<> 144:ef7eb2e8f9f7 139 @endverbatim
<> 144:ef7eb2e8f9f7 140 * @{
<> 144:ef7eb2e8f9f7 141 */
<> 144:ef7eb2e8f9f7 142
<> 144:ef7eb2e8f9f7 143 /**
<> 144:ef7eb2e8f9f7 144 * @brief This function configures the Flash prefetch, Flash preread and Buffer cache,
<> 144:ef7eb2e8f9f7 145 * Configures time base source, NVIC and Low level hardware
<> 144:ef7eb2e8f9f7 146 * @note This function is called at the beginning of program after reset and before
<> 144:ef7eb2e8f9f7 147 * the clock configuration
<> 144:ef7eb2e8f9f7 148 * @note The time base configuration is based on MSI clock when exiting from Reset.
<> 144:ef7eb2e8f9f7 149 * Once done, time base tick start incrementing.
<> 144:ef7eb2e8f9f7 150 * In the default implementation,Systick is used as source of time base.
<> 144:ef7eb2e8f9f7 151 * the tick variable is incremented each 1ms in its ISR.
<> 144:ef7eb2e8f9f7 152 * @retval HAL status
<> 144:ef7eb2e8f9f7 153 */
<> 144:ef7eb2e8f9f7 154 HAL_StatusTypeDef HAL_Init(void)
<> 144:ef7eb2e8f9f7 155 {
<> 144:ef7eb2e8f9f7 156 /* Configure Buffer cache, Flash prefetch, Flash preread */
<> 144:ef7eb2e8f9f7 157 #if (BUFFER_CACHE_DISABLE != 0)
<> 144:ef7eb2e8f9f7 158 __HAL_FLASH_BUFFER_CACHE_DISABLE();
<> 144:ef7eb2e8f9f7 159 #endif /* BUFFER_CACHE_DISABLE */
<> 144:ef7eb2e8f9f7 160
<> 144:ef7eb2e8f9f7 161 #if (PREREAD_ENABLE != 0)
<> 144:ef7eb2e8f9f7 162 __HAL_FLASH_PREREAD_BUFFER_ENABLE();
<> 144:ef7eb2e8f9f7 163 #endif /* PREREAD_ENABLE */
<> 144:ef7eb2e8f9f7 164
<> 144:ef7eb2e8f9f7 165 #if (PREFETCH_ENABLE != 0)
<> 144:ef7eb2e8f9f7 166 __HAL_FLASH_PREFETCH_BUFFER_ENABLE();
<> 144:ef7eb2e8f9f7 167 #endif /* PREFETCH_ENABLE */
<> 144:ef7eb2e8f9f7 168
<> 144:ef7eb2e8f9f7 169 /* Use systick as time base source and configure 1ms tick (default clock after Reset is MSI) */
<> 144:ef7eb2e8f9f7 170
<> 144:ef7eb2e8f9f7 171 HAL_InitTick(TICK_INT_PRIORITY);
<> 144:ef7eb2e8f9f7 172
<> 144:ef7eb2e8f9f7 173 /* Init the low level hardware */
<> 144:ef7eb2e8f9f7 174 HAL_MspInit();
<> 144:ef7eb2e8f9f7 175
<> 144:ef7eb2e8f9f7 176 /* Return function status */
<> 144:ef7eb2e8f9f7 177 return HAL_OK;
<> 144:ef7eb2e8f9f7 178 }
<> 144:ef7eb2e8f9f7 179
<> 144:ef7eb2e8f9f7 180 /**
<> 144:ef7eb2e8f9f7 181 * @brief This function de-Initializes common part of the HAL and stops the source
<> 144:ef7eb2e8f9f7 182 * of time base.
<> 144:ef7eb2e8f9f7 183 * @note This function is optional.
<> 144:ef7eb2e8f9f7 184 * @retval HAL status
<> 144:ef7eb2e8f9f7 185 */
<> 144:ef7eb2e8f9f7 186 HAL_StatusTypeDef HAL_DeInit(void)
<> 144:ef7eb2e8f9f7 187 {
<> 144:ef7eb2e8f9f7 188 /* Reset of all peripherals */
<> 144:ef7eb2e8f9f7 189 __HAL_RCC_APB1_FORCE_RESET();
<> 144:ef7eb2e8f9f7 190 __HAL_RCC_APB1_RELEASE_RESET();
<> 144:ef7eb2e8f9f7 191
<> 144:ef7eb2e8f9f7 192 __HAL_RCC_APB2_FORCE_RESET();
<> 144:ef7eb2e8f9f7 193 __HAL_RCC_APB2_RELEASE_RESET();
<> 144:ef7eb2e8f9f7 194
<> 144:ef7eb2e8f9f7 195 __HAL_RCC_AHB_FORCE_RESET();
<> 144:ef7eb2e8f9f7 196 __HAL_RCC_AHB_RELEASE_RESET();
<> 144:ef7eb2e8f9f7 197
<> 144:ef7eb2e8f9f7 198 __HAL_RCC_IOP_FORCE_RESET();
<> 144:ef7eb2e8f9f7 199 __HAL_RCC_IOP_RELEASE_RESET();
<> 144:ef7eb2e8f9f7 200
<> 144:ef7eb2e8f9f7 201 /* De-Init the low level hardware */
<> 144:ef7eb2e8f9f7 202 HAL_MspDeInit();
<> 144:ef7eb2e8f9f7 203
<> 144:ef7eb2e8f9f7 204 /* Return function status */
<> 144:ef7eb2e8f9f7 205 return HAL_OK;
<> 144:ef7eb2e8f9f7 206 }
<> 144:ef7eb2e8f9f7 207
<> 144:ef7eb2e8f9f7 208 /**
<> 144:ef7eb2e8f9f7 209 * @brief Initializes the MSP.
<> 144:ef7eb2e8f9f7 210 * @retval None
<> 144:ef7eb2e8f9f7 211 */
<> 144:ef7eb2e8f9f7 212 __weak void HAL_MspInit(void)
<> 144:ef7eb2e8f9f7 213 {
<> 144:ef7eb2e8f9f7 214 /* NOTE : This function Should not be modified, when the callback is needed,
<> 144:ef7eb2e8f9f7 215 the HAL_MspInit could be implemented in the user file
<> 144:ef7eb2e8f9f7 216 */
<> 144:ef7eb2e8f9f7 217 }
<> 144:ef7eb2e8f9f7 218
<> 144:ef7eb2e8f9f7 219 /**
<> 144:ef7eb2e8f9f7 220 * @brief DeInitializes the MSP.
<> 144:ef7eb2e8f9f7 221 * @retval None
<> 144:ef7eb2e8f9f7 222 */
<> 144:ef7eb2e8f9f7 223 __weak void HAL_MspDeInit(void)
<> 144:ef7eb2e8f9f7 224 {
<> 144:ef7eb2e8f9f7 225 /* NOTE : This function Should not be modified, when the callback is needed,
<> 144:ef7eb2e8f9f7 226 the HAL_MspDeInit could be implemented in the user file
<> 144:ef7eb2e8f9f7 227 */
<> 144:ef7eb2e8f9f7 228 }
<> 144:ef7eb2e8f9f7 229
<> 144:ef7eb2e8f9f7 230
<> 144:ef7eb2e8f9f7 231 /**
<> 144:ef7eb2e8f9f7 232 * @brief This function configures the source of the time base.
<> 144:ef7eb2e8f9f7 233 * The time source is configured to have 1ms time base with a dedicated
<> 144:ef7eb2e8f9f7 234 * Tick interrupt priority.
<> 144:ef7eb2e8f9f7 235 * @note This function is called automatically at the beginning of program after
<> 144:ef7eb2e8f9f7 236 * reset by HAL_Init() or at any time when clock is reconfigured by HAL_RCC_ClockConfig().
<> 144:ef7eb2e8f9f7 237 * @note In the default implementation, SysTick timer is the source of time base.
<> 144:ef7eb2e8f9f7 238 * It is used to generate interrupts at regular time intervals.
<> 144:ef7eb2e8f9f7 239 * Care must be taken if HAL_Delay() is called from a peripheral ISR process,
<> 144:ef7eb2e8f9f7 240 * The the SysTick interrupt must have higher priority (numerically lower)
<> 144:ef7eb2e8f9f7 241 * than the peripheral interrupt. Otherwise the caller ISR process will be blocked.
<> 144:ef7eb2e8f9f7 242 * The function is declared as __Weak to be overwritten in case of other
<> 144:ef7eb2e8f9f7 243 * implementation in user file.
<> 144:ef7eb2e8f9f7 244 * @param TickPriority: Tick interrupt priority.
<> 144:ef7eb2e8f9f7 245 * @retval HAL status
<> 144:ef7eb2e8f9f7 246 */
<> 144:ef7eb2e8f9f7 247 __weak HAL_StatusTypeDef HAL_InitTick(uint32_t TickPriority)
<> 144:ef7eb2e8f9f7 248 {
<> 144:ef7eb2e8f9f7 249 /*Configure the SysTick to have interrupt in 1ms time basis*/
<> 144:ef7eb2e8f9f7 250 HAL_SYSTICK_Config(HAL_RCC_GetHCLKFreq()/1000);
<> 144:ef7eb2e8f9f7 251
<> 144:ef7eb2e8f9f7 252 /*Configure the SysTick IRQ priority */
<> 144:ef7eb2e8f9f7 253 HAL_NVIC_SetPriority(SysTick_IRQn, TickPriority ,0);
<> 144:ef7eb2e8f9f7 254
<> 144:ef7eb2e8f9f7 255 /* Return function status */
<> 144:ef7eb2e8f9f7 256 return HAL_OK;
<> 144:ef7eb2e8f9f7 257 }
<> 144:ef7eb2e8f9f7 258
<> 144:ef7eb2e8f9f7 259 /**
<> 144:ef7eb2e8f9f7 260 * @}
<> 144:ef7eb2e8f9f7 261 */
<> 144:ef7eb2e8f9f7 262
<> 144:ef7eb2e8f9f7 263 /** @addtogroup HAL_Exported_Functions_Group2
<> 144:ef7eb2e8f9f7 264 * @brief Peripheral Control functions
<> 144:ef7eb2e8f9f7 265 *
<> 144:ef7eb2e8f9f7 266 @verbatim
<> 144:ef7eb2e8f9f7 267 ===============================================================================
<> 144:ef7eb2e8f9f7 268 ##### HAL Control functions #####
<> 144:ef7eb2e8f9f7 269 ===============================================================================
<> 144:ef7eb2e8f9f7 270 [..] This section provides functions allowing to:
<> 144:ef7eb2e8f9f7 271 (+) Provide a tick value in millisecond
<> 144:ef7eb2e8f9f7 272 (+) Provide a blocking delay in millisecond
<> 144:ef7eb2e8f9f7 273 (+) Suspend the time base source interrupt
<> 144:ef7eb2e8f9f7 274 (+) Resume the time base source interrupt
<> 144:ef7eb2e8f9f7 275 (+) Get the HAL API driver version
<> 144:ef7eb2e8f9f7 276 (+) Get the device identifier
<> 144:ef7eb2e8f9f7 277 (+) Get the device revision identifier
<> 144:ef7eb2e8f9f7 278 (+) Configure low power mode behavior when the MCU is in Debug mode
<> 144:ef7eb2e8f9f7 279 (+) Manage the VEREFINT feature (activation, lock, output selection)
<> 144:ef7eb2e8f9f7 280
<> 144:ef7eb2e8f9f7 281 @endverbatim
<> 144:ef7eb2e8f9f7 282 * @{
<> 144:ef7eb2e8f9f7 283 */
<> 144:ef7eb2e8f9f7 284
<> 144:ef7eb2e8f9f7 285 /**
<> 144:ef7eb2e8f9f7 286 * @brief This function is called to increment a global variable "uwTick"
<> 144:ef7eb2e8f9f7 287 * used as application time base.
<> 144:ef7eb2e8f9f7 288 * @note In the default implementation, this variable is incremented each 1ms
<> 144:ef7eb2e8f9f7 289 * in Systick ISR.
<> 144:ef7eb2e8f9f7 290 * @note This function is declared as __weak to be overwritten in case of other
<> 144:ef7eb2e8f9f7 291 * implementations in user file.
<> 144:ef7eb2e8f9f7 292 * @retval None
<> 144:ef7eb2e8f9f7 293 */
<> 144:ef7eb2e8f9f7 294 __weak void HAL_IncTick(void)
<> 144:ef7eb2e8f9f7 295 {
<> 144:ef7eb2e8f9f7 296 uwTick++;
<> 144:ef7eb2e8f9f7 297 }
<> 144:ef7eb2e8f9f7 298
<> 144:ef7eb2e8f9f7 299 /**
<> 144:ef7eb2e8f9f7 300 * @brief Provides a tick value in millisecond.
<> 144:ef7eb2e8f9f7 301 * @note This function is declared as __weak to be overwritten in case of other
<> 144:ef7eb2e8f9f7 302 * implementations in user file.
<> 144:ef7eb2e8f9f7 303 * @retval tick value
<> 144:ef7eb2e8f9f7 304 */
<> 144:ef7eb2e8f9f7 305 __weak uint32_t HAL_GetTick(void)
<> 144:ef7eb2e8f9f7 306 {
<> 144:ef7eb2e8f9f7 307 return uwTick;
<> 144:ef7eb2e8f9f7 308 }
<> 144:ef7eb2e8f9f7 309
<> 144:ef7eb2e8f9f7 310 /**
<> 144:ef7eb2e8f9f7 311 * @brief This function provides accurate delay (in ms) based on a variable incremented.
<> 144:ef7eb2e8f9f7 312 * @note In the default implementation , SysTick timer is the source of time base.
<> 144:ef7eb2e8f9f7 313 * It is used to generate interrupts at regular time intervals where uwTick
<> 144:ef7eb2e8f9f7 314 * is incremented.
<> 144:ef7eb2e8f9f7 315 * @note ThiS function is declared as __weak to be overwritten in case of other
<> 144:ef7eb2e8f9f7 316 * implementations in user file.
<> 144:ef7eb2e8f9f7 317 * @param Delay: specifies the delay time length, in milliseconds.
<> 144:ef7eb2e8f9f7 318 * @retval None
<> 144:ef7eb2e8f9f7 319 */
<> 144:ef7eb2e8f9f7 320 __weak void HAL_Delay(__IO uint32_t Delay)
<> 144:ef7eb2e8f9f7 321 {
<> 144:ef7eb2e8f9f7 322 uint32_t tickstart = 0;
<> 144:ef7eb2e8f9f7 323 tickstart = HAL_GetTick();
<> 144:ef7eb2e8f9f7 324 while((HAL_GetTick() - tickstart) < Delay)
<> 144:ef7eb2e8f9f7 325 {
<> 144:ef7eb2e8f9f7 326 }
<> 144:ef7eb2e8f9f7 327 }
<> 144:ef7eb2e8f9f7 328
<> 144:ef7eb2e8f9f7 329 /**
<> 144:ef7eb2e8f9f7 330 * @brief Suspends the Tick increment.
<> 144:ef7eb2e8f9f7 331 * @note In the default implementation , SysTick timer is the source of time base. It is
<> 144:ef7eb2e8f9f7 332 * used to generate interrupts at regular time intervals. Once HAL_SuspendTick()
<> 144:ef7eb2e8f9f7 333 * is called, the the SysTick interrupt will be disabled and so Tick increment
<> 144:ef7eb2e8f9f7 334 * is suspended.
<> 144:ef7eb2e8f9f7 335 * @note This function is declared as __weak to be overwritten in case of other
<> 144:ef7eb2e8f9f7 336 * implementations in user file.
<> 144:ef7eb2e8f9f7 337 * @retval None
<> 144:ef7eb2e8f9f7 338 */
<> 144:ef7eb2e8f9f7 339 __weak void HAL_SuspendTick(void)
<> 144:ef7eb2e8f9f7 340 {
<> 144:ef7eb2e8f9f7 341 /* Disable SysTick Interrupt */
<> 144:ef7eb2e8f9f7 342 SysTick->CTRL &= ~SysTick_CTRL_TICKINT_Msk;
<> 144:ef7eb2e8f9f7 343 }
<> 144:ef7eb2e8f9f7 344
<> 144:ef7eb2e8f9f7 345 /**
<> 144:ef7eb2e8f9f7 346 * @brief Resumes the Tick increment.
<> 144:ef7eb2e8f9f7 347 * @note In the default implementation , SysTick timer is the source of time base. It is
<> 144:ef7eb2e8f9f7 348 * used to generate interrupts at regular time intervals. Once HAL_ResumeTick()
<> 144:ef7eb2e8f9f7 349 * is called, the the SysTick interrupt will be enabled and so Tick increment
<> 144:ef7eb2e8f9f7 350 * is resumed.
<> 144:ef7eb2e8f9f7 351 * @note This function is declared as __weak to be overwritten in case of other
<> 144:ef7eb2e8f9f7 352 * implementations in user file.
<> 144:ef7eb2e8f9f7 353 * @retval None
<> 144:ef7eb2e8f9f7 354 */
<> 144:ef7eb2e8f9f7 355 __weak void HAL_ResumeTick(void)
<> 144:ef7eb2e8f9f7 356 {
<> 144:ef7eb2e8f9f7 357 /* Enable SysTick Interrupt */
<> 144:ef7eb2e8f9f7 358 SysTick->CTRL |= SysTick_CTRL_TICKINT_Msk;
<> 144:ef7eb2e8f9f7 359 }
<> 144:ef7eb2e8f9f7 360
<> 144:ef7eb2e8f9f7 361 /**
<> 144:ef7eb2e8f9f7 362 * @brief Returns the HAL revision
<> 144:ef7eb2e8f9f7 363 * @retval version: 0xXYZR (8bits for each decimal, R for RC)
<> 144:ef7eb2e8f9f7 364 */
<> 144:ef7eb2e8f9f7 365 uint32_t HAL_GetHalVersion(void)
<> 144:ef7eb2e8f9f7 366 {
<> 144:ef7eb2e8f9f7 367 return __STM32L0xx_HAL_VERSION;
<> 144:ef7eb2e8f9f7 368 }
<> 144:ef7eb2e8f9f7 369
<> 144:ef7eb2e8f9f7 370 /**
<> 144:ef7eb2e8f9f7 371 * @brief Returns the device revision identifier.
<> 144:ef7eb2e8f9f7 372 * @retval Device revision identifier
<> 144:ef7eb2e8f9f7 373 */
<> 144:ef7eb2e8f9f7 374 uint32_t HAL_GetREVID(void)
<> 144:ef7eb2e8f9f7 375 {
<> 144:ef7eb2e8f9f7 376 return((DBGMCU->IDCODE) >> 16);
<> 144:ef7eb2e8f9f7 377 }
<> 144:ef7eb2e8f9f7 378
<> 144:ef7eb2e8f9f7 379 /**
<> 144:ef7eb2e8f9f7 380 * @brief Returns the device identifier.
<> 144:ef7eb2e8f9f7 381 * @retval Device identifier
<> 144:ef7eb2e8f9f7 382 */
<> 144:ef7eb2e8f9f7 383 uint32_t HAL_GetDEVID(void)
<> 144:ef7eb2e8f9f7 384 {
<> 144:ef7eb2e8f9f7 385 return((DBGMCU->IDCODE) & IDCODE_DEVID_MASK);
<> 144:ef7eb2e8f9f7 386 }
<> 144:ef7eb2e8f9f7 387
<> 144:ef7eb2e8f9f7 388 /**
<> 144:ef7eb2e8f9f7 389 * @brief Enables the Debug Module during SLEEP mode
<> 144:ef7eb2e8f9f7 390 * @retval None
<> 144:ef7eb2e8f9f7 391 */
<> 144:ef7eb2e8f9f7 392 void HAL_DBGMCU_EnableDBGSleepMode(void)
<> 144:ef7eb2e8f9f7 393 {
<> 144:ef7eb2e8f9f7 394 SET_BIT(DBGMCU->CR, DBGMCU_CR_DBG_SLEEP);
<> 144:ef7eb2e8f9f7 395 }
<> 144:ef7eb2e8f9f7 396
<> 144:ef7eb2e8f9f7 397 /**
<> 144:ef7eb2e8f9f7 398 * @brief Disables the Debug Module during SLEEP mode
<> 144:ef7eb2e8f9f7 399 * @retval None
<> 144:ef7eb2e8f9f7 400 */
<> 144:ef7eb2e8f9f7 401 void HAL_DBGMCU_DisableDBGSleepMode(void)
<> 144:ef7eb2e8f9f7 402 {
<> 144:ef7eb2e8f9f7 403 CLEAR_BIT(DBGMCU->CR, DBGMCU_CR_DBG_SLEEP);
<> 144:ef7eb2e8f9f7 404 }
<> 144:ef7eb2e8f9f7 405
<> 144:ef7eb2e8f9f7 406 /**
<> 144:ef7eb2e8f9f7 407 * @brief Enables the Debug Module during STOP mode
<> 144:ef7eb2e8f9f7 408 * @retval None
<> 144:ef7eb2e8f9f7 409 */
<> 144:ef7eb2e8f9f7 410 void HAL_DBGMCU_EnableDBGStopMode(void)
<> 144:ef7eb2e8f9f7 411 {
<> 144:ef7eb2e8f9f7 412 SET_BIT(DBGMCU->CR, DBGMCU_CR_DBG_STOP);
<> 144:ef7eb2e8f9f7 413 }
<> 144:ef7eb2e8f9f7 414
<> 144:ef7eb2e8f9f7 415 /**
<> 144:ef7eb2e8f9f7 416 * @brief Disables the Debug Module during STOP mode
<> 144:ef7eb2e8f9f7 417 * @retval None
<> 144:ef7eb2e8f9f7 418 */
<> 144:ef7eb2e8f9f7 419 void HAL_DBGMCU_DisableDBGStopMode(void)
<> 144:ef7eb2e8f9f7 420 {
<> 144:ef7eb2e8f9f7 421 CLEAR_BIT(DBGMCU->CR, DBGMCU_CR_DBG_STOP);
<> 144:ef7eb2e8f9f7 422 }
<> 144:ef7eb2e8f9f7 423
<> 144:ef7eb2e8f9f7 424 /**
<> 144:ef7eb2e8f9f7 425 * @brief Enables the Debug Module during STANDBY mode
<> 144:ef7eb2e8f9f7 426 * @retval None
<> 144:ef7eb2e8f9f7 427 */
<> 144:ef7eb2e8f9f7 428 void HAL_DBGMCU_EnableDBGStandbyMode(void)
<> 144:ef7eb2e8f9f7 429 {
<> 144:ef7eb2e8f9f7 430 SET_BIT(DBGMCU->CR, DBGMCU_CR_DBG_STANDBY);
<> 144:ef7eb2e8f9f7 431 }
<> 144:ef7eb2e8f9f7 432
<> 144:ef7eb2e8f9f7 433 /**
<> 144:ef7eb2e8f9f7 434 * @brief Disables the Debug Module during STANDBY mode
<> 144:ef7eb2e8f9f7 435 * @retval None
<> 144:ef7eb2e8f9f7 436 */
<> 144:ef7eb2e8f9f7 437 void HAL_DBGMCU_DisableDBGStandbyMode(void)
<> 144:ef7eb2e8f9f7 438 {
<> 144:ef7eb2e8f9f7 439 CLEAR_BIT(DBGMCU->CR, DBGMCU_CR_DBG_STANDBY);
<> 144:ef7eb2e8f9f7 440 }
<> 144:ef7eb2e8f9f7 441
<> 144:ef7eb2e8f9f7 442 /**
<> 144:ef7eb2e8f9f7 443 * @brief Enable low power mode behavior when the MCU is in Debug mode.
<> 144:ef7eb2e8f9f7 444 * @param Periph: specifies the low power mode.
<> 144:ef7eb2e8f9f7 445 * This parameter can be any combination of the following values:
<> 144:ef7eb2e8f9f7 446 * @arg DBGMCU_SLEEP: Keep debugger connection during SLEEP mode
<> 144:ef7eb2e8f9f7 447 * @arg DBGMCU_STOP: Keep debugger connection during STOP mode
<> 144:ef7eb2e8f9f7 448 * @arg DBGMCU_STANDBY: Keep debugger connection during STANDBY mode
<> 144:ef7eb2e8f9f7 449 * @retval None
<> 144:ef7eb2e8f9f7 450 */
<> 144:ef7eb2e8f9f7 451 void HAL_DBGMCU_DBG_EnableLowPowerConfig(uint32_t Periph)
<> 144:ef7eb2e8f9f7 452 {
<> 144:ef7eb2e8f9f7 453 /* Check the parameters */
<> 144:ef7eb2e8f9f7 454 assert_param(IS_DBGMCU_PERIPH(Periph));
<> 144:ef7eb2e8f9f7 455
<> 144:ef7eb2e8f9f7 456 DBGMCU->CR |= Periph;
<> 144:ef7eb2e8f9f7 457
<> 144:ef7eb2e8f9f7 458 }
<> 144:ef7eb2e8f9f7 459 /**
<> 144:ef7eb2e8f9f7 460 * @brief Disable low power mode behavior when the MCU is in Debug mode.
<> 144:ef7eb2e8f9f7 461 * @param Periph: specifies the low power mode.
<> 144:ef7eb2e8f9f7 462 * This parameter can be any combination of the following values:
<> 144:ef7eb2e8f9f7 463 * @arg DBGMCU_SLEEP: Keep debugger connection during SLEEP mode
<> 144:ef7eb2e8f9f7 464 * @arg DBGMCU_STOP: Keep debugger connection during STOP mode
<> 144:ef7eb2e8f9f7 465 * @arg DBGMCU_STANDBY: Keep debugger connection during STANDBY mode
<> 144:ef7eb2e8f9f7 466 * @retval None
<> 144:ef7eb2e8f9f7 467 */
<> 144:ef7eb2e8f9f7 468 void HAL_DBGMCU_DBG_DisableLowPowerConfig(uint32_t Periph)
<> 144:ef7eb2e8f9f7 469 {
<> 144:ef7eb2e8f9f7 470 /* Check the parameters */
<> 144:ef7eb2e8f9f7 471 assert_param(IS_DBGMCU_PERIPH(Periph));
<> 144:ef7eb2e8f9f7 472 {
<> 144:ef7eb2e8f9f7 473 DBGMCU->CR &= ~Periph;
<> 144:ef7eb2e8f9f7 474 }
<> 144:ef7eb2e8f9f7 475 }
<> 144:ef7eb2e8f9f7 476
<> 144:ef7eb2e8f9f7 477 /**
<> 144:ef7eb2e8f9f7 478 * @brief Returns the boot mode as configured by user.
<> 144:ef7eb2e8f9f7 479 * @retval The boot mode as configured by user. The returned value can be one
<> 144:ef7eb2e8f9f7 480 * of the following values:
<> 144:ef7eb2e8f9f7 481 * - 0x00000000 : Boot is configured in Main Flash memory
<> 144:ef7eb2e8f9f7 482 * - 0x00000100 : Boot is configured in System Flash memory
<> 144:ef7eb2e8f9f7 483 * - 0x00000300 : Boot is configured in Embedded SRAM memory
<> 144:ef7eb2e8f9f7 484 */
<> 144:ef7eb2e8f9f7 485 uint32_t HAL_SYSCFG_GetBootMode(void)
<> 144:ef7eb2e8f9f7 486 {
<> 144:ef7eb2e8f9f7 487 return (SYSCFG->CFGR1 & SYSCFG_CFGR1_BOOT_MODE);
<> 144:ef7eb2e8f9f7 488 }
<> 144:ef7eb2e8f9f7 489
<> 144:ef7eb2e8f9f7 490 /**
<> 144:ef7eb2e8f9f7 491 * @brief Enables the VREFINT.
<> 144:ef7eb2e8f9f7 492 * @retval None
<> 144:ef7eb2e8f9f7 493 */
<> 144:ef7eb2e8f9f7 494 void HAL_SYSCFG_EnableVREFINT(void)
<> 144:ef7eb2e8f9f7 495 {
<> 144:ef7eb2e8f9f7 496 /* Enable the VREFINT by setting EN_VREFINT bit in the CFGR3 register */
<> 144:ef7eb2e8f9f7 497 SET_BIT(SYSCFG->CFGR3, SYSCFG_CFGR3_EN_VREFINT);
<> 144:ef7eb2e8f9f7 498 }
<> 144:ef7eb2e8f9f7 499
<> 144:ef7eb2e8f9f7 500 /**
<> 144:ef7eb2e8f9f7 501 * @brief Disables the VREFINT.
<> 144:ef7eb2e8f9f7 502 * @retval None
<> 144:ef7eb2e8f9f7 503 */
<> 144:ef7eb2e8f9f7 504 void HAL_SYSCFG_DisableVREFINT(void)
<> 144:ef7eb2e8f9f7 505 {
<> 144:ef7eb2e8f9f7 506 /* Disable the VREFINT by setting EN_VREFINT bit in the CFGR3 register */
<> 144:ef7eb2e8f9f7 507 CLEAR_BIT(SYSCFG->CFGR3,SYSCFG_CFGR3_EN_VREFINT);
<> 144:ef7eb2e8f9f7 508 }
<> 144:ef7eb2e8f9f7 509 /**
<> 144:ef7eb2e8f9f7 510 * @brief Selects the output of internal reference voltage (VREFINT).
<> 144:ef7eb2e8f9f7 511 * The VREFINT output can be routed to(PB0) or
<> 144:ef7eb2e8f9f7 512 * (PB1) or both.
<> 144:ef7eb2e8f9f7 513 * @param SYSCFG_Vrefint_OUTPUT: new state of the Vrefint output.
<> 144:ef7eb2e8f9f7 514 * This parameter can be one of the following values:
<> 144:ef7eb2e8f9f7 515 * @arg SYSCFG_VREFINT_OUT_NONE
<> 144:ef7eb2e8f9f7 516 * @arg SYSCFG_VREFINT_OUT_PB0
<> 144:ef7eb2e8f9f7 517 * @arg SYSCFG_VREFINT_OUT_PB1
<> 144:ef7eb2e8f9f7 518 * @arg SYSCFG_VREFINT_OUT_PB0_PB1
<> 144:ef7eb2e8f9f7 519 * @retval None
<> 144:ef7eb2e8f9f7 520 */
<> 144:ef7eb2e8f9f7 521 void HAL_SYSCFG_VREFINT_OutputSelect(uint32_t SYSCFG_Vrefint_OUTPUT)
<> 144:ef7eb2e8f9f7 522 {
<> 144:ef7eb2e8f9f7 523 /* Check the parameters */
<> 144:ef7eb2e8f9f7 524 assert_param(IS_SYSCFG_VREFINT_OUT_SELECT(SYSCFG_Vrefint_OUTPUT));
<> 144:ef7eb2e8f9f7 525
<> 144:ef7eb2e8f9f7 526 /* Set the output Vrefint pin */
<> 144:ef7eb2e8f9f7 527 SYSCFG->CFGR3 &= ~(SYSCFG_CFGR3_VREF_OUT);
<> 144:ef7eb2e8f9f7 528 SYSCFG->CFGR3 |= (uint32_t)(SYSCFG_Vrefint_OUTPUT);
<> 144:ef7eb2e8f9f7 529 }
<> 144:ef7eb2e8f9f7 530
<> 144:ef7eb2e8f9f7 531 /**
<> 144:ef7eb2e8f9f7 532 * @brief Lock the SYSCFG VREF register values
<> 144:ef7eb2e8f9f7 533 * @retval None
<> 144:ef7eb2e8f9f7 534 */
<> 144:ef7eb2e8f9f7 535 void HAL_SYSCFG_Enable_Lock_VREFINT(void)
<> 144:ef7eb2e8f9f7 536 {
<> 144:ef7eb2e8f9f7 537 /* Enable the LOCK by setting REF_LOCK bit in the CFGR3 register */
<> 144:ef7eb2e8f9f7 538 SET_BIT(SYSCFG->CFGR3, SYSCFG_CFGR3_REF_LOCK);
<> 144:ef7eb2e8f9f7 539 }
<> 144:ef7eb2e8f9f7 540
<> 144:ef7eb2e8f9f7 541 /**
<> 144:ef7eb2e8f9f7 542 * @brief Unlock the overall SYSCFG VREF register values
<> 144:ef7eb2e8f9f7 543 * @retval None
<> 144:ef7eb2e8f9f7 544 */
<> 144:ef7eb2e8f9f7 545 void HAL_SYSCFG_Disable_Lock_VREFINT(void)
<> 144:ef7eb2e8f9f7 546 {
<> 144:ef7eb2e8f9f7 547 /* Disable the LOCK by setting REF_LOCK bit in the CFGR3 register */
<> 144:ef7eb2e8f9f7 548 CLEAR_BIT(SYSCFG->CFGR3, SYSCFG_CFGR3_REF_LOCK);
<> 144:ef7eb2e8f9f7 549 }
<> 144:ef7eb2e8f9f7 550
<> 144:ef7eb2e8f9f7 551 /**
<> 144:ef7eb2e8f9f7 552 * @}
<> 144:ef7eb2e8f9f7 553 */
<> 144:ef7eb2e8f9f7 554
<> 144:ef7eb2e8f9f7 555 /**
<> 144:ef7eb2e8f9f7 556 * @}
<> 144:ef7eb2e8f9f7 557 */
<> 144:ef7eb2e8f9f7 558
<> 144:ef7eb2e8f9f7 559 /**
<> 144:ef7eb2e8f9f7 560 * @}
<> 144:ef7eb2e8f9f7 561 */
<> 144:ef7eb2e8f9f7 562 #endif /* HAL_MODULE_ENABLED */
<> 144:ef7eb2e8f9f7 563 /**
<> 144:ef7eb2e8f9f7 564 * @}
<> 144:ef7eb2e8f9f7 565 */
<> 144:ef7eb2e8f9f7 566
<> 144:ef7eb2e8f9f7 567 /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/
<> 144:ef7eb2e8f9f7 568