Extended Clock management functions

Extended Clock management functions. More...

Functions
HAL_StatusTypeDef	HAL_RCCEx_EnablePLLSAI1 (RCC_PLLSAI1InitTypeDef *PLLSAI1Init)
	Enable PLLSAI1.
HAL_StatusTypeDef	HAL_RCCEx_DisablePLLSAI1 (void)
	Disable PLLSAI1.
HAL_StatusTypeDef	HAL_RCCEx_EnablePLLSAI2 (RCC_PLLSAI2InitTypeDef *PLLSAI2Init)
	Enable PLLSAI2.
HAL_StatusTypeDef	HAL_RCCEx_DisablePLLSAI2 (void)
	Disable PLLISAI2.
void	HAL_RCCEx_WakeUpStopCLKConfig (uint32_t WakeUpClk)
	Configure the oscillator clock source for wakeup from Stop and CSS backup clock.
void	HAL_RCCEx_StandbyMSIRangeConfig (uint32_t MSIRange)
	Configure the MSI range after standby mode.
void	HAL_RCCEx_EnableLSECSS (void)
	Enable the LSE Clock Security System.
void	HAL_RCCEx_DisableLSECSS (void)
	Disable the LSE Clock Security System.
void	HAL_RCCEx_EnableLSECSS_IT (void)
	Enable the LSE Clock Security System Interrupt & corresponding EXTI line.
void	HAL_RCCEx_LSECSS_IRQHandler (void)
	Handle the RCC LSE Clock Security System interrupt request.
__weak void	HAL_RCCEx_LSECSS_Callback (void)
	RCCEx LSE Clock Security System interrupt callback.
void	HAL_RCCEx_EnableLSCO (uint32_t LSCOSource)
	Select the Low Speed clock source to output on LSCO pin (PA2).
void	HAL_RCCEx_DisableLSCO (void)
	Disable the Low Speed clock output.
void	HAL_RCCEx_EnableMSIPLLMode (void)
	Enable the PLL-mode of the MSI.
void	HAL_RCCEx_DisableMSIPLLMode (void)
	Disable the PLL-mode of the MSI.

---

Detailed Description

Extended Clock management functions.

 ===============================================================================
                ##### Extended clock management functions  #####
 ===============================================================================
    [..]
    This subsection provides a set of functions allowing to control the
    activation or deactivation of MSI PLL-mode, PLLSAI1, PLLSAI2, LSE CSS,
    Low speed clock output and clock after wake-up from STOP mode.

---

Function Documentation

void HAL_RCCEx_DisableLSCO

(

void

)

Disable the Low Speed clock output.

Return values:

None

Definition at line 2536 of file stm32l4xx_hal_rcc_ex.c.

References __HAL_RCC_PWR_CLK_DISABLE, __HAL_RCC_PWR_CLK_ENABLE, __HAL_RCC_PWR_IS_CLK_DISABLED, HAL_PWR_DisableBkUpAccess(), and HAL_PWR_EnableBkUpAccess().

void HAL_RCCEx_DisableLSECSS

(

void

)

Disable the LSE Clock Security System.

Note:

LSE Clock Security System can only be disabled after a LSE failure detection.

Return values:

None

Definition at line 2427 of file stm32l4xx_hal_rcc_ex.c.

References __HAL_RCC_DISABLE_IT, and RCC_IT_LSECSS.

void HAL_RCCEx_DisableMSIPLLMode

(

void

)

Disable the PLL-mode of the MSI.

Note:

PLL-mode of the MSI is automatically reset when LSE oscillator is disabled.

Return values:

None

Definition at line 2584 of file stm32l4xx_hal_rcc_ex.c.

HAL_StatusTypeDef HAL_RCCEx_DisablePLLSAI1

(

void

)

Disable PLLSAI1.

Return values:

HAL

status

Definition at line 2209 of file stm32l4xx_hal_rcc_ex.c.

References __HAL_RCC_PLLSAI1_DISABLE, __HAL_RCC_PLLSAI1CLKOUT_DISABLE, HAL_GetTick(), PLLSAI1_TIMEOUT_VALUE, and RCC_PLLSOURCE_NONE.

HAL_StatusTypeDef HAL_RCCEx_DisablePLLSAI2

(

void

)

Disable PLLISAI2.

Return values:

HAL

