Chau Vo / 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_STM32L1/stm32l1xx_hal.c@144:ef7eb2e8f9f7, 2016-09-02 (annotated)

Committer:
<>
Date:
Fri Sep 02 15:07:44 2016 +0100
Revision:
144:ef7eb2e8f9f7
Parent:
0:9b334a45a8ff 
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 stm32l1xx_hal.c
<> 144:ef7eb2e8f9f7 4 * @author MCD Application Team
<> 144:ef7eb2e8f9f7 5 * @version V1.1.3
<> 144:ef7eb2e8f9f7 6 * @date 04-March-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 "stm32l1xx_hal.h"
<> 144:ef7eb2e8f9f7 55
<> 144:ef7eb2e8f9f7 56 /** @addtogroup STM32L1xx_HAL_Driver
<> 144:ef7eb2e8f9f7 57 * @{
<> 144:ef7eb2e8f9f7 58 */
<> 144:ef7eb2e8f9f7 59
<> 144:ef7eb2e8f9f7 60 /** @defgroup HAL HAL
<> 144:ef7eb2e8f9f7 61 * @brief HAL module driver.
<> 144:ef7eb2e8f9f7 62 * @{
<> 144:ef7eb2e8f9f7 63 */
<> 144:ef7eb2e8f9f7 64
<> 144:ef7eb2e8f9f7 65 #ifdef HAL_MODULE_ENABLED
<> 144:ef7eb2e8f9f7 66
<> 144:ef7eb2e8f9f7 67 /* Private typedef -----------------------------------------------------------*/
<> 144:ef7eb2e8f9f7 68 /* Private define ------------------------------------------------------------*/
<> 144:ef7eb2e8f9f7 69
<> 144:ef7eb2e8f9f7 70 /** @defgroup HAL_Private_Defines HAL Private Defines
<> 144:ef7eb2e8f9f7 71 * @{
<> 144:ef7eb2e8f9f7 72 */
<> 144:ef7eb2e8f9f7 73
<> 144:ef7eb2e8f9f7 74 /**
<> 144:ef7eb2e8f9f7 75 * @brief STM32L1xx HAL Driver version number V1.1.3
<> 144:ef7eb2e8f9f7 76 */
<> 144:ef7eb2e8f9f7 77 #define __STM32L1xx_HAL_VERSION_MAIN (0x01) /*!< [31:24] main version */
<> 144:ef7eb2e8f9f7 78 #define __STM32L1xx_HAL_VERSION_SUB1 (0x01) /*!< [23:16] sub1 version */
<> 144:ef7eb2e8f9f7 79 #define __STM32L1xx_HAL_VERSION_SUB2 (0x03) /*!< [15:8] sub2 version */
<> 144:ef7eb2e8f9f7 80 #define __STM32L1xx_HAL_VERSION_RC (0x00) /*!< [7:0] release candidate */
<> 144:ef7eb2e8f9f7 81 #define __STM32L1xx_HAL_VERSION ((__STM32L1xx_HAL_VERSION_MAIN << 24)\
<> 144:ef7eb2e8f9f7 82 |(__STM32L1xx_HAL_VERSION_SUB1 << 16)\
<> 144:ef7eb2e8f9f7 83 |(__STM32L1xx_HAL_VERSION_SUB2 << 8 )\
<> 144:ef7eb2e8f9f7 84 |(__STM32L1xx_HAL_VERSION_RC))
<> 144:ef7eb2e8f9f7 85
<> 144:ef7eb2e8f9f7 86 #define IDCODE_DEVID_MASK ((uint32_t)0x00000FFF)
<> 144:ef7eb2e8f9f7 87
<> 144:ef7eb2e8f9f7 88 /**
<> 144:ef7eb2e8f9f7 89 * @}
<> 144:ef7eb2e8f9f7 90 */
<> 144:ef7eb2e8f9f7 91
<> 144:ef7eb2e8f9f7 92 /* Private macro -------------------------------------------------------------*/
<> 144:ef7eb2e8f9f7 93 /* Private variables ---------------------------------------------------------*/
<> 144:ef7eb2e8f9f7 94
<> 144:ef7eb2e8f9f7 95 /** @defgroup HAL_Private_Variables HAL Private Variables
<> 144:ef7eb2e8f9f7 96 * @{
<> 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 /* Private function prototypes -----------------------------------------------*/
<> 144:ef7eb2e8f9f7 106 /* Private functions ---------------------------------------------------------*/
<> 144:ef7eb2e8f9f7 107
<> 144:ef7eb2e8f9f7 108 /** @defgroup HAL_Exported_Functions HAL Exported Functions
<> 144:ef7eb2e8f9f7 109 * @{
<> 144:ef7eb2e8f9f7 110 */
<> 144:ef7eb2e8f9f7 111
<> 144:ef7eb2e8f9f7 112 /** @defgroup HAL_Exported_Functions_Group1 Initialization and de-initialization Functions
<> 144:ef7eb2e8f9f7 113 * @brief Initialization and de-initialization functions
<> 144:ef7eb2e8f9f7 114 *
<> 144:ef7eb2e8f9f7 115 @verbatim
<> 144:ef7eb2e8f9f7 116 ===============================================================================
<> 144:ef7eb2e8f9f7 117 ##### Initialization and de-initialization functions #####
<> 144:ef7eb2e8f9f7 118 ===============================================================================
<> 144:ef7eb2e8f9f7 119 [..] This section provides functions allowing to:
<> 144:ef7eb2e8f9f7 120 (+) Initializes the Flash interface, the NVIC allocation and initial clock
<> 144:ef7eb2e8f9f7 121 configuration. It initializes the source of time base also when timeout
<> 144:ef7eb2e8f9f7 122 is needed and the backup domain when enabled.
<> 144:ef7eb2e8f9f7 123 (+) de-Initializes common part of the HAL.
<> 144:ef7eb2e8f9f7 124 (+) Configure The time base source to have 1ms time base with a dedicated
<> 144:ef7eb2e8f9f7 125 Tick interrupt priority.
<> 144:ef7eb2e8f9f7 126 (++) Systick timer is used by default as source of time base, but user
<> 144:ef7eb2e8f9f7 127 can eventually implement his proper time base source (a general purpose
<> 144:ef7eb2e8f9f7 128 timer for example or other time source), keeping in mind that Time base
<> 144:ef7eb2e8f9f7 129 duration should be kept 1ms since PPP_TIMEOUT_VALUEs are defined and
<> 144:ef7eb2e8f9f7 130 handled in milliseconds basis.
<> 144:ef7eb2e8f9f7 131 (++) Time base configuration function (HAL_InitTick ()) is called automatically
<> 144:ef7eb2e8f9f7 132 at the beginning of the program after reset by HAL_Init() or at any time
<> 144:ef7eb2e8f9f7 133 when clock is configured, by HAL_RCC_ClockConfig().
<> 144:ef7eb2e8f9f7 134 (++) Source of time base is configured to generate interrupts at regular
<> 144:ef7eb2e8f9f7 135 time intervals. Care must be taken if HAL_Delay() is called from a
<> 144:ef7eb2e8f9f7 136 peripheral ISR process, the Tick interrupt line must have higher priority
<> 144:ef7eb2e8f9f7 137 (numerically lower) than the peripheral interrupt. Otherwise the caller
<> 144:ef7eb2e8f9f7 138 ISR process will be blocked.
<> 144:ef7eb2e8f9f7 139 (++) functions affecting time base configurations are declared as __Weak
<> 144:ef7eb2e8f9f7 140 to make override possible in case of other implementations in user file.
<> 144:ef7eb2e8f9f7 141
<> 144:ef7eb2e8f9f7 142 @endverbatim
<> 144:ef7eb2e8f9f7 143 * @{
<> 144:ef7eb2e8f9f7 144 */
<> 144:ef7eb2e8f9f7 145
<> 144:ef7eb2e8f9f7 146 /**
<> 144:ef7eb2e8f9f7 147 * @brief This function configures the Flash prefetch,
<> 144:ef7eb2e8f9f7 148 * Configures time base source, NVIC and Low level hardware
<> 144:ef7eb2e8f9f7 149 * @note This function is called at the beginning of program after reset and before
<> 144:ef7eb2e8f9f7 150 * the clock configuration
<> 144:ef7eb2e8f9f7 151 * @note The time base configuration is based on MSI clock when exiting from Reset.
<> 144:ef7eb2e8f9f7 152 * Once done, time base tick start incrementing.
<> 144:ef7eb2e8f9f7 153 * In the default implementation,Systick is used as source of time base.
<> 144:ef7eb2e8f9f7 154 * the tick variable is incremented each 1ms in its ISR.
<> 144:ef7eb2e8f9f7 155 * @retval HAL status
<> 144:ef7eb2e8f9f7 156 */
<> 144:ef7eb2e8f9f7 157 HAL_StatusTypeDef HAL_Init(void)
<> 144:ef7eb2e8f9f7 158 {
<> 144:ef7eb2e8f9f7 159 /* Configure Flash prefetch */
<> 144:ef7eb2e8f9f7 160 #if (PREFETCH_ENABLE != 0)
<> 144:ef7eb2e8f9f7 161 __HAL_FLASH_PREFETCH_BUFFER_ENABLE();
<> 144:ef7eb2e8f9f7 162 #endif /* PREFETCH_ENABLE */
<> 144:ef7eb2e8f9f7 163
<> 144:ef7eb2e8f9f7 164 /* Set Interrupt Group Priority */
<> 144:ef7eb2e8f9f7 165 HAL_NVIC_SetPriorityGrouping(NVIC_PRIORITYGROUP_4);
<> 144:ef7eb2e8f9f7 166
<> 144:ef7eb2e8f9f7 167 /* Use systick as time base source and configure 1ms tick (default clock after Reset is MSI) */
<> 144:ef7eb2e8f9f7 168 HAL_InitTick(TICK_INT_PRIORITY);
<> 144:ef7eb2e8f9f7 169
<> 144:ef7eb2e8f9f7 170 /* Init the low level hardware */
<> 144:ef7eb2e8f9f7 171 HAL_MspInit();
<> 144:ef7eb2e8f9f7 172
<> 144:ef7eb2e8f9f7 173 /* Return function status */
<> 144:ef7eb2e8f9f7 174 return HAL_OK;
<> 144:ef7eb2e8f9f7 175 }
<> 144:ef7eb2e8f9f7 176
<> 144:ef7eb2e8f9f7 177 /**
<> 144:ef7eb2e8f9f7 178 * @brief This function de-Initializes common part of the HAL and stops the source
<> 144:ef7eb2e8f9f7 179 * of time base.
<> 144:ef7eb2e8f9f7 180 * @note This function is optional.
<> 144:ef7eb2e8f9f7 181 * @retval HAL status
<> 144:ef7eb2e8f9f7 182 */
<> 144:ef7eb2e8f9f7 183 HAL_StatusTypeDef HAL_DeInit(void)
<> 144:ef7eb2e8f9f7 184 {
<> 144:ef7eb2e8f9f7 185 /* Reset of all peripherals */
<> 144:ef7eb2e8f9f7 186 __HAL_RCC_APB1_FORCE_RESET();
<> 144:ef7eb2e8f9f7 187 __HAL_RCC_APB1_RELEASE_RESET();
<> 144:ef7eb2e8f9f7 188
<> 144:ef7eb2e8f9f7 189 __HAL_RCC_APB2_FORCE_RESET();
<> 144:ef7eb2e8f9f7 190 __HAL_RCC_APB2_RELEASE_RESET();
<> 144:ef7eb2e8f9f7 191
<> 144:ef7eb2e8f9f7 192 __HAL_RCC_AHB_FORCE_RESET();
<> 144:ef7eb2e8f9f7 193 __HAL_RCC_AHB_RELEASE_RESET();
<> 144:ef7eb2e8f9f7 194
<> 144:ef7eb2e8f9f7 195 /* De-Init the low level hardware */
<> 144:ef7eb2e8f9f7 196 HAL_MspDeInit();
<> 144:ef7eb2e8f9f7 197
<> 144:ef7eb2e8f9f7 198 /* Return function status */
<> 144:ef7eb2e8f9f7 199 return HAL_OK;
<> 144:ef7eb2e8f9f7 200 }
<> 144:ef7eb2e8f9f7 201
<> 144:ef7eb2e8f9f7 202 /**
<> 144:ef7eb2e8f9f7 203 * @brief Initializes the MSP.
<> 144:ef7eb2e8f9f7 204 * @retval None
<> 144:ef7eb2e8f9f7 205 */
<> 144:ef7eb2e8f9f7 206 __weak void HAL_MspInit(void)
<> 144:ef7eb2e8f9f7 207 {
<> 144:ef7eb2e8f9f7 208 /* NOTE : This function Should not be modified, when the callback is needed,
<> 144:ef7eb2e8f9f7 209 the HAL_MspInit could be implemented in the user file
<> 144:ef7eb2e8f9f7 210 */
<> 144:ef7eb2e8f9f7 211 }
<> 144:ef7eb2e8f9f7 212
<> 144:ef7eb2e8f9f7 213 /**
<> 144:ef7eb2e8f9f7 214 * @brief DeInitializes the MSP.
<> 144:ef7eb2e8f9f7 215 * @retval None
<> 144:ef7eb2e8f9f7 216 */
<> 144:ef7eb2e8f9f7 217 __weak void HAL_MspDeInit(void)
<> 144:ef7eb2e8f9f7 218 {
<> 144:ef7eb2e8f9f7 219 /* NOTE : This function Should not be modified, when the callback is needed,
<> 144:ef7eb2e8f9f7 220 the HAL_MspDeInit could be implemented in the user file
<> 144:ef7eb2e8f9f7 221 */
<> 144:ef7eb2e8f9f7 222 }
<> 144:ef7eb2e8f9f7 223
<> 144:ef7eb2e8f9f7 224 /**
<> 144:ef7eb2e8f9f7 225 * @brief This function configures the source of the time base.
<> 144:ef7eb2e8f9f7 226 * The time source is configured to have 1ms time base with a dedicated
<> 144:ef7eb2e8f9f7 227 * Tick interrupt priority.
<> 144:ef7eb2e8f9f7 228 * @note This function is called automatically at the beginning of program after
<> 144:ef7eb2e8f9f7 229 * reset by HAL_Init() or at any time when clock is reconfigured by HAL_RCC_ClockConfig().
<> 144:ef7eb2e8f9f7 230 * @note In the default implementation, SysTick timer is the source of time base.
<> 144:ef7eb2e8f9f7 231 * It is used to generate interrupts at regular time intervals.
<> 144:ef7eb2e8f9f7 232 * Care must be taken if HAL_Delay() is called from a peripheral ISR process,
<> 144:ef7eb2e8f9f7 233 * The the SysTick interrupt must have higher priority (numerically lower)
<> 144:ef7eb2e8f9f7 234 * than the peripheral interrupt. Otherwise the caller ISR process will be blocked.
<> 144:ef7eb2e8f9f7 235 * The function is declared as __Weak to be overwritten in case of other
<> 144:ef7eb2e8f9f7 236 * implementation in user file.
<> 144:ef7eb2e8f9f7 237 * @param TickPriority: Tick interrupt priority.
<> 144:ef7eb2e8f9f7 238 * @retval HAL status
<> 144:ef7eb2e8f9f7 239 */
<> 144:ef7eb2e8f9f7 240 __weak HAL_StatusTypeDef HAL_InitTick(uint32_t TickPriority)
<> 144:ef7eb2e8f9f7 241 {
<> 144:ef7eb2e8f9f7 242 /*Configure the SysTick to have interrupt in 1ms time basis*/
<> 144:ef7eb2e8f9f7 243 HAL_SYSTICK_Config(SystemCoreClock /1000);
<> 144:ef7eb2e8f9f7 244
<> 144:ef7eb2e8f9f7 245 /*Configure the SysTick IRQ priority */
<> 144:ef7eb2e8f9f7 246 HAL_NVIC_SetPriority(SysTick_IRQn, TickPriority ,0);
<> 144:ef7eb2e8f9f7 247
<> 144:ef7eb2e8f9f7 248 /* Return function status */
<> 144:ef7eb2e8f9f7 249 return HAL_OK;
<> 144:ef7eb2e8f9f7 250 }
<> 144:ef7eb2e8f9f7 251
<> 144:ef7eb2e8f9f7 252 /**
<> 144:ef7eb2e8f9f7 253 * @}
<> 144:ef7eb2e8f9f7 254 */
<> 144:ef7eb2e8f9f7 255
<> 144:ef7eb2e8f9f7 256 /** @defgroup HAL_Exported_Functions_Group2 HAL Control functions
<> 144:ef7eb2e8f9f7 257 * @brief HAL Control functions
<> 144:ef7eb2e8f9f7 258 *
<> 144:ef7eb2e8f9f7 259 @verbatim
<> 144:ef7eb2e8f9f7 260 ===============================================================================
<> 144:ef7eb2e8f9f7 261 ##### HAL Control functions #####
<> 144:ef7eb2e8f9f7 262 ===============================================================================
<> 144:ef7eb2e8f9f7 263 [..] This section provides functions allowing to:
<> 144:ef7eb2e8f9f7 264 (+) Provide a tick value in millisecond
<> 144:ef7eb2e8f9f7 265 (+) Provide a blocking delay in millisecond
<> 144:ef7eb2e8f9f7 266 (+) Suspend the time base source interrupt
<> 144:ef7eb2e8f9f7 267 (+) Resume the time base source interrupt
<> 144:ef7eb2e8f9f7 268 (+) Get the HAL API driver version
<> 144:ef7eb2e8f9f7 269 (+) Get the device identifier
<> 144:ef7eb2e8f9f7 270 (+) Get the device revision identifier
<> 144:ef7eb2e8f9f7 271 (+) Enable/Disable Debug module during Sleep mode
<> 144:ef7eb2e8f9f7 272 (+) Enable/Disable Debug module during STOP mode
<> 144:ef7eb2e8f9f7 273 (+) Enable/Disable Debug module during STANDBY mode
<> 144:ef7eb2e8f9f7 274
<> 144:ef7eb2e8f9f7 275 @endverbatim
<> 144:ef7eb2e8f9f7 276 * @{
<> 144:ef7eb2e8f9f7 277 */
<> 144:ef7eb2e8f9f7 278
<> 144:ef7eb2e8f9f7 279 /**
<> 144:ef7eb2e8f9f7 280 * @brief This function is called to increment a global variable "uwTick"
<> 144:ef7eb2e8f9f7 281 * used as application time base.
<> 144:ef7eb2e8f9f7 282 * @note In the default implementation, this variable is incremented each 1ms
<> 144:ef7eb2e8f9f7 283 * in Systick ISR.
<> 144:ef7eb2e8f9f7 284 * @note This function is declared as __weak to be overwritten in case of other
<> 144:ef7eb2e8f9f7 285 * implementations in user file.
<> 144:ef7eb2e8f9f7 286 * @retval None
<> 144:ef7eb2e8f9f7 287 */
<> 144:ef7eb2e8f9f7 288 __weak void HAL_IncTick(void)
<> 144:ef7eb2e8f9f7 289 {
<> 144:ef7eb2e8f9f7 290 uwTick++;
<> 144:ef7eb2e8f9f7 291 }
<> 144:ef7eb2e8f9f7 292
<> 144:ef7eb2e8f9f7 293 /**
<> 144:ef7eb2e8f9f7 294 * @brief Provides a tick value in millisecond.
<> 144:ef7eb2e8f9f7 295 * @note This function is declared as __weak to be overwritten in case of other
<> 144:ef7eb2e8f9f7 296 * implementations in user file.
<> 144:ef7eb2e8f9f7 297 * @retval tick value
<> 144:ef7eb2e8f9f7 298 */
<> 144:ef7eb2e8f9f7 299 __weak uint32_t HAL_GetTick(void)
<> 144:ef7eb2e8f9f7 300 {
<> 144:ef7eb2e8f9f7 301 return uwTick;
<> 144:ef7eb2e8f9f7 302 }
<> 144:ef7eb2e8f9f7 303
<> 144:ef7eb2e8f9f7 304 /**
<> 144:ef7eb2e8f9f7 305 * @brief This function provides accurate delay (in milliseconds) based
<> 144:ef7eb2e8f9f7 306 * on variable incremented.
<> 144:ef7eb2e8f9f7 307 * @note In the default implementation , SysTick timer is the source of time base.
<> 144:ef7eb2e8f9f7 308 * It is used to generate interrupts at regular time intervals where uwTick
<> 144:ef7eb2e8f9f7 309 * is incremented.
<> 144:ef7eb2e8f9f7 310 * @note ThiS function is declared as __weak to be overwritten in case of other
<> 144:ef7eb2e8f9f7 311 * implementations in user file.
<> 144:ef7eb2e8f9f7 312 * @param Delay: specifies the delay time length, in milliseconds.
<> 144:ef7eb2e8f9f7 313 * @retval None
<> 144:ef7eb2e8f9f7 314 */
<> 144:ef7eb2e8f9f7 315 __weak void HAL_Delay(__IO uint32_t Delay)
<> 144:ef7eb2e8f9f7 316 {
<> 144:ef7eb2e8f9f7 317 uint32_t tickstart = 0;
<> 144:ef7eb2e8f9f7 318 tickstart = HAL_GetTick();
<> 144:ef7eb2e8f9f7 319 while((HAL_GetTick() - tickstart) < Delay)
<> 144:ef7eb2e8f9f7 320 {
<> 144:ef7eb2e8f9f7 321 }
<> 144:ef7eb2e8f9f7 322 }
<> 144:ef7eb2e8f9f7 323
<> 144:ef7eb2e8f9f7 324 /**
<> 144:ef7eb2e8f9f7 325 * @brief Suspend Tick increment.
<> 144:ef7eb2e8f9f7 326 * @note In the default implementation , SysTick timer is the source of time base. It is
<> 144:ef7eb2e8f9f7 327 * used to generate interrupts at regular time intervals. Once HAL_SuspendTick()
<> 144:ef7eb2e8f9f7 328 * is called, the the SysTick interrupt will be disabled and so Tick increment
<> 144:ef7eb2e8f9f7 329 * is suspended.
<> 144:ef7eb2e8f9f7 330 * @note This function is declared as __weak to be overwritten in case of other
<> 144:ef7eb2e8f9f7 331 * implementations in user file.
<> 144:ef7eb2e8f9f7 332 * @retval None
<> 144:ef7eb2e8f9f7 333 */
<> 144:ef7eb2e8f9f7 334 __weak void HAL_SuspendTick(void)
<> 144:ef7eb2e8f9f7 335 {
<> 144:ef7eb2e8f9f7 336 /* Disable SysTick Interrupt */
<> 144:ef7eb2e8f9f7 337 CLEAR_BIT(SysTick->CTRL,SysTick_CTRL_TICKINT_Msk);
<> 144:ef7eb2e8f9f7 338 }
<> 144:ef7eb2e8f9f7 339
<> 144:ef7eb2e8f9f7 340 /**
<> 144:ef7eb2e8f9f7 341 * @brief Resume Tick increment.
<> 144:ef7eb2e8f9f7 342 * @note In the default implementation , SysTick timer is the source of time base. It is
<> 144:ef7eb2e8f9f7 343 * used to generate interrupts at regular time intervals. Once HAL_ResumeTick()
<> 144:ef7eb2e8f9f7 344 * is called, the the SysTick interrupt will be enabled and so Tick increment
<> 144:ef7eb2e8f9f7 345 * is resumed.
<> 144:ef7eb2e8f9f7 346 * @note This function is declared as __weak to be overwritten in case of other
<> 144:ef7eb2e8f9f7 347 * implementations in user file.
<> 144:ef7eb2e8f9f7 348 * @retval None
<> 144:ef7eb2e8f9f7 349 */
<> 144:ef7eb2e8f9f7 350 __weak void HAL_ResumeTick(void)
<> 144:ef7eb2e8f9f7 351 {
<> 144:ef7eb2e8f9f7 352 /* Enable SysTick Interrupt */
<> 144:ef7eb2e8f9f7 353 SET_BIT(SysTick->CTRL,SysTick_CTRL_TICKINT_Msk);
<> 144:ef7eb2e8f9f7 354 }
<> 144:ef7eb2e8f9f7 355
<> 144:ef7eb2e8f9f7 356 /**
<> 144:ef7eb2e8f9f7 357 * @brief Returns the HAL revision
<> 144:ef7eb2e8f9f7 358 * @retval version: 0xXYZR (8bits for each decimal, R for RC)
<> 144:ef7eb2e8f9f7 359 */
<> 144:ef7eb2e8f9f7 360 uint32_t HAL_GetHalVersion(void)
<> 144:ef7eb2e8f9f7 361 {
<> 144:ef7eb2e8f9f7 362 return __STM32L1xx_HAL_VERSION;
<> 144:ef7eb2e8f9f7 363 }
<> 144:ef7eb2e8f9f7 364
<> 144:ef7eb2e8f9f7 365 /**
<> 144:ef7eb2e8f9f7 366 * @brief Returns the device revision identifier.
<> 144:ef7eb2e8f9f7 367 * @retval Device revision identifier
<> 144:ef7eb2e8f9f7 368 */
<> 144:ef7eb2e8f9f7 369 uint32_t HAL_GetREVID(void)
<> 144:ef7eb2e8f9f7 370 {
<> 144:ef7eb2e8f9f7 371 return((DBGMCU->IDCODE) >> 16);
<> 144:ef7eb2e8f9f7 372 }
<> 144:ef7eb2e8f9f7 373
<> 144:ef7eb2e8f9f7 374 /**
<> 144:ef7eb2e8f9f7 375 * @brief Returns the device identifier.
<> 144:ef7eb2e8f9f7 376 * @retval Device identifier
<> 144:ef7eb2e8f9f7 377 */
<> 144:ef7eb2e8f9f7 378 uint32_t HAL_GetDEVID(void)
<> 144:ef7eb2e8f9f7 379 {
<> 144:ef7eb2e8f9f7 380 return((DBGMCU->IDCODE) & IDCODE_DEVID_MASK);
<> 144:ef7eb2e8f9f7 381 }
<> 144:ef7eb2e8f9f7 382
<> 144:ef7eb2e8f9f7 383 /**
<> 144:ef7eb2e8f9f7 384 * @brief Enable the Debug Module during SLEEP mode
<> 144:ef7eb2e8f9f7 385 * @retval None
<> 144:ef7eb2e8f9f7 386 */
<> 144:ef7eb2e8f9f7 387 void HAL_DBGMCU_EnableDBGSleepMode(void)
<> 144:ef7eb2e8f9f7 388 {
<> 144:ef7eb2e8f9f7 389 SET_BIT(DBGMCU->CR, DBGMCU_CR_DBG_SLEEP);
<> 144:ef7eb2e8f9f7 390 }
<> 144:ef7eb2e8f9f7 391
<> 144:ef7eb2e8f9f7 392 /**
<> 144:ef7eb2e8f9f7 393 * @brief Disable the Debug Module during SLEEP mode
<> 144:ef7eb2e8f9f7 394 * @retval None
<> 144:ef7eb2e8f9f7 395 */
<> 144:ef7eb2e8f9f7 396 void HAL_DBGMCU_DisableDBGSleepMode(void)
<> 144:ef7eb2e8f9f7 397 {
<> 144:ef7eb2e8f9f7 398 CLEAR_BIT(DBGMCU->CR, DBGMCU_CR_DBG_SLEEP);
<> 144:ef7eb2e8f9f7 399 }
<> 144:ef7eb2e8f9f7 400
<> 144:ef7eb2e8f9f7 401 /**
<> 144:ef7eb2e8f9f7 402 * @brief Enable the Debug Module during STOP mode
<> 144:ef7eb2e8f9f7 403 * @retval None
<> 144:ef7eb2e8f9f7 404 */
<> 144:ef7eb2e8f9f7 405 void HAL_DBGMCU_EnableDBGStopMode(void)
<> 144:ef7eb2e8f9f7 406 {
<> 144:ef7eb2e8f9f7 407 SET_BIT(DBGMCU->CR, DBGMCU_CR_DBG_STOP);
<> 144:ef7eb2e8f9f7 408 }
<> 144:ef7eb2e8f9f7 409
<> 144:ef7eb2e8f9f7 410 /**
<> 144:ef7eb2e8f9f7 411 * @brief Disable the Debug Module during STOP mode
<> 144:ef7eb2e8f9f7 412 * @retval None
<> 144:ef7eb2e8f9f7 413 */
<> 144:ef7eb2e8f9f7 414 void HAL_DBGMCU_DisableDBGStopMode(void)
<> 144:ef7eb2e8f9f7 415 {
<> 144:ef7eb2e8f9f7 416 CLEAR_BIT(DBGMCU->CR, DBGMCU_CR_DBG_STOP);
<> 144:ef7eb2e8f9f7 417 }
<> 144:ef7eb2e8f9f7 418
<> 144:ef7eb2e8f9f7 419 /**
<> 144:ef7eb2e8f9f7 420 * @brief Enable the Debug Module during STANDBY mode
<> 144:ef7eb2e8f9f7 421 * @retval None
<> 144:ef7eb2e8f9f7 422 */
<> 144:ef7eb2e8f9f7 423 void HAL_DBGMCU_EnableDBGStandbyMode(void)
<> 144:ef7eb2e8f9f7 424 {
<> 144:ef7eb2e8f9f7 425 SET_BIT(DBGMCU->CR, DBGMCU_CR_DBG_STANDBY);
<> 144:ef7eb2e8f9f7 426 }
<> 144:ef7eb2e8f9f7 427
<> 144:ef7eb2e8f9f7 428 /**
<> 144:ef7eb2e8f9f7 429 * @brief Disable the Debug Module during STANDBY mode
<> 144:ef7eb2e8f9f7 430 * @retval None
<> 144:ef7eb2e8f9f7 431 */
<> 144:ef7eb2e8f9f7 432 void HAL_DBGMCU_DisableDBGStandbyMode(void)
<> 144:ef7eb2e8f9f7 433 {
<> 144:ef7eb2e8f9f7 434 CLEAR_BIT(DBGMCU->CR, DBGMCU_CR_DBG_STANDBY);
<> 144:ef7eb2e8f9f7 435 }
<> 144:ef7eb2e8f9f7 436
<> 144:ef7eb2e8f9f7 437 /**
<> 144:ef7eb2e8f9f7 438 * @}
<> 144:ef7eb2e8f9f7 439 */
<> 144:ef7eb2e8f9f7 440
<> 144:ef7eb2e8f9f7 441 /**
<> 144:ef7eb2e8f9f7 442 * @}
<> 144:ef7eb2e8f9f7 443 */
<> 144:ef7eb2e8f9f7 444
<> 144:ef7eb2e8f9f7 445 #endif /* HAL_MODULE_ENABLED */
<> 144:ef7eb2e8f9f7 446 /**
<> 144:ef7eb2e8f9f7 447 * @}
<> 144:ef7eb2e8f9f7 448 */
<> 144:ef7eb2e8f9f7 449
<> 144:ef7eb2e8f9f7 450 /**
<> 144:ef7eb2e8f9f7 451 * @}
<> 144:ef7eb2e8f9f7 452 */
<> 144:ef7eb2e8f9f7 453
<> 144:ef7eb2e8f9f7 454 /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/