Extended Peripheral Control functions. More...

Functions
HAL_StatusTypeDef	HAL_RCCEx_PeriphCLKConfig (RCC_PeriphCLKInitTypeDef *PeriphClkInit)
	Initializes the RCC extended peripherals clocks according to the specified parameters in the RCC_PeriphCLKInitTypeDef.
void	HAL_RCCEx_GetPeriphCLKConfig (RCC_PeriphCLKInitTypeDef *PeriphClkInit)
	Get the RCC_ClkInitStruct according to the internal RCC configuration registers.
uint32_t	HAL_RCCEx_GetPeriphCLKFreq (uint32_t PeriphClk)
	Return the peripheral clock frequency for a given peripheral(SAI..)
uint32_t	HAL_RCCEx_GetD1PCLK1Freq (void)
	Returns the D1PCLK1 frequency.
uint32_t	HAL_RCCEx_GetD3PCLK1Freq (void)
	Returns the D3PCLK1 frequency.
void	HAL_RCCEx_GetPLL2ClockFreq (PLL2_ClocksTypeDef *PLL2_Clocks)
	Returns the PLL2 clock frequencies :PLL2_P_Frequency,PLL2_R_Frequency and PLL2_Q_Frequency.
void	HAL_RCCEx_GetPLL3ClockFreq (PLL3_ClocksTypeDef *PLL3_Clocks)
	Returns the PLL3 clock frequencies :PLL3_P_Frequency,PLL3_R_Frequency and PLL3_Q_Frequency.
void	HAL_RCCEx_GetPLL1ClockFreq (PLL1_ClocksTypeDef *PLL1_Clocks)
	Returns the PLL1 clock frequencies :PLL1_P_Frequency,PLL1_R_Frequency and PLL1_Q_Frequency.
uint32_t	HAL_RCCEx_GetD1SysClockFreq (void)
	Returns the main System frequency.

Detailed Description

Extended Peripheral Control functions.

 ===============================================================================
                ##### Extended Peripheral Control functions  #####
 ===============================================================================
    [..]
    This subsection provides a set of functions allowing to control the RCC Clocks
    frequencies.
    [..]
    (@) Important note: Care must be taken when HAL_RCCEx_PeriphCLKConfig() is used to
        select the RTC clock source; in this case the Backup domain will be reset in
        order to modify the RTC Clock source, as consequence RTC registers (including
        the backup registers) and RCC_BDCR register are set to their reset values.

Function Documentation

uint32_t HAL_RCCEx_GetD1PCLK1Freq ( void )

Returns the D1PCLK1 frequency.

Note:: Each time D1PCLK1 changes, this function must be called to update the right D1PCLK1 value. Otherwise, any configuration based on this function will be incorrect.

Return values:

D1PCLK1 frequency

Definition at line 2727 of file stm32h7xx_hal_rcc_ex.c.

References HAL_RCC_GetHCLKFreq().

uint32_t HAL_RCCEx_GetD1SysClockFreq ( void )

Returns the main System frequency.

Note:: Each time System clock changes, this function must be called to update the right core clock value. Otherwise, any configuration based on this function will be incorrect.; The SystemCoreClock CMSIS variable is used to store System current Core Clock Frequency and updated within this function

Return values:

HCLK frequency

Definition at line 2966 of file stm32h7xx_hal_rcc_ex.c.

References HAL_RCC_GetSysClockFreq().

uint32_t HAL_RCCEx_GetD3PCLK1Freq ( void )

Returns the D3PCLK1 frequency.

Note:: Each time D3PCLK1 changes, this function must be called to update the right D3PCLK1 value. Otherwise, any configuration based on this function will be incorrect.

Return values:

D3PCLK1 frequency

Definition at line 2744 of file stm32h7xx_hal_rcc_ex.c.

References HAL_RCC_GetHCLKFreq().

Referenced by HAL_DTS_GetTemperature(), HAL_RCCEx_GetPeriphCLKFreq(), and UART_SetConfig().

void HAL_RCCEx_GetPeriphCLKConfig ( RCC_PeriphCLKInitTypeDef * PeriphClkInit )

