Important changes to repositories hosted on mbed.com
Mbed hosted mercurial repositories are deprecated and are due to be permanently deleted in July 2026.
To keep a copy of this software download the repository Zip archive or clone locally using Mercurial.
It is also possible to export all your personal repositories from the account settings page.
HAL Control functions
[HAL Exported Functions]
HAL Control functions. More...
Functions | |
| __weak void | HAL_IncTick (void) |
| This function is called to increment a global variable "uwTick" used as application time base. | |
| __weak uint32_t | HAL_GetTick (void) |
| Provides a tick value in millisecond. | |
| __weak void | HAL_Delay (__IO uint32_t Delay) |
| This function provides accurate delay (in milliseconds) based on variable incremented. | |
| __weak void | HAL_SuspendTick (void) |
| Suspend Tick increment. | |
| __weak void | HAL_ResumeTick (void) |
| Resume Tick increment. | |
| uint32_t | HAL_GetHalVersion (void) |
| This method returns the HAL revision. | |
| uint32_t | HAL_GetREVID (void) |
| Returns the device revision identifier. | |
| uint32_t | HAL_GetDEVID (void) |
| Returns the device identifier. | |
| void | HAL_DBGMCU_EnableDBGSleepMode (void) |
| Enable the Debug Module during SLEEP mode. | |
| void | HAL_DBGMCU_DisableDBGSleepMode (void) |
| Disable the Debug Module during SLEEP mode Note: On devices STM32F10xx8 and STM32F10xxB, STM32F101xC/D/E and STM32F103xC/D/E, STM32F101xF/G and STM32F103xF/G STM32F10xx4 and STM32F10xx6 Debug registers DBGMCU_IDCODE and DBGMCU_CR are accessible only in debug mode (not accessible by the user software in normal mode). | |
| void | HAL_DBGMCU_EnableDBGStopMode (void) |
| Enable the Debug Module during STOP mode Note: On devices STM32F10xx8 and STM32F10xxB, STM32F101xC/D/E and STM32F103xC/D/E, STM32F101xF/G and STM32F103xF/G STM32F10xx4 and STM32F10xx6 Debug registers DBGMCU_IDCODE and DBGMCU_CR are accessible only in debug mode (not accessible by the user software in normal mode). | |
| void | HAL_DBGMCU_DisableDBGStopMode (void) |
| Disable the Debug Module during STOP mode Note: On devices STM32F10xx8 and STM32F10xxB, STM32F101xC/D/E and STM32F103xC/D/E, STM32F101xF/G and STM32F103xF/G STM32F10xx4 and STM32F10xx6 Debug registers DBGMCU_IDCODE and DBGMCU_CR are accessible only in debug mode (not accessible by the user software in normal mode). | |
| void | HAL_DBGMCU_EnableDBGStandbyMode (void) |
| Enable the Debug Module during STANDBY mode Note: On devices STM32F10xx8 and STM32F10xxB, STM32F101xC/D/E and STM32F103xC/D/E, STM32F101xF/G and STM32F103xF/G STM32F10xx4 and STM32F10xx6 Debug registers DBGMCU_IDCODE and DBGMCU_CR are accessible only in debug mode (not accessible by the user software in normal mode). | |
| void | HAL_DBGMCU_DisableDBGStandbyMode (void) |
| Disable the Debug Module during STANDBY mode Note: On devices STM32F10xx8 and STM32F10xxB, STM32F101xC/D/E and STM32F103xC/D/E, STM32F101xF/G and STM32F103xF/G STM32F10xx4 and STM32F10xx6 Debug registers DBGMCU_IDCODE and DBGMCU_CR are accessible only in debug mode (not accessible by the user software in normal mode). | |
Detailed Description
HAL Control functions.
===============================================================================
##### HAL Control functions #####
===============================================================================
[..] This section provides functions allowing to:
(+) Provide a tick value in millisecond
(+) Provide a blocking delay in millisecond
(+) Suspend the time base source interrupt
(+) Resume the time base source interrupt
(+) Get the HAL API driver version
(+) Get the device identifier
(+) Get the device revision identifier
(+) Enable/Disable Debug module during Sleep mode
(+) Enable/Disable Debug module during STOP mode
(+) Enable/Disable Debug module during STANDBY mode
Function Documentation
| void HAL_DBGMCU_DisableDBGSleepMode | ( | void | ) |
Disable the Debug Module during SLEEP mode Note: On devices STM32F10xx8 and STM32F10xxB, STM32F101xC/D/E and STM32F103xC/D/E, STM32F101xF/G and STM32F103xF/G STM32F10xx4 and STM32F10xx6 Debug registers DBGMCU_IDCODE and DBGMCU_CR are accessible only in debug mode (not accessible by the user software in normal mode).
Refer to errata sheet of these devices for more details.
- Return values:
-
None
Definition at line 426 of file stm32f1xx_hal.c.
| void HAL_DBGMCU_DisableDBGStandbyMode | ( | void | ) |
Disable the Debug Module during STANDBY mode Note: On devices STM32F10xx8 and STM32F10xxB, STM32F101xC/D/E and STM32F103xC/D/E, STM32F101xF/G and STM32F103xF/G STM32F10xx4 and STM32F10xx6 Debug registers DBGMCU_IDCODE and DBGMCU_CR are accessible only in debug mode (not accessible by the user software in normal mode).
Refer to errata sheet of these devices for more details.
- Return values:
-
None
Definition at line 504 of file stm32f1xx_hal.c.
| void HAL_DBGMCU_DisableDBGStopMode | ( | void | ) |
Disable the Debug Module during STOP mode Note: On devices STM32F10xx8 and STM32F10xxB, STM32F101xC/D/E and STM32F103xC/D/E, STM32F101xF/G and STM32F103xF/G STM32F10xx4 and STM32F10xx6 Debug registers DBGMCU_IDCODE and DBGMCU_CR are accessible only in debug mode (not accessible by the user software in normal mode).
Refer to errata sheet of these devices for more details.
- Return values:
-
None
Definition at line 472 of file stm32f1xx_hal.c.
| void HAL_DBGMCU_EnableDBGSleepMode | ( | void | ) |
Enable the Debug Module during SLEEP mode.
- Return values:
-
None
Definition at line 410 of file stm32f1xx_hal.c.
| void HAL_DBGMCU_EnableDBGStandbyMode | ( | void | ) |
Enable the Debug Module during STANDBY mode Note: On devices STM32F10xx8 and STM32F10xxB, STM32F101xC/D/E and STM32F103xC/D/E, STM32F101xF/G and STM32F103xF/G STM32F10xx4 and STM32F10xx6 Debug registers DBGMCU_IDCODE and DBGMCU_CR are accessible only in debug mode (not accessible by the user software in normal mode).
Refer to errata sheet of these devices for more details.
- Return values:
-
None
Definition at line 488 of file stm32f1xx_hal.c.
| void HAL_DBGMCU_EnableDBGStopMode | ( | void | ) |
Enable the Debug Module during STOP mode Note: On devices STM32F10xx8 and STM32F10xxB, STM32F101xC/D/E and STM32F103xC/D/E, STM32F101xF/G and STM32F103xF/G STM32F10xx4 and STM32F10xx6 Debug registers DBGMCU_IDCODE and DBGMCU_CR are accessible only in debug mode (not accessible by the user software in normal mode).
Refer to errata sheet of these devices for more details. Note: On all STM32F1 devices: If the system tick timer interrupt is enabled during the Stop mode debug (DBG_STOP bit set in the DBGMCU_CR register ), it will wakeup the system from Stop mode. Workaround: To debug the Stop mode, disable the system tick timer interrupt. Refer to errata sheet of these devices for more details. Note: On all STM32F1 devices: If the system tick timer interrupt is enabled during the Stop mode debug (DBG_STOP bit set in the DBGMCU_CR register ), it will wakeup the system from Stop mode. Workaround: To debug the Stop mode, disable the system tick timer interrupt. Refer to errata sheet of these devices for more details.
- Return values:
-
None
Definition at line 456 of file stm32f1xx_hal.c.
| __weak void HAL_Delay | ( | __IO uint32_t | Delay ) |
This function provides accurate delay (in milliseconds) based on variable incremented.
- Note:
- In the default implementation , SysTick timer is the source of time base. It is used to generate interrupts at regular time intervals where uwTick is incremented.
- ThiS function is declared as __weak to be overwritten in case of other implementations in user file.
- Parameters:
-
Delay,: specifies the delay time length, in milliseconds.
- Return values:
-
None
Definition at line 324 of file stm32f1xx_hal.c.
| uint32_t HAL_GetDEVID | ( | void | ) |
Returns the device identifier.
Note: On devices STM32F10xx8 and STM32F10xxB, STM32F101xC/D/E and STM32F103xC/D/E, STM32F101xF/G and STM32F103xF/G STM32F10xx4 and STM32F10xx6 Debug registers DBGMCU_IDCODE and DBGMCU_CR are accessible only in debug mode (not accessible by the user software in normal mode). Refer to errata sheet of these devices for more details.
- Return values:
-
Device identifier
Definition at line 401 of file stm32f1xx_hal.c.
| uint32_t HAL_GetHalVersion | ( | void | ) |
This method returns the HAL revision.
- Return values:
-
version,: 0xXYZR (8bits for each decimal, R for RC)
Definition at line 369 of file stm32f1xx_hal.c.
| uint32_t HAL_GetREVID | ( | void | ) |
Returns the device revision identifier.
Note: On devices STM32F10xx8 and STM32F10xxB, STM32F101xC/D/E and STM32F103xC/D/E, STM32F101xF/G and STM32F103xF/G STM32F10xx4 and STM32F10xx6 Debug registers DBGMCU_IDCODE and DBGMCU_CR are accessible only in debug mode (not accessible by the user software in normal mode). Refer to errata sheet of these devices for more details.
- Return values:
-
Device revision identifier
Definition at line 385 of file stm32f1xx_hal.c.
| __weak uint32_t HAL_GetTick | ( | void | ) |
Provides a tick value in millisecond.
- Note:
- This function is declared as __weak to be overwritten in case of other implementations in user file.
- Return values:
-
tick value
Definition at line 308 of file stm32f1xx_hal.c.
| __weak void HAL_IncTick | ( | void | ) |
This function is called to increment a global variable "uwTick" used as application time base.
- Note:
- In the default implementation, this variable is incremented each 1ms in Systick ISR.
- This function is declared as __weak to be overwritten in case of other implementations in user file.
- Return values:
-
None
Definition at line 297 of file stm32f1xx_hal.c.
| __weak void HAL_ResumeTick | ( | void | ) |
Resume Tick increment.
- Note:
- In the default implementation , SysTick timer is the source of time base. It is used to generate interrupts at regular time intervals. Once HAL_ResumeTick() is called, the the SysTick interrupt will be enabled and so Tick increment is resumed.
- This function is declared as __weak to be overwritten in case of other implementations in user file.
- Return values:
-
None
Definition at line 359 of file stm32f1xx_hal.c.
| __weak void HAL_SuspendTick | ( | void | ) |
Suspend Tick increment.
- Note:
- In the default implementation , SysTick timer is the source of time base. It is used to generate interrupts at regular time intervals. Once HAL_SuspendTick() is called, the the SysTick interrupt will be disabled and so Tick increment is suspended.
- This function is declared as __weak to be overwritten in case of other implementations in user file.
- Return values:
-
None
Definition at line 343 of file stm32f1xx_hal.c.
Generated on Tue Jul 12 2022 15:37:32 by
1.7.2