Defined Constants and Types for the STM32F1xx PWR Control More...

Collaboration diagram for PWR Defines:

Modules
	PVD level selection

Macros
#define	PWR_CR MMIO32(POWER_CONTROL_BASE + 0x00)
	Power control register (PWR_CR) More...

#define	PWR_CSR MMIO32(POWER_CONTROL_BASE + 0x04)
	Power control/status register (PWR_CSR) More...

#define	PWR_CR_DBP (1 << 8)
	DBP: Disable backup domain write protection. More...

#define	PWR_CR_PLS_LSB 5

#define	PWR_CR_PLS_MASK (0x7 << PWR_CR_PLS_LSB)

#define	PWR_CR_PVDE (1 << 4)
	PVDE: Power voltage detector enable. More...

#define	PWR_CR_CSBF (1 << 3)
	CSBF: Clear standby flag. More...

#define	PWR_CR_CWUF (1 << 2)
	CWUF: Clear wakeup flag. More...

#define	PWR_CR_PDDS (1 << 1)
	PDDS: Power down deepsleep. More...

#define	PWR_CR_LPDS (1 << 0)
	LPDS: Low-power deepsleep. More...

#define	PWR_CSR_EWUP (1 << 8)
	EWUP: Enable WKUP pin. More...

#define	PWR_CSR_PVDO (1 << 2)
	PVDO: PVD output. More...

#define	PWR_CSR_SBF (1 << 1)
	SBF: Standby flag. More...

#define	PWR_CSR_WUF (1 << 0)
	WUF: Wakeup flag. More...

Functions
void	pwr_disable_backup_domain_write_protect (void)
	Disable Backup Domain Write Protection. More...

void	pwr_enable_backup_domain_write_protect (void)
	Re-enable Backup Domain Write Protection. More...

void	pwr_enable_power_voltage_detect (uint32_t pvd_level)
	Enable Power Voltage Detector. More...

void	pwr_disable_power_voltage_detect (void)
	Disable Power Voltage Detector. More...

void	pwr_clear_standby_flag (void)
	Clear the Standby Flag. More...

void	pwr_clear_wakeup_flag (void)
	Clear the Wakeup Flag. More...

void	pwr_set_standby_mode (void)
	Set Standby Mode in Deep Sleep. More...

void	pwr_set_stop_mode (void)
	Set Stop Mode in Deep Sleep. More...

void	pwr_voltage_regulator_on_in_stop (void)
	Voltage Regulator On in Stop Mode. More...

void	pwr_voltage_regulator_low_power_in_stop (void)
	Voltage Regulator Low Power in Stop Mode. More...

void	pwr_enable_wakeup_pin (void)
	Enable Wakeup Pin. More...

void	pwr_disable_wakeup_pin (void)
	Release Wakeup Pin. More...

bool	pwr_voltage_high (void)
	Get Voltage Detector Output. More...

bool	pwr_get_standby_flag (void)
	Get Standby Flag. More...

bool	pwr_get_wakeup_flag (void)
	Get Wakeup Flag. More...

Detailed Description

Defined Constants and Types for the STM32F1xx PWR Control

Version: 1.0.0

Date: 5 December 2012

LGPL License Terms libopencm3 License

Author: © 2010 Thomas Otto tommi.nosp@m.@via.nosp@m.dmin..nosp@m.org

Macro Definition Documentation

◆ PWR_CR

#define PWR_CR MMIO32(POWER_CONTROL_BASE + 0x00)

Power control register (PWR_CR)

Definition at line 41 of file pwr_common_v1.h.

◆ PWR_CR_CSBF

#define PWR_CR_CSBF (1 << 3)

CSBF: Clear standby flag.

Definition at line 74 of file pwr_common_v1.h.

◆ PWR_CR_CWUF

#define PWR_CR_CWUF (1 << 2)

CWUF: Clear wakeup flag.

Definition at line 77 of file pwr_common_v1.h.

◆ PWR_CR_DBP

#define PWR_CR_DBP (1 << 8)

DBP: Disable backup domain write protection.

