STM32U5xx_System_Exported_Functions

Functions
void	SystemInit (void)
	Setup the microcontroller system.
void	SystemCoreClockUpdate (void)
	Update SystemCoreClock variable.
uint32_t	SECURE_SystemCoreClockUpdate (void)
	Update SystemCoreClock variable from secure application and return its value when security is implemented in the system (Non-secure callable function).

Detailed Description

Function Documentation

SECURE_SystemCoreClockUpdate()

uint32_t SECURE_SystemCoreClockUpdate

(

void

)

Update SystemCoreClock variable from secure application and return its value when security is implemented in the system (Non-secure callable function).

Returns the SystemCoreClock value with current core Clock retrieved from cpu registers.

SystemCoreClockUpdate()

void SystemCoreClockUpdate

(

void

)

Update SystemCoreClock variable.

Updates the SystemCoreClock with current core Clock retrieved from cpu registers.

Update SystemCoreClock variable.

Updates the SystemCoreClock variable.

Updates the SystemCoreClock with current core Clock retrieved from cpu registers.

Note

Each time the core clock changes, this function must be called to update SystemCoreClock variable value. Otherwise, any configuration based on this variable will be incorrect.

- The system frequency computed by this function is not the real frequency in the chip. It is calculated based on the predefined constant and the selected clock source:

• If SYSCLK source is CSI, SystemCoreClock will contain the CSI_VALUE(*)
• If SYSCLK source is HSI, SystemCoreClock will contain the HSI_VALUE(**)
• If SYSCLK source is HSE, SystemCoreClock will contain the HSE_VALUE(***)
• If SYSCLK source is PLL, SystemCoreClock will contain the CSI_VALUE(*), HSI_VALUE(**) or HSE_VALUE(***) multiplied/divided by the PLL factors.

(*) CSI_VALUE is a constant defined in stm32h7xx_hal.h file (default value 4 MHz) but the real value may vary depending on the variations in voltage and temperature. (**) HSI_VALUE is a constant defined in stm32h7xx_hal.h file (default value 64 MHz) but the real value may vary depending on the variations in voltage and temperature.

(***)HSE_VALUE is a constant defined in stm32h7xx_hal.h file (default value 25 MHz), user has to ensure that HSE_VALUE is same as the real frequency of the crystal used. Otherwise, this function may have wrong result.

• The result of this function could be not correct when using fractional value for HSE crystal.

  Parameters

  None

  Return values

  None

Note

Each time the core clock changes, this function must be called to update SystemCoreClock variable value. Otherwise, any configuration based on this variable will be incorrect.

- The system frequency computed by this function is not the real frequency in the chip. It is calculated based on the predefined constant and the selected clock source:

• If SYSCLK source is CSI, SystemCoreClock will contain the CSI_VALUE(*)
  
• If SYSCLK source is HSI, SystemCoreClock will contain the HSI_VALUE(**)
• If SYSCLK source is HSE, SystemCoreClock will contain the HSE_VALUE(***)
• If SYSCLK source is PLL, SystemCoreClock will contain the CSI_VALUE(*), HSI_VALUE(**) or HSE_VALUE(***) multiplied/divided by the PLL factors.

(*) CSI_VALUE is a constant defined in stm32h7xx_hal.h file (default value 4 MHz) but the real value may vary depending on the variations in voltage and temperature.
(**) HSI_VALUE is a constant defined in stm32h7xx_hal.h file (default value 64 MHz) but the real value may vary depending on the variations in voltage and temperature.

(***)HSE_VALUE is a constant defined in stm32h7xx_hal.h file (default value 25 MHz), user has to ensure that HSE_VALUE is same as the real frequency of the crystal used. Otherwise, this function may have wrong result.

• The result of this function could be not correct when using fractional value for HSE crystal.

  Parameters

  None

  Return values

  None

Note

Each time the core clock changes, this function must be called to update SystemCoreClock variable value. Otherwise, any configuration based on this variable will be incorrect.

- The system frequency computed by this function is not the real frequency in the chip. It is calculated based on the predefined constant and the selected clock source:

• If SYSCLK source is CSI, SystemCoreClock will contain the CSI_VALUE(*)
• If SYSCLK source is HSI, SystemCoreClock will contain the HSI_VALUE(**)
• If SYSCLK source is HSE, SystemCoreClock will contain the HSE_VALUE(***)
• If SYSCLK source is PLL, SystemCoreClock will contain the CSI_VALUE(*), HSI_VALUE(**) or HSE_VALUE(***) multiplied/divided by the PLL factors.

(*) CSI_VALUE is a constant defined in stm32h7xx_hal.h file (default value 4 MHz) but the real value may vary depending on the variations in voltage and temperature. (**) HSI_VALUE is a constant defined in stm32h7xx_hal.h file (default value 64 MHz) but the real value may vary depending on the variations in voltage and temperature.

(***)HSE_VALUE is a constant defined in stm32h7xx_hal.h file (default value 25 MHz), user has to ensure that HSE_VALUE is same as the real frequency of the crystal used. Otherwise, this function may have wrong result.