Get the RCC_ClkInitStruct according to the internal RCC configuration registers.

Parameters:

PeriphClkInit,: pointer to an RCC_PeriphCLKInitTypeDef structure that returns the configuration information for the Extended Peripherals clocks : (SDMMC, CKPER, FMC, QSPI*, OSPI*, DSI*, SPI45, SPDIF, DFSDM1, DFSDM2*, FDCAN, SWPMI, SAI23*, SAI1, SPI123, USART234578, USART16, RNG, HRTIM1*, I2C123 (I2C1235*), USB, CEC, LPTIM1, LPUART1, I2C4, LPTIM2, LPTIM345, ADC. SAI4A*, SAI4B*, SPI6, RTC, TIM).

Return values:

None	(*) : Available on some STM32H7 lines only.

Definition at line 1595 of file stm32h7xx_hal_rcc_ex.c.

uint32_t HAL_RCCEx_GetPeriphCLKFreq ( uint32_t PeriphClk )

Return the peripheral clock frequency for a given peripheral(SAI..)

Note:: Return 0 if peripheral clock identifier not managed by this API

Parameters:

PeriphClk,:

Peripheral clock identifier This parameter can be one of the following values:

RCC_PERIPHCLK_SAI1 : SAI1 peripheral clock
RCC_PERIPHCLK_SAI23 : SAI2/3 peripheral clock (*)
RCC_PERIPHCLK_SAI2A : SAI2A peripheral clock (*)
RCC_PERIPHCLK_SAI2B : SAI2B peripheral clock (*)
RCC_PERIPHCLK_SAI4A : SAI4A peripheral clock (*)
RCC_PERIPHCLK_SAI4B : SAI4B peripheral clock (*)
RCC_PERIPHCLK_SPI123: SPI1/2/3 peripheral clock
RCC_PERIPHCLK_ADC : ADC peripheral clock
RCC_PERIPHCLK_SDMMC : SDMMC peripheral clock
RCC_PERIPHCLK_SPI6 : SPI6 peripheral clock

Return values:

Frequency in KHz

(*) : Available on some STM32H7 lines only.

Definition at line 1784 of file stm32h7xx_hal_rcc_ex.c.

