HAL DBGMCU Functions

DBGMCU Device identification functions

STM32C562xx STM32C5A3xx STM32C542xx

group DBGMCU_Exported_Functions_Group1

This section provides functions to get the device identity:

• Call HAL_DBGMCU_GetRevisionID() function to get the device revision identifier.

• Call HAL_DBGMCU_GetDeviceID() function to get the device identifier.

Functions

uint32_t HAL_DBGMCU_GetRevisionID ( void )

Returns the device revision identifier.

Note

This field indicates the revision ID of the device.

• For STM32C53x/54x:

  • 0x1000: revision A

  • 0x1001: revision Z

• For STM32C55x/56x:

  • 0x1001: revision Z

  • 0x1003: revision Y

• For STM32C59x/5Ax:

  • 0x1000: revision A

  • 0x1001: revision Z

Return values :

uint32_t – Value of device revision ID.

hal_dbgmcu_device_id_t HAL_DBGMCU_GetDeviceID ( void )

Returns the device identifier.

Return values :

• HAL_DBGMCU_DEV_ID_C53X_C542 – device ID for STM32C53x/542.

• HAL_DBGMCU_DEV_ID_C55X_C562 – device ID for STM32C55x/562.

• HAL_DBGMCU_DEV_ID_C59X_C5A3 – device ID for STM32C59x/5A3.

DBGMCU Low power mode debug activation functions

STM32C562xx STM32C5A3xx STM32C542xx

group DBGMCU_Exported_Functions_Group2

This section provides functions allowing to debug peripherals during low power mode (Sleep, Stop and Standby modes):

• Call HAL_DBGMCU_EnableDebugLowPowerMode() function to enable the debug module during Sleep, Stop and Standby modes.

• Call HAL_DBGMCU_DisableDebugLowPowerMode() function to disable the debug module during Sleep, Stop and Standby modes.

• Call HAL_DBGMCU_IsEnabledDebugLowPowerMode() function to check the debug module during Sleep, Stop and Standby modes activation.

Functions

void HAL_DBGMCU_EnableDebugLowPowerMode ( uint32_t mode )

Enable the Debug Module during low power mode (Sleep, Stop and Standby modes).

Parameters :

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

• HAL_DBGMCU_SLEEP_MODE_DEBUG : Debug during Sleep mode.

• HAL_DBGMCU_STOP_MODE_DEBUG : Debug during Stop modes.

• HAL_DBGMCU_STANDBY_MODE_DEBUG : Debug during Standby mode.

• HAL_DBGMCU_LP_MODE_DEBUG_ALL : Debug during all Low power modes.

void HAL_DBGMCU_DisableDebugLowPowerMode ( uint32_t mode )

Disable the Debug Module during low power mode (Sleep, Stop and Standby modes).

Parameters :

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

• HAL_DBGMCU_SLEEP_MODE_DEBUG : Debug during Sleep mode.

• HAL_DBGMCU_STOP_MODE_DEBUG : Debug during Stop modes.

• HAL_DBGMCU_STANDBY_MODE_DEBUG : Debug during Standby mode.

• HAL_DBGMCU_LP_MODE_DEBUG_ALL : Debug during all Low power modes.

hal_dbgmcu_dbg_low_power_mode_status_t HAL_DBGMCU_IsEnabledDebugLowPowerMode ( uint32_t mode )

Check that the Debug Module during low power mode (Sleep, Stop and Standby modes) is enabled.

Parameters :

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

• HAL_DBGMCU_SLEEP_MODE_DEBUG : Debug during Sleep mode.

• HAL_DBGMCU_STOP_MODE_DEBUG : Debug during Stop modes.

• HAL_DBGMCU_STANDBY_MODE_DEBUG : Debug during Standby mode.

Return values :

hal_dbgmcu_dbg_low_power_mode_status_t – Debug in low power mode activation.

DBGMCU Peripheral clock freeze and unfreeze functions

STM32C562xx STM32C5A3xx STM32C542xx

group DBGMCU_Exported_Functions_Group3

Use these functions to freeze and unfreeze the peripheral clock when the CPU is halted:

• Call HAL_DBGMCU_PPPi_Freeze() to freeze the peripheral clock of PPPi when the CPU is halted.