Definition at line 51 of file pwr_common_v1.h.

◆ PWR_CR_LPDS

#define PWR_CR_LPDS (1 << 0)

LPDS: Low-power deepsleep.

Definition at line 83 of file pwr_common_v1.h.

◆ PWR_CR_PDDS

#define PWR_CR_PDDS (1 << 1)

PDDS: Power down deepsleep.

Definition at line 80 of file pwr_common_v1.h.

◆ PWR_CR_PLS_LSB

#define PWR_CR_PLS_LSB 5

Definition at line 54 of file pwr_common_v1.h.

◆ PWR_CR_PLS_MASK

#define PWR_CR_PLS_MASK (0x7 << PWR_CR_PLS_LSB)

Definition at line 68 of file pwr_common_v1.h.

◆ PWR_CR_PVDE

#define PWR_CR_PVDE (1 << 4)

PVDE: Power voltage detector enable.

Definition at line 71 of file pwr_common_v1.h.

◆ PWR_CSR

#define PWR_CSR MMIO32(POWER_CONTROL_BASE + 0x04)

Power control/status register (PWR_CSR)

Definition at line 44 of file pwr_common_v1.h.

◆ PWR_CSR_EWUP

#define PWR_CSR_EWUP (1 << 8)

EWUP: Enable WKUP pin.

Definition at line 90 of file pwr_common_v1.h.

◆ PWR_CSR_PVDO

#define PWR_CSR_PVDO (1 << 2)

PVDO: PVD output.

Definition at line 95 of file pwr_common_v1.h.

◆ PWR_CSR_SBF

#define PWR_CSR_SBF (1 << 1)

SBF: Standby flag.

Definition at line 98 of file pwr_common_v1.h.

◆ PWR_CSR_WUF

#define PWR_CSR_WUF (1 << 0)

WUF: Wakeup flag.

Definition at line 101 of file pwr_common_v1.h.

Function Documentation

◆ pwr_clear_standby_flag()

void pwr_clear_standby_flag ( void )

Clear the Standby Flag.

This is set when the processor returns from a standby mode.

Definition at line 86 of file pwr_common_v1.c.

References PWR_CR, and PWR_CR_CSBF.

◆ pwr_clear_wakeup_flag()

void pwr_clear_wakeup_flag ( void )

Clear the Wakeup Flag.

This is set when the processor receives a wakeup signal.

Definition at line 97 of file pwr_common_v1.c.

References PWR_CR, and PWR_CR_CWUF.

◆ pwr_disable_backup_domain_write_protect()

void pwr_disable_backup_domain_write_protect ( void )

Disable Backup Domain Write Protection.

This allows backup domain registers to be changed. These registers are write protected after a reset.

Definition at line 38 of file pwr_common_v1.c.

References PWR_CR, and PWR_CR_DBP.

Referenced by rtc_awake_from_off(), and rtc_awake_from_standby().

Here is the caller graph for this function:

◆ pwr_disable_power_voltage_detect()

void pwr_disable_power_voltage_detect ( void )

Disable Power Voltage Detector.

Definition at line 75 of file pwr_common_v1.c.

References PWR_CR.

◆ pwr_disable_wakeup_pin()

void pwr_disable_wakeup_pin ( void )

Release Wakeup Pin.

The wakeup pin is used for general purpose I/O.

Definition at line 159 of file pwr_common_v1.c.

References PWR_CSR.

◆ pwr_enable_backup_domain_write_protect()

void pwr_enable_backup_domain_write_protect ( void )

Re-enable Backup Domain Write Protection.

This protects backup domain registers from inadvertent change.

Definition at line 49 of file pwr_common_v1.c.

References PWR_CR.

◆ pwr_enable_power_voltage_detect()

void pwr_enable_power_voltage_detect ( uint32_t pvd_level )

Enable Power Voltage Detector.

This provides voltage level threshold detection. The result of detection is provided in the power voltage detector output flag (see pwr_voltage_high) or by setting the EXTI16 interrupt (see datasheet for configuration details).

