HAL SYSCFG Functions

General management functions

group SYSCFG_Exported_Functions_Group1

This section provides functions allowing to global functions :

Functions

void HAL_SYSCFG_SetAnalogIOSwitchSupply ( hal_syscfg_analog_switch_t analog_switch )

Set the I/O analog switch supply.

Parameters :

analog_switch – This parameter can be one of the following values:

hal_syscfg_analog_switch_t HAL_SYSCFG_GetAnalogIOSwitchSupply ( void )

Get the I/O analog switch supply.

Return values :

hal_syscfg_analog_switch_t – I/O Analog switch supply.

void HAL_SYSCFG_EnableFastModePlus ( uint32_t fast_mode_plus )

Enable the fast mode plus driving capability.

Parameters :

fast_mode_plus – This parameter can be one or a combination of the following values:

void HAL_SYSCFG_DisableFastModePlus ( uint32_t fast_mode_plus )

Disable the fast mode plus driving capability.

Parameters :

fast_mode_plus – This parameter can be one or a combination of the following values:

hal_syscfg_fast_mode_plus_status_t HAL_SYSCFG_IsEnabledFastModePlus ( uint32_t fast_mode_plus )

Check that fast mode plus driving capability is enabled.

Parameters :

fast_mode_plus – This parameter can be one of the following values:

Return values :

hal_syscfg_fast_mode_plus_status_t – Fast mode plus status

void HAL_SYSCFG_SetHSPISupplyDecouplingCapacitance ( hal_syscfg_capacitance_t capacitance )

Set the decoupling capacitance on HSPI supply.

Parameters :

capacitance – This parameter is an element of hal_syscfg_capacitance_t enumeration.

hal_syscfg_capacitance_t HAL_SYSCFG_GetHSPISupplyDecouplingCapacitance ( void )

Get the decoupling capacitance on HSPI supply.

Return values :

hal_syscfg_capacitance_t – Decoupling capacitance value.

void HAL_SYSCFG_EnableDCACHE2SRAMCacheability ( void )

Enable the cacheability of internal SRAMx by DCACHE2.

void HAL_SYSCFG_DisableDCACHE2SRAMCacheability ( void )

Disable the cacheability of internal SRAMx by DCACHE2.

hal_syscfg_dcache2_sram_status_t HAL_SYSCFG_IsEnabledDCACHE2SRAMCacheability ( void )

Check that cacheability of internal SRAMx by DCACHE2 is enabled.

Return values :

hal_syscfg_dcache2_sram_status_t – DCACHE2 SRAM capability status.

Floating point unit interrupts management functions

group SYSCFG_Exported_Functions_Group2

This section provides functions allowing to manage the floating point interrupts:

Functions

void HAL_SYSCFG_EnableFPUIT ( uint32_t floating_point )

Enable the floating point unit interrupts.

Parameters :

floating_point – This parameter can be one or a combination of the following values:

void HAL_SYSCFG_DisableFPUIT ( uint32_t floating_point )

Disable the floating point unit interrupts.

Parameters :

floating_point – This parameter can be one or a combination of the following values:

hal_syscfg_it_fpu_status_t HAL_SYSCFG_IsEnabledFPUIT ( uint32_t floating_point )

Check that floating point unit interrupts is enabled.

Parameters :

floating_point – This parameter can be one of the following values:

Return values :

hal_syscfg_it_fpu_status_t – Floating point interrupt status.

TIM break inputs management functions

group SYSCFG_Exported_Functions_Group3

This section provides functions allowing to manage the TIM break inputs:

Functions

void HAL_SYSCFG_EnableTIMBreakInputs ( uint32_t break_input )

Enable the TIM break inputs.

Note

The TIM break input deactivation can only be done by a hardware reset.

Parameters :

break_input – This parameter can be one or a combination of the following values:

hal_syscfg_tim_break_input_status_t HAL_SYSCFG_IsEnabledTIMBreakInputs ( uint32_t break_input )

Check that TIM break inputs is enabled.

Parameters :

break_input – This parameter can be one of the following values:

Return values :

hal_syscfg_tim_break_input_status_t – TIM break inputs status.

Compensation cell control functions

group SYSCFG_Exported_Functions_Group4

This section provides functions allowing to control the compensation cell:

Functions

void HAL_SYSCFG_SetConfigCompensationCellCode ( uint32_t comp_cell , hal_syscfg_ccell_code_t code_select )

Configure the compensation cell code.

Note

(*) value not defined in all devices

Parameters :
hal_syscfg_ccell_code_t HAL_SYSCFG_GetConfigCompensationCellCode ( uint32_t comp_cell )

Get the compensation cell code.

Note

(*) value not defined in all devices

Parameters :

comp_cell – This parameter can be one of the following values:

Return values :

hal_syscfg_ccell_code_t – Compensation cell code.

hal_status_t HAL_SYSCFG_EnableCompensationCell ( uint32_t comp_cell )

Enable the I/O compensation cell.

Note

(*) value not defined in all devices

Warning

Before enabling the VDDIO2 compensation cell, it is mandatory to ensure that the independent IO2 supply is enabled through the use of the HAL_PWR_EnableIndependentVddIO2Supply() function

Parameters :

comp_cell – This parameter can be one or a combination of the following values:

Return values :

hal_status_t – Compensation cell status.

void HAL_SYSCFG_DisableCompensationCell ( uint32_t comp_cell )

Disable the I/O compensation cell.

Note

(*) value not defined in all devices

Parameters :

comp_cell – This parameter can be one or a combination of the following values:

hal_syscfg_ccell_status_t HAL_SYSCFG_IsEnabledCompensationCell ( uint32_t comp_cell )

Check that I/O compensation cell is enabled.

Note

(*) value not defined in all devices

Parameters :

