mbed official / mbed-dev

mbed library sources. Supersedes mbed-src.

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

targets/TARGET_STM/TARGET_STM32F2/device/stm32f2xx_hal.c@189:f392fc9709a3, 2019-02-20 (annotated)

Committer:
AnnaBridge
Date:
Wed Feb 20 22:31:08 2019 +0000
Revision:
189:f392fc9709a3
Parent:
167:e84263d55307 
mbed library release version 165

Who changed what in which revision?

UserRevisionLine numberNew contents of line
<> 144:ef7eb2e8f9f7 1 /**
<> 144:ef7eb2e8f9f7 2 ******************************************************************************
<> 144:ef7eb2e8f9f7 3 * @file stm32f2xx_hal.c
<> 144:ef7eb2e8f9f7 4 * @author MCD Application Team
AnnaBridge 167:e84263d55307 5 * @version V1.2.1
AnnaBridge 167:e84263d55307 6 * @date 14-April-2017
<> 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 *
AnnaBridge 167:e84263d55307 26 * <h2><center>&copy; COPYRIGHT(c) 2017 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 "stm32f2xx_hal.h"
<> 144:ef7eb2e8f9f7 55
<> 144:ef7eb2e8f9f7 56 /** @addtogroup STM32F2xx_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 /* Private typedef -----------------------------------------------------------*/
<> 144:ef7eb2e8f9f7 66 /* Private define ------------------------------------------------------------*/
<> 144:ef7eb2e8f9f7 67 /** @addtogroup HAL_Private_Constants
<> 144:ef7eb2e8f9f7 68 * @{
<> 144:ef7eb2e8f9f7 69 */
<> 144:ef7eb2e8f9f7 70 /**
AnnaBridge 167:e84263d55307 71 * @brief STM32F2xx HAL Driver version number V1.2.1
<> 144:ef7eb2e8f9f7 72 */
AnnaBridge 167:e84263d55307 73 #define __STM32F2xx_HAL_VERSION_MAIN 0x01U /*!< [31:24] main version */
AnnaBridge 167:e84263d55307 74 #define __STM32F2xx_HAL_VERSION_SUB1 0x02U /*!< [23:16] sub1 version */
AnnaBridge 167:e84263d55307 75 #define __STM32F2xx_HAL_VERSION_SUB2 0x01U /*!< [15:8] sub2 version */
AnnaBridge 167:e84263d55307 76 #define __STM32F2xx_HAL_VERSION_RC 0x00U /*!< [7:0] release candidate */
<> 144:ef7eb2e8f9f7 77 #define __STM32F2xx_HAL_VERSION ((__STM32F2xx_HAL_VERSION_MAIN << 24U)\
<> 144:ef7eb2e8f9f7 78 |(__STM32F2xx_HAL_VERSION_SUB1 << 16U)\
<> 144:ef7eb2e8f9f7 79 |(__STM32F2xx_HAL_VERSION_SUB2 << 8U) \
<> 144:ef7eb2e8f9f7 80 |(__STM32F2xx_HAL_VERSION_RC))
<> 144:ef7eb2e8f9f7 81
AnnaBridge 167:e84263d55307 82 #define IDCODE_DEVID_MASK 0x00000FFFU
<> 144:ef7eb2e8f9f7 83
<> 144:ef7eb2e8f9f7 84 /* ------------ RCC registers bit address in the alias region ----------- */
<> 144:ef7eb2e8f9f7 85 #define SYSCFG_OFFSET (SYSCFG_BASE - PERIPH_BASE)
<> 144:ef7eb2e8f9f7 86 /* --- MEMRMP Register ---*/
<> 144:ef7eb2e8f9f7 87 /* Alias word address of UFB_MODE bit */
<> 144:ef7eb2e8f9f7 88 #define MEMRMP_OFFSET SYSCFG_OFFSET
<> 144:ef7eb2e8f9f7 89 #define UFB_MODE_BIT_NUMBER POSITION_VAL(SYSCFG_MEMRMP_UFB_MODE)
<> 144:ef7eb2e8f9f7 90 #define UFB_MODE_BB (uint32_t)(PERIPH_BB_BASE + (MEMRMP_OFFSET * 32U) + (UFB_MODE_BIT_NUMBER * 4U))
<> 144:ef7eb2e8f9f7 91
<> 144:ef7eb2e8f9f7 92 /* --- CMPCR Register ---*/
<> 144:ef7eb2e8f9f7 93 /* Alias word address of CMP_PD bit */
<> 144:ef7eb2e8f9f7 94 #define CMPCR_OFFSET (SYSCFG_OFFSET + 0x20U)
<> 144:ef7eb2e8f9f7 95 #define CMP_PD_BIT_NUMBER POSITION_VAL(SYSCFG_CMPCR_CMP_PD)
<> 144:ef7eb2e8f9f7 96 #define CMPCR_CMP_PD_BB (uint32_t)(PERIPH_BB_BASE + (CMPCR_OFFSET * 32U) + (CMP_PD_BIT_NUMBER * 4U))
<> 144:ef7eb2e8f9f7 97 /**
<> 144:ef7eb2e8f9f7 98 * @}
<> 144:ef7eb2e8f9f7 99 */
<> 144:ef7eb2e8f9f7 100
<> 144:ef7eb2e8f9f7 101 /* Private macro -------------------------------------------------------------*/
<> 144:ef7eb2e8f9f7 102 /* Private variables ---------------------------------------------------------*/
<> 144:ef7eb2e8f9f7 103 /** @addtogroup HAL_Private_Variables
<> 144:ef7eb2e8f9f7 104 * @{
<> 144:ef7eb2e8f9f7 105 */
<> 144:ef7eb2e8f9f7 106 __IO uint32_t uwTick;
<> 144:ef7eb2e8f9f7 107 /**
<> 144:ef7eb2e8f9f7 108 * @}
<> 144:ef7eb2e8f9f7 109 */
<> 144:ef7eb2e8f9f7 110 /* Private function prototypes -----------------------------------------------*/
<> 144:ef7eb2e8f9f7 111 /* Private functions ---------------------------------------------------------*/
<> 144:ef7eb2e8f9f7 112
<> 144:ef7eb2e8f9f7 113 /** @defgroup HAL_Exported_Functions HAL Exported Functions
<> 144:ef7eb2e8f9f7 114 * @{
<> 144:ef7eb2e8f9f7 115 */
<> 144:ef7eb2e8f9f7 116
<> 144:ef7eb2e8f9f7 117 /** @defgroup HAL_Exported_Functions_Group1 Initialization and de-initialization Functions
<> 144:ef7eb2e8f9f7 118 * @brief Initialization and de-initialization functions
<> 144:ef7eb2e8f9f7 119 *
<> 144:ef7eb2e8f9f7 120 @verbatim
<> 144:ef7eb2e8f9f7 121 ===============================================================================
<> 144:ef7eb2e8f9f7 122 ##### Initialization and de-initialization functions #####
<> 144:ef7eb2e8f9f7 123 ===============================================================================
<> 144:ef7eb2e8f9f7 124 [..] This section provides functions allowing to:
<> 144:ef7eb2e8f9f7 125 (+) Initializes the Flash interface the NVIC allocation and initial clock
<> 144:ef7eb2e8f9f7 126 configuration. It initializes the systick also when timeout is needed
<> 144:ef7eb2e8f9f7 127 and the backup domain when enabled.
<> 144:ef7eb2e8f9f7 128 (+) de-Initializes common part of the HAL
<> 144:ef7eb2e8f9f7 129 (+) Configure The time base source to have 1ms time base with a dedicated
<> 144:ef7eb2e8f9f7 130 Tick interrupt priority.
<> 144:ef7eb2e8f9f7 131 (++) Systick timer is used by default as source of time base, but user
<> 144:ef7eb2e8f9f7 132 can eventually implement his proper time base source (a general purpose
<> 144:ef7eb2e8f9f7 133 timer for example or other time source), keeping in mind that Time base
<> 144:ef7eb2e8f9f7 134 duration should be kept 1ms since PPP_TIMEOUT_VALUEs are defined and
<> 144:ef7eb2e8f9f7 135 handled in milliseconds basis.
<> 144:ef7eb2e8f9f7 136 (++) Time base configuration function (HAL_InitTick ()) is called automatically
<> 144:ef7eb2e8f9f7 137 at the beginning of the program after reset by HAL_Init() or at any time
<> 144:ef7eb2e8f9f7 138 when clock is configured, by HAL_RCC_ClockConfig().
<> 144:ef7eb2e8f9f7 139 (++) Source of time base is configured to generate interrupts at regular
<> 144:ef7eb2e8f9f7 140 time intervals. Care must be taken if HAL_Delay() is called from a
<> 144:ef7eb2e8f9f7 141 peripheral ISR process, the Tick interrupt line must have higher priority
<> 144:ef7eb2e8f9f7 142 (numerically lower) than the peripheral interrupt. Otherwise the caller
<> 144:ef7eb2e8f9f7 143 ISR process will be blocked.
<> 144:ef7eb2e8f9f7 144 (++) functions affecting time base configurations are declared as __weak
<> 144:ef7eb2e8f9f7 145 to make override possible in case of other implementations in user file.
<> 144:ef7eb2e8f9f7 146 @endverbatim
<> 144:ef7eb2e8f9f7 147 * @{
<> 144:ef7eb2e8f9f7 148 */
<> 144:ef7eb2e8f9f7 149
<> 144:ef7eb2e8f9f7 150 /**
<> 144:ef7eb2e8f9f7 151 * @brief This function is used to initialize the HAL Library; it must be the first
<> 144:ef7eb2e8f9f7 152 * instruction to be executed in the main program (before to call any other
<> 144:ef7eb2e8f9f7 153 * HAL function), it performs the following:
<> 144:ef7eb2e8f9f7 154 * Configure the Flash prefetch, instruction and Data caches.
<> 144:ef7eb2e8f9f7 155 * Configures the SysTick to generate an interrupt each 1 millisecond,
<> 144:ef7eb2e8f9f7 156 * which is clocked by the HSI (at this stage, the clock is not yet
<> 144:ef7eb2e8f9f7 157 * configured and thus the system is running from the internal HSI at 16 MHz).
<> 144:ef7eb2e8f9f7 158 * Set NVIC Group Priority to 4.
<> 144:ef7eb2e8f9f7 159 * Calls the HAL_MspInit() callback function defined in user file
<> 144:ef7eb2e8f9f7 160 * "stm32f2xx_hal_msp.c" to do the global low level hardware initialization
<> 144:ef7eb2e8f9f7 161 *
<> 144:ef7eb2e8f9f7 162 * @note SysTick is used as time base for the HAL_Delay() function, the application
<> 144:ef7eb2e8f9f7 163 * need to ensure that the SysTick time base is always set to 1 millisecond
<> 144:ef7eb2e8f9f7 164 * to have correct HAL operation.
<> 144:ef7eb2e8f9f7 165 * @retval HAL status
<> 144:ef7eb2e8f9f7 166 */
<> 144:ef7eb2e8f9f7 167 HAL_StatusTypeDef HAL_Init(void)
<> 144:ef7eb2e8f9f7 168 {
<> 144:ef7eb2e8f9f7 169 /* Configure Flash prefetch, Instruction cache, Data cache */
<> 144:ef7eb2e8f9f7 170 #if (INSTRUCTION_CACHE_ENABLE != 0U)
<> 144:ef7eb2e8f9f7 171 __HAL_FLASH_INSTRUCTION_CACHE_ENABLE();
<> 144:ef7eb2e8f9f7 172 #endif /* INSTRUCTION_CACHE_ENABLE */
<> 144:ef7eb2e8f9f7 173
<> 144:ef7eb2e8f9f7 174 #if (DATA_CACHE_ENABLE != 0U)
<> 144:ef7eb2e8f9f7 175 __HAL_FLASH_DATA_CACHE_ENABLE();
<> 144:ef7eb2e8f9f7 176 #endif /* DATA_CACHE_ENABLE */
<> 144:ef7eb2e8f9f7 177
<> 144:ef7eb2e8f9f7 178 #if (PREFETCH_ENABLE != 0U)
<> 144:ef7eb2e8f9f7 179 __HAL_FLASH_PREFETCH_BUFFER_ENABLE();
<> 144:ef7eb2e8f9f7 180 #endif /* PREFETCH_ENABLE */
<> 144:ef7eb2e8f9f7 181
<> 144:ef7eb2e8f9f7 182 /* Set Interrupt Group Priority */
<> 144:ef7eb2e8f9f7 183 HAL_NVIC_SetPriorityGrouping(NVIC_PRIORITYGROUP_4);
<> 144:ef7eb2e8f9f7 184
<> 144:ef7eb2e8f9f7 185 /* Use systick as time base source and configure 1ms tick (default clock after Reset is HSI) */
<> 144:ef7eb2e8f9f7 186 HAL_InitTick(TICK_INT_PRIORITY);
<> 144:ef7eb2e8f9f7 187
<> 144:ef7eb2e8f9f7 188 /* Init the low level hardware */
<> 144:ef7eb2e8f9f7 189 HAL_MspInit();
<> 144:ef7eb2e8f9f7 190
<> 144:ef7eb2e8f9f7 191 /* Return function status */
<> 144:ef7eb2e8f9f7 192 return HAL_OK;
<> 144:ef7eb2e8f9f7 193 }
<> 144:ef7eb2e8f9f7 194
<> 144:ef7eb2e8f9f7 195 /**
<> 144:ef7eb2e8f9f7 196 * @brief This function de-Initializes common part of the HAL and stops the systick.
<> 144:ef7eb2e8f9f7 197 * This function is optional.
<> 144:ef7eb2e8f9f7 198 * @retval HAL status
<> 144:ef7eb2e8f9f7 199 */
<> 144:ef7eb2e8f9f7 200 HAL_StatusTypeDef HAL_DeInit(void)
<> 144:ef7eb2e8f9f7 201 {
<> 144:ef7eb2e8f9f7 202 /* Reset of all peripherals */
<> 144:ef7eb2e8f9f7 203 __HAL_RCC_APB1_FORCE_RESET();
<> 144:ef7eb2e8f9f7 204 __HAL_RCC_APB1_RELEASE_RESET();
<> 144:ef7eb2e8f9f7 205
<> 144:ef7eb2e8f9f7 206 __HAL_RCC_APB2_FORCE_RESET();
<> 144:ef7eb2e8f9f7 207 __HAL_RCC_APB2_RELEASE_RESET();
<> 144:ef7eb2e8f9f7 208
<> 144:ef7eb2e8f9f7 209 __HAL_RCC_AHB1_FORCE_RESET();
<> 144:ef7eb2e8f9f7 210 __HAL_RCC_AHB1_RELEASE_RESET();
<> 144:ef7eb2e8f9f7 211
<> 144:ef7eb2e8f9f7 212 __HAL_RCC_AHB2_FORCE_RESET();
<> 144:ef7eb2e8f9f7 213 __HAL_RCC_AHB2_RELEASE_RESET();
<> 144:ef7eb2e8f9f7 214
<> 144:ef7eb2e8f9f7 215 __HAL_RCC_AHB3_FORCE_RESET();
<> 144:ef7eb2e8f9f7 216 __HAL_RCC_AHB3_RELEASE_RESET();
<> 144:ef7eb2e8f9f7 217
<> 144:ef7eb2e8f9f7 218 /* De-Init the low level hardware */
<> 144:ef7eb2e8f9f7 219 HAL_MspDeInit();
<> 144:ef7eb2e8f9f7 220
<> 144:ef7eb2e8f9f7 221 /* Return function status */
<> 144:ef7eb2e8f9f7 222 return HAL_OK;
<> 144:ef7eb2e8f9f7 223 }
<> 144:ef7eb2e8f9f7 224
<> 144:ef7eb2e8f9f7 225 /**
<> 144:ef7eb2e8f9f7 226 * @brief Initializes the MSP.
<> 144:ef7eb2e8f9f7 227 * @retval None
<> 144:ef7eb2e8f9f7 228 */
<> 144:ef7eb2e8f9f7 229 __weak void HAL_MspInit(void)
<> 144:ef7eb2e8f9f7 230 {
<> 144:ef7eb2e8f9f7 231 /* NOTE : This function Should not be modified, when the callback is needed,
<> 144:ef7eb2e8f9f7 232 the HAL_MspInit could be implemented in the user file
<> 144:ef7eb2e8f9f7 233 */
<> 144:ef7eb2e8f9f7 234 }
<> 144:ef7eb2e8f9f7 235
<> 144:ef7eb2e8f9f7 236 /**
<> 144:ef7eb2e8f9f7 237 * @brief DeInitializes the MSP.
<> 144:ef7eb2e8f9f7 238 * @retval None
<> 144:ef7eb2e8f9f7 239 */
<> 144:ef7eb2e8f9f7 240 __weak void HAL_MspDeInit(void)
<> 144:ef7eb2e8f9f7 241 {
<> 144:ef7eb2e8f9f7 242 /* NOTE : This function Should not be modified, when the callback is needed,
<> 144:ef7eb2e8f9f7 243 the HAL_MspDeInit could be implemented in the user file
<> 144:ef7eb2e8f9f7 244 */
<> 144:ef7eb2e8f9f7 245 }
<> 144:ef7eb2e8f9f7 246
<> 144:ef7eb2e8f9f7 247 /**
<> 144:ef7eb2e8f9f7 248 * @brief This function configures the source of the time base.
<> 144:ef7eb2e8f9f7 249 * The time source is configured to have 1ms time base with a dedicated
<> 144:ef7eb2e8f9f7 250 * Tick interrupt priority.
<> 144:ef7eb2e8f9f7 251 * @note This function is called automatically at the beginning of program after
<> 144:ef7eb2e8f9f7 252 * reset by HAL_Init() or at any time when clock is reconfigured by HAL_RCC_ClockConfig().
<> 144:ef7eb2e8f9f7 253 * @note In the default implementation, SysTick timer is the source of time base.
<> 144:ef7eb2e8f9f7 254 * It is used to generate interrupts at regular time intervals.
<> 144:ef7eb2e8f9f7 255 * Care must be taken if HAL_Delay() is called from a peripheral ISR process,
<> 144:ef7eb2e8f9f7 256 * The the SysTick interrupt must have higher priority (numerically lower)
<> 144:ef7eb2e8f9f7 257 * than the peripheral interrupt. Otherwise the caller ISR process will be blocked.
<> 144:ef7eb2e8f9f7 258 * The function is declared as __weak to be overwritten in case of other
<> 144:ef7eb2e8f9f7 259 * implementation in user file.
<> 144:ef7eb2e8f9f7 260 * @param TickPriority: Tick interrupt priority.
<> 144:ef7eb2e8f9f7 261 * @retval HAL status
<> 144:ef7eb2e8f9f7 262 */
<> 144:ef7eb2e8f9f7 263 __weak HAL_StatusTypeDef HAL_InitTick(uint32_t TickPriority)
<> 144:ef7eb2e8f9f7 264 {
<> 144:ef7eb2e8f9f7 265 /*Configure the SysTick to have interrupt in 1ms time basis*/
<> 144:ef7eb2e8f9f7 266 HAL_SYSTICK_Config(SystemCoreClock/1000U);
<> 144:ef7eb2e8f9f7 267
<> 144:ef7eb2e8f9f7 268 /*Configure the SysTick IRQ priority */
<> 144:ef7eb2e8f9f7 269 HAL_NVIC_SetPriority(SysTick_IRQn, TickPriority ,0U);
<> 144:ef7eb2e8f9f7 270
<> 144:ef7eb2e8f9f7 271 /* Return function status */
<> 144:ef7eb2e8f9f7 272 return HAL_OK;
<> 144:ef7eb2e8f9f7 273 }
<> 144:ef7eb2e8f9f7 274
<> 144:ef7eb2e8f9f7 275 /**
<> 144:ef7eb2e8f9f7 276 * @}
<> 144:ef7eb2e8f9f7 277 */
<> 144:ef7eb2e8f9f7 278
<> 144:ef7eb2e8f9f7 279 /** @defgroup HAL_Exported_Functions_Group2 HAL Control functions
<> 144:ef7eb2e8f9f7 280 * @brief HAL Control functions
<> 144:ef7eb2e8f9f7 281 *
<> 144:ef7eb2e8f9f7 282 @verbatim
<> 144:ef7eb2e8f9f7 283 ===============================================================================
<> 144:ef7eb2e8f9f7 284 ##### HAL Control functions #####
<> 144:ef7eb2e8f9f7 285 ===============================================================================
<> 144:ef7eb2e8f9f7 286 [..] This section provides functions allowing to:
<> 144:ef7eb2e8f9f7 287 (+) Provide a tick value in millisecond
<> 144:ef7eb2e8f9f7 288 (+) Provide a blocking delay in millisecond
<> 144:ef7eb2e8f9f7 289 (+) Suspend the time base source interrupt
<> 144:ef7eb2e8f9f7 290 (+) Resume the time base source interrupt
<> 144:ef7eb2e8f9f7 291 (+) Get the HAL API driver version
<> 144:ef7eb2e8f9f7 292 (+) Get the device identifier
<> 144:ef7eb2e8f9f7 293 (+) Get the device revision identifier
<> 144:ef7eb2e8f9f7 294 (+) Enable/Disable Debug module during SLEEP mode
<> 144:ef7eb2e8f9f7 295 (+) Enable/Disable Debug module during STOP mode
<> 144:ef7eb2e8f9f7 296 (+) Enable/Disable Debug module during STANDBY mode
<> 144:ef7eb2e8f9f7 297
<> 144:ef7eb2e8f9f7 298 @endverbatim
<> 144:ef7eb2e8f9f7 299 * @{
<> 144:ef7eb2e8f9f7 300 */
<> 144:ef7eb2e8f9f7 301
<> 144:ef7eb2e8f9f7 302 /**
<> 144:ef7eb2e8f9f7 303 * @brief This function is called to increment a global variable "uwTick"
<> 144:ef7eb2e8f9f7 304 * used as application time base.
<> 144:ef7eb2e8f9f7 305 * @note In the default implementation, this variable is incremented each 1ms
<> 144:ef7eb2e8f9f7 306 * in Systick ISR.
<> 144:ef7eb2e8f9f7 307 * @note This function is declared as __weak to be overwritten in case of other
<> 144:ef7eb2e8f9f7 308 * implementations in user file.
<> 144:ef7eb2e8f9f7 309 * @retval None
<> 144:ef7eb2e8f9f7 310 */
<> 144:ef7eb2e8f9f7 311 __weak void HAL_IncTick(void)
<> 144:ef7eb2e8f9f7 312 {
<> 144:ef7eb2e8f9f7 313 uwTick++;
<> 144:ef7eb2e8f9f7 314 }
<> 144:ef7eb2e8f9f7 315
<> 144:ef7eb2e8f9f7 316 /**
<> 144:ef7eb2e8f9f7 317 * @brief Provides a tick value in millisecond.
<> 144:ef7eb2e8f9f7 318 * @note This function is declared as __weak to be overwritten in case of other
<> 144:ef7eb2e8f9f7 319 * implementations in user file.
<> 144:ef7eb2e8f9f7 320 * @retval tick value
<> 144:ef7eb2e8f9f7 321 */
<> 144:ef7eb2e8f9f7 322 __weak uint32_t HAL_GetTick(void)
<> 144:ef7eb2e8f9f7 323 {
<> 144:ef7eb2e8f9f7 324 return uwTick;
<> 144:ef7eb2e8f9f7 325 }
<> 144:ef7eb2e8f9f7 326
<> 144:ef7eb2e8f9f7 327 /**
AnnaBridge 167:e84263d55307 328 * @brief This function provides minimum delay (in milliseconds) based
<> 144:ef7eb2e8f9f7 329 * on variable incremented.
<> 144:ef7eb2e8f9f7 330 * @note In the default implementation , SysTick timer is the source of time base.
<> 144:ef7eb2e8f9f7 331 * It is used to generate interrupts at regular time intervals where uwTick
<> 144:ef7eb2e8f9f7 332 * is incremented.
<> 144:ef7eb2e8f9f7 333 * @note This function is declared as __weak to be overwritten in case of other
<> 144:ef7eb2e8f9f7 334 * implementations in user file.
<> 144:ef7eb2e8f9f7 335 * @param Delay: specifies the delay time length, in milliseconds.
<> 144:ef7eb2e8f9f7 336 * @retval None
<> 144:ef7eb2e8f9f7 337 */
<> 144:ef7eb2e8f9f7 338 __weak void HAL_Delay(__IO uint32_t Delay)
<> 144:ef7eb2e8f9f7 339 {
AnnaBridge 167:e84263d55307 340 uint32_t tickstart = HAL_GetTick();
AnnaBridge 167:e84263d55307 341 uint32_t wait = Delay;
AnnaBridge 167:e84263d55307 342
AnnaBridge 167:e84263d55307 343 /* Add a period to guarantee minimum wait */
AnnaBridge 167:e84263d55307 344 if (wait < HAL_MAX_DELAY)
AnnaBridge 167:e84263d55307 345 {
AnnaBridge 167:e84263d55307 346 wait++;
AnnaBridge 167:e84263d55307 347 }
AnnaBridge 167:e84263d55307 348
AnnaBridge 167:e84263d55307 349 while((HAL_GetTick() - tickstart) < wait)
<> 144:ef7eb2e8f9f7 350 {
<> 144:ef7eb2e8f9f7 351 }
<> 144:ef7eb2e8f9f7 352 }
<> 144:ef7eb2e8f9f7 353
<> 144:ef7eb2e8f9f7 354 /**
<> 144:ef7eb2e8f9f7 355 * @brief Suspend Tick increment.
<> 144:ef7eb2e8f9f7 356 * @note In the default implementation , SysTick timer is the source of time base. It is
<> 144:ef7eb2e8f9f7 357 * used to generate interrupts at regular time intervals. Once HAL_SuspendTick()
<> 144:ef7eb2e8f9f7 358 * is called, the SysTick interrupt will be disabled and so Tick increment
<> 144:ef7eb2e8f9f7 359 * is suspended.
<> 144:ef7eb2e8f9f7 360 * @note This function is declared as __weak to be overwritten in case of other
<> 144:ef7eb2e8f9f7 361 * implementations in user file.
<> 144:ef7eb2e8f9f7 362 * @retval None
<> 144:ef7eb2e8f9f7 363 */
<> 144:ef7eb2e8f9f7 364 __weak void HAL_SuspendTick(void)
<> 144:ef7eb2e8f9f7 365 {
<> 144:ef7eb2e8f9f7 366 /* Disable SysTick Interrupt */
<> 144:ef7eb2e8f9f7 367 SysTick->CTRL &= ~SysTick_CTRL_TICKINT_Msk;
<> 144:ef7eb2e8f9f7 368 }
<> 144:ef7eb2e8f9f7 369
<> 144:ef7eb2e8f9f7 370 /**
<> 144:ef7eb2e8f9f7 371 * @brief Resume Tick increment.
<> 144:ef7eb2e8f9f7 372 * @note In the default implementation , SysTick timer is the source of time base. It is
<> 144:ef7eb2e8f9f7 373 * used to generate interrupts at regular time intervals. Once HAL_ResumeTick()
<> 144:ef7eb2e8f9f7 374 * is called, the SysTick interrupt will be enabled and so Tick increment
<> 144:ef7eb2e8f9f7 375 * is resumed.
<> 144:ef7eb2e8f9f7 376 * @note This function is declared as __weak to be overwritten in case of other
<> 144:ef7eb2e8f9f7 377 * implementations in user file.
<> 144:ef7eb2e8f9f7 378 * @retval None
<> 144:ef7eb2e8f9f7 379 */
<> 144:ef7eb2e8f9f7 380 __weak void HAL_ResumeTick(void)
<> 144:ef7eb2e8f9f7 381 {
<> 144:ef7eb2e8f9f7 382 /* Enable SysTick Interrupt */
<> 144:ef7eb2e8f9f7 383 SysTick->CTRL |= SysTick_CTRL_TICKINT_Msk;
<> 144:ef7eb2e8f9f7 384 }
<> 144:ef7eb2e8f9f7 385
<> 144:ef7eb2e8f9f7 386 /**
<> 144:ef7eb2e8f9f7 387 * @brief Returns the HAL revision
<> 144:ef7eb2e8f9f7 388 * @retval version : 0xXYZR (8bits for each decimal, R for RC)
<> 144:ef7eb2e8f9f7 389 */
<> 144:ef7eb2e8f9f7 390 uint32_t HAL_GetHalVersion(void)
<> 144:ef7eb2e8f9f7 391 {
<> 144:ef7eb2e8f9f7 392 return __STM32F2xx_HAL_VERSION;
<> 144:ef7eb2e8f9f7 393 }
<> 144:ef7eb2e8f9f7 394
<> 144:ef7eb2e8f9f7 395 /**
<> 144:ef7eb2e8f9f7 396 * @brief Returns the device revision identifier.
<> 144:ef7eb2e8f9f7 397 * @retval Device revision identifier
<> 144:ef7eb2e8f9f7 398 */
<> 144:ef7eb2e8f9f7 399 uint32_t HAL_GetREVID(void)
<> 144:ef7eb2e8f9f7 400 {
<> 144:ef7eb2e8f9f7 401 return((DBGMCU->IDCODE) >> 16U);
<> 144:ef7eb2e8f9f7 402 }
<> 144:ef7eb2e8f9f7 403
<> 144:ef7eb2e8f9f7 404 /**
<> 144:ef7eb2e8f9f7 405 * @brief Returns the device identifier.
<> 144:ef7eb2e8f9f7 406 * @retval Device identifier
<> 144:ef7eb2e8f9f7 407 */
<> 144:ef7eb2e8f9f7 408 uint32_t HAL_GetDEVID(void)
<> 144:ef7eb2e8f9f7 409 {
<> 144:ef7eb2e8f9f7 410 return((DBGMCU->IDCODE) & IDCODE_DEVID_MASK);
<> 144:ef7eb2e8f9f7 411 }
<> 144:ef7eb2e8f9f7 412
<> 144:ef7eb2e8f9f7 413 /**
<> 144:ef7eb2e8f9f7 414 * @brief Enable the Debug Module during SLEEP mode
<> 144:ef7eb2e8f9f7 415 * @retval None
<> 144:ef7eb2e8f9f7 416 */
<> 144:ef7eb2e8f9f7 417 void HAL_DBGMCU_EnableDBGSleepMode(void)
<> 144:ef7eb2e8f9f7 418 {
<> 144:ef7eb2e8f9f7 419 SET_BIT(DBGMCU->CR, DBGMCU_CR_DBG_SLEEP);
<> 144:ef7eb2e8f9f7 420 }
<> 144:ef7eb2e8f9f7 421
<> 144:ef7eb2e8f9f7 422 /**
<> 144:ef7eb2e8f9f7 423 * @brief Disable the Debug Module during SLEEP mode
<> 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 * @retval None
<> 144:ef7eb2e8f9f7 434 */
<> 144:ef7eb2e8f9f7 435 void HAL_DBGMCU_EnableDBGStopMode(void)
<> 144:ef7eb2e8f9f7 436 {
<> 144:ef7eb2e8f9f7 437 SET_BIT(DBGMCU->CR, DBGMCU_CR_DBG_STOP);
<> 144:ef7eb2e8f9f7 438 }
<> 144:ef7eb2e8f9f7 439
<> 144:ef7eb2e8f9f7 440 /**
<> 144:ef7eb2e8f9f7 441 * @brief Disable the Debug Module during STOP mode
<> 144:ef7eb2e8f9f7 442 * @retval None
<> 144:ef7eb2e8f9f7 443 */
<> 144:ef7eb2e8f9f7 444 void HAL_DBGMCU_DisableDBGStopMode(void)
<> 144:ef7eb2e8f9f7 445 {
<> 144:ef7eb2e8f9f7 446 CLEAR_BIT(DBGMCU->CR, DBGMCU_CR_DBG_STOP);
<> 144:ef7eb2e8f9f7 447 }
<> 144:ef7eb2e8f9f7 448
<> 144:ef7eb2e8f9f7 449 /**
<> 144:ef7eb2e8f9f7 450 * @brief Enable the Debug Module during STANDBY mode
<> 144:ef7eb2e8f9f7 451 * @retval None
<> 144:ef7eb2e8f9f7 452 */
<> 144:ef7eb2e8f9f7 453 void HAL_DBGMCU_EnableDBGStandbyMode(void)
<> 144:ef7eb2e8f9f7 454 {
<> 144:ef7eb2e8f9f7 455 SET_BIT(DBGMCU->CR, DBGMCU_CR_DBG_STANDBY);
<> 144:ef7eb2e8f9f7 456 }
<> 144:ef7eb2e8f9f7 457
<> 144:ef7eb2e8f9f7 458 /**
<> 144:ef7eb2e8f9f7 459 * @brief Disable the Debug Module during STANDBY mode
<> 144:ef7eb2e8f9f7 460 * @retval None
<> 144:ef7eb2e8f9f7 461 */
<> 144:ef7eb2e8f9f7 462 void HAL_DBGMCU_DisableDBGStandbyMode(void)
<> 144:ef7eb2e8f9f7 463 {
<> 144:ef7eb2e8f9f7 464 CLEAR_BIT(DBGMCU->CR, DBGMCU_CR_DBG_STANDBY);
<> 144:ef7eb2e8f9f7 465 }
<> 144:ef7eb2e8f9f7 466
<> 144:ef7eb2e8f9f7 467 /**
<> 144:ef7eb2e8f9f7 468 * @brief Enables the I/O Compensation Cell.
<> 144:ef7eb2e8f9f7 469 * @note The I/O compensation cell can be used only when the device supply
<> 144:ef7eb2e8f9f7 470 * voltage ranges from 2.4 to 3.6 V.
<> 144:ef7eb2e8f9f7 471 * @retval None
<> 144:ef7eb2e8f9f7 472 */
<> 144:ef7eb2e8f9f7 473 void HAL_EnableCompensationCell(void)
<> 144:ef7eb2e8f9f7 474 {
<> 144:ef7eb2e8f9f7 475 *(__IO uint32_t *)CMPCR_CMP_PD_BB = (uint32_t)ENABLE;
<> 144:ef7eb2e8f9f7 476 }
<> 144:ef7eb2e8f9f7 477
<> 144:ef7eb2e8f9f7 478 /**
<> 144:ef7eb2e8f9f7 479 * @brief Power-down the I/O Compensation Cell.
<> 144:ef7eb2e8f9f7 480 * @note The I/O compensation cell can be used only when the device supply
<> 144:ef7eb2e8f9f7 481 * voltage ranges from 2.4 to 3.6 V.
<> 144:ef7eb2e8f9f7 482 * @retval None
<> 144:ef7eb2e8f9f7 483 */
<> 144:ef7eb2e8f9f7 484 void HAL_DisableCompensationCell(void)
<> 144:ef7eb2e8f9f7 485 {
<> 144:ef7eb2e8f9f7 486 *(__IO uint32_t *)CMPCR_CMP_PD_BB = (uint32_t)DISABLE;
<> 144:ef7eb2e8f9f7 487 }
<> 144:ef7eb2e8f9f7 488
<> 144:ef7eb2e8f9f7 489 /**
AnnaBridge 167:e84263d55307 490 * @brief Return the unique device identifier (UID based on 96 bits)
AnnaBridge 167:e84263d55307 491 * @param UID: pointer to 3 words array.
AnnaBridge 167:e84263d55307 492 * @retval Device identifier
AnnaBridge 167:e84263d55307 493 */
AnnaBridge 167:e84263d55307 494 void HAL_GetUID(uint32_t *UID)
AnnaBridge 167:e84263d55307 495 {
AnnaBridge 167:e84263d55307 496 UID[0] = (uint32_t)(READ_REG(*((uint32_t *)UID_BASE)));
AnnaBridge 167:e84263d55307 497 UID[1] = (uint32_t)(READ_REG(*((uint32_t *)(UID_BASE + 4U))));
AnnaBridge 167:e84263d55307 498 UID[2] = (uint32_t)(READ_REG(*((uint32_t *)(UID_BASE + 8U))));
AnnaBridge 167:e84263d55307 499 }
AnnaBridge 167:e84263d55307 500
AnnaBridge 167:e84263d55307 501 /**
<> 144:ef7eb2e8f9f7 502 * @}
<> 144:ef7eb2e8f9f7 503 */
<> 144:ef7eb2e8f9f7 504
<> 144:ef7eb2e8f9f7 505 /**
<> 144:ef7eb2e8f9f7 506 * @}
<> 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 /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/