Fawwaz Nadzmy / 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@0:9b334a45a8ff, 2015-10-01 (annotated)

Committer:
bogdanm
Date:
Thu Oct 01 15:25:22 2015 +0300
Revision:
0:9b334a45a8ff
Child:
113:b3775bf36a83
Initial commit on mbed-dev



Replaces mbed-src (now inactive)

Who changed what in which revision?

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