rt-thread-official/bsp/mm32f327x/Libraries/MM32F327x/HAL_Lib/Src/hal_pwr.c

216 lines
8.5 KiB
C

////////////////////////////////////////////////////////////////////////////////
/// @file hal_pwr.c
/// @author AE TEAM
/// @brief THIS FILE PROVIDES ALL THE PWR FIRMWARE FUNCTIONS.
////////////////////////////////////////////////////////////////////////////////
/// @attention
///
/// THE EXISTING FIRMWARE IS ONLY FOR REFERENCE, WHICH IS DESIGNED TO PROVIDE
/// CUSTOMERS WITH CODING INFORMATION ABOUT THEIR PRODUCTS SO THEY CAN SAVE
/// TIME. THEREFORE, MINDMOTION SHALL NOT BE LIABLE FOR ANY DIRECT, INDIRECT OR
/// CONSEQUENTIAL DAMAGES ABOUT ANY CLAIMS ARISING OUT OF THE CONTENT OF SUCH
/// HARDWARE AND/OR THE USE OF THE CODING INFORMATION CONTAINED HEREIN IN
/// CONNECTION WITH PRODUCTS MADE BY CUSTOMERS.
///
/// <H2><CENTER>&COPY; COPYRIGHT MINDMOTION </CENTER></H2>
////////////////////////////////////////////////////////////////////////////////
// Define to prevent recursive inclusion
#define __HAL_PWR_C_
// Files includes
#include "hal_pwr.h"
#include "hal_rcc.h"
#include "hal_syscfg.h"
////////////////////////////////////////////////////////////////////////////////
/// @addtogroup MM32_Hardware_Abstract_Layer
/// @{
////////////////////////////////////////////////////////////////////////////////
/// @addtogroup PWR_HAL
/// @{
////////////////////////////////////////////////////////////////////////////////
/// @addtogroup PWR_Exported_Functions
/// @{
////////////////////////////////////////////////////////////////////////////////
/// @brief Deinitializes the PWR peripheral registers to their default reset
/// values.
/// @param None.
/// @retval None.
////////////////////////////////////////////////////////////////////////////////
void PWR_DeInit(void)
{
exRCC_APB1PeriphReset(RCC_APB1ENR_PWR);
}
////////////////////////////////////////////////////////////////////////////////
/// @brief Enables or disables access to the RTC and backup registers.
/// @param state: new state of the access to the RTC and backup
/// registers. This parameter can be: ENABLE or DISABLE.
/// @retval None.
////////////////////////////////////////////////////////////////////////////////
void PWR_BackupAccessCmd(FunctionalState state)
{
(state) ? (RCC->BDCR |= RCC_BDCR_DBP) : (RCC->BDCR &= ~RCC_BDCR_DBP);
}
////////////////////////////////////////////////////////////////////////////////
/// @brief Enables or disables the Power Voltage Detector(PVD).
/// @param state: new state of the PVD.
/// This parameter can be: ENABLE or DISABLE.
/// @retval None.
////////////////////////////////////////////////////////////////////////////////
void PWR_PVDCmd(FunctionalState state)
{
(state) ? (SYSCFG->PDETCSR |= SYSCFG_PDETCSR_PVDE) : (SYSCFG->PDETCSR &= ~SYSCFG_PDETCSR_PVDE);
}
////////////////////////////////////////////////////////////////////////////////
/// @brief Configures the voltage threshold detected by the Power Voltage
/// Detector(PVD).
/// @param pvd_level: specifies the PVD detection level
/// This parameter can be one of the following values:
/// @arg emPVD_LEVEL0 : PVD detection level set to 1.7V
/// @arg emPVD_LEVEL1 : PVD detection level set to 2.0V
/// @arg emPVD_LEVEL2 : PVD detection level set to 2.3V
/// @arg emPVD_LEVEL3 : PVD detection level set to 2.6V
/// @arg emPVD_LEVEL4 : PVD detection level set to 2.9V
/// @arg emPVD_LEVEL5 : PVD detection level set to 3.2V
/// @arg emPVD_LEVEL6 : PVD detection level set to 3.5V
/// @arg emPVD_LEVEL7 : PVD detection level set to 3.8V
/// @arg emPVD_LEVEL8 : PVD detection level set to 4.1V
/// @arg emPVD_LEVEL9 : PVD detection level set to 4.4V
/// @arg emPVD_LEVEL10: PVD detection level set to 4.7V
/// @retval None.
////////////////////////////////////////////////////////////////////////////////
void PWR_PVDLevelConfig(emPVD_Level_Typedef pvd_level)
{
SYSCFG->PDETCSR = (SYSCFG->PDETCSR & (~SYSCFG_PDETCSR_PLS)) | pvd_level;
}
////////////////////////////////////////////////////////////////////////////////
/// @brief Enables or disables the WakeUp Pin functionality.
/// @param state: new state of the WakeUp Pin functionality.
/// This parameter can be: ENABLE or DISABLE.
/// @retval None.
////////////////////////////////////////////////////////////////////////////////
void PWR_WakeUpPinCmd(FunctionalState state)
{
(state != DISABLE) ? (PWR->CR2 |= PWR_CR2_EWUP1) : (PWR->CSR &= ~PWR_CR2_EWUP1);
}
////////////////////////////////////////////////////////////////////////////////
/// @brief Enables or disables the WakeUp Pin functionality.
/// @param state: new state of the WakeUp Pin functionality.
/// This parameter can be: ENABLE or DISABLE.
/// @retval None.
////////////////////////////////////////////////////////////////////////////////
void PWR_WakeUpPinXCmd(emWUP_Pin_Typedef pin, FunctionalState state)
{
(state != DISABLE) ? (PWR->CR2 |= (PWR_CR2_EWUP1 << pin)) : (PWR->CSR &= ~(PWR_CR2_EWUP1 << pin));
}
////////////////////////////////////////////////////////////////////////////////
/// @brief Enters STOP mode.
/// @param regulator: specifies the regulator state in STOP mode.
/// This parameter can be one of the following values:
/// @arg PWR_Regulator_ON: STOP mode with regulator ON
/// @arg PWR_Regulator_LowPower: STOP mode with regulator in low power mode.
/// @param stop_entry: specifies if STOP mode in entered with WFI or WFE
/// instruction.
/// This parameter can be one of the following values:
/// @arg PWR_STOPEntry_WFI: enter STOP mode with WFI instruction
/// @arg PWR_STOPEntry_WFE: enter STOP mode with WFE instruction
/// @retval None.
////////////////////////////////////////////////////////////////////////////////
void PWR_EnterSTOPMode(emPWR_Reg_Stop_mode_Typedef regulator, emPWR_STOP_ModeEn_Typedef stop_entry)
{
MODIFY_REG(PWR->CR, PWR_CR_LDPS, regulator);
SCB->SCR |= SCB_SCR_SLEEPDEEP_Msk;
if(stop_entry == PWR_STOPEntry_WFI) {
__WFI();
}
else {
__WFE();
}
}
////////////////////////////////////////////////////////////////////////////////
/// @brief Enters STANDBY mode.
/// @param None.
/// @retval None.
////////////////////////////////////////////////////////////////////////////////
void PWR_EnterSTANDBYMode(void)
{
PWR->CR |= PWR_CR_PDDS;
PWR->SCR |= PWR_SCR_CWUF1 | PWR_SCR_CWUF2 | PWR_SCR_CWUF3 | PWR_SCR_CWUF4 | PWR_SCR_CWUF5 | PWR_SCR_CWUF6;
SCB->SCR |= SCB_SCR_SLEEPDEEP_Msk;
#if defined(__CC_ARM)
__force_stores();
#endif
__WFI();
}
////////////////////////////////////////////////////////////////////////////////
/// @brief Checks whether the specified PWR flag is set or not.
/// @param flag: specifies the flag to check.
/// This parameter can be one of the following values:
/// @arg PWR_FLAG_WU: Wake Up flag
/// @arg PWR_FLAG_SB: StandBy flag
/// @arg PWR_FLAG_PVDO: PVD Output
/// @retval The new state of PWR_FLAG (SET or RESET).
////////////////////////////////////////////////////////////////////////////////
FlagStatus PWR_GetPVDOFlagStatus(u32 flag)
{
return (FlagStatus)(SYSCFG->PDETCSR & flag);
}
////////////////////////////////////////////////////////////////////////////////
/// @brief Clears the PWR's pending flags.
/// @param flag: specifies the flag to clear.
/// This parameter can be one of the following values:
/// @arg PWR_FLAG_WU: Wake Up flag
/// @arg PWR_FLAG_SB: StandBy flag
/// @retval None.
////////////////////////////////////////////////////////////////////////////////
void PWR_ClearPVDOFlag(u32 flag)
{
PWR->CR |= flag << 2;
}
////////////////////////////////////////////////////////////////////////////////
/// @brief Checks whether the specified PWR flag is set or not.
/// @param flag: specifies the flag to check.
/// This parameter can be one of the following values:
/// @arg PWR_FLAG_WU: Wake Up flag
/// @arg PWR_FLAG_SB: StandBy flag
/// @arg PWR_FLAG_PVDO: PVD Output
/// @retval The new state of PWR_FLAG (SET or RESET).
////////////////////////////////////////////////////////////////////////////////
FlagStatus PWR_GetFlagStatus(u32 flag)
{
return (FlagStatus)(PWR->CSR & flag);
}
////////////////////////////////////////////////////////////////////////////////
/// @brief Clears the PWR's pending flags.
/// @param flag: specifies the flag to clear.
/// This parameter can be one of the following values:
/// @arg PWR_FLAG_WU: Wake Up flag
/// @arg PWR_FLAG_SB: StandBy flag
/// @retval None.
////////////////////////////////////////////////////////////////////////////////
void PWR_ClearFlag(u32 flag)
{
PWR->CR |= flag << 2;
}
/// @}
/// @}
/// @}