stm32h7xx_hal.c File Reference

HAL module driver. This is the common part of the HAL initialization. More...

#include "stm32h7xx_hal.h"

Macros
#define	__STM32H7xx_HAL_VERSION_MAIN   (0x01UL)
	STM32H7xx HAL Driver version number.
#define	__STM32H7xx_HAL_VERSION_SUB1   (0x0BUL)
#define	__STM32H7xx_HAL_VERSION_SUB2   (0x03UL)
#define	__STM32H7xx_HAL_VERSION_RC   (0x00UL)
#define	__STM32H7xx_HAL_VERSION
#define	IDCODE_DEVID_MASK   ((uint32_t)0x00000FFF)
#define	VREFBUF_TIMEOUT_VALUE   (uint32_t)10 /* 10 ms */

Functions
HAL_StatusTypeDef	HAL_Init (void)
	This function is used to initialize the HAL Library; it must be the first instruction to be executed in the main program (before to call any other HAL function), it performs the following: Configures the SysTick to generate an interrupt each 1 millisecond, which is clocked by the HSI (at this stage, the clock is not yet configured and thus the system is running from the internal HSI at 16 MHz). Set NVIC Group Priority to 4. Calls the HAL_MspInit() callback function defined in user file "stm32h7xx_hal_msp.c" to do the global low level hardware initialization.
HAL_StatusTypeDef	HAL_DeInit (void)
	This function de-Initializes common part of the HAL and stops the systick. This function is optional.
__weak void	HAL_MspInit (void)
	Initializes the MSP.
__weak void	HAL_MspDeInit (void)
	DeInitializes the MSP.
__weak HAL_StatusTypeDef	HAL_InitTick (uint32_t TickPriority)
	This function configures the source of the time base. The time source is configured to have 1ms time base with a dedicated Tick interrupt priority.
__weak void	HAL_IncTick (void)
	This function is called to increment a global variable "uwTick" used as application time base.
__weak uint32_t	HAL_GetTick (void)
	Provides a tick value in millisecond.
uint32_t	HAL_GetTickPrio (void)
	This function returns a tick priority.
HAL_StatusTypeDef	HAL_SetTickFreq (HAL_TickFreqTypeDef Freq)
	Set new tick Freq.
HAL_TickFreqTypeDef	HAL_GetTickFreq (void)
	Return tick frequency.
__weak void	HAL_Delay (uint32_t Delay)
	This function provides minimum delay (in milliseconds) based on variable incremented.
__weak void	HAL_SuspendTick (void)
	Suspend Tick increment.
__weak void	HAL_ResumeTick (void)
	Resume Tick increment.
uint32_t	HAL_GetHalVersion (void)
	Returns the HAL revision.
uint32_t	HAL_GetREVID (void)
	Returns the device revision identifier.
uint32_t	HAL_GetDEVID (void)
	Returns the device identifier.
uint32_t	HAL_GetUIDw0 (void)
	Return the first word of the unique device identifier (UID based on 96 bits)
uint32_t	HAL_GetUIDw1 (void)
	Return the second word of the unique device identifier (UID based on 96 bits)
uint32_t	HAL_GetUIDw2 (void)
	Return the third word of the unique device identifier (UID based on 96 bits)
void	HAL_SYSCFG_VREFBUF_VoltageScalingConfig (uint32_t VoltageScaling)
	Configure the internal voltage reference buffer voltage scale.
void	HAL_SYSCFG_VREFBUF_HighImpedanceConfig (uint32_t Mode)
	Configure the internal voltage reference buffer high impedance mode.
void	HAL_SYSCFG_VREFBUF_TrimmingConfig (uint32_t TrimmingValue)
	Tune the Internal Voltage Reference buffer (VREFBUF).
HAL_StatusTypeDef	HAL_SYSCFG_EnableVREFBUF (void)
	Enable the Internal Voltage Reference buffer (VREFBUF).
void	HAL_SYSCFG_DisableVREFBUF (void)
	Disable the Internal Voltage Reference buffer (VREFBUF).