• Call HAL_DBGMCU_PPPi_UnFreeze() to unfreeze the peripheral clock of PPPi when the CPU is halted.

Functions

void HAL_DBGMCU_TIM1_Freeze ( void )

Freeze the clock of TIM1 when the CPU is halted.

void HAL_DBGMCU_TIM1_UnFreeze ( void )

Unfreeze the clock of TIM1 when the CPU is halted.

void HAL_DBGMCU_TIM2_Freeze ( void )

Freeze the clock of TIM2 when the CPU is halted.

void HAL_DBGMCU_TIM2_UnFreeze ( void )

Unfreeze the clock of TIM2 when the CPU is halted.

void HAL_DBGMCU_TIM5_Freeze ( void )

Freeze the clock of TIM5 when the CPU is halted.

void HAL_DBGMCU_TIM5_UnFreeze ( void )

Unfreeze the clock of TIM5 when the CPU is halted.

void HAL_DBGMCU_TIM6_Freeze ( void )

Freeze the clock of TIM6 when the CPU is halted.

void HAL_DBGMCU_TIM6_UnFreeze ( void )

Unfreeze the clock of TIM6 when the CPU is halted.

void HAL_DBGMCU_TIM7_Freeze ( void )

Freeze the clock of TIM7 when the CPU is halted.

void HAL_DBGMCU_TIM7_UnFreeze ( void )

Unfreeze the clock of TIM7 when the CPU is halted.

void HAL_DBGMCU_TIM8_Freeze ( void )

Freeze the clock of TIM8 when the CPU is halted.

void HAL_DBGMCU_TIM8_UnFreeze ( void )

Unfreeze the clock of TIM8 when the CPU is halted.

void HAL_DBGMCU_TIM12_Freeze ( void )

Freeze the clock of TIM12 when the CPU is halted.

void HAL_DBGMCU_TIM12_UnFreeze ( void )

Unfreeze the clock of TIM12 when the CPU is halted.

void HAL_DBGMCU_TIM15_Freeze ( void )

Freeze the clock of TIM15 when the CPU is halted.

void HAL_DBGMCU_TIM15_UnFreeze ( void )

Unfreeze the clock of TIM15 when the CPU is halted.

void HAL_DBGMCU_TIM16_Freeze ( void )

Freeze the clock of TIM16 when the CPU is halted.

void HAL_DBGMCU_TIM16_UnFreeze ( void )

Unfreeze the clock of TIM16 when the CPU is halted.

void HAL_DBGMCU_TIM17_Freeze ( void )

Freeze the clock of TIM17 when the CPU is halted.

void HAL_DBGMCU_TIM17_UnFreeze ( void )

Unfreeze the clock of TIM17 when the CPU is halted.

void HAL_DBGMCU_I2C1_Freeze ( void )

Freeze the clock of I2C1 when the CPU is halted.

void HAL_DBGMCU_I2C1_UnFreeze ( void )

Unfreeze the clock of I2C1 when the CPU is halted.

void HAL_DBGMCU_I2C2_Freeze ( void )

Freeze the clock of I2C2 when the CPU is halted.

void HAL_DBGMCU_I2C2_UnFreeze ( void )

Unfreeze the clock of I2C2 when the CPU is halted.

void HAL_DBGMCU_I3C1_Freeze ( void )

Freeze the clock of I3C1 when the CPU is halted.

void HAL_DBGMCU_I3C1_UnFreeze ( void )

Unfreeze the clock of I3C1 when the CPU is halted.

void HAL_DBGMCU_WWDG_Freeze ( void )

Freeze the clock of WWDG when the CPU is halted.

void HAL_DBGMCU_WWDG_UnFreeze ( void )

Unfreeze the clock of WWDG when the CPU is halted.

void HAL_DBGMCU_IWDG_Freeze ( void )

Freeze the clock of IWDG when the CPU is halted.

void HAL_DBGMCU_IWDG_UnFreeze ( void )

Unfreeze the clock of IWDG when the CPU is halted.

void HAL_DBGMCU_RTC_Freeze ( void )

Freeze the clock of RTC when the CPU is halted.

void HAL_DBGMCU_RTC_UnFreeze ( void )

Unfreeze the clock of RTC when the CPU is halted.