References __HAL_RCC_GET_ADC_SOURCE, __HAL_RCC_GET_CLKP_SOURCE, __HAL_RCC_GET_FDCAN_SOURCE, __HAL_RCC_GET_HSI_DIVIDER, __HAL_RCC_GET_SAI1_SOURCE, __HAL_RCC_GET_SAI4A_SOURCE, __HAL_RCC_GET_SAI4B_SOURCE, __HAL_RCC_GET_SDMMC_SOURCE, __HAL_RCC_GET_SPI123_SOURCE, __HAL_RCC_GET_SPI6_SOURCE, CSI_VALUE, EXTERNAL_CLOCK_VALUE, HAL_RCCEx_GetD3PCLK1Freq(), HAL_RCCEx_GetPLL1ClockFreq(), HAL_RCCEx_GetPLL2ClockFreq(), HAL_RCCEx_GetPLL3ClockFreq(), HSE_VALUE, HSI_VALUE, PLL1_ClocksTypeDef::PLL1_Q_Frequency, PLL2_ClocksTypeDef::PLL2_P_Frequency, PLL2_ClocksTypeDef::PLL2_Q_Frequency, PLL2_ClocksTypeDef::PLL2_R_Frequency, PLL3_ClocksTypeDef::PLL3_P_Frequency, PLL3_ClocksTypeDef::PLL3_Q_Frequency, PLL3_ClocksTypeDef::PLL3_R_Frequency, RCC_ADCCLKSOURCE_CLKP, RCC_ADCCLKSOURCE_PLL2, RCC_ADCCLKSOURCE_PLL3, RCC_CLKPSOURCE_CSI, RCC_CLKPSOURCE_HSE, RCC_CLKPSOURCE_HSI, RCC_FDCANCLKSOURCE_HSE, RCC_FDCANCLKSOURCE_PLL, RCC_FDCANCLKSOURCE_PLL2, RCC_PERIPHCLK_ADC, RCC_PERIPHCLK_FDCAN, RCC_PERIPHCLK_SAI1, RCC_PERIPHCLK_SAI4A, RCC_PERIPHCLK_SAI4B, RCC_PERIPHCLK_SDMMC, RCC_PERIPHCLK_SPI123, RCC_PERIPHCLK_SPI6, RCC_SAI1CLKSOURCE_CLKP, RCC_SAI1CLKSOURCE_PIN, RCC_SAI1CLKSOURCE_PLL, RCC_SAI1CLKSOURCE_PLL2, RCC_SAI1CLKSOURCE_PLL3, RCC_SAI4ACLKSOURCE_CLKP, RCC_SAI4ACLKSOURCE_PIN, RCC_SAI4ACLKSOURCE_PLL, RCC_SAI4ACLKSOURCE_PLL2, RCC_SAI4ACLKSOURCE_PLL3, RCC_SAI4BCLKSOURCE_CLKP, RCC_SAI4BCLKSOURCE_PIN, RCC_SAI4BCLKSOURCE_PLL, RCC_SAI4BCLKSOURCE_PLL2, RCC_SAI4BCLKSOURCE_PLL3, RCC_SDMMCCLKSOURCE_PLL, RCC_SDMMCCLKSOURCE_PLL2, RCC_SPI123CLKSOURCE_CLKP, RCC_SPI123CLKSOURCE_PIN, RCC_SPI123CLKSOURCE_PLL, RCC_SPI123CLKSOURCE_PLL2, RCC_SPI123CLKSOURCE_PLL3, RCC_SPI6CLKSOURCE_CSI, RCC_SPI6CLKSOURCE_D3PCLK1, RCC_SPI6CLKSOURCE_HSE, RCC_SPI6CLKSOURCE_HSI, RCC_SPI6CLKSOURCE_PLL2, and RCC_SPI6CLKSOURCE_PLL3.

Referenced by ADC_ConfigureBoostMode(), HAL_I2S_Init(), HAL_MMC_InitCard(), HAL_SAI_Init(), HAL_SD_ConfigWideBusOperation(), HAL_SD_InitCard(), and MMC_HighSpeed().

void HAL_RCCEx_GetPLL1ClockFreq ( PLL1_ClocksTypeDef * PLL1_Clocks )

Returns the PLL1 clock frequencies :PLL1_P_Frequency,PLL1_R_Frequency and PLL1_Q_Frequency.

Note:: The PLL1 clock frequencies 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:; The function returns values based on HSE_VALUE, HSI_VALUE or CSI Value multiplied/divided by the PLL factors.; This function can be used by the user application to compute the baud-rate for the communication peripherals or configure other parameters.; Each time PLL1CLK changes, this function must be called to update the right PLL1CLK value. Otherwise, any configuration based on this function will be incorrect.

Parameters:

PLL1_Clocks structure.

Return values:

None

Definition at line 2905 of file stm32h7xx_hal_rcc_ex.c.

References __HAL_RCC_GET_FLAG, __HAL_RCC_GET_HSI_DIVIDER, CSI_VALUE, HSE_VALUE, HSI_VALUE, PLL1_ClocksTypeDef::PLL1_P_Frequency, PLL1_ClocksTypeDef::PLL1_Q_Frequency, PLL1_ClocksTypeDef::PLL1_R_Frequency, RCC_FLAG_HSIDIV, RCC_PLLSOURCE_CSI, RCC_PLLSOURCE_HSE, and RCC_PLLSOURCE_HSI.

Referenced by HAL_RCCEx_GetPeriphCLKFreq().

void HAL_RCCEx_GetPLL2ClockFreq ( PLL2_ClocksTypeDef * PLL2_Clocks )

Returns the PLL2 clock frequencies :PLL2_P_Frequency,PLL2_R_Frequency and PLL2_Q_Frequency.

