shao ziyang / 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.

Dependents:   SensorTileTest

Fork of mbed-dev by mbed official

targets/TARGET_STM/TARGET_STM32L0/device/stm32l0xx_hal.c@154:1375a99fb16d, 2017-01-02 (annotated)

Committer:
shaoziyang
Date:
Mon Jan 02 15:52:04 2017 +0000
Revision:
154:1375a99fb16d
Parent:
151:5eaa88a5bcc7 
Mbed for ST SensorTile kit, fixed GPIOG bug, add PORTG support.

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