HAL DBGMCU How to Use ¶

group DBGMCU_How_To_Use

DBGMCU peripheral overview ¶

The DBGMCU controls the power and the clock behaviours in debug mode.

This file provides firmware functions to manage the following features:

• Get the revision identification and identification code of the device.

• Maintain the clock and power to the system debug component when in low power modes (Stop0/1/2 and Standby modes).

• Freeze and unfreeze the clock to certain peripherals when the CPU is stopped in debug mode.

How to use the DBGMCU HAL module driver ¶

The DBGMCU HAL driver can be used as follows: ¶

This module provides 3 different sets of APIs that allows to:

1. Identify the device: This feature is used to get information about the device.

   • Get the device revision:

     • This functionality is provided by HAL_DBGMCU_GetRevisionID() function.

   • Get the device identifier:

     • This functionality is provided by HAL_DBGMCU_GetDeviceID() function.

2. Debug during low power mode: Several APIs are available to debug peripherals during low power modes.

   • Enable, disable the debug module during Stop0/1/2 and Standby modes:

     • These functionalities are provided respectively by HAL_DBGMCU_EnableDebugLowPowerMode() and HAL_DBGMCU_DisableDebugLowPowerMode() functions.

   • Check if the debug module is enabled during Stop0/1/2 and Standby modes:

     • This functionality is provided by HAL_DBGMCU_IsEnabledDebugLowPowerMode() function.

3. Freeze and Unfreeze clock peripherals: The DBGMCU peripheral allows certain peripherals to be suspended in debug mode when the CPU is halted.

   • Freeze and unfreeze PPPi peripherals:

     • These functionalities are provided by HAL_DBGMCU_PPPi_Freeze() and HAL_DBGMCU_PPPi_UnFreeze() functions.