philippe s. / 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_STM32F1/stm32f1xx_hal.c@70:b3a5af880266, 2016-02-23 (annotated)

Committer:
neurofun
Date:
Tue Feb 23 21:59:35 2016 +0000
Revision:
70:b3a5af880266
Parent:
0:9b334a45a8ff 
Edited DAC routines to allow for the simultaneous use of three channels from two DACs as seen on the STM32F334R8 and STM32F303K8. Edited ADC routines to allow for the simultaneous use of more than one ADC.

Who changed what in which revision?

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