STM32H735xx HAL User Manual
Functions
Peripherals control functions
PWREx Exported Functions

Peripherals control functions. More...

Functions

HAL_StatusTypeDef HAL_PWREx_EnableBkUpReg (void)
 Enable the Backup Regulator.
HAL_StatusTypeDef HAL_PWREx_DisableBkUpReg (void)
 Disable the Backup Regulator.
HAL_StatusTypeDef HAL_PWREx_EnableUSBReg (void)
 Enable the USB Regulator.
HAL_StatusTypeDef HAL_PWREx_DisableUSBReg (void)
 Disable the USB Regulator.
void HAL_PWREx_EnableUSBVoltageDetector (void)
 Enable the USB voltage level detector.
void HAL_PWREx_DisableUSBVoltageDetector (void)
 Disable the USB voltage level detector.
void HAL_PWREx_EnableBatteryCharging (uint32_t ResistorValue)
 Enable the Battery charging.
void HAL_PWREx_DisableBatteryCharging (void)
 Disable the Battery charging.

Detailed Description

Peripherals control functions.

 ===============================================================================
                 ##### Peripherals control functions #####
 ===============================================================================

    *** Main and Backup Regulators configuration ***
    ================================================
    [..]
      (+) The backup domain includes 4 Kbytes of backup SRAM accessible only
          from the CPU, and addressed in 32-bit, 16-bit or 8-bit mode. Its
          content is retained even in Standby or VBAT mode when the low power
          backup regulator is enabled. It can be considered as an internal
          EEPROM when VBAT is always present. You can use the
          HAL_PWREx_EnableBkUpReg() function to enable the low power backup
          regulator.
      (+) When the backup domain is supplied by VDD (analog switch connected to
          VDD) the backup SRAM is powered from VDD which replaces the VBAT power
          supply to save battery life.
      (+) The backup SRAM is not mass erased by a tamper event. It is read
          protected to prevent confidential data, such as cryptographic private
          key, from being accessed. The backup SRAM can be erased only through
          the Flash interface when a protection level change from level 1 to
          level 0 is requested.
      -@- Refer to the description of Read protection (RDP) in the Flash
          programming manual.
      (+) The main internal regulator can be configured to have a tradeoff
          between performance and power consumption when the device does not
          operate at the maximum frequency. This is done through
          HAL_PWREx_ControlVoltageScaling(VOS) function which configure the VOS
          bit in PWR_D3CR register.
      (+) The main internal regulator can be configured to operate in Low Power
          mode when the system enters STOP mode to further reduce power
          consumption.
          This is done through HAL_PWREx_ControlStopModeVoltageScaling(SVOS)
          function which configure the SVOS bit in PWR_CR1 register.
          The selected SVOS4 and SVOS5 levels add an additional startup delay
          when exiting from system Stop mode.
    -@- Refer to the product datasheets for more details.

    *** USB Regulator configuration ***
    ===================================
    [..]
      (+) The USB transceivers are supplied from a dedicated VDD33USB supply
          that can be provided either by the integrated USB regulator, or by an
          external USB supply.
      (+) The USB regulator is enabled by HAL_PWREx_EnableUSBReg() function, the
          VDD33USB is then provided from the USB regulator.
      (+) When the USB regulator is enabled, the VDD33USB supply level detector
          shall be enabled through  HAL_PWREx_EnableUSBVoltageDetector()
          function.
      (+) The USB regulator is disabled through HAL_PWREx_DisableUSBReg()
          function and VDD33USB can be provided from an external supply. In this
          case VDD33USB and VDD50USB shall be connected together.

    *** VBAT battery charging ***
    =============================
    [..]
      (+) When VDD is present, the external battery connected to VBAT can be
          charged through an internal resistance. VBAT charging can be performed
          either through a 5 KOhm resistor or through a 1.5 KOhm resistor.
      (+) VBAT charging is enabled by HAL_PWREx_EnableBatteryCharging
          (ResistorValue) function with:
       (++) ResistorValue:
        (+++) PWR_BATTERY_CHARGING_RESISTOR_5: 5 KOhm resistor.
        (+++) PWR_BATTERY_CHARGING_RESISTOR_1_5: 1.5 KOhm resistor.
      (+) VBAT charging is disabled by HAL_PWREx_DisableBatteryCharging()
          function.


Function Documentation

Disable the Battery charging.

Return values:
None.

Definition at line 1771 of file stm32h7xx_hal_pwr_ex.c.

HAL_StatusTypeDef HAL_PWREx_DisableBkUpReg ( void  )

Disable the Backup Regulator.

Return values:
HALstatus.

Definition at line 1651 of file stm32h7xx_hal_pwr_ex.c.

References __HAL_PWR_GET_FLAG, HAL_GetTick(), PWR_FLAG_BRR, and PWR_FLAG_SETTING_DELAY.

HAL_StatusTypeDef HAL_PWREx_DisableUSBReg ( void  )

Disable the USB Regulator.

Return values:
HALstatus.

Definition at line 1703 of file stm32h7xx_hal_pwr_ex.c.

References __HAL_PWR_GET_FLAG, HAL_GetTick(), PWR_FLAG_SETTING_DELAY, and PWR_FLAG_USB33RDY.

Disable the USB voltage level detector.

Return values:
None.

Definition at line 1739 of file stm32h7xx_hal_pwr_ex.c.

void HAL_PWREx_EnableBatteryCharging ( uint32_t  ResistorValue)

Enable the Battery charging.

Note:
When VDD is present, charge the external battery through an internal resistor.
Parameters:
ResistorValue: Specifies the charging resistor. This parameter can be one of the following values :
  • PWR_BATTERY_CHARGING_RESISTOR_5 : 5 KOhm resistor.
  • PWR_BATTERY_CHARGING_RESISTOR_1_5 : 1.5 KOhm resistor.
Return values:
None.

Definition at line 1755 of file stm32h7xx_hal_pwr_ex.c.

References assert_param, and IS_PWR_BATTERY_RESISTOR_SELECT.

HAL_StatusTypeDef HAL_PWREx_EnableBkUpReg ( void  )

Enable the Backup Regulator.

Return values:
HALstatus.

Definition at line 1625 of file stm32h7xx_hal_pwr_ex.c.

References __HAL_PWR_GET_FLAG, HAL_GetTick(), PWR_FLAG_BRR, and PWR_FLAG_SETTING_DELAY.

HAL_StatusTypeDef HAL_PWREx_EnableUSBReg ( void  )

Enable the USB Regulator.

Return values:
HALstatus.

Definition at line 1677 of file stm32h7xx_hal_pwr_ex.c.

References __HAL_PWR_GET_FLAG, HAL_GetTick(), PWR_FLAG_SETTING_DELAY, and PWR_FLAG_USB33RDY.

Enable the USB voltage level detector.

Return values:
None.

Definition at line 1729 of file stm32h7xx_hal_pwr_ex.c.