void HAL_DBGMCU_LPTIM1_Freeze ( void )

Freeze the clock of LPTIM1 when the CPU is halted.

void HAL_DBGMCU_LPTIM1_UnFreeze ( void )

Unfreeze the clock of LPTIM1 when the CPU is halted.

void HAL_DBGMCU_LPDMA1_Ch0_Freeze ( void )

Freeze the clock of LPDMA1 channel 0 when the CPU is halted.

void HAL_DBGMCU_LPDMA1_Ch0_UnFreeze ( void )

Unfreeze the clock of LPDMA1 channel 0 when the CPU is halted.

void HAL_DBGMCU_LPDMA1_Ch1_Freeze ( void )

Freeze the clock of LPDMA1 channel 1 when the CPU is halted.

void HAL_DBGMCU_LPDMA1_Ch1_UnFreeze ( void )

Unfreeze the clock of LPDMA1 channel 1 when the CPU is halted.

void HAL_DBGMCU_LPDMA1_Ch2_Freeze ( void )

Freeze the clock of LPDMA1 channel 2 when the CPU is halted.

void HAL_DBGMCU_LPDMA1_Ch2_UnFreeze ( void )

Unfreeze the clock of LPDMA1 channel 2 when the CPU is halted.

void HAL_DBGMCU_LPDMA1_Ch3_Freeze ( void )

Freeze the clock of LPDMA1 channel 3 when the CPU is halted.

void HAL_DBGMCU_LPDMA1_Ch3_UnFreeze ( void )

Unfreeze the clock of LPDMA1 channel 3 when the CPU is halted.

void HAL_DBGMCU_LPDMA1_Ch4_Freeze ( void )

Freeze the clock of LPDMA1 channel 4 when the CPU is halted.

void HAL_DBGMCU_LPDMA1_Ch4_UnFreeze ( void )

Unfreeze the clock of LPDMA1 channel 4 when the CPU is halted.

void HAL_DBGMCU_LPDMA1_Ch5_Freeze ( void )

Freeze the clock of LPDMA1 channel 5 when the CPU is halted.

void HAL_DBGMCU_LPDMA1_Ch5_UnFreeze ( void )

Unfreeze the clock of LPDMA1 channel 5 when the CPU is halted.

void HAL_DBGMCU_LPDMA1_Ch6_Freeze ( void )

Freeze the clock of LPDMA1 channel 6 when the CPU is halted.

void HAL_DBGMCU_LPDMA1_Ch6_UnFreeze ( void )

Unfreeze the clock of LPDMA1 channel 6 when the CPU is halted.

void HAL_DBGMCU_LPDMA1_Ch7_Freeze ( void )

Freeze the clock of LPDMA1 channel 7 when the CPU is halted.

void HAL_DBGMCU_LPDMA1_Ch7_UnFreeze ( void )

Unfreeze the clock of LPDMA1 channel 7 when the CPU is halted.

void HAL_DBGMCU_LPDMA2_Ch0_Freeze ( void )

Freeze the clock of LPDMA2 channel 0 when the CPU is halted.

void HAL_DBGMCU_LPDMA2_Ch0_UnFreeze ( void )

Unfreeze the clock of LPDMA2 channel 0 when the CPU is halted.

void HAL_DBGMCU_LPDMA2_Ch1_Freeze ( void )

Freeze the clock of LPDMA2 channel 1 when the CPU is halted.

void HAL_DBGMCU_LPDMA2_Ch1_UnFreeze ( void )

Unfreeze the clock of LPDMA2 channel 1 when the CPU is halted.

void HAL_DBGMCU_LPDMA2_Ch2_Freeze ( void )

Freeze the clock of LPDMA2 channel 2 when the CPU is halted.

void HAL_DBGMCU_LPDMA2_Ch2_UnFreeze ( void )

Unfreeze the clock of LPDMA2 channel 2 when the CPU is halted.

void HAL_DBGMCU_LPDMA2_Ch3_Freeze ( void )

Freeze the clock of LPDMA2 channel 3 when the CPU is halted.

void HAL_DBGMCU_LPDMA2_Ch3_UnFreeze ( void )

Unfreeze the clock of LPDMA2 channel 3 when the CPU is halted.