ostc4: Common/Drivers/STM32F4xx_HAL_Driver/Src/stm32f4xx

annotate Common/Drivers/STM32F4xx_HAL_Driver/Src/stm32f4xx_hal.c @ 442:adb18fe92737 minor_improvments

Introduced enum for lower left corner view selection: Enums allow changes in view configuration without danger of index inconsistencies

author	ideenmodellierer
date	Sat, 29 Feb 2020 22:25:20 +0100
parents	c78bcbd5deda
children

rev	line source
128 c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	1 /**
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	2 ******************************************************************************
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	3 * @file stm32f4xx_hal.c
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	4 * @author MCD Application Team
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	5 * @brief HAL module driver.
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	6 * This is the common part of the HAL initialization
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	7 *
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	8 @verbatim
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	9 ==============================================================================
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	10 ##### How to use this driver #####
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	11 ==============================================================================
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	12 [..]
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	13 The common HAL driver contains a set of generic and common APIs that can be
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	14 used by the PPP peripheral drivers and the user to start using the HAL.
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	15 [..]
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	16 The HAL contains two APIs' categories:
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	17 (+) Common HAL APIs
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	18 (+) Services HAL APIs
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	19
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	20 @endverbatim
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	21 ******************************************************************************
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	22 * @attention
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	23 *
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	24 * <h2><center>© COPYRIGHT(c) 2017 STMicroelectronics</center></h2>
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	25 *
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	26 * Redistribution and use in source and binary forms, with or without modification,
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	27 * are permitted provided that the following conditions are met:
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	28 * 1. Redistributions of source code must retain the above copyright notice,
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	29 * this list of conditions and the following disclaimer.
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	30 * 2. Redistributions in binary form must reproduce the above copyright notice,
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	31 * this list of conditions and the following disclaimer in the documentation
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	32 * and/or other materials provided with the distribution.
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	33 * 3. Neither the name of STMicroelectronics nor the names of its contributors
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	34 * may be used to endorse or promote products derived from this software
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	35 * without specific prior written permission.
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	36 *
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	37 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	38 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	39 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	40 * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	41 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	42 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	43 * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	44 * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	45 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	46 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	47 *
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	48 ******************************************************************************
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	49 */
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	50
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	51 /* Includes ------------------------------------------------------------------*/
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	52 #include "stm32f4xx_hal.h"
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	53
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	54 /** @addtogroup STM32F4xx_HAL_Driver
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	55 * @{
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	56 */
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	57
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	58 /** @defgroup HAL HAL
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	59 * @brief HAL module driver.
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	60 * @{
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	61 */
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	62
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	63 /* Private typedef -----------------------------------------------------------*/
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	64 /* Private define ------------------------------------------------------------*/
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	65 /** @addtogroup HAL_Private_Constants
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	66 * @{
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	67 */
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	68 /**
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	69 * @brief STM32F4xx HAL Driver version number V1.7.4
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	70 */
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	71 #define __STM32F4xx_HAL_VERSION_MAIN (0x01U) /!< [31:24] main version /
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	72 #define __STM32F4xx_HAL_VERSION_SUB1 (0x07U) /!< [23:16] sub1 version /
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	73 #define __STM32F4xx_HAL_VERSION_SUB2 (0x04U) /!< [15:8] sub2 version /
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	74 #define __STM32F4xx_HAL_VERSION_RC (0x00U) /!< [7:0] release candidate /
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	75 #define __STM32F4xx_HAL_VERSION ((__STM32F4xx_HAL_VERSION_MAIN << 24U)\
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	76 \|(__STM32F4xx_HAL_VERSION_SUB1 << 16U)\
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	77 \|(__STM32F4xx_HAL_VERSION_SUB2 << 8U )\
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	78 \|(__STM32F4xx_HAL_VERSION_RC))
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	79
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	80 #define IDCODE_DEVID_MASK 0x00000FFFU
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	81
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	82 /* ------------ RCC registers bit address in the alias region ----------- */
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	83 #define SYSCFG_OFFSET (SYSCFG_BASE - PERIPH_BASE)
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	84 /* --- MEMRMP Register ---*/
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	85 /* Alias word address of UFB_MODE bit */
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	86 #define MEMRMP_OFFSET SYSCFG_OFFSET
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	87 #define UFB_MODE_BIT_NUMBER SYSCFG_MEMRMP_UFB_MODE_Pos
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	88 #define UFB_MODE_BB (uint32_t)(PERIPH_BB_BASE + (MEMRMP_OFFSET * 32U) + (UFB_MODE_BIT_NUMBER * 4U))
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	89
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	90 /* --- CMPCR Register ---*/
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	91 /* Alias word address of CMP_PD bit */
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	92 #define CMPCR_OFFSET (SYSCFG_OFFSET + 0x20U)
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	93 #define CMP_PD_BIT_NUMBER SYSCFG_CMPCR_CMP_PD_Pos
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	94 #define CMPCR_CMP_PD_BB (uint32_t)(PERIPH_BB_BASE + (CMPCR_OFFSET * 32U) + (CMP_PD_BIT_NUMBER * 4U))
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	95
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	96 /* --- MCHDLYCR Register ---*/
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	97 /* Alias word address of BSCKSEL bit */
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	98 #define MCHDLYCR_OFFSET (SYSCFG_OFFSET + 0x30U)
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	99 #define BSCKSEL_BIT_NUMBER SYSCFG_MCHDLYCR_BSCKSEL_Pos
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	100 #define MCHDLYCR_BSCKSEL_BB (uint32_t)(PERIPH_BB_BASE + (MCHDLYCR_OFFSET * 32U) + (BSCKSEL_BIT_NUMBER * 4U))
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	101 /**
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	102 * @}
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	103 */
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	104
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	105 /* Private macro -------------------------------------------------------------*/
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	106 /* Private variables ---------------------------------------------------------*/
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	107 /** @addtogroup HAL_Private_Variables
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	108 * @{
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	109 */
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	110 __IO uint32_t uwTick;
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	111 uint32_t uwTickPrio = (1UL << __NVIC_PRIO_BITS); /* Invalid PRIO */
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	112 HAL_TickFreqTypeDef uwTickFreq = HAL_TICK_FREQ_DEFAULT; /* 1KHz */
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	113 /**
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	114 * @}
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	115 */
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	116 /* Private function prototypes -----------------------------------------------*/
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	117 /* Private functions ---------------------------------------------------------*/
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	118
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	119 /** @defgroup HAL_Exported_Functions HAL Exported Functions
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	120 * @{
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	121 */
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	122
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	123 /** @defgroup HAL_Exported_Functions_Group1 Initialization and de-initialization Functions
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	124 * @brief Initialization and de-initialization functions
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	125 *
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	126 @verbatim
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	127 ===============================================================================
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	128 ##### Initialization and Configuration functions #####
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	129 ===============================================================================
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	130 [..] This section provides functions allowing to:
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	131 (+) Initializes the Flash interface the NVIC allocation and initial clock
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	132 configuration. It initializes the systick also when timeout is needed
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	133 and the backup domain when enabled.
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	134 (+) De-Initializes common part of the HAL.
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	135 (+) Configure the time base source to have 1ms time base with a dedicated
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	136 Tick interrupt priority.
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	137 (++) SysTick timer is used by default as source of time base, but user
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	138 can eventually implement his proper time base source (a general purpose
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	139 timer for example or other time source), keeping in mind that Time base
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	140 duration should be kept 1ms since PPP_TIMEOUT_VALUEs are defined and
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	141 handled in milliseconds basis.
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	142 (++) Time base configuration function (HAL_InitTick ()) is called automatically
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	143 at the beginning of the program after reset by HAL_Init() or at any time
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	144 when clock is configured, by HAL_RCC_ClockConfig().
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	145 (++) Source of time base is configured to generate interrupts at regular
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	146 time intervals. Care must be taken if HAL_Delay() is called from a
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	147 peripheral ISR process, the Tick interrupt line must have higher priority
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	148 (numerically lower) than the peripheral interrupt. Otherwise the caller
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	149 ISR process will be blocked.
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	150 (++) functions affecting time base configurations are declared as __weak
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	151 to make override possible in case of other implementations in user file.
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	152 @endverbatim
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	153 * @{
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	154 */
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	155
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	156 /**
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	157 * @brief This function is used to initialize the HAL Library; it must be the first
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	158 * instruction to be executed in the main program (before to call any other
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	159 * HAL function), it performs the following:
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	160 * Configure the Flash prefetch, instruction and Data caches.
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	161 * Configures the SysTick to generate an interrupt each 1 millisecond,
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	162 * which is clocked by the HSI (at this stage, the clock is not yet
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	163 * configured and thus the system is running from the internal HSI at 16 MHz).
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	164 * Set NVIC Group Priority to 4.
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	165 * Calls the HAL_MspInit() callback function defined in user file
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	166 * "stm32f4xx_hal_msp.c" to do the global low level hardware initialization
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	167 *
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	168 * @note SysTick is used as time base for the HAL_Delay() function, the application
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	169 * need to ensure that the SysTick time base is always set to 1 millisecond
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	170 * to have correct HAL operation.
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	171 * @retval HAL status
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	172 */
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	173 HAL_StatusTypeDef HAL_Init(void)
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	174 {
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	175 /* Configure Flash prefetch, Instruction cache, Data cache */
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	176 #if (INSTRUCTION_CACHE_ENABLE != 0U)
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	177 __HAL_FLASH_INSTRUCTION_CACHE_ENABLE();
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	178 #endif /* INSTRUCTION_CACHE_ENABLE */
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	179
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	180 #if (DATA_CACHE_ENABLE != 0U)
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	181 __HAL_FLASH_DATA_CACHE_ENABLE();
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	182 #endif /* DATA_CACHE_ENABLE */
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	183
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	184 #if (PREFETCH_ENABLE != 0U)
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	185 __HAL_FLASH_PREFETCH_BUFFER_ENABLE();
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	186 #endif /* PREFETCH_ENABLE */
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	187
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	188 /* Set Interrupt Group Priority */
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	189 HAL_NVIC_SetPriorityGrouping(NVIC_PRIORITYGROUP_4);
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	190
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	191 /* Use systick as time base source and configure 1ms tick (default clock after Reset is HSI) */
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	192 HAL_InitTick(TICK_INT_PRIORITY);
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	193
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	194 /* Init the low level hardware */
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	195 HAL_MspInit();
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	196
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	197 /* Return function status */
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	198 return HAL_OK;
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	199 }
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	200
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	201 /**
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	202 * @brief This function de-Initializes common part of the HAL and stops the systick.
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	203 * This function is optional.
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	204 * @retval HAL status
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	205 */
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	206 HAL_StatusTypeDef HAL_DeInit(void)
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	207 {
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	208 /* Reset of all peripherals */
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	209 __HAL_RCC_APB1_FORCE_RESET();
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	210 __HAL_RCC_APB1_RELEASE_RESET();
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	211
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	212 __HAL_RCC_APB2_FORCE_RESET();
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	213 __HAL_RCC_APB2_RELEASE_RESET();
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	214
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	215 __HAL_RCC_AHB1_FORCE_RESET();
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	216 __HAL_RCC_AHB1_RELEASE_RESET();
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	217
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	218 __HAL_RCC_AHB2_FORCE_RESET();
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	219 __HAL_RCC_AHB2_RELEASE_RESET();
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	220
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	221 __HAL_RCC_AHB3_FORCE_RESET();
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	222 __HAL_RCC_AHB3_RELEASE_RESET();
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	223
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	224 /* De-Init the low level hardware */
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	225 HAL_MspDeInit();
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	226
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	227 /* Return function status */
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	228 return HAL_OK;
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	229 }
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	230
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	231 /**
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	232 * @brief Initialize the MSP.
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	233 * @retval None
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	234 */
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	235 __weak void HAL_MspInit(void)
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	236 {
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	237 /* NOTE : This function should not be modified, when the callback is needed,
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	238 the HAL_MspInit could be implemented in the user file
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	239 */
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	240 }
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	241
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	242 /**
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	243 * @brief DeInitializes the MSP.
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	244 * @retval None
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	245 */
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	246 __weak void HAL_MspDeInit(void)
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	247 {
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	248 /* NOTE : This function should not be modified, when the callback is needed,
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	249 the HAL_MspDeInit could be implemented in the user file
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	250 */
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	251 }
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	252
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	253 /**
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	254 * @brief This function configures the source of the time base.
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	255 * The time source is configured to have 1ms time base with a dedicated
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	256 * Tick interrupt priority.
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	257 * @note This function is called automatically at the beginning of program after
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	258 * reset by HAL_Init() or at any time when clock is reconfigured by HAL_RCC_ClockConfig().
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	259 * @note In the default implementation, SysTick timer is the source of time base.
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	260 * It is used to generate interrupts at regular time intervals.
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	261 * Care must be taken if HAL_Delay() is called from a peripheral ISR process,
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	262 * The SysTick interrupt must have higher priority (numerically lower)
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	263 * than the peripheral interrupt. Otherwise the caller ISR process will be blocked.
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	264 * The function is declared as __weak to be overwritten in case of other
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	265 * implementation in user file.
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	266 * @param TickPriority Tick interrupt priority.
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	267 * @retval HAL status
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	268 */
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	269 __weak HAL_StatusTypeDef HAL_InitTick(uint32_t TickPriority)
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	270 {
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	271 /* Configure the SysTick to have interrupt in 1ms time basis*/
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	272 if (HAL_SYSTICK_Config(SystemCoreClock / (1000U / uwTickFreq)) > 0U)
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	273 {
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	274 return HAL_ERROR;
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	275 }
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	276
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	277 /* Configure the SysTick IRQ priority */
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	278 if (TickPriority < (1UL << __NVIC_PRIO_BITS))
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	279 {
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	280 HAL_NVIC_SetPriority(SysTick_IRQn, TickPriority, 0U);
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	281 uwTickPrio = TickPriority;
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	282 }
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	283 else
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	284 {
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	285 return HAL_ERROR;
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	286 }
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	287
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	288 /* Return function status */
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	289 return HAL_OK;
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	290 }
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	291
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	292 /**
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	293 * @}
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	294 */
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	295
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	296 /** @defgroup HAL_Exported_Functions_Group2 HAL Control functions
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	297 * @brief HAL Control functions
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	298 *
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	299 @verbatim
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	300 ===============================================================================
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	301 ##### HAL Control functions #####
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	302 ===============================================================================
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	303 [..] This section provides functions allowing to:
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	304 (+) Provide a tick value in millisecond
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	305 (+) Provide a blocking delay in millisecond
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	306 (+) Suspend the time base source interrupt
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	307 (+) Resume the time base source interrupt
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	308 (+) Get the HAL API driver version
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	309 (+) Get the device identifier
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	310 (+) Get the device revision identifier
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	311 (+) Enable/Disable Debug module during SLEEP mode
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	312 (+) Enable/Disable Debug module during STOP mode
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	313 (+) Enable/Disable Debug module during STANDBY mode
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	314
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	315 @endverbatim
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	316 * @{
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	317 */
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	318
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	319 /**
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	320 * @brief This function is called to increment a global variable "uwTick"
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	321 * used as application time base.
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	322 * @note In the default implementation, this variable is incremented each 1ms
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	323 * in SysTick ISR.
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	324 * @note This function is declared as __weak to be overwritten in case of other
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	325 * implementations in user file.
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	326 * @retval None
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	327 */
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	328 __weak void HAL_IncTick(void)
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	329 {
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	330 uwTick += uwTickFreq;
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	331 }
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	332
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	333 /**
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	334 * @brief Provides a tick value in millisecond.
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	335 * @note This function is declared as __weak to be overwritten in case of other
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	336 * implementations in user file.
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	337 * @retval tick value
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	338 */
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	339 __weak uint32_t HAL_GetTick(void)
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	340 {
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	341 return uwTick;
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	342 }
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	343
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	344 /**
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	345 * @brief This function returns a tick priority.
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	346 * @retval tick priority
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	347 */
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	348 uint32_t HAL_GetTickPrio(void)
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	349 {
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	350 return uwTickPrio;
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	351 }
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	352
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	353 /**
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	354 * @brief Set new tick Freq.
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	355 * @retval Status
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	356 */
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	357 HAL_StatusTypeDef HAL_SetTickFreq(HAL_TickFreqTypeDef Freq)
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	358 {
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	359 HAL_StatusTypeDef status = HAL_OK;
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	360 assert_param(IS_TICKFREQ(Freq));
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	361
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	362 if (uwTickFreq != Freq)
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	363 {
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	364 uwTickFreq = Freq;
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	365
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	366 /* Apply the new tick Freq */
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	367 status = HAL_InitTick(uwTickPrio);
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	368 }
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	369
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	370 return status;
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	371 }
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	372
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	373 /**
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	374 * @brief Return tick frequency.
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	375 * @retval tick period in Hz
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	376 */
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	377 HAL_TickFreqTypeDef HAL_GetTickFreq(void)
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	378 {
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	379 return uwTickFreq;
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	380 }
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	381
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	382 /**
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	383 * @brief This function provides minimum delay (in milliseconds) based
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	384 * on variable incremented.
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	385 * @note In the default implementation , SysTick timer is the source of time base.
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	386 * It is used to generate interrupts at regular time intervals where uwTick
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	387 * is incremented.
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	388 * @note This function is declared as __weak to be overwritten in case of other
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	389 * implementations in user file.
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	390 * @param Delay specifies the delay time length, in milliseconds.
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	391 * @retval None
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	392 */
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	393 __weak void HAL_Delay(uint32_t Delay)
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	394 {
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	395 uint32_t tickstart = HAL_GetTick();
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	396 uint32_t wait = Delay;
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	397
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	398 /* Add a freq to guarantee minimum wait */
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	399 if (wait < HAL_MAX_DELAY)
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	400 {
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	401 wait += (uint32_t)(uwTickFreq);
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	402 }
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	403
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	404 while((HAL_GetTick() - tickstart) < wait)
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	405 {
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	406 }
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	407 }
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	408
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	409 /**
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	410 * @brief Suspend Tick increment.
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	411 * @note In the default implementation , SysTick timer is the source of time base. It is
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	412 * used to generate interrupts at regular time intervals. Once HAL_SuspendTick()
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	413 * is called, the SysTick interrupt will be disabled and so Tick increment
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	414 * is suspended.
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	415 * @note This function is declared as __weak to be overwritten in case of other
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	416 * implementations in user file.
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	417 * @retval None
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	418 */
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	419 __weak void HAL_SuspendTick(void)
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	420 {
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	421 /* Disable SysTick Interrupt */
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	422 SysTick->CTRL &= ~SysTick_CTRL_TICKINT_Msk;
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	423 }
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	424
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	425 /**
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	426 * @brief Resume Tick increment.
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	427 * @note In the default implementation , SysTick timer is the source of time base. It is
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	428 * used to generate interrupts at regular time intervals. Once HAL_ResumeTick()
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	429 * is called, the SysTick interrupt will be enabled and so Tick increment
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	430 * is resumed.
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	431 * @note This function is declared as __weak to be overwritten in case of other
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	432 * implementations in user file.
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	433 * @retval None
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	434 */
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	435 __weak void HAL_ResumeTick(void)
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	436 {
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	437 /* Enable SysTick Interrupt */
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	438 SysTick->CTRL \|= SysTick_CTRL_TICKINT_Msk;
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	439 }
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	440
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	441 /**
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	442 * @brief Returns the HAL revision
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	443 * @retval version : 0xXYZR (8bits for each decimal, R for RC)
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	444 */
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	445 uint32_t HAL_GetHalVersion(void)
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	446 {
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	447 return __STM32F4xx_HAL_VERSION;
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	448 }
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	449
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	450 /**
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	451 * @brief Returns the device revision identifier.
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	452 * @retval Device revision identifier
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	453 */
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	454 uint32_t HAL_GetREVID(void)
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	455 {
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	456 return((DBGMCU->IDCODE) >> 16U);
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	457 }
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	458
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	459 /**
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	460 * @brief Returns the device identifier.
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	461 * @retval Device identifier
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	462 */
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	463 uint32_t HAL_GetDEVID(void)
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	464 {
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	465 return((DBGMCU->IDCODE) & IDCODE_DEVID_MASK);
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	466 }
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	467
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	468 /**
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	469 * @brief Enable the Debug Module during SLEEP mode
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	470 * @retval None
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	471 */
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	472 void HAL_DBGMCU_EnableDBGSleepMode(void)
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	473 {
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	474 SET_BIT(DBGMCU->CR, DBGMCU_CR_DBG_SLEEP);
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	475 }
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	476
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	477 /**
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	478 * @brief Disable the Debug Module during SLEEP mode
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	479 * @retval None
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	480 */
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	481 void HAL_DBGMCU_DisableDBGSleepMode(void)
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	482 {
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	483 CLEAR_BIT(DBGMCU->CR, DBGMCU_CR_DBG_SLEEP);
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	484 }
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	485
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	486 /**
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	487 * @brief Enable the Debug Module during STOP mode
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	488 * @retval None
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	489 */
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	490 void HAL_DBGMCU_EnableDBGStopMode(void)
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	491 {
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	492 SET_BIT(DBGMCU->CR, DBGMCU_CR_DBG_STOP);
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	493 }
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	494
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	495 /**
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	496 * @brief Disable the Debug Module during STOP mode
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	497 * @retval None
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	498 */
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	499 void HAL_DBGMCU_DisableDBGStopMode(void)
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	500 {
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	501 CLEAR_BIT(DBGMCU->CR, DBGMCU_CR_DBG_STOP);
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	502 }
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	503
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	504 /**
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	505 * @brief Enable the Debug Module during STANDBY mode
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	506 * @retval None
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	507 */
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	508 void HAL_DBGMCU_EnableDBGStandbyMode(void)
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	509 {
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	510 SET_BIT(DBGMCU->CR, DBGMCU_CR_DBG_STANDBY);
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	511 }
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	512
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	513 /**
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	514 * @brief Disable the Debug Module during STANDBY mode
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	515 * @retval None
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	516 */
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	517 void HAL_DBGMCU_DisableDBGStandbyMode(void)
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	518 {
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	519 CLEAR_BIT(DBGMCU->CR, DBGMCU_CR_DBG_STANDBY);
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	520 }
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	521
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	522 /**
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	523 * @brief Enables the I/O Compensation Cell.
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	524 * @note The I/O compensation cell can be used only when the device supply
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	525 * voltage ranges from 2.4 to 3.6 V.
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	526 * @retval None
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	527 */
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	528 void HAL_EnableCompensationCell(void)
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	529 {
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	530 (__IO uint32_t )CMPCR_CMP_PD_BB = (uint32_t)ENABLE;
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	531 }
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	532
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	533 /**
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	534 * @brief Power-down the I/O Compensation Cell.
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	535 * @note The I/O compensation cell can be used only when the device supply
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	536 * voltage ranges from 2.4 to 3.6 V.
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	537 * @retval None
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	538 */
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	539 void HAL_DisableCompensationCell(void)
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	540 {
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	541 (__IO uint32_t )CMPCR_CMP_PD_BB = (uint32_t)DISABLE;
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	542 }
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	543
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	544 /**
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	545 * @brief Return the unique device identifier (UID based on 96 bits)
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	546 * @param UID pointer to 3 words array.
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	547 * @retval Device identifier
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	548 */
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	549 void HAL_GetUID(uint32_t *UID)
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	550 {
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	551 UID[0] = (uint32_t)(READ_REG(((uint32_t )UID_BASE)));
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	552 UID[1] = (uint32_t)(READ_REG(((uint32_t )(UID_BASE + 4U))));
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	553 UID[2] = (uint32_t)(READ_REG(((uint32_t )(UID_BASE + 8U))));
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	554 }
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	555
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	556 #if defined(STM32F427xx) \|\| defined(STM32F437xx) \|\| defined(STM32F429xx)\|\| defined(STM32F439xx) \|\|\
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	557 defined(STM32F469xx) \|\| defined(STM32F479xx)
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	558 /**
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	559 * @brief Enables the Internal FLASH Bank Swapping.
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	560 *
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	561 * @note This function can be used only for STM32F42xxx/43xxx devices.
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	562 *
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	563 * @note Flash Bank2 mapped at 0x08000000 (and aliased @0x00000000)
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	564 * and Flash Bank1 mapped at 0x08100000 (and aliased at 0x00100000)
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	565 *
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	566 * @retval None
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	567 */
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	568 void HAL_EnableMemorySwappingBank(void)
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	569 {
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	570 (__IO uint32_t )UFB_MODE_BB = (uint32_t)ENABLE;
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	571 }
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	572
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	573 /**
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	574 * @brief Disables the Internal FLASH Bank Swapping.
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	575 *
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	576 * @note This function can be used only for STM32F42xxx/43xxx devices.
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	577 *
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	578 * @note The default state : Flash Bank1 mapped at 0x08000000 (and aliased @0x00000000)
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	579 * and Flash Bank2 mapped at 0x08100000 (and aliased at 0x00100000)
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	580 *
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	581 * @retval None
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	582 */
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	583 void HAL_DisableMemorySwappingBank(void)
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	584 {
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	585 (__IO uint32_t )UFB_MODE_BB = (uint32_t)DISABLE;
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	586 }
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	587 #endif /* STM32F427xx \|\| STM32F437xx \|\| STM32F429xx \|\| STM32F439xx \|\| STM32F469xx \|\| STM32F479xx */
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	588 /**
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	589 * @}
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	590 */
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	591
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	592 /**
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	593 * @}
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	594 */
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	595
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	596 /**
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	597 * @}
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	598 */
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	599
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	600 /**
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	601 * @}
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	602 */
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	603
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	604 /********************** (C) COPYRIGHT STMicroelectronics *END OF FILE**/

Mercurial > public > ostc4

annotate Common/Drivers/STM32F4xx_HAL_Driver/Src/stm32f4xx_hal.c @ 442:adb18fe92737 minor_improvments