Parameters

[in] pvd_level uint32_t. Taken from PVD level selection.

Definition at line 64 of file pwr_common_v1.c.

References PWR_CR, and PWR_CR_PVDE.

◆ pwr_enable_wakeup_pin()

void pwr_enable_wakeup_pin ( void )

Enable Wakeup Pin.

The wakeup pin is used for waking the processor from standby mode.

Definition at line 148 of file pwr_common_v1.c.

References PWR_CSR, and PWR_CSR_EWUP.

◆ pwr_get_standby_flag()

bool pwr_get_standby_flag ( void )

Get Standby Flag.

The standby flag is set when the processor returns from a standby state. It is cleared by software (see pwr_clear_standby_flag).

Returns: boolean: TRUE if the processor was in standby state.

Definition at line 188 of file pwr_common_v1.c.

References PWR_CSR, and PWR_CSR_SBF.

◆ pwr_get_wakeup_flag()

bool pwr_get_wakeup_flag ( void )

Get Wakeup Flag.

The wakeup flag is set when a wakeup event has been received. It is cleared by software (see pwr_clear_wakeup_flag).

Returns: boolean: TRUE if a wakeup event was received.

Definition at line 202 of file pwr_common_v1.c.

References PWR_CSR, and PWR_CSR_WUF.

◆ pwr_set_standby_mode()

void pwr_set_standby_mode ( void )

Set Standby Mode in Deep Sleep.

Definition at line 107 of file pwr_common_v1.c.

References PWR_CR, and PWR_CR_PDDS.

◆ pwr_set_stop_mode()

void pwr_set_stop_mode ( void )

Set Stop Mode in Deep Sleep.

Definition at line 117 of file pwr_common_v1.c.

References PWR_CR.

◆ pwr_voltage_high()

bool pwr_voltage_high ( void )

Get Voltage Detector Output.

The voltage detector threshold must be set when the power voltage detector is enabled, see pwr_enable_power_voltage_detect.

Returns: boolean: TRUE if the power voltage is above the preset voltage threshold.

Definition at line 174 of file pwr_common_v1.c.

References PWR_CSR, and PWR_CSR_PVDO.

◆ pwr_voltage_regulator_low_power_in_stop()

void pwr_voltage_regulator_low_power_in_stop ( void )

Voltage Regulator Low Power in Stop Mode.

Definition at line 137 of file pwr_common_v1.c.

References PWR_CR, and PWR_CR_LPDS.

◆ pwr_voltage_regulator_on_in_stop()

void pwr_voltage_regulator_on_in_stop ( void )

Voltage Regulator On in Stop Mode.

Definition at line 127 of file pwr_common_v1.c.

References PWR_CR.

Modules

Macros

Functions

Detailed Description

Macro Definition Documentation

◆ PWR_CR

◆ PWR_CR_CSBF

◆ PWR_CR_CWUF

◆ PWR_CR_DBP

◆ PWR_CR_LPDS

◆ PWR_CR_PDDS

◆ PWR_CR_PLS_LSB

◆ PWR_CR_PLS_MASK

◆ PWR_CR_PVDE

◆ PWR_CSR

◆ PWR_CSR_EWUP

◆ PWR_CSR_PVDO

◆ PWR_CSR_SBF

◆ PWR_CSR_WUF

Function Documentation

◆ pwr_clear_standby_flag()

◆ pwr_clear_wakeup_flag()

◆ pwr_disable_backup_domain_write_protect()

◆ pwr_disable_power_voltage_detect()

◆ pwr_disable_wakeup_pin()

◆ pwr_enable_backup_domain_write_protect()

◆ pwr_enable_power_voltage_detect()

◆ pwr_enable_wakeup_pin()

◆ pwr_get_standby_flag()

◆ pwr_get_wakeup_flag()

◆ pwr_set_standby_mode()

◆ pwr_set_stop_mode()

◆ pwr_voltage_high()

◆ pwr_voltage_regulator_low_power_in_stop()

◆ pwr_voltage_regulator_on_in_stop()