void	HAL_SYSCFG_AnalogSwitchConfig (uint32_t SYSCFG_AnalogSwitch, uint32_t SYSCFG_SwitchState)
	Analog Switch control for dual analog pads.
void	HAL_EnableCompensationCell (void)
	Enables the I/O Compensation Cell.
void	HAL_DisableCompensationCell (void)
	Power-down the I/O Compensation Cell.
void	HAL_SYSCFG_EnableIOSpeedOptimize (void)
	To Enable optimize the I/O speed when the product voltage is low.
void	HAL_SYSCFG_DisableIOSpeedOptimize (void)
	To Disable optimize the I/O speed when the product voltage is low.
void	HAL_SYSCFG_CompensationCodeSelect (uint32_t SYSCFG_CompCode)
	Code selection for the I/O Compensation cell.
void	HAL_SYSCFG_CompensationCodeConfig (uint32_t SYSCFG_PMOSCode, uint32_t SYSCFG_NMOSCode)
	Code selection for the I/O Compensation cell.
void	HAL_DBGMCU_EnableDBGSleepMode (void)
	Enable the Debug Module during Domain1/CDomain SLEEP mode.
void	HAL_DBGMCU_DisableDBGSleepMode (void)
	Disable the Debug Module during Domain1/CDomain SLEEP mode.
void	HAL_DBGMCU_EnableDBGStopMode (void)
	Enable the Debug Module during Domain1/CDomain STOP mode.
void	HAL_DBGMCU_DisableDBGStopMode (void)
	Disable the Debug Module during Domain1/CDomain STOP mode.
void	HAL_DBGMCU_EnableDBGStandbyMode (void)
	Enable the Debug Module during Domain1/CDomain STANDBY mode.
void	HAL_DBGMCU_DisableDBGStandbyMode (void)
	Disable the Debug Module during Domain1/CDomain STANDBY mode.
void	HAL_SetFMCMemorySwappingConfig (uint32_t BankMapConfig)
	Set the FMC Memory Mapping Swapping config.
uint32_t	HAL_GetFMCMemorySwappingConfig (void)
	Get FMC Bank mapping mode.
void	HAL_EXTI_EdgeConfig (uint32_t EXTI_Line, uint32_t EXTI_Edge)
	Configure the EXTI input event line edge.
void	HAL_EXTI_GenerateSWInterrupt (uint32_t EXTI_Line)
	Generates a Software interrupt on selected EXTI line.
void	HAL_EXTI_D1_ClearFlag (uint32_t EXTI_Line)
	Clears the EXTI's line pending flags for Domain D1.
void	HAL_EXTI_D1_EventInputConfig (uint32_t EXTI_Line, uint32_t EXTI_Mode, uint32_t EXTI_LineCmd)
	Configure the EXTI input event line for Domain D1.
void	HAL_EXTI_D3_EventInputConfig (uint32_t EXTI_Line, uint32_t EXTI_LineCmd, uint32_t EXTI_ClearSrc)
	Configure the EXTI input event line for Domain D3.

Variables
__IO uint32_t	uwTick
uint32_t	uwTickPrio = (1UL << __NVIC_PRIO_BITS)
HAL_TickFreqTypeDef	uwTickFreq = HAL_TICK_FREQ_DEFAULT

Detailed Description

HAL module driver. This is the common part of the HAL initialization.

Author

MCD Application Team

Attention

Copyright (c) 2017 STMicroelectronics. All rights reserved.

This software is licensed under terms that can be found in the LICENSE file in the root directory of this software component. If no LICENSE file comes with this software, it is provided AS-IS.

==============================================================================
                   ##### How to use this driver #####
==============================================================================
  [..]
  The common HAL driver contains a set of generic and common APIs that can be
  used by the PPP peripheral drivers and the user to start using the HAL.
  [..]
  The HAL contains two APIs' categories:
       (+) Common HAL APIs
       (+) Services HAL APIs