status

Definition at line 2333 of file stm32l4xx_hal_rcc_ex.c.

References __HAL_RCC_PLLSAI2_DISABLE, __HAL_RCC_PLLSAI2CLKOUT_DISABLE, HAL_GetTick(), PLLSAI2_TIMEOUT_VALUE, and RCC_PLLSOURCE_NONE.

void HAL_RCCEx_EnableLSCO

(

uint32_t

LSCOSource

)

Select the Low Speed clock source to output on LSCO pin (PA2).

Parameters:

LSCOSource

specifies the Low Speed clock source to output. This parameter can be one of the following values: RCC_LSCOSOURCE_LSI LSI clock selected as LSCO source RCC_LSCOSOURCE_LSE LSE clock selected as LSCO source

Return values:

None

Definition at line 2489 of file stm32l4xx_hal_rcc_ex.c.

References __HAL_RCC_PWR_CLK_DISABLE, __HAL_RCC_PWR_CLK_ENABLE, __HAL_RCC_PWR_IS_CLK_DISABLED, __LSCO_CLK_ENABLE, assert_param, GPIO_MODE_ANALOG, GPIO_NOPULL, GPIO_SPEED_FREQ_HIGH, HAL_GPIO_Init(), HAL_PWR_DisableBkUpAccess(), HAL_PWR_EnableBkUpAccess(), IS_RCC_LSCOSOURCE, LSCO_GPIO_PORT, LSCO_PIN, GPIO_InitTypeDef::Mode, GPIO_InitTypeDef::Pin, GPIO_InitTypeDef::Pull, and GPIO_InitTypeDef::Speed.

void HAL_RCCEx_EnableLSECSS

(

void

)

Enable the LSE Clock Security System.

Note:

Prior to enable the LSE Clock Security System, LSE oscillator is to be enabled with HAL_RCC_OscConfig() and the LSE oscillator clock is to be selected as RTC clock with HAL_RCCEx_PeriphCLKConfig().

Return values:

None

Definition at line 2417 of file stm32l4xx_hal_rcc_ex.c.

void HAL_RCCEx_EnableLSECSS_IT

(

void

)

Enable the LSE Clock Security System Interrupt & corresponding EXTI line.

Note:

LSE Clock Security System Interrupt is mapped on RTC EXTI line 19

Return values:

None

Definition at line 2440 of file stm32l4xx_hal_rcc_ex.c.

References __HAL_RCC_ENABLE_IT, __HAL_RCC_LSECSS_EXTI_ENABLE_IT, __HAL_RCC_LSECSS_EXTI_ENABLE_RISING_EDGE, and RCC_IT_LSECSS.

void HAL_RCCEx_EnableMSIPLLMode

(

void

)

Enable the PLL-mode of the MSI.

Note:

Prior to enable the PLL-mode of the MSI for automatic hardware calibration LSE oscillator is to be enabled with HAL_RCC_OscConfig().

Return values:

None

Definition at line 2574 of file stm32l4xx_hal_rcc_ex.c.

HAL_StatusTypeDef HAL_RCCEx_EnablePLLSAI1

(

RCC_PLLSAI1InitTypeDef *

PLLSAI1Init

)

Enable PLLSAI1.

Parameters:

PLLSAI1Init

pointer to an RCC_PLLSAI1InitTypeDef structure that contains the configuration information for the PLLSAI1

Return values:

HAL

status

Definition at line 2141 of file stm32l4xx_hal_rcc_ex.c.

References __HAL_RCC_PLLSAI1_CONFIG, __HAL_RCC_PLLSAI1_DISABLE, __HAL_RCC_PLLSAI1_ENABLE, __HAL_RCC_PLLSAI1CLKOUT_ENABLE, assert_param, HAL_GetTick(), IS_RCC_PLLSAI1CLOCKOUT_VALUE, IS_RCC_PLLSAI1M_VALUE, IS_RCC_PLLSAI1N_VALUE, IS_RCC_PLLSAI1P_VALUE, IS_RCC_PLLSAI1Q_VALUE, IS_RCC_PLLSAI1R_VALUE, IS_RCC_PLLSAI1SOURCE, PLLSAI1_TIMEOUT_VALUE, RCC_PLLSAI1InitTypeDef::PLLSAI1ClockOut, RCC_PLLSAI1InitTypeDef::PLLSAI1M, RCC_PLLSAI1InitTypeDef::PLLSAI1N, RCC_PLLSAI1InitTypeDef::PLLSAI1P, RCC_PLLSAI1InitTypeDef::PLLSAI1Q, RCC_PLLSAI1InitTypeDef::PLLSAI1R, and RCC_PLLSAI1InitTypeDef::PLLSAI1Source.

