b luo / 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/TARGET_STM/TARGET_STM32F1/device/stm32f1xx_hal.c@149:156823d33999, 2016-10-28 (annotated)

Committer:
<>
Date:
Fri Oct 28 11:17:30 2016 +0100
Revision:
149:156823d33999
Parent:
targets/cmsis/TARGET_STM/TARGET_STM32F1/stm32f1xx_hal.c@144:ef7eb2e8f9f7 
This updates the lib to the mbed lib v128



NOTE: This release includes a restructuring of the file and directory locations and thus some

include paths in your code may need updating accordingly.

Who changed what in which revision?

UserRevisionLine numberNew contents of line
<> 144:ef7eb2e8f9f7 1 /**
<> 144:ef7eb2e8f9f7 2 ******************************************************************************
<> 144:ef7eb2e8f9f7 3 * @file stm32f1xx_hal.c
<> 144:ef7eb2e8f9f7 4 * @author MCD Application Team
<> 144:ef7eb2e8f9f7 5 * @version V1.0.4
<> 144:ef7eb2e8f9f7 6 * @date 29-April-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 "stm32f1xx_hal.h"
<> 144:ef7eb2e8f9f7 55
<> 144:ef7eb2e8f9f7 56 /** @addtogroup STM32F1xx_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_Constants HAL Private Constants
<> 144:ef7eb2e8f9f7 71 * @{
<> 144:ef7eb2e8f9f7 72 */
<> 144:ef7eb2e8f9f7 73
<> 144:ef7eb2e8f9f7 74 /**
<> 144:ef7eb2e8f9f7 75 * @brief STM32F1xx HAL Driver version number
<> 144:ef7eb2e8f9f7 76 */
<> 144:ef7eb2e8f9f7 77 #define __STM32F1xx_HAL_VERSION_MAIN (0x01) /*!< [31:24] main version */
<> 144:ef7eb2e8f9f7 78 #define __STM32F1xx_HAL_VERSION_SUB1 (0x00) /*!< [23:16] sub1 version */
<> 144:ef7eb2e8f9f7 79 #define __STM32F1xx_HAL_VERSION_SUB2 (0x04) /*!< [15:8] sub2 version */
<> 144:ef7eb2e8f9f7 80 #define __STM32F1xx_HAL_VERSION_RC (0x00) /*!< [7:0] release candidate */
<> 144:ef7eb2e8f9f7 81 #define __STM32F1xx_HAL_VERSION ((__STM32F1xx_HAL_VERSION_MAIN << 24)\
<> 144:ef7eb2e8f9f7 82 |(__STM32F1xx_HAL_VERSION_SUB1 << 16)\
<> 144:ef7eb2e8f9f7 83 |(__STM32F1xx_HAL_VERSION_SUB2 << 8 )\
<> 144:ef7eb2e8f9f7 84 |(__STM32F1xx_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 /* 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 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 #if defined(STM32F101x6) || defined(STM32F101xB) || defined(STM32F101xE) || defined(STM32F101xG) || \
<> 144:ef7eb2e8f9f7 162 defined(STM32F102x6) || defined(STM32F102xB) || \
<> 144:ef7eb2e8f9f7 163 defined(STM32F103x6) || defined(STM32F103xB) || defined(STM32F103xE) || defined(STM32F103xG) || \
<> 144:ef7eb2e8f9f7 164 defined(STM32F105xC) || defined(STM32F107xC)
<> 144:ef7eb2e8f9f7 165
<> 144:ef7eb2e8f9f7 166 /* Prefetch buffer is not available on value line devices */
<> 144:ef7eb2e8f9f7 167 __HAL_FLASH_PREFETCH_BUFFER_ENABLE();
<> 144:ef7eb2e8f9f7 168 #endif
<> 144:ef7eb2e8f9f7 169 #endif /* PREFETCH_ENABLE */
<> 144:ef7eb2e8f9f7 170
<> 144:ef7eb2e8f9f7 171 /* Set Interrupt Group Priority */
<> 144:ef7eb2e8f9f7 172 HAL_NVIC_SetPriorityGrouping(NVIC_PRIORITYGROUP_4);
<> 144:ef7eb2e8f9f7 173
<> 144:ef7eb2e8f9f7 174 /* Use systick as time base source and configure 1ms tick (default clock after Reset is MSI) */
<> 144:ef7eb2e8f9f7 175 HAL_InitTick(TICK_INT_PRIORITY);
<> 144:ef7eb2e8f9f7 176
<> 144:ef7eb2e8f9f7 177 /* Init the low level hardware */
<> 144:ef7eb2e8f9f7 178 HAL_MspInit();
<> 144:ef7eb2e8f9f7 179
<> 144:ef7eb2e8f9f7 180 /* Return function status */
<> 144:ef7eb2e8f9f7 181 return HAL_OK;
<> 144:ef7eb2e8f9f7 182 }
<> 144:ef7eb2e8f9f7 183
<> 144:ef7eb2e8f9f7 184 /**
<> 144:ef7eb2e8f9f7 185 * @brief This function de-Initializes common part of the HAL and stops the source
<> 144:ef7eb2e8f9f7 186 * of time base.
<> 144:ef7eb2e8f9f7 187 * @note This function is optional.
<> 144:ef7eb2e8f9f7 188 * @retval HAL status
<> 144:ef7eb2e8f9f7 189 */
<> 144:ef7eb2e8f9f7 190 HAL_StatusTypeDef HAL_DeInit(void)
<> 144:ef7eb2e8f9f7 191 {
<> 144:ef7eb2e8f9f7 192 /* Reset of all peripherals */
<> 144:ef7eb2e8f9f7 193 __HAL_RCC_APB1_FORCE_RESET();
<> 144:ef7eb2e8f9f7 194 __HAL_RCC_APB1_RELEASE_RESET();
<> 144:ef7eb2e8f9f7 195
<> 144:ef7eb2e8f9f7 196 __HAL_RCC_APB2_FORCE_RESET();
<> 144:ef7eb2e8f9f7 197 __HAL_RCC_APB2_RELEASE_RESET();
<> 144:ef7eb2e8f9f7 198
<> 144:ef7eb2e8f9f7 199 #if defined(STM32F105xC) || defined(STM32F107xC)
<> 144:ef7eb2e8f9f7 200 __HAL_RCC_AHB_FORCE_RESET();
<> 144:ef7eb2e8f9f7 201 __HAL_RCC_AHB_RELEASE_RESET();
<> 144:ef7eb2e8f9f7 202 #endif
<> 144:ef7eb2e8f9f7 203
<> 144:ef7eb2e8f9f7 204 /* De-Init the low level hardware */
<> 144:ef7eb2e8f9f7 205 HAL_MspDeInit();
<> 144:ef7eb2e8f9f7 206
<> 144:ef7eb2e8f9f7 207 /* Return function status */
<> 144:ef7eb2e8f9f7 208 return HAL_OK;
<> 144:ef7eb2e8f9f7 209 }
<> 144:ef7eb2e8f9f7 210
<> 144:ef7eb2e8f9f7 211 /**
<> 144:ef7eb2e8f9f7 212 * @brief Initializes the MSP.
<> 144:ef7eb2e8f9f7 213 * @retval None
<> 144:ef7eb2e8f9f7 214 */
<> 144:ef7eb2e8f9f7 215 __weak void HAL_MspInit(void)
<> 144:ef7eb2e8f9f7 216 {
<> 144:ef7eb2e8f9f7 217 /* NOTE : This function Should not be modified, when the callback is needed,
<> 144:ef7eb2e8f9f7 218 the HAL_MspInit could be implemented in the user file
<> 144:ef7eb2e8f9f7 219 */
<> 144:ef7eb2e8f9f7 220 }
<> 144:ef7eb2e8f9f7 221
<> 144:ef7eb2e8f9f7 222 /**
<> 144:ef7eb2e8f9f7 223 * @brief DeInitializes the MSP.
<> 144:ef7eb2e8f9f7 224 * @retval None
<> 144:ef7eb2e8f9f7 225 */
<> 144:ef7eb2e8f9f7 226 __weak void HAL_MspDeInit(void)
<> 144:ef7eb2e8f9f7 227 {
<> 144:ef7eb2e8f9f7 228 /* NOTE : This function Should not be modified, when the callback is needed,
<> 144:ef7eb2e8f9f7 229 the HAL_MspDeInit could be implemented in the user file
<> 144:ef7eb2e8f9f7 230 */
<> 144:ef7eb2e8f9f7 231 }
<> 144:ef7eb2e8f9f7 232
<> 144:ef7eb2e8f9f7 233 /**
<> 144:ef7eb2e8f9f7 234 * @brief This function configures the source of the time base.
<> 144:ef7eb2e8f9f7 235 * The time source is configured to have 1ms time base with a dedicated
<> 144:ef7eb2e8f9f7 236 * Tick interrupt priority.
<> 144:ef7eb2e8f9f7 237 * @note This function is called automatically at the beginning of program after
<> 144:ef7eb2e8f9f7 238 * reset by HAL_Init() or at any time when clock is reconfigured by HAL_RCC_ClockConfig().
<> 144:ef7eb2e8f9f7 239 * @note In the default implementation, SysTick timer is the source of time base.
<> 144:ef7eb2e8f9f7 240 * It is used to generate interrupts at regular time intervals.
<> 144:ef7eb2e8f9f7 241 * Care must be taken if HAL_Delay() is called from a peripheral ISR process,
<> 144:ef7eb2e8f9f7 242 * The the SysTick interrupt must have higher priority (numerically lower)
<> 144:ef7eb2e8f9f7 243 * than the peripheral interrupt. Otherwise the caller ISR process will be blocked.
<> 144:ef7eb2e8f9f7 244 * The function is declared as __Weak to be overwritten in case of other
<> 144:ef7eb2e8f9f7 245 * implementation in user file.
<> 144:ef7eb2e8f9f7 246 * @param TickPriority: Tick interrupt priority.
<> 144:ef7eb2e8f9f7 247 * @retval HAL status
<> 144:ef7eb2e8f9f7 248 */
<> 144:ef7eb2e8f9f7 249 __weak HAL_StatusTypeDef HAL_InitTick(uint32_t TickPriority)
<> 144:ef7eb2e8f9f7 250 {
<> 144:ef7eb2e8f9f7 251 /*Configure the SysTick to have interrupt in 1ms time basis*/
<> 144:ef7eb2e8f9f7 252 HAL_SYSTICK_Config(HAL_RCC_GetHCLKFreq()/1000);
<> 144:ef7eb2e8f9f7 253
<> 144:ef7eb2e8f9f7 254 /*Configure the SysTick IRQ priority */
<> 144:ef7eb2e8f9f7 255 HAL_NVIC_SetPriority(SysTick_IRQn, TickPriority ,0);
<> 144:ef7eb2e8f9f7 256
<> 144:ef7eb2e8f9f7 257 /* Return function status */
<> 144:ef7eb2e8f9f7 258 return HAL_OK;
<> 144:ef7eb2e8f9f7 259 }
<> 144:ef7eb2e8f9f7 260
<> 144:ef7eb2e8f9f7 261 /**
<> 144:ef7eb2e8f9f7 262 * @}
<> 144:ef7eb2e8f9f7 263 */
<> 144:ef7eb2e8f9f7 264
<> 144:ef7eb2e8f9f7 265 /** @defgroup HAL_Exported_Functions_Group2 HAL Control functions
<> 144:ef7eb2e8f9f7 266 * @brief HAL Control functions
<> 144:ef7eb2e8f9f7 267 *
<> 144:ef7eb2e8f9f7 268 @verbatim
<> 144:ef7eb2e8f9f7 269 ===============================================================================
<> 144:ef7eb2e8f9f7 270 ##### HAL Control functions #####
<> 144:ef7eb2e8f9f7 271 ===============================================================================
<> 144:ef7eb2e8f9f7 272 [..] This section provides functions allowing to:
<> 144:ef7eb2e8f9f7 273 (+) Provide a tick value in millisecond
<> 144:ef7eb2e8f9f7 274 (+) Provide a blocking delay in millisecond
<> 144:ef7eb2e8f9f7 275 (+) Suspend the time base source interrupt
<> 144:ef7eb2e8f9f7 276 (+) Resume the time base source interrupt
<> 144:ef7eb2e8f9f7 277 (+) Get the HAL API driver version
<> 144:ef7eb2e8f9f7 278 (+) Get the device identifier
<> 144:ef7eb2e8f9f7 279 (+) Get the device revision identifier
<> 144:ef7eb2e8f9f7 280 (+) Enable/Disable Debug module during Sleep mode
<> 144:ef7eb2e8f9f7 281 (+) Enable/Disable Debug module during STOP mode
<> 144:ef7eb2e8f9f7 282 (+) Enable/Disable Debug module during STANDBY mode
<> 144:ef7eb2e8f9f7 283
<> 144:ef7eb2e8f9f7 284 @endverbatim
<> 144:ef7eb2e8f9f7 285 * @{
<> 144:ef7eb2e8f9f7 286 */
<> 144:ef7eb2e8f9f7 287
<> 144:ef7eb2e8f9f7 288 /**
<> 144:ef7eb2e8f9f7 289 * @brief This function is called to increment a global variable "uwTick"
<> 144:ef7eb2e8f9f7 290 * used as application time base.
<> 144:ef7eb2e8f9f7 291 * @note In the default implementation, this variable is incremented each 1ms
<> 144:ef7eb2e8f9f7 292 * in Systick ISR.
<> 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 None
<> 144:ef7eb2e8f9f7 296 */
<> 144:ef7eb2e8f9f7 297 __weak void HAL_IncTick(void)
<> 144:ef7eb2e8f9f7 298 {
<> 144:ef7eb2e8f9f7 299 uwTick++;
<> 144:ef7eb2e8f9f7 300 }
<> 144:ef7eb2e8f9f7 301
<> 144:ef7eb2e8f9f7 302 /**
<> 144:ef7eb2e8f9f7 303 * @brief Provides a tick value in millisecond.
<> 144:ef7eb2e8f9f7 304 * @note This function is declared as __weak to be overwritten in case of other
<> 144:ef7eb2e8f9f7 305 * implementations in user file.
<> 144:ef7eb2e8f9f7 306 * @retval tick value
<> 144:ef7eb2e8f9f7 307 */
<> 144:ef7eb2e8f9f7 308 __weak uint32_t HAL_GetTick(void)
<> 144:ef7eb2e8f9f7 309 {
<> 144:ef7eb2e8f9f7 310 return uwTick;
<> 144:ef7eb2e8f9f7 311 }
<> 144:ef7eb2e8f9f7 312
<> 144:ef7eb2e8f9f7 313 /**
<> 144:ef7eb2e8f9f7 314 * @brief This function provides accurate delay (in milliseconds) based
<> 144:ef7eb2e8f9f7 315 * on variable incremented.
<> 144:ef7eb2e8f9f7 316 * @note In the default implementation , SysTick timer is the source of time base.
<> 144:ef7eb2e8f9f7 317 * It is used to generate interrupts at regular time intervals where uwTick
<> 144:ef7eb2e8f9f7 318 * is incremented.
<> 144:ef7eb2e8f9f7 319 * @note ThiS function is declared as __weak to be overwritten in case of other
<> 144:ef7eb2e8f9f7 320 * implementations in user file.
<> 144:ef7eb2e8f9f7 321 * @param Delay: specifies the delay time length, in milliseconds.
<> 144:ef7eb2e8f9f7 322 * @retval None
<> 144:ef7eb2e8f9f7 323 */
<> 144:ef7eb2e8f9f7 324 __weak void HAL_Delay(__IO uint32_t Delay)
<> 144:ef7eb2e8f9f7 325 {
<> 144:ef7eb2e8f9f7 326 uint32_t tickstart = 0;
<> 144:ef7eb2e8f9f7 327 tickstart = HAL_GetTick();
<> 144:ef7eb2e8f9f7 328 while((HAL_GetTick() - tickstart) < Delay)
<> 144:ef7eb2e8f9f7 329 {
<> 144:ef7eb2e8f9f7 330 }
<> 144:ef7eb2e8f9f7 331 }
<> 144:ef7eb2e8f9f7 332
<> 144:ef7eb2e8f9f7 333 /**
<> 144:ef7eb2e8f9f7 334 * @brief Suspend Tick increment.
<> 144:ef7eb2e8f9f7 335 * @note In the default implementation , SysTick timer is the source of time base. It is
<> 144:ef7eb2e8f9f7 336 * used to generate interrupts at regular time intervals. Once HAL_SuspendTick()
<> 144:ef7eb2e8f9f7 337 * is called, the the SysTick interrupt will be disabled and so Tick increment
<> 144:ef7eb2e8f9f7 338 * is suspended.
<> 144:ef7eb2e8f9f7 339 * @note This function is declared as __weak to be overwritten in case of other
<> 144:ef7eb2e8f9f7 340 * implementations in user file.
<> 144:ef7eb2e8f9f7 341 * @retval None
<> 144:ef7eb2e8f9f7 342 */
<> 144:ef7eb2e8f9f7 343 __weak void HAL_SuspendTick(void)
<> 144:ef7eb2e8f9f7 344 {
<> 144:ef7eb2e8f9f7 345 /* Disable SysTick Interrupt */
<> 144:ef7eb2e8f9f7 346 CLEAR_BIT(SysTick->CTRL,SysTick_CTRL_TICKINT_Msk);
<> 144:ef7eb2e8f9f7 347 }
<> 144:ef7eb2e8f9f7 348
<> 144:ef7eb2e8f9f7 349 /**
<> 144:ef7eb2e8f9f7 350 * @brief Resume Tick increment.
<> 144:ef7eb2e8f9f7 351 * @note In the default implementation , SysTick timer is the source of time base. It is
<> 144:ef7eb2e8f9f7 352 * used to generate interrupts at regular time intervals. Once HAL_ResumeTick()
<> 144:ef7eb2e8f9f7 353 * is called, the the SysTick interrupt will be enabled and so Tick increment
<> 144:ef7eb2e8f9f7 354 * is resumed.
<> 144:ef7eb2e8f9f7 355 * @note This function is declared as __weak to be overwritten in case of other
<> 144:ef7eb2e8f9f7 356 * implementations in user file.
<> 144:ef7eb2e8f9f7 357 * @retval None
<> 144:ef7eb2e8f9f7 358 */
<> 144:ef7eb2e8f9f7 359 __weak void HAL_ResumeTick(void)
<> 144:ef7eb2e8f9f7 360 {
<> 144:ef7eb2e8f9f7 361 /* Enable SysTick Interrupt */
<> 144:ef7eb2e8f9f7 362 SET_BIT(SysTick->CTRL,SysTick_CTRL_TICKINT_Msk);
<> 144:ef7eb2e8f9f7 363 }
<> 144:ef7eb2e8f9f7 364
<> 144:ef7eb2e8f9f7 365 /**
<> 144:ef7eb2e8f9f7 366 * @brief This method returns the HAL revision
<> 144:ef7eb2e8f9f7 367 * @retval version: 0xXYZR (8bits for each decimal, R for RC)
<> 144:ef7eb2e8f9f7 368 */
<> 144:ef7eb2e8f9f7 369 uint32_t HAL_GetHalVersion(void)
<> 144:ef7eb2e8f9f7 370 {
<> 144:ef7eb2e8f9f7 371 return __STM32F1xx_HAL_VERSION;
<> 144:ef7eb2e8f9f7 372 }
<> 144:ef7eb2e8f9f7 373
<> 144:ef7eb2e8f9f7 374 /**
<> 144:ef7eb2e8f9f7 375 * @brief Returns the device revision identifier.
<> 144:ef7eb2e8f9f7 376 * Note: On devices STM32F10xx8 and STM32F10xxB,
<> 144:ef7eb2e8f9f7 377 * STM32F101xC/D/E and STM32F103xC/D/E,
<> 144:ef7eb2e8f9f7 378 * STM32F101xF/G and STM32F103xF/G
<> 144:ef7eb2e8f9f7 379 * STM32F10xx4 and STM32F10xx6
<> 144:ef7eb2e8f9f7 380 * Debug registers DBGMCU_IDCODE and DBGMCU_CR are accessible only in
<> 144:ef7eb2e8f9f7 381 * debug mode (not accessible by the user software in normal mode).
<> 144:ef7eb2e8f9f7 382 * Refer to errata sheet of these devices for more details.
<> 144:ef7eb2e8f9f7 383 * @retval Device revision identifier
<> 144:ef7eb2e8f9f7 384 */
<> 144:ef7eb2e8f9f7 385 uint32_t HAL_GetREVID(void)
<> 144:ef7eb2e8f9f7 386 {
<> 144:ef7eb2e8f9f7 387 return((DBGMCU->IDCODE) >> POSITION_VAL(DBGMCU_IDCODE_REV_ID));
<> 144:ef7eb2e8f9f7 388 }
<> 144:ef7eb2e8f9f7 389
<> 144:ef7eb2e8f9f7 390 /**
<> 144:ef7eb2e8f9f7 391 * @brief Returns the device identifier.
<> 144:ef7eb2e8f9f7 392 * Note: On devices STM32F10xx8 and STM32F10xxB,
<> 144:ef7eb2e8f9f7 393 * STM32F101xC/D/E and STM32F103xC/D/E,
<> 144:ef7eb2e8f9f7 394 * STM32F101xF/G and STM32F103xF/G
<> 144:ef7eb2e8f9f7 395 * STM32F10xx4 and STM32F10xx6
<> 144:ef7eb2e8f9f7 396 * Debug registers DBGMCU_IDCODE and DBGMCU_CR are accessible only in
<> 144:ef7eb2e8f9f7 397 * debug mode (not accessible by the user software in normal mode).
<> 144:ef7eb2e8f9f7 398 * Refer to errata sheet of these devices for more details.
<> 144:ef7eb2e8f9f7 399 * @retval Device identifier
<> 144:ef7eb2e8f9f7 400 */
<> 144:ef7eb2e8f9f7 401 uint32_t HAL_GetDEVID(void)
<> 144:ef7eb2e8f9f7 402 {
<> 144:ef7eb2e8f9f7 403 return((DBGMCU->IDCODE) & IDCODE_DEVID_MASK);
<> 144:ef7eb2e8f9f7 404 }
<> 144:ef7eb2e8f9f7 405
<> 144:ef7eb2e8f9f7 406 /**
<> 144:ef7eb2e8f9f7 407 * @brief Enable the Debug Module during SLEEP mode
<> 144:ef7eb2e8f9f7 408 * @retval None
<> 144:ef7eb2e8f9f7 409 */
<> 144:ef7eb2e8f9f7 410 void HAL_DBGMCU_EnableDBGSleepMode(void)
<> 144:ef7eb2e8f9f7 411 {
<> 144:ef7eb2e8f9f7 412 SET_BIT(DBGMCU->CR, DBGMCU_CR_DBG_SLEEP);
<> 144:ef7eb2e8f9f7 413 }
<> 144:ef7eb2e8f9f7 414
<> 144:ef7eb2e8f9f7 415 /**
<> 144:ef7eb2e8f9f7 416 * @brief Disable the Debug Module during SLEEP mode
<> 144:ef7eb2e8f9f7 417 * Note: On devices STM32F10xx8 and STM32F10xxB,
<> 144:ef7eb2e8f9f7 418 * STM32F101xC/D/E and STM32F103xC/D/E,
<> 144:ef7eb2e8f9f7 419 * STM32F101xF/G and STM32F103xF/G
<> 144:ef7eb2e8f9f7 420 * STM32F10xx4 and STM32F10xx6
<> 144:ef7eb2e8f9f7 421 * Debug registers DBGMCU_IDCODE and DBGMCU_CR are accessible only in
<> 144:ef7eb2e8f9f7 422 * debug mode (not accessible by the user software in normal mode).
<> 144:ef7eb2e8f9f7 423 * Refer to errata sheet of these devices for more details.
<> 144:ef7eb2e8f9f7 424 * @retval None
<> 144:ef7eb2e8f9f7 425 */
<> 144:ef7eb2e8f9f7 426 void HAL_DBGMCU_DisableDBGSleepMode(void)
<> 144:ef7eb2e8f9f7 427 {
<> 144:ef7eb2e8f9f7 428 CLEAR_BIT(DBGMCU->CR, DBGMCU_CR_DBG_SLEEP);
<> 144:ef7eb2e8f9f7 429 }
<> 144:ef7eb2e8f9f7 430
<> 144:ef7eb2e8f9f7 431 /**
<> 144:ef7eb2e8f9f7 432 * @brief Enable the Debug Module during STOP mode
<> 144:ef7eb2e8f9f7 433 * Note: On devices STM32F10xx8 and STM32F10xxB,
<> 144:ef7eb2e8f9f7 434 * STM32F101xC/D/E and STM32F103xC/D/E,
<> 144:ef7eb2e8f9f7 435 * STM32F101xF/G and STM32F103xF/G
<> 144:ef7eb2e8f9f7 436 * STM32F10xx4 and STM32F10xx6
<> 144:ef7eb2e8f9f7 437 * Debug registers DBGMCU_IDCODE and DBGMCU_CR are accessible only in
<> 144:ef7eb2e8f9f7 438 * debug mode (not accessible by the user software in normal mode).
<> 144:ef7eb2e8f9f7 439 * Refer to errata sheet of these devices for more details.
<> 144:ef7eb2e8f9f7 440 * Note: On all STM32F1 devices:
<> 144:ef7eb2e8f9f7 441 * If the system tick timer interrupt is enabled during the Stop mode
<> 144:ef7eb2e8f9f7 442 * debug (DBG_STOP bit set in the DBGMCU_CR register ), it will wakeup
<> 144:ef7eb2e8f9f7 443 * the system from Stop mode.
<> 144:ef7eb2e8f9f7 444 * Workaround: To debug the Stop mode, disable the system tick timer
<> 144:ef7eb2e8f9f7 445 * interrupt.
<> 144:ef7eb2e8f9f7 446 * Refer to errata sheet of these devices for more details.
<> 144:ef7eb2e8f9f7 447 * Note: On all STM32F1 devices:
<> 144:ef7eb2e8f9f7 448 * If the system tick timer interrupt is enabled during the Stop mode
<> 144:ef7eb2e8f9f7 449 * debug (DBG_STOP bit set in the DBGMCU_CR register ), it will wakeup
<> 144:ef7eb2e8f9f7 450 * the system from Stop mode.
<> 144:ef7eb2e8f9f7 451 * Workaround: To debug the Stop mode, disable the system tick timer
<> 144:ef7eb2e8f9f7 452 * interrupt.
<> 144:ef7eb2e8f9f7 453 * Refer to errata sheet of these devices for more details.
<> 144:ef7eb2e8f9f7 454 * @retval None
<> 144:ef7eb2e8f9f7 455 */
<> 144:ef7eb2e8f9f7 456 void HAL_DBGMCU_EnableDBGStopMode(void)
<> 144:ef7eb2e8f9f7 457 {
<> 144:ef7eb2e8f9f7 458 SET_BIT(DBGMCU->CR, DBGMCU_CR_DBG_STOP);
<> 144:ef7eb2e8f9f7 459 }
<> 144:ef7eb2e8f9f7 460
<> 144:ef7eb2e8f9f7 461 /**
<> 144:ef7eb2e8f9f7 462 * @brief Disable the Debug Module during STOP mode
<> 144:ef7eb2e8f9f7 463 * Note: On devices STM32F10xx8 and STM32F10xxB,
<> 144:ef7eb2e8f9f7 464 * STM32F101xC/D/E and STM32F103xC/D/E,
<> 144:ef7eb2e8f9f7 465 * STM32F101xF/G and STM32F103xF/G
<> 144:ef7eb2e8f9f7 466 * STM32F10xx4 and STM32F10xx6
<> 144:ef7eb2e8f9f7 467 * Debug registers DBGMCU_IDCODE and DBGMCU_CR are accessible only in
<> 144:ef7eb2e8f9f7 468 * debug mode (not accessible by the user software in normal mode).
<> 144:ef7eb2e8f9f7 469 * Refer to errata sheet of these devices for more details.
<> 144:ef7eb2e8f9f7 470 * @retval None
<> 144:ef7eb2e8f9f7 471 */
<> 144:ef7eb2e8f9f7 472 void HAL_DBGMCU_DisableDBGStopMode(void)
<> 144:ef7eb2e8f9f7 473 {
<> 144:ef7eb2e8f9f7 474 CLEAR_BIT(DBGMCU->CR, DBGMCU_CR_DBG_STOP);
<> 144:ef7eb2e8f9f7 475 }
<> 144:ef7eb2e8f9f7 476
<> 144:ef7eb2e8f9f7 477 /**
<> 144:ef7eb2e8f9f7 478 * @brief Enable the Debug Module during STANDBY mode
<> 144:ef7eb2e8f9f7 479 * Note: On devices STM32F10xx8 and STM32F10xxB,
<> 144:ef7eb2e8f9f7 480 * STM32F101xC/D/E and STM32F103xC/D/E,
<> 144:ef7eb2e8f9f7 481 * STM32F101xF/G and STM32F103xF/G
<> 144:ef7eb2e8f9f7 482 * STM32F10xx4 and STM32F10xx6
<> 144:ef7eb2e8f9f7 483 * Debug registers DBGMCU_IDCODE and DBGMCU_CR are accessible only in
<> 144:ef7eb2e8f9f7 484 * debug mode (not accessible by the user software in normal mode).
<> 144:ef7eb2e8f9f7 485 * Refer to errata sheet of these devices for more details.
<> 144:ef7eb2e8f9f7 486 * @retval None
<> 144:ef7eb2e8f9f7 487 */
<> 144:ef7eb2e8f9f7 488 void HAL_DBGMCU_EnableDBGStandbyMode(void)
<> 144:ef7eb2e8f9f7 489 {
<> 144:ef7eb2e8f9f7 490 SET_BIT(DBGMCU->CR, DBGMCU_CR_DBG_STANDBY);
<> 144:ef7eb2e8f9f7 491 }
<> 144:ef7eb2e8f9f7 492
<> 144:ef7eb2e8f9f7 493 /**
<> 144:ef7eb2e8f9f7 494 * @brief Disable the Debug Module during STANDBY mode
<> 144:ef7eb2e8f9f7 495 * Note: On devices STM32F10xx8 and STM32F10xxB,
<> 144:ef7eb2e8f9f7 496 * STM32F101xC/D/E and STM32F103xC/D/E,
<> 144:ef7eb2e8f9f7 497 * STM32F101xF/G and STM32F103xF/G
<> 144:ef7eb2e8f9f7 498 * STM32F10xx4 and STM32F10xx6
<> 144:ef7eb2e8f9f7 499 * Debug registers DBGMCU_IDCODE and DBGMCU_CR are accessible only in
<> 144:ef7eb2e8f9f7 500 * debug mode (not accessible by the user software in normal mode).
<> 144:ef7eb2e8f9f7 501 * Refer to errata sheet of these devices for more details.
<> 144:ef7eb2e8f9f7 502 * @retval None
<> 144:ef7eb2e8f9f7 503 */
<> 144:ef7eb2e8f9f7 504 void HAL_DBGMCU_DisableDBGStandbyMode(void)
<> 144:ef7eb2e8f9f7 505 {
<> 144:ef7eb2e8f9f7 506 CLEAR_BIT(DBGMCU->CR, DBGMCU_CR_DBG_STANDBY);
<> 144:ef7eb2e8f9f7 507 }
<> 144:ef7eb2e8f9f7 508
<> 144:ef7eb2e8f9f7 509 /**
<> 144:ef7eb2e8f9f7 510 * @}
<> 144:ef7eb2e8f9f7 511 */
<> 144:ef7eb2e8f9f7 512
<> 144:ef7eb2e8f9f7 513 /**
<> 144:ef7eb2e8f9f7 514 * @}
<> 144:ef7eb2e8f9f7 515 */
<> 144:ef7eb2e8f9f7 516
<> 144:ef7eb2e8f9f7 517 #endif /* HAL_MODULE_ENABLED */
<> 144:ef7eb2e8f9f7 518 /**
<> 144:ef7eb2e8f9f7 519 * @}
<> 144:ef7eb2e8f9f7 520 */
<> 144:ef7eb2e8f9f7 521
<> 144:ef7eb2e8f9f7 522 /**
<> 144:ef7eb2e8f9f7 523 * @}
<> 144:ef7eb2e8f9f7 524 */
<> 144:ef7eb2e8f9f7 525
<> 144:ef7eb2e8f9f7 526 /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/