marcus chiou / mbed-src

mbed library sources

Fork of mbed-src by mbed official

targets/cmsis/TARGET_STM/TARGET_STM32F7/stm32f7xx_hal.c@600:7d17ca308cd1, 2015-07-31 (annotated)

Committer:
mbed_official
Date:
Fri Jul 31 14:15:09 2015 +0100
Revision:
600:7d17ca308cd1
Parent:
573:ad23fe03a082
Child:
610:813dcc80987e
Synchronized with git revision e4cd8bbd3e05b68e5a7f466c74035a85743d45e0



Full URL: https://github.com/mbedmicro/mbed/commit/e4cd8bbd3e05b68e5a7f466c74035a85743d45e0/



Enable LPC8xx usart when configuring it

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