HAL_StatusTypeDef HAL_RCCEx_EnablePLLSAI2

(

RCC_PLLSAI2InitTypeDef *

PLLSAI2Init

)

Enable PLLSAI2.

Parameters:

PLLSAI2Init

pointer to an RCC_PLLSAI2InitTypeDef structure that contains the configuration information for the PLLSAI2

Return values:

HAL

status

Definition at line 2255 of file stm32l4xx_hal_rcc_ex.c.

References __HAL_RCC_PLLSAI2_CONFIG, __HAL_RCC_PLLSAI2_DISABLE, __HAL_RCC_PLLSAI2_ENABLE, __HAL_RCC_PLLSAI2CLKOUT_ENABLE, assert_param, HAL_GetTick(), IS_RCC_PLLSAI2CLOCKOUT_VALUE, IS_RCC_PLLSAI2M_VALUE, IS_RCC_PLLSAI2N_VALUE, IS_RCC_PLLSAI2P_VALUE, IS_RCC_PLLSAI2R_VALUE, IS_RCC_PLLSAI2SOURCE, PLLSAI2_TIMEOUT_VALUE, RCC_PLLSAI2InitTypeDef::PLLSAI2ClockOut, RCC_PLLSAI2InitTypeDef::PLLSAI2M, RCC_PLLSAI2InitTypeDef::PLLSAI2N, RCC_PLLSAI2InitTypeDef::PLLSAI2P, RCC_PLLSAI2InitTypeDef::PLLSAI2R, and RCC_PLLSAI2InitTypeDef::PLLSAI2Source.

void HAL_RCCEx_LSECSS_Callback

(

void

)

RCCEx LSE Clock Security System interrupt callback.

Return values:

none

Definition at line 2474 of file stm32l4xx_hal_rcc_ex.c.

Referenced by HAL_RCCEx_LSECSS_IRQHandler().

void HAL_RCCEx_LSECSS_IRQHandler

(

void

)

Handle the RCC LSE Clock Security System interrupt request.

Return values:

None

Definition at line 2457 of file stm32l4xx_hal_rcc_ex.c.

References __HAL_RCC_CLEAR_IT, __HAL_RCC_GET_IT, HAL_RCCEx_LSECSS_Callback(), and RCC_IT_LSECSS.

void HAL_RCCEx_StandbyMSIRangeConfig

(

uint32_t

MSIRange

)

Configure the MSI range after standby mode.

Note:

After Standby its frequency can be selected between 4 possible values (1, 2, 4 or 8 MHz).

Parameters:

MSIRange

MSI range This parameter can be one of the following values: RCC_MSIRANGE_4 Range 4 around 1 MHz RCC_MSIRANGE_5 Range 5 around 2 MHz RCC_MSIRANGE_6 Range 6 around 4 MHz (reset value) RCC_MSIRANGE_7 Range 7 around 8 MHz

Return values:

None

Definition at line 2403 of file stm32l4xx_hal_rcc_ex.c.

References __HAL_RCC_MSI_STANDBY_RANGE_CONFIG, assert_param, and IS_RCC_MSI_STANDBY_CLOCK_RANGE.

void HAL_RCCEx_WakeUpStopCLKConfig

(

uint32_t

WakeUpClk

)

Configure the oscillator clock source for wakeup from Stop and CSS backup clock.

Parameters:

WakeUpClk

Wakeup clock This parameter can be one of the following values: RCC_STOP_WAKEUPCLOCK_MSI MSI oscillator selection RCC_STOP_WAKEUPCLOCK_HSI HSI oscillator selection

Note:

This function shall not be called after the Clock Security System on HSE has been enabled.

Return values:

None

Definition at line 2385 of file stm32l4xx_hal_rcc_ex.c.

References __HAL_RCC_WAKEUPSTOP_CLK_CONFIG, assert_param, and IS_RCC_STOP_WAKEUPCLOCK.