• The result of this function could be not correct when using fractional value for HSE crystal.

  Parameters

  None

  Return values

  None

Note

Each time the core clock changes, this function must be called to update SystemCoreClock variable value. Otherwise, any configuration based on this variable will be incorrect.

- The system frequency computed by this function is not the real frequency in the chip. It is calculated based on the predefined constant and the selected clock source:

• If SYSCLK source is CSI, SystemCoreClock will contain the CSI_VALUE(*)
  
• If SYSCLK source is HSI, SystemCoreClock will contain the HSI_VALUE(**)
• If SYSCLK source is HSE, SystemCoreClock will contain the HSE_VALUE(***)
• If SYSCLK source is PLL, SystemCoreClock will contain the CSI_VALUE(*), HSI_VALUE(**) or HSE_VALUE(***) multiplied/divided by the PLL factors.

(*) CSI_VALUE is a constant defined in stm32h7xx_hal.h file (default value 4 MHz) but the real value may vary depending on the variations in voltage and temperature.
(**) HSI_VALUE is a constant defined in stm32h7xx_hal.h file (default value 64 MHz) but the real value may vary depending on the variations in voltage and temperature.

(***)HSE_VALUE is a constant defined in stm32h7xx_hal.h file (default value 25 MHz), user has to ensure that HSE_VALUE is same as the real frequency of the crystal used. Otherwise, this function may have wrong result.

• The result of this function could be not correct when using fractional value for HSE crystal.

  Parameters

  None

  Return values

  None

Note

Each time the core clock changes, this function must be called to update SystemCoreClock variable value. Otherwise, any configuration based on this variable will be incorrect.

- The system frequency computed by this function is not the real frequency in the chip. It is calculated based on the predefined constant and the selected clock source:

• If SYSCLK source is CSI, SystemCoreClock will contain the CSI_VALUE(*)
• If SYSCLK source is HSI, SystemCoreClock will contain the HSI_VALUE(**)
• If SYSCLK source is HSE, SystemCoreClock will contain the HSE_VALUE(***)
• If SYSCLK source is PLL, SystemCoreClock will contain the CSI_VALUE(*), HSI_VALUE(**) or HSE_VALUE(***) multiplied/divided by the PLL factors.

(*) CSI_VALUE is a constant defined in stm32h7xx_hal.h file (default value 4 MHz) but the real value may vary depending on the variations in voltage and temperature. (**) HSI_VALUE is a constant defined in stm32h7xx_hal.h file (default value 64 MHz) but the real value may vary depending on the variations in voltage and temperature.

(***)HSE_VALUE is a constant defined in stm32h7xx_hal.h file (default value 25 MHz), user has to ensure that HSE_VALUE is same as the real frequency of the crystal used. Otherwise, this function may have wrong result.

• The result of this function could be not correct when using fractional value for HSE crystal.

  Parameters

  None

  Return values

  None

  Update SystemCoreClock variable.

Updates the SystemCoreClock variable.

Updates the SystemCoreClock with current core Clock retrieved from cpu registers.

Note

Each time the core clock (HCLK) changes, this function must be called to update SystemCoreClock variable value. Otherwise, any configuration based on this variable will be incorrect.

- The system frequency computed by this function is not the real frequency in the chip. It is calculated based on the predefined constant and the selected clock source:

• If SYSCLK source is MSI, SystemCoreClock will contain the MSI_VALUE(*)
• If SYSCLK source is HSI, SystemCoreClock will contain the HSI_VALUE(**)
• If SYSCLK source is HSE, SystemCoreClock will contain the HSE_VALUE(***)
• If SYSCLK source is PLL, SystemCoreClock will contain the HSE_VALUE(***) or HSI_VALUE(*) or MSI_VALUE(*) multiplied/divided by the PLL factors.

(*) MSI_VALUE is a constant defined in stm32u5xx_hal.h file (default value 4 MHz) but the real value may vary depending on the variations in voltage and temperature.

(**) HSI_VALUE is a constant defined in stm32u5xx_hal.h file (default value 16 MHz) but the real value may vary depending on the variations in voltage and temperature.

(***) HSE_VALUE is a constant defined in stm32u5xx_hal.h file (default value 8 MHz), user has to ensure that HSE_VALUE is same as the real frequency of the crystal used. Otherwise, this function may have wrong result.

• The result of this function could be not correct when using fractional value for HSE crystal.

Parameters

None

Return values

None

SystemInit()

void SystemInit

(

void

)

Setup the microcontroller system.

Initialize the System and update the SystemCoreClock variable.

Setup the microcontroller system.

Setup the microcontroller system. Initialize the System and update the SystemCoreClock variable.

Setup the microcontroller system Initialize the FPU setting, vector table location and External memory configuration.

Setup the microcontroller system Initialize the FPU setting and vector table location configuration.

Parameters

None

Return values

None

Setup the microcontroller system.

Setup the microcontroller system. Initialize the System and update the SystemCoreClock variable.

Setup the microcontroller system Initialize the FPU setting, vector table location and External memory configuration.

Parameters

None

Return values

None

Setup the microcontroller system. Initialize the System and update the SystemCoreClock variable.

Parameters

None

Return values

None