comp_cell – This parameter can be one of the following values:

Return values :

hal_syscfg_ccell_status_t – I/O Compensation cell status.

Compensation code management functions

group SYSCFG_Exported_Functions_Group5

This section provides functions allowing to manage backup domain write protection:

Functions

uint32_t HAL_SYSCFG_GetPMOSCompensationCellValue ( uint32_t comp_cell )

Get the PMOS compensation value.

Note

(*) value not defined in all devices

Parameters :

comp_cell – This parameter can be one of the following values:

Return values :

Returned – value of the PMOS compensation cell

uint32_t HAL_SYSCFG_GetNMOSCompensationCellValue ( uint32_t comp_cell )

Get the NMOS compensation value of selected compensation cell.

Note

(*) value not defined in all devices

Parameters :

comp_cell – This parameter can be one of the following values:

Return values :

uint32_t – Value of the NMOS compensation cell

void HAL_SYSCFG_SetxMOSCompensationCellCode ( uint32_t comp_cell , uint32_t pmos_code , uint32_t nmos_code )

Set the compensation cell code.

Note

(*) value not defined in all devices

Parameters :
void HAL_SYSCFG_GetxMOSCompensationCellCode ( uint32_t comp_cell , uint32_t * p_pmos_code , uint32_t * p_nmos_code )

Get the compensation cell code.

Note

(*) value not defined in all devices

Parameters :

  • comp_cell – This parameter can be one of the following values:

  • p_pmos_code – Pointer to PMOS register of selected compensation cell

  • p_nmos_code – Pointer to NMOS register of selected compensation cell

USB HS PHY management functions

group SYSCFG_Exported_Functions_Group6

This section provides functions allowing to manage the USB HS PHY:

Functions

void HAL_SYSCFG_EnableUSBHSPHY ( void )

Enable the USB HS PHY feature.

void HAL_SYSCFG_DisableUSBHSPHY ( void )

Disable the USB HS PHY feature.

hal_syscfg_usbhsphy_status_t HAL_SYSCFG_IsEnabledUSBHSPHY ( void )

Check that USB HS PHY is enabled.

Return values :

hal_syscfg_usbhsphy_status_t – USB HS PHY status.

void HAL_SYSCFG_EnableUSBHSPHYPowerDown ( void )

Enable the USB HS PHY Power Down control.

void HAL_SYSCFG_DisableUSBHSPHYPowerDown ( void )

Disable the USB HS PHY Power Down control.

hal_syscfg_usbhsphy_power_down_status_t HAL_SYSCFG_IsEnabledUSBHSPHYPowerDown ( void )

Check that USB HS PHY power down control is enabled.

Return values :

hal_syscfg_usbhsphy_power_down_status_t – USB HS PHY power down control status.

void HAL_SYSCFG_SetUSBHSPHYReferenceClockFrequency ( hal_syscfg_usbhsphy_frequency_t clk_frequency )

Set the USB HS PHY reference clock frequency selection.

Parameters :

clk_frequency – This parameter can be one of the following values:

hal_syscfg_usbhsphy_frequency_t HAL_SYSCFG_GetUSBHSPHYReferenceClockFrequency ( void )

Get the USB PHY reference clock frequency selection.

Return values :

hal_syscfg_usbhsphy_frequency_t – Reference clock frequency.

USB HS PHY tune management functions

group SYSCFG_Exported_Functions_Group7

This section provides functions allowing to manage backup domain write protection:

Functions

void HAL_SYSCFG_SetConfigUSBHSPHY ( hal_syscfg_disconnect_adjustment_t disconnect_threshold , hal_syscfg_squelch_adjust_t squelch_threshold , hal_syscfg_src_current_t src_current )

Set all USB HS PHY tune simultaneously.

Parameters :
void HAL_SYSCFG_GetConfigUSBHSPHY ( hal_syscfg_disconnect_adjustment_t * p_disconnect_threshold , hal_syscfg_squelch_adjust_t * p_squelch_threshold , hal_syscfg_src_current_t * p_src_current )

Get the USB HS PHY tune.

Parameters :
void HAL_SYSCFG_SetUSBHSPHYDisconnectThresholdAdjustment ( hal_syscfg_disconnect_adjustment_t disconnect_threshold )

Set the USB HS PHY disconnect threshold adjustment.

Parameters :

disconnect_threshold – This parameter can be one of the following values:

hal_syscfg_disconnect_adjustment_t HAL_SYSCFG_GetUSBHSPHYDisconnectThresholdAdjustment ( void )

Get the USB HS PHY disconnect Threshold adjustment.

Return values :

hal_syscfg_disconnect_adjustment_t – Disconnect threshold adjustment value.

void HAL_SYSCFG_SetUSBHSPHYSquelchThresholdAdjustment ( hal_syscfg_squelch_adjust_t squelch_threshold )

Adjust the voltage level for the threshold used to detect valid high speed data.

Parameters :

squelch_threshold – This parameter can be one of the following values:

hal_syscfg_squelch_adjust_t HAL_SYSCFG_GetUSBHSPHYSquelchThresholdAdjustment ( void )

Get the USB HS PHY disconnect threshold adjustment.

Return values :

hal_syscfg_squelch_adjust_t – Squelch threshold adjustment value.

void HAL_SYSCFG_SetUSBHSPHYTransmitterPreemphasisCurrent ( hal_syscfg_src_current_t src_current )

Set the USB HS PHY transmitter preemphasis Current control.

Parameters :

src_current – This parameter can be one of the following values:

hal_syscfg_src_current_t HAL_SYSCFG_GetUSBHSPHYTransmitterPreemphasisCurrent ( void )

Get the USB HS PHY transmitter preemphasis Current control.

Return values :

hal_syscfg_src_current_t – Transmitter preemphasis Current control.