Note:: The PLL2 clock frequencies 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:; The function returns values based on HSE_VALUE, HSI_VALUE or CSI Value multiplied/divided by the PLL factors.; This function can be used by the user application to compute the baud-rate for the communication peripherals or configure other parameters.; Each time PLL2CLK changes, this function must be called to update the right PLL2CLK value. Otherwise, any configuration based on this function will be incorrect.

Parameters:

PLL2_Clocks structure.

Return values:

None

Definition at line 2768 of file stm32h7xx_hal_rcc_ex.c.

References __HAL_RCC_GET_FLAG, __HAL_RCC_GET_HSI_DIVIDER, CSI_VALUE, HSE_VALUE, HSI_VALUE, PLL2_ClocksTypeDef::PLL2_P_Frequency, PLL2_ClocksTypeDef::PLL2_Q_Frequency, PLL2_ClocksTypeDef::PLL2_R_Frequency, RCC_FLAG_HSIDIV, RCC_PLLSOURCE_CSI, RCC_PLLSOURCE_HSE, and RCC_PLLSOURCE_HSI.

Referenced by HAL_RCCEx_GetPeriphCLKFreq(), IRDA_SetConfig(), SMARTCARD_SetConfig(), UART_SetConfig(), and USART_SetConfig().

void HAL_RCCEx_GetPLL3ClockFreq ( PLL3_ClocksTypeDef * PLL3_Clocks )

Returns the PLL3 clock frequencies :PLL3_P_Frequency,PLL3_R_Frequency and PLL3_Q_Frequency.

Note:: The PLL3 clock frequencies 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:; The function returns values based on HSE_VALUE, HSI_VALUE or CSI Value multiplied/divided by the PLL factors.; This function can be used by the user application to compute the baud-rate for the communication peripherals or configure other parameters.; Each time PLL3CLK changes, this function must be called to update the right PLL3CLK value. Otherwise, any configuration based on this function will be incorrect.

Parameters:

PLL3_Clocks structure.

Return values:

None

Definition at line 2837 of file stm32h7xx_hal_rcc_ex.c.

References __HAL_RCC_GET_FLAG, __HAL_RCC_GET_HSI_DIVIDER, CSI_VALUE, HSE_VALUE, HSI_VALUE, PLL3_ClocksTypeDef::PLL3_P_Frequency, PLL3_ClocksTypeDef::PLL3_Q_Frequency, PLL3_ClocksTypeDef::PLL3_R_Frequency, RCC_FLAG_HSIDIV, RCC_PLLSOURCE_CSI, RCC_PLLSOURCE_HSE, and RCC_PLLSOURCE_HSI.

Referenced by HAL_RCCEx_GetPeriphCLKFreq(), IRDA_SetConfig(), SMARTCARD_SetConfig(), UART_SetConfig(), and USART_SetConfig().

HAL_StatusTypeDef HAL_RCCEx_PeriphCLKConfig ( RCC_PeriphCLKInitTypeDef * PeriphClkInit )

Initializes the RCC extended peripherals clocks according to the specified parameters in the RCC_PeriphCLKInitTypeDef.

Parameters:

PeriphClkInit,: pointer to an RCC_PeriphCLKInitTypeDef structure that contains the configuration information for the Extended Peripherals clocks (SDMMC, CKPER, FMC, QSPI*, OSPI*, DSI, SPI45, SPDIF, DFSDM1, DFSDM2*, FDCAN, SWPMI, SAI23*,SAI2A*, SAI2B*, SAI1, SPI123, USART234578, USART16 (USART16910*), RNG, HRTIM1*, I2C123 (I2C1235*), USB, CEC, LPTIM1, LPUART1, I2C4, LPTIM2, LPTIM345, ADC, SAI4A*, SAI4B*, SPI6, RTC).

Note:: Care must be taken when HAL_RCCEx_PeriphCLKConfig() is used to select the RTC clock source; in this case the Backup domain will be reset in order to modify the RTC Clock source, as consequence RTC registers (including the backup registers) are set to their reset values.

(*) : Available on some STM32H7 lines only.

Return values:

HAL status

Definition at line 105 of file stm32h7xx_hal_rcc_ex.c.

Functions

Detailed Description

Function Documentation