mbed official / mbed-dev

mbed library sources. Supersedes mbed-src.

Dependents:   Nucleo_Hello_Encoder BLE_iBeaconScan AM1805_DEMO DISCO-F429ZI_ExportTemplate1 ... more

targets/cmsis/TARGET_STM/TARGET_STM32F0/stm32f0xx_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 stm32f0xx_hal.c
<> 144:ef7eb2e8f9f7 4 * @author MCD Application Team
<> 144:ef7eb2e8f9f7 5 * @version V1.4.0
<> 144:ef7eb2e8f9f7 6 * @date 27-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 (+) HAL Initialization and de-initialization functions
<> 144:ef7eb2e8f9f7 20 (+) HAL Control functions
<> 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 "stm32f0xx_hal.h"
<> 144:ef7eb2e8f9f7 55
<> 144:ef7eb2e8f9f7 56 /** @addtogroup STM32F0xx_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 /** @defgroup HAL_Private_Constants HAL Private Constants
<> 144:ef7eb2e8f9f7 70 * @{
<> 144:ef7eb2e8f9f7 71 */
<> 144:ef7eb2e8f9f7 72 /**
<> 144:ef7eb2e8f9f7 73 * @brief STM32F0xx HAL Driver version number V1.4.0
<> 144:ef7eb2e8f9f7 74 */
<> 144:ef7eb2e8f9f7 75 #define __STM32F0xx_HAL_VERSION_MAIN (0x01) /*!< [31:24] main version */
<> 144:ef7eb2e8f9f7 76 #define __STM32F0xx_HAL_VERSION_SUB1 (0x04) /*!< [23:16] sub1 version */
<> 144:ef7eb2e8f9f7 77 #define __STM32F0xx_HAL_VERSION_SUB2 (0x00) /*!< [15:8] sub2 version */
<> 144:ef7eb2e8f9f7 78 #define __STM32F0xx_HAL_VERSION_RC (0x00) /*!< [7:0] release candidate */
<> 144:ef7eb2e8f9f7 79 #define __STM32F0xx_HAL_VERSION ((__STM32F0xx_HAL_VERSION_MAIN << 24)\
<> 144:ef7eb2e8f9f7 80 |(__STM32F0xx_HAL_VERSION_SUB1 << 16)\
<> 144:ef7eb2e8f9f7 81 |(__STM32F0xx_HAL_VERSION_SUB2 << 8 )\
<> 144:ef7eb2e8f9f7 82 |(__STM32F0xx_HAL_VERSION_RC))
<> 144:ef7eb2e8f9f7 83
<> 144:ef7eb2e8f9f7 84 #define IDCODE_DEVID_MASK ((uint32_t)0x00000FFF)
<> 144:ef7eb2e8f9f7 85 /**
<> 144:ef7eb2e8f9f7 86 * @}
<> 144:ef7eb2e8f9f7 87 */
<> 144:ef7eb2e8f9f7 88
<> 144:ef7eb2e8f9f7 89 /* Private macro -------------------------------------------------------------*/
<> 144:ef7eb2e8f9f7 90 /** @defgroup HAL_Private_Macros HAL Private Macros
<> 144:ef7eb2e8f9f7 91 * @{
<> 144:ef7eb2e8f9f7 92 */
<> 144:ef7eb2e8f9f7 93 /**
<> 144:ef7eb2e8f9f7 94 * @}
<> 144:ef7eb2e8f9f7 95 */
<> 144:ef7eb2e8f9f7 96
<> 144:ef7eb2e8f9f7 97 /* Private variables ---------------------------------------------------------*/
<> 144:ef7eb2e8f9f7 98 /** @defgroup HAL_Private_Variables HAL Private Variables
<> 144:ef7eb2e8f9f7 99 * @{
<> 144:ef7eb2e8f9f7 100 */
<> 144:ef7eb2e8f9f7 101 __IO uint32_t uwTick;
<> 144:ef7eb2e8f9f7 102 /**
<> 144:ef7eb2e8f9f7 103 * @}
<> 144:ef7eb2e8f9f7 104 */
<> 144:ef7eb2e8f9f7 105 /* Private function prototypes -----------------------------------------------*/
<> 144:ef7eb2e8f9f7 106 /* Exported 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 HSI 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 /* Use systick as time base source and configure 1ms tick (default clock after Reset is HSI) */
<> 144:ef7eb2e8f9f7 165
<> 144:ef7eb2e8f9f7 166 HAL_InitTick(TICK_INT_PRIORITY);
<> 144:ef7eb2e8f9f7 167
<> 144:ef7eb2e8f9f7 168 /* Init the low level hardware */
<> 144:ef7eb2e8f9f7 169 HAL_MspInit();
<> 144:ef7eb2e8f9f7 170
<> 144:ef7eb2e8f9f7 171 /* Return function status */
<> 144:ef7eb2e8f9f7 172 return HAL_OK;
<> 144:ef7eb2e8f9f7 173 }
<> 144:ef7eb2e8f9f7 174
<> 144:ef7eb2e8f9f7 175 /**
<> 144:ef7eb2e8f9f7 176 * @brief This function de-Initializes common part of the HAL and stops the source
<> 144:ef7eb2e8f9f7 177 * of time base.
<> 144:ef7eb2e8f9f7 178 * @note This function is optional.
<> 144:ef7eb2e8f9f7 179 * @retval HAL status
<> 144:ef7eb2e8f9f7 180 */
<> 144:ef7eb2e8f9f7 181 HAL_StatusTypeDef HAL_DeInit(void)
<> 144:ef7eb2e8f9f7 182 {
<> 144:ef7eb2e8f9f7 183 /* Reset of all peripherals */
<> 144:ef7eb2e8f9f7 184 __HAL_RCC_APB1_FORCE_RESET();
<> 144:ef7eb2e8f9f7 185 __HAL_RCC_APB1_RELEASE_RESET();
<> 144:ef7eb2e8f9f7 186
<> 144:ef7eb2e8f9f7 187 __HAL_RCC_APB2_FORCE_RESET();
<> 144:ef7eb2e8f9f7 188 __HAL_RCC_APB2_RELEASE_RESET();
<> 144:ef7eb2e8f9f7 189
<> 144:ef7eb2e8f9f7 190 __HAL_RCC_AHB_FORCE_RESET();
<> 144:ef7eb2e8f9f7 191 __HAL_RCC_AHB_RELEASE_RESET();
<> 144:ef7eb2e8f9f7 192
<> 144:ef7eb2e8f9f7 193 /* De-Init the low level hardware */
<> 144:ef7eb2e8f9f7 194 HAL_MspDeInit();
<> 144:ef7eb2e8f9f7 195
<> 144:ef7eb2e8f9f7 196 /* Return function status */
<> 144:ef7eb2e8f9f7 197 return HAL_OK;
<> 144:ef7eb2e8f9f7 198 }
<> 144:ef7eb2e8f9f7 199
<> 144:ef7eb2e8f9f7 200 /**
<> 144:ef7eb2e8f9f7 201 * @brief Initializes the MSP.
<> 144:ef7eb2e8f9f7 202 * @retval None
<> 144:ef7eb2e8f9f7 203 */
<> 144:ef7eb2e8f9f7 204 __weak void HAL_MspInit(void)
<> 144:ef7eb2e8f9f7 205 {
<> 144:ef7eb2e8f9f7 206 /* NOTE : This function Should not be modified, when the callback is needed,
<> 144:ef7eb2e8f9f7 207 the HAL_MspInit could be implemented in the user file
<> 144:ef7eb2e8f9f7 208 */
<> 144:ef7eb2e8f9f7 209 }
<> 144:ef7eb2e8f9f7 210
<> 144:ef7eb2e8f9f7 211 /**
<> 144:ef7eb2e8f9f7 212 * @brief DeInitializes the MSP.
<> 144:ef7eb2e8f9f7 213 * @retval None
<> 144:ef7eb2e8f9f7 214 */
<> 144:ef7eb2e8f9f7 215 __weak void HAL_MspDeInit(void)
<> 144:ef7eb2e8f9f7 216 {
<> 144:ef7eb2e8f9f7 217 /* NOTE : This function Should not be modified, when the callback is needed,
<> 144:ef7eb2e8f9f7 218 the HAL_MspDeInit could be implemented in the user file
<> 144:ef7eb2e8f9f7 219 */
<> 144:ef7eb2e8f9f7 220 }
<> 144:ef7eb2e8f9f7 221
<> 144:ef7eb2e8f9f7 222 /**
<> 144:ef7eb2e8f9f7 223 * @brief This function configures the source of the time base.
<> 144:ef7eb2e8f9f7 224 * The time source is configured to have 1ms time base with a dedicated
<> 144:ef7eb2e8f9f7 225 * Tick interrupt priority.
<> 144:ef7eb2e8f9f7 226 * @note This function is called automatically at the beginning of program after
<> 144:ef7eb2e8f9f7 227 * reset by HAL_Init() or at any time when clock is reconfigured by HAL_RCC_ClockConfig().
<> 144:ef7eb2e8f9f7 228 * @note In the default implementation, SysTick timer is the source of time base.
<> 144:ef7eb2e8f9f7 229 * It is used to generate interrupts at regular time intervals.
<> 144:ef7eb2e8f9f7 230 * Care must be taken if HAL_Delay() is called from a peripheral ISR process,
<> 144:ef7eb2e8f9f7 231 * The the SysTick interrupt must have higher priority (numerically lower)
<> 144:ef7eb2e8f9f7 232 * than the peripheral interrupt. Otherwise the caller ISR process will be blocked.
<> 144:ef7eb2e8f9f7 233 * The function is declared as __Weak to be overwritten in case of other
<> 144:ef7eb2e8f9f7 234 * implementation in user file.
<> 144:ef7eb2e8f9f7 235 * @param TickPriority: Tick interrupt priority.
<> 144:ef7eb2e8f9f7 236 * @retval HAL status
<> 144:ef7eb2e8f9f7 237 */
<> 144:ef7eb2e8f9f7 238 __weak HAL_StatusTypeDef HAL_InitTick(uint32_t TickPriority)
<> 144:ef7eb2e8f9f7 239 {
<> 144:ef7eb2e8f9f7 240 /*Configure the SysTick to have interrupt in 1ms time basis*/
<> 144:ef7eb2e8f9f7 241 HAL_SYSTICK_Config(HAL_RCC_GetHCLKFreq()/1000);
<> 144:ef7eb2e8f9f7 242
<> 144:ef7eb2e8f9f7 243 /*Configure the SysTick IRQ priority */
<> 144:ef7eb2e8f9f7 244 HAL_NVIC_SetPriority(SysTick_IRQn, TickPriority ,0);
<> 144:ef7eb2e8f9f7 245
<> 144:ef7eb2e8f9f7 246 /* Return function status */
<> 144:ef7eb2e8f9f7 247 return HAL_OK;
<> 144:ef7eb2e8f9f7 248 }
<> 144:ef7eb2e8f9f7 249
<> 144:ef7eb2e8f9f7 250 /**
<> 144:ef7eb2e8f9f7 251 * @}
<> 144:ef7eb2e8f9f7 252 */
<> 144:ef7eb2e8f9f7 253
<> 144:ef7eb2e8f9f7 254 /** @defgroup HAL_Exported_Functions_Group2 HAL Control functions
<> 144:ef7eb2e8f9f7 255 * @brief HAL Control functions
<> 144:ef7eb2e8f9f7 256 *
<> 144:ef7eb2e8f9f7 257 @verbatim
<> 144:ef7eb2e8f9f7 258 ===============================================================================
<> 144:ef7eb2e8f9f7 259 ##### HAL Control functions #####
<> 144:ef7eb2e8f9f7 260 ===============================================================================
<> 144:ef7eb2e8f9f7 261 [..] This section provides functions allowing to:
<> 144:ef7eb2e8f9f7 262 (+) Provide a tick value in millisecond
<> 144:ef7eb2e8f9f7 263 (+) Provide a blocking delay in millisecond
<> 144:ef7eb2e8f9f7 264 (+) Suspend the time base source interrupt
<> 144:ef7eb2e8f9f7 265 (+) Resume the time base source interrupt
<> 144:ef7eb2e8f9f7 266 (+) Get the HAL API driver version
<> 144:ef7eb2e8f9f7 267 (+) Get the device identifier
<> 144:ef7eb2e8f9f7 268 (+) Get the device revision identifier
<> 144:ef7eb2e8f9f7 269 (+) Enable/Disable Debug module during Sleep mode
<> 144:ef7eb2e8f9f7 270 (+) Enable/Disable Debug module during STOP mode
<> 144:ef7eb2e8f9f7 271 (+) Enable/Disable Debug module during STANDBY mode
<> 144:ef7eb2e8f9f7 272
<> 144:ef7eb2e8f9f7 273 @endverbatim
<> 144:ef7eb2e8f9f7 274 * @{
<> 144:ef7eb2e8f9f7 275 */
<> 144:ef7eb2e8f9f7 276
<> 144:ef7eb2e8f9f7 277 /**
<> 144:ef7eb2e8f9f7 278 * @brief This function is called to increment a global variable "uwTick"
<> 144:ef7eb2e8f9f7 279 * used as application time base.
<> 144:ef7eb2e8f9f7 280 * @note In the default implementation, this variable is incremented each 1ms
<> 144:ef7eb2e8f9f7 281 * in Systick ISR.
<> 144:ef7eb2e8f9f7 282 * @note This function is declared as __weak to be overwritten in case of other
<> 144:ef7eb2e8f9f7 283 * implementations in user file.
<> 144:ef7eb2e8f9f7 284 * @retval None
<> 144:ef7eb2e8f9f7 285 */
<> 144:ef7eb2e8f9f7 286 __weak void HAL_IncTick(void)
<> 144:ef7eb2e8f9f7 287 {
<> 144:ef7eb2e8f9f7 288 uwTick++;
<> 144:ef7eb2e8f9f7 289 }
<> 144:ef7eb2e8f9f7 290
<> 144:ef7eb2e8f9f7 291 /**
<> 144:ef7eb2e8f9f7 292 * @brief Provides a tick value in millisecond.
<> 144:ef7eb2e8f9f7 293 * @note This function is declared as __weak to be overwritten in case of other
<> 144:ef7eb2e8f9f7 294 * implementations in user file.
<> 144:ef7eb2e8f9f7 295 * @retval tick value
<> 144:ef7eb2e8f9f7 296 */
<> 144:ef7eb2e8f9f7 297 __weak uint32_t HAL_GetTick(void)
<> 144:ef7eb2e8f9f7 298 {
<> 144:ef7eb2e8f9f7 299 return uwTick;
<> 144:ef7eb2e8f9f7 300 }
<> 144:ef7eb2e8f9f7 301
<> 144:ef7eb2e8f9f7 302 /**
<> 144:ef7eb2e8f9f7 303 * @brief This function provides accurate delay (in milliseconds) based
<> 144:ef7eb2e8f9f7 304 * on variable incremented.
<> 144:ef7eb2e8f9f7 305 * @note In the default implementation , SysTick timer is the source of time base.
<> 144:ef7eb2e8f9f7 306 * It is used to generate interrupts at regular time intervals where uwTick
<> 144:ef7eb2e8f9f7 307 * is incremented.
<> 144:ef7eb2e8f9f7 308 * @note ThiS function is declared as __weak to be overwritten in case of other
<> 144:ef7eb2e8f9f7 309 * implementations in user file.
<> 144:ef7eb2e8f9f7 310 * @param Delay: specifies the delay time length, in milliseconds.
<> 144:ef7eb2e8f9f7 311 * @retval None
<> 144:ef7eb2e8f9f7 312 */
<> 144:ef7eb2e8f9f7 313 __weak void HAL_Delay(__IO uint32_t Delay)
<> 144:ef7eb2e8f9f7 314 {
<> 144:ef7eb2e8f9f7 315 uint32_t tickstart = 0;
<> 144:ef7eb2e8f9f7 316 tickstart = HAL_GetTick();
<> 144:ef7eb2e8f9f7 317 while((HAL_GetTick() - tickstart) < Delay)
<> 144:ef7eb2e8f9f7 318 {
<> 144:ef7eb2e8f9f7 319 }
<> 144:ef7eb2e8f9f7 320 }
<> 144:ef7eb2e8f9f7 321
<> 144:ef7eb2e8f9f7 322 /**
<> 144:ef7eb2e8f9f7 323 * @brief Suspend Tick increment.
<> 144:ef7eb2e8f9f7 324 * @note In the default implementation , SysTick timer is the source of time base. It is
<> 144:ef7eb2e8f9f7 325 * used to generate interrupts at regular time intervals. Once HAL_SuspendTick()
<> 144:ef7eb2e8f9f7 326 * is called, the the SysTick interrupt will be disabled and so Tick increment
<> 144:ef7eb2e8f9f7 327 * is suspended.
<> 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 * @retval None
<> 144:ef7eb2e8f9f7 331 */
<> 144:ef7eb2e8f9f7 332 __weak void HAL_SuspendTick(void)
<> 144:ef7eb2e8f9f7 333
<> 144:ef7eb2e8f9f7 334 {
<> 144:ef7eb2e8f9f7 335 /* Disable SysTick Interrupt */
<> 144:ef7eb2e8f9f7 336 CLEAR_BIT(SysTick->CTRL,SysTick_CTRL_TICKINT_Msk);
<> 144:ef7eb2e8f9f7 337 }
<> 144:ef7eb2e8f9f7 338
<> 144:ef7eb2e8f9f7 339 /**
<> 144:ef7eb2e8f9f7 340 * @brief Resume Tick increment.
<> 144:ef7eb2e8f9f7 341 * @note In the default implementation , SysTick timer is the source of time base. It is
<> 144:ef7eb2e8f9f7 342 * used to generate interrupts at regular time intervals. Once HAL_ResumeTick()
<> 144:ef7eb2e8f9f7 343 * is called, the the SysTick interrupt will be enabled and so Tick increment
<> 144:ef7eb2e8f9f7 344 * is resumed.
<> 144:ef7eb2e8f9f7 345 * @note This function is declared as __weak to be overwritten in case of other
<> 144:ef7eb2e8f9f7 346 * implementations in user file.
<> 144:ef7eb2e8f9f7 347 * @retval None
<> 144:ef7eb2e8f9f7 348 */
<> 144:ef7eb2e8f9f7 349 __weak void HAL_ResumeTick(void)
<> 144:ef7eb2e8f9f7 350 {
<> 144:ef7eb2e8f9f7 351 /* Enable SysTick Interrupt */
<> 144:ef7eb2e8f9f7 352 SET_BIT(SysTick->CTRL,SysTick_CTRL_TICKINT_Msk);
<> 144:ef7eb2e8f9f7 353 }
<> 144:ef7eb2e8f9f7 354
<> 144:ef7eb2e8f9f7 355 /**
<> 144:ef7eb2e8f9f7 356 * @brief This method returns the HAL revision
<> 144:ef7eb2e8f9f7 357 * @retval version : 0xXYZR (8bits for each decimal, R for RC)
<> 144:ef7eb2e8f9f7 358 */
<> 144:ef7eb2e8f9f7 359 uint32_t HAL_GetHalVersion(void)
<> 144:ef7eb2e8f9f7 360 {
<> 144:ef7eb2e8f9f7 361 return __STM32F0xx_HAL_VERSION;
<> 144:ef7eb2e8f9f7 362 }
<> 144:ef7eb2e8f9f7 363
<> 144:ef7eb2e8f9f7 364 /**
<> 144:ef7eb2e8f9f7 365 * @brief Returns the device revision identifier.
<> 144:ef7eb2e8f9f7 366 * @retval Device revision identifier
<> 144:ef7eb2e8f9f7 367 */
<> 144:ef7eb2e8f9f7 368 uint32_t HAL_GetREVID(void)
<> 144:ef7eb2e8f9f7 369 {
<> 144:ef7eb2e8f9f7 370 return((DBGMCU->IDCODE) >> 16);
<> 144:ef7eb2e8f9f7 371 }
<> 144:ef7eb2e8f9f7 372
<> 144:ef7eb2e8f9f7 373 /**
<> 144:ef7eb2e8f9f7 374 * @brief Returns the device identifier.
<> 144:ef7eb2e8f9f7 375 * @retval Device identifier
<> 144:ef7eb2e8f9f7 376 */
<> 144:ef7eb2e8f9f7 377 uint32_t HAL_GetDEVID(void)
<> 144:ef7eb2e8f9f7 378 {
<> 144:ef7eb2e8f9f7 379 return((DBGMCU->IDCODE) & IDCODE_DEVID_MASK);
<> 144:ef7eb2e8f9f7 380 }
<> 144:ef7eb2e8f9f7 381
<> 144:ef7eb2e8f9f7 382 /**
<> 144:ef7eb2e8f9f7 383 * @brief Enable the Debug Module during STOP mode
<> 144:ef7eb2e8f9f7 384 * @retval None
<> 144:ef7eb2e8f9f7 385 */
<> 144:ef7eb2e8f9f7 386 void HAL_DBGMCU_EnableDBGStopMode(void)
<> 144:ef7eb2e8f9f7 387 {
<> 144:ef7eb2e8f9f7 388 SET_BIT(DBGMCU->CR, DBGMCU_CR_DBG_STOP);
<> 144:ef7eb2e8f9f7 389 }
<> 144:ef7eb2e8f9f7 390
<> 144:ef7eb2e8f9f7 391 /**
<> 144:ef7eb2e8f9f7 392 * @brief Disable the Debug Module during STOP mode
<> 144:ef7eb2e8f9f7 393 * @retval None
<> 144:ef7eb2e8f9f7 394 */
<> 144:ef7eb2e8f9f7 395 void HAL_DBGMCU_DisableDBGStopMode(void)
<> 144:ef7eb2e8f9f7 396 {
<> 144:ef7eb2e8f9f7 397 CLEAR_BIT(DBGMCU->CR, DBGMCU_CR_DBG_STOP);
<> 144:ef7eb2e8f9f7 398 }
<> 144:ef7eb2e8f9f7 399
<> 144:ef7eb2e8f9f7 400 /**
<> 144:ef7eb2e8f9f7 401 * @brief Enable the Debug Module during STANDBY mode
<> 144:ef7eb2e8f9f7 402 * @retval None
<> 144:ef7eb2e8f9f7 403 */
<> 144:ef7eb2e8f9f7 404 void HAL_DBGMCU_EnableDBGStandbyMode(void)
<> 144:ef7eb2e8f9f7 405 {
<> 144:ef7eb2e8f9f7 406 SET_BIT(DBGMCU->CR, DBGMCU_CR_DBG_STANDBY);
<> 144:ef7eb2e8f9f7 407 }
<> 144:ef7eb2e8f9f7 408
<> 144:ef7eb2e8f9f7 409 /**
<> 144:ef7eb2e8f9f7 410 * @brief Disable the Debug Module during STANDBY mode
<> 144:ef7eb2e8f9f7 411 * @retval None
<> 144:ef7eb2e8f9f7 412 */
<> 144:ef7eb2e8f9f7 413 void HAL_DBGMCU_DisableDBGStandbyMode(void)
<> 144:ef7eb2e8f9f7 414 {
<> 144:ef7eb2e8f9f7 415 CLEAR_BIT(DBGMCU->CR, DBGMCU_CR_DBG_STANDBY);
<> 144:ef7eb2e8f9f7 416 }
<> 144:ef7eb2e8f9f7 417
<> 144:ef7eb2e8f9f7 418 /**
<> 144:ef7eb2e8f9f7 419 * @}
<> 144:ef7eb2e8f9f7 420 */
<> 144:ef7eb2e8f9f7 421
<> 144:ef7eb2e8f9f7 422 /**
<> 144:ef7eb2e8f9f7 423 * @}
<> 144:ef7eb2e8f9f7 424 */
<> 144:ef7eb2e8f9f7 425
<> 144:ef7eb2e8f9f7 426 #endif /* HAL_MODULE_ENABLED */
<> 144:ef7eb2e8f9f7 427 /**
<> 144:ef7eb2e8f9f7 428 * @}
<> 144:ef7eb2e8f9f7 429 */
<> 144:ef7eb2e8f9f7 430
<> 144:ef7eb2e8f9f7 431 /**
<> 144:ef7eb2e8f9f7 432 * @}
<> 144:ef7eb2e8f9f7 433 */
<> 144:ef7eb2e8f9f7 434
<> 144:ef7eb2e8f9f7 435 /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/