ostc4: Common/Drivers/STM32F4xx_HAL_Driver/Src/stm32f4xx

annotate Common/Drivers/STM32F4xx_HAL_Driver/Src/stm32f4xx_hal.c @ 328:4fe5400567e7 I2C_Improvment

Set I2C speed to 88kHz, use digital filter only and reworked idle clock recovery The errata describes a possible problem in operation between 88kHz and 100kHz => Set speed as recommended as work around. Based on reference implementation only one filter should be use. Choice was digital because only drawback is lag of wakeup functionality which is not used I2C communication may be randomly interrupted e.g. by a RTE reset or firmware update => reworked recovery function to get I2C devices in idle state again (Clk and SDA HIGH)

author	ideenmodellierer
date	Wed, 17 Jul 2019 22:42:15 +0200
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 @ 328:4fe5400567e7 I2C_Improvment