mbed official / mbed-src

mbed library sources

Dependents:   Encrypted my_mbed lklk CyaSSL_DTLS_Cellular ... more

Superseded

This library was superseded by mbed-dev - https://os.mbed.com/users/mbed_official/code/mbed-dev/.

Development branch of the mbed library sources. This library is kept in synch with the latest changes from the mbed SDK and it is not guaranteed to work.

If you are looking for a stable and tested release, please import one of the official mbed library releases:

Import librarymbed

The official Mbed 2 C/C++ SDK provides the software platform and libraries to build your applications.

Last commit 20 Feb 2019 by mbed official

targets/cmsis/TARGET_STM/TARGET_STM32F7/stm32f7xx_hal.c@610:813dcc80987e, 2015-08-14 (annotated)

Committer:
mbed_official
Date:
Fri Aug 14 13:15:17 2015 +0100
Revision:
610:813dcc80987e
Parent:
573:ad23fe03a082 
Synchronized with git revision 6d84db41c6833e0b9b024741eb0616a5f62d5599



Full URL: https://github.com/mbedmicro/mbed/commit/6d84db41c6833e0b9b024741eb0616a5f62d5599/



DISCO_F746NG - Improvements

Who changed what in which revision?

UserRevisionLine numberNew contents of line
mbed_official 573:ad23fe03a082 1 /**
mbed_official 573:ad23fe03a082 2 ******************************************************************************
mbed_official 573:ad23fe03a082 3 * @file stm32f7xx_hal.c
mbed_official 573:ad23fe03a082 4 * @author MCD Application Team
mbed_official 610:813dcc80987e 5 * @version V1.0.1
mbed_official 610:813dcc80987e 6 * @date 25-June-2015
mbed_official 573:ad23fe03a082 7 * @brief HAL module driver.
mbed_official 573:ad23fe03a082 8 * This is the common part of the HAL initialization
mbed_official 573:ad23fe03a082 9 *
mbed_official 573:ad23fe03a082 10 @verbatim
mbed_official 573:ad23fe03a082 11 ==============================================================================
mbed_official 573:ad23fe03a082 12 ##### How to use this driver #####
mbed_official 573:ad23fe03a082 13 ==============================================================================
mbed_official 573:ad23fe03a082 14 [..]
mbed_official 573:ad23fe03a082 15 The common HAL driver contains a set of generic and common APIs that can be
mbed_official 573:ad23fe03a082 16 used by the PPP peripheral drivers and the user to start using the HAL.
mbed_official 573:ad23fe03a082 17 [..]
mbed_official 573:ad23fe03a082 18 The HAL contains two APIs' categories:
mbed_official 573:ad23fe03a082 19 (+) Common HAL APIs
mbed_official 573:ad23fe03a082 20 (+) Services HAL APIs
mbed_official 573:ad23fe03a082 21
mbed_official 573:ad23fe03a082 22 @endverbatim
mbed_official 573:ad23fe03a082 23 ******************************************************************************
mbed_official 573:ad23fe03a082 24 * @attention
mbed_official 573:ad23fe03a082 25 *
mbed_official 573:ad23fe03a082 26 * <h2><center>&copy; COPYRIGHT(c) 2015 STMicroelectronics</center></h2>
mbed_official 573:ad23fe03a082 27 *
mbed_official 573:ad23fe03a082 28 * Redistribution and use in source and binary forms, with or without modification,
mbed_official 573:ad23fe03a082 29 * are permitted provided that the following conditions are met:
mbed_official 573:ad23fe03a082 30 * 1. Redistributions of source code must retain the above copyright notice,
mbed_official 573:ad23fe03a082 31 * this list of conditions and the following disclaimer.
mbed_official 573:ad23fe03a082 32 * 2. Redistributions in binary form must reproduce the above copyright notice,
mbed_official 573:ad23fe03a082 33 * this list of conditions and the following disclaimer in the documentation
mbed_official 573:ad23fe03a082 34 * and/or other materials provided with the distribution.
mbed_official 573:ad23fe03a082 35 * 3. Neither the name of STMicroelectronics nor the names of its contributors
mbed_official 573:ad23fe03a082 36 * may be used to endorse or promote products derived from this software
mbed_official 573:ad23fe03a082 37 * without specific prior written permission.
mbed_official 573:ad23fe03a082 38 *
mbed_official 573:ad23fe03a082 39 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
mbed_official 573:ad23fe03a082 40 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
mbed_official 573:ad23fe03a082 41 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
mbed_official 573:ad23fe03a082 42 * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
mbed_official 573:ad23fe03a082 43 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
mbed_official 573:ad23fe03a082 44 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
mbed_official 573:ad23fe03a082 45 * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
mbed_official 573:ad23fe03a082 46 * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
mbed_official 573:ad23fe03a082 47 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
mbed_official 573:ad23fe03a082 48 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
mbed_official 573:ad23fe03a082 49 *
mbed_official 573:ad23fe03a082 50 ******************************************************************************
mbed_official 573:ad23fe03a082 51 */
mbed_official 573:ad23fe03a082 52
mbed_official 573:ad23fe03a082 53 /* Includes ------------------------------------------------------------------*/
mbed_official 573:ad23fe03a082 54 #include "stm32f7xx_hal.h"
mbed_official 573:ad23fe03a082 55
mbed_official 573:ad23fe03a082 56 /** @addtogroup STM32F7xx_HAL_Driver
mbed_official 573:ad23fe03a082 57 * @{
mbed_official 573:ad23fe03a082 58 */
mbed_official 573:ad23fe03a082 59
mbed_official 573:ad23fe03a082 60 /** @defgroup HAL HAL
mbed_official 573:ad23fe03a082 61 * @brief HAL module driver.
mbed_official 573:ad23fe03a082 62 * @{
mbed_official 573:ad23fe03a082 63 */
mbed_official 573:ad23fe03a082 64
mbed_official 573:ad23fe03a082 65 /* Private typedef -----------------------------------------------------------*/
mbed_official 573:ad23fe03a082 66 /* Private define ------------------------------------------------------------*/
mbed_official 610:813dcc80987e 67 /** @addtogroup HAL_Private_Constants
mbed_official 610:813dcc80987e 68 * @{
mbed_official 610:813dcc80987e 69 */
mbed_official 573:ad23fe03a082 70 /**
mbed_official 610:813dcc80987e 71 * @brief STM32F7xx HAL Driver version number V1.0.1
mbed_official 573:ad23fe03a082 72 */
mbed_official 573:ad23fe03a082 73 #define __STM32F7xx_HAL_VERSION_MAIN (0x01) /*!< [31:24] main version */
mbed_official 573:ad23fe03a082 74 #define __STM32F7xx_HAL_VERSION_SUB1 (0x00) /*!< [23:16] sub1 version */
mbed_official 610:813dcc80987e 75 #define __STM32F7xx_HAL_VERSION_SUB2 (0x01) /*!< [15:8] sub2 version */
mbed_official 573:ad23fe03a082 76 #define __STM32F7xx_HAL_VERSION_RC (0x00) /*!< [7:0] release candidate */
mbed_official 573:ad23fe03a082 77 #define __STM32F7xx_HAL_VERSION ((__STM32F7xx_HAL_VERSION_MAIN << 24)\
mbed_official 573:ad23fe03a082 78 |(__STM32F7xx_HAL_VERSION_SUB1 << 16)\
mbed_official 573:ad23fe03a082 79 |(__STM32F7xx_HAL_VERSION_SUB2 << 8 )\
mbed_official 573:ad23fe03a082 80 |(__STM32F7xx_HAL_VERSION_RC))
mbed_official 573:ad23fe03a082 81
mbed_official 573:ad23fe03a082 82 #define IDCODE_DEVID_MASK ((uint32_t)0x00000FFF)
mbed_official 610:813dcc80987e 83 /**
mbed_official 610:813dcc80987e 84 * @}
mbed_official 610:813dcc80987e 85 */
mbed_official 573:ad23fe03a082 86
mbed_official 573:ad23fe03a082 87 /* Private macro -------------------------------------------------------------*/
mbed_official 573:ad23fe03a082 88 /* Private variables ---------------------------------------------------------*/
mbed_official 610:813dcc80987e 89 /** @addtogroup HAL_Private_Variables
mbed_official 610:813dcc80987e 90 * @{
mbed_official 610:813dcc80987e 91 */
mbed_official 573:ad23fe03a082 92 static __IO uint32_t uwTick;
mbed_official 610:813dcc80987e 93 /**
mbed_official 610:813dcc80987e 94 * @}
mbed_official 610:813dcc80987e 95 */
mbed_official 573:ad23fe03a082 96
mbed_official 573:ad23fe03a082 97 /* Private function prototypes -----------------------------------------------*/
mbed_official 573:ad23fe03a082 98 /* Private functions ---------------------------------------------------------*/
mbed_official 573:ad23fe03a082 99
mbed_official 610:813dcc80987e 100 /** @defgroup HAL_Exported_Functions HAL Exported Functions
mbed_official 573:ad23fe03a082 101 * @{
mbed_official 573:ad23fe03a082 102 */
mbed_official 573:ad23fe03a082 103
mbed_official 610:813dcc80987e 104 /** @defgroup HAL_Exported_Functions_Group1 Initialization and de-initialization Functions
mbed_official 573:ad23fe03a082 105 * @brief Initialization and de-initialization functions
mbed_official 573:ad23fe03a082 106 *
mbed_official 573:ad23fe03a082 107 @verbatim
mbed_official 573:ad23fe03a082 108 ===============================================================================
mbed_official 573:ad23fe03a082 109 ##### Initialization and de-initialization functions #####
mbed_official 573:ad23fe03a082 110 ===============================================================================
mbed_official 573:ad23fe03a082 111 [..] This section provides functions allowing to:
mbed_official 573:ad23fe03a082 112 (+) Initializes the Flash interface the NVIC allocation and initial clock
mbed_official 573:ad23fe03a082 113 configuration. It initializes the systick also when timeout is needed
mbed_official 573:ad23fe03a082 114 and the backup domain when enabled.
mbed_official 573:ad23fe03a082 115 (+) de-Initializes common part of the HAL
mbed_official 573:ad23fe03a082 116 (+) Configure The time base source to have 1ms time base with a dedicated
mbed_official 573:ad23fe03a082 117 Tick interrupt priority.
mbed_official 573:ad23fe03a082 118 (++) Systick timer is used by default as source of time base, but user
mbed_official 573:ad23fe03a082 119 can eventually implement his proper time base source (a general purpose
mbed_official 573:ad23fe03a082 120 timer for example or other time source), keeping in mind that Time base
mbed_official 573:ad23fe03a082 121 duration should be kept 1ms since PPP_TIMEOUT_VALUEs are defined and
mbed_official 573:ad23fe03a082 122 handled in milliseconds basis.
mbed_official 573:ad23fe03a082 123 (++) Time base configuration function (HAL_InitTick ()) is called automatically
mbed_official 573:ad23fe03a082 124 at the beginning of the program after reset by HAL_Init() or at any time
mbed_official 573:ad23fe03a082 125 when clock is configured, by HAL_RCC_ClockConfig().
mbed_official 573:ad23fe03a082 126 (++) Source of time base is configured to generate interrupts at regular
mbed_official 573:ad23fe03a082 127 time intervals. Care must be taken if HAL_Delay() is called from a
mbed_official 573:ad23fe03a082 128 peripheral ISR process, the Tick interrupt line must have higher priority
mbed_official 573:ad23fe03a082 129 (numerically lower) than the peripheral interrupt. Otherwise the caller
mbed_official 573:ad23fe03a082 130 ISR process will be blocked.
mbed_official 573:ad23fe03a082 131 (++) functions affecting time base configurations are declared as __weak
mbed_official 573:ad23fe03a082 132 to make override possible in case of other implementations in user file.
mbed_official 573:ad23fe03a082 133 @endverbatim
mbed_official 573:ad23fe03a082 134 * @{
mbed_official 573:ad23fe03a082 135 */
mbed_official 573:ad23fe03a082 136
mbed_official 573:ad23fe03a082 137 /**
mbed_official 573:ad23fe03a082 138 * @brief This function is used to initialize the HAL Library; it must be the first
mbed_official 573:ad23fe03a082 139 * instruction to be executed in the main program (before to call any other
mbed_official 573:ad23fe03a082 140 * HAL function), it performs the following:
mbed_official 573:ad23fe03a082 141 * Configure the Flash prefetch, and instruction cache through ART accelerator.
mbed_official 573:ad23fe03a082 142 * Configures the SysTick to generate an interrupt each 1 millisecond,
mbed_official 573:ad23fe03a082 143 * which is clocked by the HSI (at this stage, the clock is not yet
mbed_official 573:ad23fe03a082 144 * configured and thus the system is running from the internal HSI at 16 MHz).
mbed_official 573:ad23fe03a082 145 * Set NVIC Group Priority to 4.
mbed_official 573:ad23fe03a082 146 * Calls the HAL_MspInit() callback function defined in user file
mbed_official 573:ad23fe03a082 147 * "stm32f7xx_hal_msp.c" to do the global low level hardware initialization
mbed_official 573:ad23fe03a082 148 *
mbed_official 573:ad23fe03a082 149 * @note SysTick is used as time base for the HAL_Delay() function, the application
mbed_official 573:ad23fe03a082 150 * need to ensure that the SysTick time base is always set to 1 millisecond
mbed_official 573:ad23fe03a082 151 * to have correct HAL operation.
mbed_official 573:ad23fe03a082 152 * @retval HAL status
mbed_official 573:ad23fe03a082 153 */
mbed_official 573:ad23fe03a082 154 HAL_StatusTypeDef HAL_Init(void)
mbed_official 573:ad23fe03a082 155 {
mbed_official 573:ad23fe03a082 156 /* Configure Flash prefetch and Instruction cache through ART accelerator */
mbed_official 573:ad23fe03a082 157 #if (ART_ACCLERATOR_ENABLE != 0)
mbed_official 573:ad23fe03a082 158 __HAL_FLASH_ART_ENABLE();
mbed_official 573:ad23fe03a082 159 #endif /* ART_ACCLERATOR_ENABLE */
mbed_official 573:ad23fe03a082 160
mbed_official 573:ad23fe03a082 161 /* Set Interrupt Group Priority */
mbed_official 573:ad23fe03a082 162 HAL_NVIC_SetPriorityGrouping(NVIC_PRIORITYGROUP_4);
mbed_official 573:ad23fe03a082 163
mbed_official 573:ad23fe03a082 164 /* Use systick as time base source and configure 1ms tick (default clock after Reset is HSI) */
mbed_official 573:ad23fe03a082 165 HAL_InitTick(TICK_INT_PRIORITY);
mbed_official 573:ad23fe03a082 166
mbed_official 573:ad23fe03a082 167 /* Init the low level hardware */
mbed_official 573:ad23fe03a082 168 HAL_MspInit();
mbed_official 573:ad23fe03a082 169
mbed_official 573:ad23fe03a082 170 /* Return function status */
mbed_official 573:ad23fe03a082 171 return HAL_OK;
mbed_official 573:ad23fe03a082 172 }
mbed_official 573:ad23fe03a082 173
mbed_official 573:ad23fe03a082 174 /**
mbed_official 573:ad23fe03a082 175 * @brief This function de-Initializes common part of the HAL and stops the systick.
mbed_official 573:ad23fe03a082 176 * This function is optional.
mbed_official 573:ad23fe03a082 177 * @retval HAL status
mbed_official 573:ad23fe03a082 178 */
mbed_official 573:ad23fe03a082 179 HAL_StatusTypeDef HAL_DeInit(void)
mbed_official 573:ad23fe03a082 180 {
mbed_official 573:ad23fe03a082 181 /* Reset of all peripherals */
mbed_official 573:ad23fe03a082 182 __HAL_RCC_APB1_FORCE_RESET();
mbed_official 573:ad23fe03a082 183 __HAL_RCC_APB1_RELEASE_RESET();
mbed_official 573:ad23fe03a082 184
mbed_official 573:ad23fe03a082 185 __HAL_RCC_APB2_FORCE_RESET();
mbed_official 573:ad23fe03a082 186 __HAL_RCC_APB2_RELEASE_RESET();
mbed_official 573:ad23fe03a082 187
mbed_official 573:ad23fe03a082 188 __HAL_RCC_AHB1_FORCE_RESET();
mbed_official 573:ad23fe03a082 189 __HAL_RCC_AHB1_RELEASE_RESET();
mbed_official 573:ad23fe03a082 190
mbed_official 573:ad23fe03a082 191 __HAL_RCC_AHB2_FORCE_RESET();
mbed_official 573:ad23fe03a082 192 __HAL_RCC_AHB2_RELEASE_RESET();
mbed_official 573:ad23fe03a082 193
mbed_official 573:ad23fe03a082 194 __HAL_RCC_AHB3_FORCE_RESET();
mbed_official 573:ad23fe03a082 195 __HAL_RCC_AHB3_RELEASE_RESET();
mbed_official 573:ad23fe03a082 196
mbed_official 573:ad23fe03a082 197 /* De-Init the low level hardware */
mbed_official 573:ad23fe03a082 198 HAL_MspDeInit();
mbed_official 573:ad23fe03a082 199
mbed_official 573:ad23fe03a082 200 /* Return function status */
mbed_official 573:ad23fe03a082 201 return HAL_OK;
mbed_official 573:ad23fe03a082 202 }
mbed_official 573:ad23fe03a082 203
mbed_official 573:ad23fe03a082 204 /**
mbed_official 573:ad23fe03a082 205 * @brief Initializes the MSP.
mbed_official 573:ad23fe03a082 206 * @retval None
mbed_official 573:ad23fe03a082 207 */
mbed_official 573:ad23fe03a082 208 __weak void HAL_MspInit(void)
mbed_official 573:ad23fe03a082 209 {
mbed_official 573:ad23fe03a082 210 /* NOTE : This function Should not be modified, when the callback is needed,
mbed_official 573:ad23fe03a082 211 the HAL_MspInit could be implemented in the user file
mbed_official 573:ad23fe03a082 212 */
mbed_official 573:ad23fe03a082 213 }
mbed_official 573:ad23fe03a082 214
mbed_official 573:ad23fe03a082 215 /**
mbed_official 573:ad23fe03a082 216 * @brief DeInitializes the MSP.
mbed_official 573:ad23fe03a082 217 * @retval None
mbed_official 573:ad23fe03a082 218 */
mbed_official 573:ad23fe03a082 219 __weak void HAL_MspDeInit(void)
mbed_official 573:ad23fe03a082 220 {
mbed_official 573:ad23fe03a082 221 /* NOTE : This function Should not be modified, when the callback is needed,
mbed_official 573:ad23fe03a082 222 the HAL_MspDeInit could be implemented in the user file
mbed_official 573:ad23fe03a082 223 */
mbed_official 573:ad23fe03a082 224 }
mbed_official 573:ad23fe03a082 225
mbed_official 573:ad23fe03a082 226 /**
mbed_official 573:ad23fe03a082 227 * @brief This function configures the source of the time base.
mbed_official 573:ad23fe03a082 228 * The time source is configured to have 1ms time base with a dedicated
mbed_official 573:ad23fe03a082 229 * Tick interrupt priority.
mbed_official 573:ad23fe03a082 230 * @note This function is called automatically at the beginning of program after
mbed_official 573:ad23fe03a082 231 * reset by HAL_Init() or at any time when clock is reconfigured by HAL_RCC_ClockConfig().
mbed_official 573:ad23fe03a082 232 * @note In the default implementation, SysTick timer is the source of time base.
mbed_official 573:ad23fe03a082 233 * It is used to generate interrupts at regular time intervals.
mbed_official 573:ad23fe03a082 234 * Care must be taken if HAL_Delay() is called from a peripheral ISR process,
mbed_official 573:ad23fe03a082 235 * The the SysTick interrupt must have higher priority (numerically lower)
mbed_official 573:ad23fe03a082 236 * than the peripheral interrupt. Otherwise the caller ISR process will be blocked.
mbed_official 573:ad23fe03a082 237 * The function is declared as __weak to be overwritten in case of other
mbed_official 573:ad23fe03a082 238 * implementation in user file.
mbed_official 573:ad23fe03a082 239 * @param TickPriority: Tick interrupt priority.
mbed_official 573:ad23fe03a082 240 * @retval HAL status
mbed_official 573:ad23fe03a082 241 */
mbed_official 573:ad23fe03a082 242 __weak HAL_StatusTypeDef HAL_InitTick(uint32_t TickPriority)
mbed_official 573:ad23fe03a082 243 {
mbed_official 573:ad23fe03a082 244 /*Configure the SysTick to have interrupt in 1ms time basis*/
mbed_official 573:ad23fe03a082 245 HAL_SYSTICK_Config(HAL_RCC_GetHCLKFreq()/1000);
mbed_official 573:ad23fe03a082 246
mbed_official 573:ad23fe03a082 247 /*Configure the SysTick IRQ priority */
mbed_official 573:ad23fe03a082 248 HAL_NVIC_SetPriority(SysTick_IRQn, TickPriority ,0);
mbed_official 573:ad23fe03a082 249
mbed_official 573:ad23fe03a082 250 /* Return function status */
mbed_official 573:ad23fe03a082 251 return HAL_OK;
mbed_official 573:ad23fe03a082 252 }
mbed_official 573:ad23fe03a082 253
mbed_official 573:ad23fe03a082 254 /**
mbed_official 573:ad23fe03a082 255 * @}
mbed_official 573:ad23fe03a082 256 */
mbed_official 573:ad23fe03a082 257
mbed_official 610:813dcc80987e 258 /** @defgroup HAL_Exported_Functions_Group2 HAL Control functions
mbed_official 573:ad23fe03a082 259 * @brief HAL Control functions
mbed_official 573:ad23fe03a082 260 *
mbed_official 573:ad23fe03a082 261 @verbatim
mbed_official 573:ad23fe03a082 262 ===============================================================================
mbed_official 573:ad23fe03a082 263 ##### HAL Control functions #####
mbed_official 573:ad23fe03a082 264 ===============================================================================
mbed_official 573:ad23fe03a082 265 [..] This section provides functions allowing to:
mbed_official 573:ad23fe03a082 266 (+) Provide a tick value in millisecond
mbed_official 573:ad23fe03a082 267 (+) Provide a blocking delay in millisecond
mbed_official 573:ad23fe03a082 268 (+) Suspend the time base source interrupt
mbed_official 573:ad23fe03a082 269 (+) Resume the time base source interrupt
mbed_official 573:ad23fe03a082 270 (+) Get the HAL API driver version
mbed_official 573:ad23fe03a082 271 (+) Get the device identifier
mbed_official 573:ad23fe03a082 272 (+) Get the device revision identifier
mbed_official 573:ad23fe03a082 273 (+) Enable/Disable Debug module during SLEEP mode
mbed_official 573:ad23fe03a082 274 (+) Enable/Disable Debug module during STOP mode
mbed_official 573:ad23fe03a082 275 (+) Enable/Disable Debug module during STANDBY mode
mbed_official 573:ad23fe03a082 276
mbed_official 573:ad23fe03a082 277 @endverbatim
mbed_official 573:ad23fe03a082 278 * @{
mbed_official 573:ad23fe03a082 279 */
mbed_official 573:ad23fe03a082 280
mbed_official 573:ad23fe03a082 281 /**
mbed_official 573:ad23fe03a082 282 * @brief This function is called to increment a global variable "uwTick"
mbed_official 573:ad23fe03a082 283 * used as application time base.
mbed_official 573:ad23fe03a082 284 * @note In the default implementation, this variable is incremented each 1ms
mbed_official 573:ad23fe03a082 285 * in Systick ISR.
mbed_official 573:ad23fe03a082 286 * @note This function is declared as __weak to be overwritten in case of other
mbed_official 573:ad23fe03a082 287 * implementations in user file.
mbed_official 573:ad23fe03a082 288 * @retval None
mbed_official 573:ad23fe03a082 289 */
mbed_official 573:ad23fe03a082 290 __weak void HAL_IncTick(void)
mbed_official 573:ad23fe03a082 291 {
mbed_official 573:ad23fe03a082 292 uwTick++;
mbed_official 573:ad23fe03a082 293 }
mbed_official 573:ad23fe03a082 294
mbed_official 573:ad23fe03a082 295 /**
mbed_official 573:ad23fe03a082 296 * @brief Provides a tick value in millisecond.
mbed_official 573:ad23fe03a082 297 * @note This function is declared as __weak to be overwritten in case of other
mbed_official 573:ad23fe03a082 298 * implementations in user file.
mbed_official 573:ad23fe03a082 299 * @retval tick value
mbed_official 573:ad23fe03a082 300 */
mbed_official 573:ad23fe03a082 301 __weak uint32_t HAL_GetTick(void)
mbed_official 573:ad23fe03a082 302 {
mbed_official 573:ad23fe03a082 303 return uwTick;
mbed_official 573:ad23fe03a082 304 }
mbed_official 573:ad23fe03a082 305
mbed_official 573:ad23fe03a082 306 /**
mbed_official 573:ad23fe03a082 307 * @brief This function provides accurate delay (in milliseconds) based
mbed_official 573:ad23fe03a082 308 * on variable incremented.
mbed_official 573:ad23fe03a082 309 * @note In the default implementation , SysTick timer is the source of time base.
mbed_official 573:ad23fe03a082 310 * It is used to generate interrupts at regular time intervals where uwTick
mbed_official 573:ad23fe03a082 311 * is incremented.
mbed_official 573:ad23fe03a082 312 * @note ThiS function is declared as __weak to be overwritten in case of other
mbed_official 573:ad23fe03a082 313 * implementations in user file.
mbed_official 573:ad23fe03a082 314 * @param Delay: specifies the delay time length, in milliseconds.
mbed_official 573:ad23fe03a082 315 * @retval None
mbed_official 573:ad23fe03a082 316 */
mbed_official 573:ad23fe03a082 317 __weak void HAL_Delay(__IO uint32_t Delay)
mbed_official 573:ad23fe03a082 318 {
mbed_official 573:ad23fe03a082 319 uint32_t tickstart = 0;
mbed_official 573:ad23fe03a082 320 tickstart = HAL_GetTick();
mbed_official 573:ad23fe03a082 321 while((HAL_GetTick() - tickstart) < Delay)
mbed_official 573:ad23fe03a082 322 {
mbed_official 573:ad23fe03a082 323 }
mbed_official 573:ad23fe03a082 324 }
mbed_official 573:ad23fe03a082 325
mbed_official 573:ad23fe03a082 326 /**
mbed_official 573:ad23fe03a082 327 * @brief Suspend Tick increment.
mbed_official 573:ad23fe03a082 328 * @note In the default implementation , SysTick timer is the source of time base. It is
mbed_official 573:ad23fe03a082 329 * used to generate interrupts at regular time intervals. Once HAL_SuspendTick()
mbed_official 573:ad23fe03a082 330 * is called, the the SysTick interrupt will be disabled and so Tick increment
mbed_official 573:ad23fe03a082 331 * is suspended.
mbed_official 573:ad23fe03a082 332 * @note This function is declared as __weak to be overwritten in case of other
mbed_official 573:ad23fe03a082 333 * implementations in user file.
mbed_official 573:ad23fe03a082 334 * @retval None
mbed_official 573:ad23fe03a082 335 */
mbed_official 573:ad23fe03a082 336 __weak void HAL_SuspendTick(void)
mbed_official 573:ad23fe03a082 337 {
mbed_official 573:ad23fe03a082 338 /* Disable SysTick Interrupt */
mbed_official 573:ad23fe03a082 339 SysTick->CTRL &= ~SysTick_CTRL_TICKINT_Msk;
mbed_official 573:ad23fe03a082 340 }
mbed_official 573:ad23fe03a082 341
mbed_official 573:ad23fe03a082 342 /**
mbed_official 573:ad23fe03a082 343 * @brief Resume Tick increment.
mbed_official 573:ad23fe03a082 344 * @note In the default implementation , SysTick timer is the source of time base. It is
mbed_official 573:ad23fe03a082 345 * used to generate interrupts at regular time intervals. Once HAL_ResumeTick()
mbed_official 573:ad23fe03a082 346 * is called, the the SysTick interrupt will be enabled and so Tick increment
mbed_official 573:ad23fe03a082 347 * is resumed.
mbed_official 573:ad23fe03a082 348 * @note This function is declared as __weak to be overwritten in case of other
mbed_official 573:ad23fe03a082 349 * implementations in user file.
mbed_official 573:ad23fe03a082 350 * @retval None
mbed_official 573:ad23fe03a082 351 */
mbed_official 573:ad23fe03a082 352 __weak void HAL_ResumeTick(void)
mbed_official 573:ad23fe03a082 353 {
mbed_official 573:ad23fe03a082 354 /* Enable SysTick Interrupt */
mbed_official 573:ad23fe03a082 355 SysTick->CTRL |= SysTick_CTRL_TICKINT_Msk;
mbed_official 573:ad23fe03a082 356 }
mbed_official 573:ad23fe03a082 357
mbed_official 573:ad23fe03a082 358 /**
mbed_official 573:ad23fe03a082 359 * @brief Returns the HAL revision
mbed_official 573:ad23fe03a082 360 * @retval version : 0xXYZR (8bits for each decimal, R for RC)
mbed_official 573:ad23fe03a082 361 */
mbed_official 573:ad23fe03a082 362 uint32_t HAL_GetHalVersion(void)
mbed_official 573:ad23fe03a082 363 {
mbed_official 573:ad23fe03a082 364 return __STM32F7xx_HAL_VERSION;
mbed_official 573:ad23fe03a082 365 }
mbed_official 573:ad23fe03a082 366
mbed_official 573:ad23fe03a082 367 /**
mbed_official 573:ad23fe03a082 368 * @brief Returns the device revision identifier.
mbed_official 573:ad23fe03a082 369 * @retval Device revision identifier
mbed_official 573:ad23fe03a082 370 */
mbed_official 573:ad23fe03a082 371 uint32_t HAL_GetREVID(void)
mbed_official 573:ad23fe03a082 372 {
mbed_official 573:ad23fe03a082 373 return((DBGMCU->IDCODE) >> 16);
mbed_official 573:ad23fe03a082 374 }
mbed_official 573:ad23fe03a082 375
mbed_official 573:ad23fe03a082 376 /**
mbed_official 573:ad23fe03a082 377 * @brief Returns the device identifier.
mbed_official 573:ad23fe03a082 378 * @retval Device identifier
mbed_official 573:ad23fe03a082 379 */
mbed_official 573:ad23fe03a082 380 uint32_t HAL_GetDEVID(void)
mbed_official 573:ad23fe03a082 381 {
mbed_official 573:ad23fe03a082 382 return((DBGMCU->IDCODE) & IDCODE_DEVID_MASK);
mbed_official 573:ad23fe03a082 383 }
mbed_official 573:ad23fe03a082 384
mbed_official 573:ad23fe03a082 385 /**
mbed_official 573:ad23fe03a082 386 * @brief Enable the Debug Module during SLEEP mode
mbed_official 573:ad23fe03a082 387 * @retval None
mbed_official 573:ad23fe03a082 388 */
mbed_official 573:ad23fe03a082 389 void HAL_DBGMCU_EnableDBGSleepMode(void)
mbed_official 573:ad23fe03a082 390 {
mbed_official 573:ad23fe03a082 391 SET_BIT(DBGMCU->CR, DBGMCU_CR_DBG_SLEEP);
mbed_official 573:ad23fe03a082 392 }
mbed_official 573:ad23fe03a082 393
mbed_official 573:ad23fe03a082 394 /**
mbed_official 573:ad23fe03a082 395 * @brief Disable the Debug Module during SLEEP mode
mbed_official 573:ad23fe03a082 396 * @retval None
mbed_official 573:ad23fe03a082 397 */
mbed_official 573:ad23fe03a082 398 void HAL_DBGMCU_DisableDBGSleepMode(void)
mbed_official 573:ad23fe03a082 399 {
mbed_official 573:ad23fe03a082 400 CLEAR_BIT(DBGMCU->CR, DBGMCU_CR_DBG_SLEEP);
mbed_official 573:ad23fe03a082 401 }
mbed_official 573:ad23fe03a082 402
mbed_official 573:ad23fe03a082 403 /**
mbed_official 573:ad23fe03a082 404 * @brief Enable the Debug Module during STOP mode
mbed_official 573:ad23fe03a082 405 * @retval None
mbed_official 573:ad23fe03a082 406 */
mbed_official 573:ad23fe03a082 407 void HAL_DBGMCU_EnableDBGStopMode(void)
mbed_official 573:ad23fe03a082 408 {
mbed_official 573:ad23fe03a082 409 SET_BIT(DBGMCU->CR, DBGMCU_CR_DBG_STOP);
mbed_official 573:ad23fe03a082 410 }
mbed_official 573:ad23fe03a082 411
mbed_official 573:ad23fe03a082 412 /**
mbed_official 573:ad23fe03a082 413 * @brief Disable the Debug Module during STOP mode
mbed_official 573:ad23fe03a082 414 * @retval None
mbed_official 573:ad23fe03a082 415 */
mbed_official 573:ad23fe03a082 416 void HAL_DBGMCU_DisableDBGStopMode(void)
mbed_official 573:ad23fe03a082 417 {
mbed_official 573:ad23fe03a082 418 CLEAR_BIT(DBGMCU->CR, DBGMCU_CR_DBG_STOP);
mbed_official 573:ad23fe03a082 419 }
mbed_official 573:ad23fe03a082 420
mbed_official 573:ad23fe03a082 421 /**
mbed_official 573:ad23fe03a082 422 * @brief Enable the Debug Module during STANDBY mode
mbed_official 573:ad23fe03a082 423 * @retval None
mbed_official 573:ad23fe03a082 424 */
mbed_official 573:ad23fe03a082 425 void HAL_DBGMCU_EnableDBGStandbyMode(void)
mbed_official 573:ad23fe03a082 426 {
mbed_official 573:ad23fe03a082 427 SET_BIT(DBGMCU->CR, DBGMCU_CR_DBG_STANDBY);
mbed_official 573:ad23fe03a082 428 }
mbed_official 573:ad23fe03a082 429
mbed_official 573:ad23fe03a082 430 /**
mbed_official 573:ad23fe03a082 431 * @brief Disable the Debug Module during STANDBY mode
mbed_official 573:ad23fe03a082 432 * @retval None
mbed_official 573:ad23fe03a082 433 */
mbed_official 573:ad23fe03a082 434 void HAL_DBGMCU_DisableDBGStandbyMode(void)
mbed_official 573:ad23fe03a082 435 {
mbed_official 573:ad23fe03a082 436 CLEAR_BIT(DBGMCU->CR, DBGMCU_CR_DBG_STANDBY);
mbed_official 573:ad23fe03a082 437 }
mbed_official 573:ad23fe03a082 438
mbed_official 573:ad23fe03a082 439 /**
mbed_official 573:ad23fe03a082 440 * @brief Enables the I/O Compensation Cell.
mbed_official 573:ad23fe03a082 441 * @note The I/O compensation cell can be used only when the device supply
mbed_official 573:ad23fe03a082 442 * voltage ranges from 2.4 to 3.6 V.
mbed_official 573:ad23fe03a082 443 * @retval None
mbed_official 573:ad23fe03a082 444 */
mbed_official 573:ad23fe03a082 445 void HAL_EnableCompensationCell(void)
mbed_official 573:ad23fe03a082 446 {
mbed_official 573:ad23fe03a082 447 SYSCFG->CMPCR |= SYSCFG_CMPCR_CMP_PD;
mbed_official 573:ad23fe03a082 448 }
mbed_official 573:ad23fe03a082 449
mbed_official 573:ad23fe03a082 450 /**
mbed_official 573:ad23fe03a082 451 * @brief Power-down the I/O Compensation Cell.
mbed_official 573:ad23fe03a082 452 * @note The I/O compensation cell can be used only when the device supply
mbed_official 573:ad23fe03a082 453 * voltage ranges from 2.4 to 3.6 V.
mbed_official 573:ad23fe03a082 454 * @retval None
mbed_official 573:ad23fe03a082 455 */
mbed_official 573:ad23fe03a082 456 void HAL_DisableCompensationCell(void)
mbed_official 573:ad23fe03a082 457 {
mbed_official 573:ad23fe03a082 458 SYSCFG->CMPCR &= (uint32_t)~((uint32_t)SYSCFG_CMPCR_CMP_PD);
mbed_official 573:ad23fe03a082 459 }
mbed_official 573:ad23fe03a082 460
mbed_official 573:ad23fe03a082 461 /**
mbed_official 573:ad23fe03a082 462 * @brief Enables the FMC Memory Mapping Swapping.
mbed_official 573:ad23fe03a082 463 *
mbed_official 573:ad23fe03a082 464 * @note SDRAM is accessible at 0x60000000
mbed_official 573:ad23fe03a082 465 * and NOR/RAM is accessible at 0xC0000000
mbed_official 573:ad23fe03a082 466 *
mbed_official 573:ad23fe03a082 467 * @retval None
mbed_official 573:ad23fe03a082 468 */
mbed_official 573:ad23fe03a082 469 void HAL_EnableFMCMemorySwapping(void)
mbed_official 573:ad23fe03a082 470 {
mbed_official 573:ad23fe03a082 471 SYSCFG->MEMRMP |= SYSCFG_MEMRMP_SWP_FMC_0;
mbed_official 573:ad23fe03a082 472 }
mbed_official 573:ad23fe03a082 473
mbed_official 573:ad23fe03a082 474 /**
mbed_official 573:ad23fe03a082 475 * @brief Disables the FMC Memory Mapping Swapping
mbed_official 573:ad23fe03a082 476 *
mbed_official 573:ad23fe03a082 477 * @note SDRAM is accessible at 0xC0000000 (default mapping)
mbed_official 573:ad23fe03a082 478 * and NOR/RAM is accessible at 0x60000000 (default mapping)
mbed_official 573:ad23fe03a082 479 *
mbed_official 573:ad23fe03a082 480 * @retval None
mbed_official 573:ad23fe03a082 481 */
mbed_official 573:ad23fe03a082 482 void HAL_DisableFMCMemorySwapping(void)
mbed_official 573:ad23fe03a082 483 {
mbed_official 573:ad23fe03a082 484
mbed_official 573:ad23fe03a082 485 SYSCFG->MEMRMP &= (uint32_t)~((uint32_t)SYSCFG_MEMRMP_SWP_FMC);
mbed_official 573:ad23fe03a082 486 }
mbed_official 573:ad23fe03a082 487
mbed_official 573:ad23fe03a082 488 /**
mbed_official 573:ad23fe03a082 489 * @}
mbed_official 573:ad23fe03a082 490 */
mbed_official 573:ad23fe03a082 491
mbed_official 573:ad23fe03a082 492 /**
mbed_official 573:ad23fe03a082 493 * @}
mbed_official 573:ad23fe03a082 494 */
mbed_official 573:ad23fe03a082 495
mbed_official 573:ad23fe03a082 496 /**
mbed_official 573:ad23fe03a082 497 * @}
mbed_official 573:ad23fe03a082 498 */
mbed_official 573:ad23fe03a082 499
mbed_official 573:ad23fe03a082 500 /**
mbed_official 573:ad23fe03a082 501 * @}
mbed_official 573:ad23fe03a082 502 */
mbed_official 573:ad23fe03a082 503
mbed_official 573:ad23fe03a082 504 /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/