pravin sarode / Mymbed-dev

MBED-DEV only fro Nucleo STM32F303K8T6

Fork of mbed-dev by mbed official

targets/TARGET_STM/TARGET_STM32F3/device/stm32f3xx_hal.c@151:acf04f8e7d03, 2016-11-19 (annotated)

Committer:
pravinautosys
Date:
Sat Nov 19 10:38:54 2016 +0000
Revision:
151:acf04f8e7d03
Parent:
149:156823d33999 
MyMBED-DEVWithSTM32F303K8T6;

Who changed what in which revision?

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