This component allows setting up the node to go into deep sleep mode to conserve battery. More...

#include <deep_sleep_component.h>

Inheritance diagram for esphome::deep_sleep::DeepSleepComponent:

Public Member Functions
void	set_sleep_duration (uint32_t time_ms)
	Set the duration in ms the component should sleep once it's in deep sleep mode. More...

void	set_wakeup_pin (InternalGPIOPin *pin)
	Set the pin to wake up to on the ESP32 once it's in deep sleep mode. More...

void	set_wakeup_pin_mode (WakeupPinMode wakeup_pin_mode)

void	set_ext1_wakeup (Ext1Wakeup ext1_wakeup)

void	set_touch_wakeup (bool touch_wakeup)

void	set_run_duration (WakeupCauseToRunDuration wakeup_cause_to_run_duration)

void	set_run_duration (uint32_t time_ms)
	Set a duration in ms for how long the code should run before entering deep sleep mode. More...

void	setup () override

void	dump_config () override

void	loop () override

float	get_loop_priority () const override

float	get_setup_priority () const override

void	begin_sleep (bool manual=false)
	Helper to enter deep sleep mode. More...

void	prevent_deep_sleep ()

Public Member Functions inherited from esphome::Component
float	get_actual_setup_priority () const

void	set_setup_priority (float priority)

void	call ()

virtual void	on_shutdown ()

virtual void	on_safe_shutdown ()

uint32_t	get_component_state () const

virtual void	mark_failed ()
	Mark this component as failed. More...

bool	is_failed ()

virtual bool	can_proceed ()

bool	status_has_warning ()

bool	status_has_error ()

void	status_set_warning ()

void	status_set_error ()

void	status_clear_warning ()

void	status_clear_error ()

void	status_momentary_warning (const std::string &name, uint32_t length=5000)

void	status_momentary_error (const std::string &name, uint32_t length=5000)

bool	has_overridden_loop () const

void	set_component_source (const char *source)
	Set where this component was loaded from for some debug messages. More...

const char *	get_component_source () const
	Get the integration where this component was declared as a string. More...

Protected Member Functions
optional< uint32_t >	get_run_duration_ () const

Protected Member Functions inherited from esphome::Component
virtual void	call_loop ()

virtual void	call_setup ()

virtual void	call_dump_config ()

void	set_interval (const std::string &name, uint32_t interval, std::function< void()> &&f)
	Set an interval function with a unique name. More...

void	set_interval (uint32_t interval, std::function< void()> &&f)

bool	cancel_interval (const std::string &name)
	Cancel an interval function. More...

void	set_retry (const std::string &name, uint32_t initial_wait_time, uint8_t max_attempts, std::function< RetryResult()> &&f, float backoff_increase_factor=1.0f)
	Set an retry function with a unique name. More...

void	set_retry (uint32_t initial_wait_time, uint8_t max_attempts, std::function< RetryResult()> &&f, float backoff_increase_factor=1.0f)

bool	cancel_retry (const std::string &name)
	Cancel a retry function. More...

void	set_timeout (const std::string &name, uint32_t timeout, std::function< void()> &&f)
	Set a timeout function with a unique name. More...

void	set_timeout (uint32_t timeout, std::function< void()> &&f)

bool	cancel_timeout (const std::string &name)
	Cancel a timeout function. More...

void	defer (const std::string &name, std::function< void()> &&f)
	Defer a callback to the next loop() call. More...

void	defer (std::function< void()> &&f)
	Defer a callback to the next loop() call. More...

bool	cancel_defer (const std::string &name)
	Cancel a defer callback using the specified name, name must not be empty. More...

Protected Attributes
optional< uint64_t >	sleep_duration_

InternalGPIOPin *	wakeup_pin_

WakeupPinMode	wakeup_pin_mode_ {WAKEUP_PIN_MODE_IGNORE}

optional< Ext1Wakeup >	ext1_wakeup_

optional< bool >	touch_wakeup_

optional< WakeupCauseToRunDuration >	wakeup_cause_to_run_duration_

optional< uint32_t >	run_duration_

bool	next_enter_deep_sleep_ {false}

bool	prevent_ {false}

Protected Attributes inherited from esphome::Component
uint32_t	component_state_ {0x0000}
	State of this component. More...

float	setup_priority_override_ {NAN}

const char *	component_source_ = nullptr

Detailed Description

This component allows setting up the node to go into deep sleep mode to conserve battery.

To set this component up, first set when the deep sleep should trigger using set_run_cycles and set_run_duration, then set how long the deep sleep should last using set_sleep_duration and optionally on the ESP32 set_wakeup_pin.

Definition at line 56 of file deep_sleep_component.h.

Member Function Documentation

◆ begin_sleep()

void esphome::deep_sleep::DeepSleepComponent::begin_sleep ( bool manual = false )

Helper to enter deep sleep mode.

Definition at line 85 of file deep_sleep_component.cpp.

◆ dump_config()

void esphome::deep_sleep::DeepSleepComponent::dump_config ( )

overridevirtual

Reimplemented from esphome::Component.

Definition at line 46 of file deep_sleep_component.cpp.

◆ get_loop_priority()

float esphome::deep_sleep::DeepSleepComponent::get_loop_priority ( ) const

overridevirtual

Reimplemented from esphome::Component.

Definition at line 70 of file deep_sleep_component.cpp.

◆ get_run_duration_()

optional< uint32_t > esphome::deep_sleep::DeepSleepComponent::get_run_duration_ ( ) const

protected

Definition at line 16 of file deep_sleep_component.cpp.

◆ get_setup_priority()

float esphome::deep_sleep::DeepSleepComponent::get_setup_priority ( ) const

overridevirtual

Reimplemented from esphome::Component.

Definition at line 133 of file deep_sleep_component.cpp.

◆ loop()

void esphome::deep_sleep::DeepSleepComponent::loop ( )

overridevirtual

Reimplemented from esphome::Component.

Definition at line 66 of file deep_sleep_component.cpp.

◆ prevent_deep_sleep()

void esphome::deep_sleep::DeepSleepComponent::prevent_deep_sleep ( )

Definition at line 134 of file deep_sleep_component.cpp.

◆ set_ext1_wakeup()

void esphome::deep_sleep::DeepSleepComponent::set_ext1_wakeup ( Ext1Wakeup ext1_wakeup )

Definition at line 78 of file deep_sleep_component.cpp.

◆ set_run_duration() [1/2]

void esphome::deep_sleep::DeepSleepComponent::set_run_duration ( WakeupCauseToRunDuration wakeup_cause_to_run_duration )

Definition at line 80 of file deep_sleep_component.cpp.

◆ set_run_duration() [2/2]

void esphome::deep_sleep::DeepSleepComponent::set_run_duration ( uint32_t time_ms )

Set a duration in ms for how long the code should run before entering deep sleep mode.

Definition at line 84 of file deep_sleep_component.cpp.

◆ set_sleep_duration()

void esphome::deep_sleep::DeepSleepComponent::set_sleep_duration ( uint32_t time_ms )

Set the duration in ms the component should sleep once it's in deep sleep mode.

Definition at line 73 of file deep_sleep_component.cpp.

◆ set_touch_wakeup()

void esphome::deep_sleep::DeepSleepComponent::set_touch_wakeup ( bool touch_wakeup )

Definition at line 79 of file deep_sleep_component.cpp.

◆ set_wakeup_pin()

void esphome::deep_sleep::DeepSleepComponent::set_wakeup_pin ( InternalGPIOPin * pin )

inline

Set the pin to wake up to on the ESP32 once it's in deep sleep mode.

Use the inverted property to set the wakeup level.

Definition at line 64 of file deep_sleep_component.h.

◆ set_wakeup_pin_mode()

void esphome::deep_sleep::DeepSleepComponent::set_wakeup_pin_mode ( WakeupPinMode wakeup_pin_mode )

Definition at line 75 of file deep_sleep_component.cpp.

◆ setup()

void esphome::deep_sleep::DeepSleepComponent::setup ( )

overridevirtual

Reimplemented from esphome::Component.

Definition at line 34 of file deep_sleep_component.cpp.

Field Documentation

◆ ext1_wakeup_

optional<Ext1Wakeup> esphome::deep_sleep::DeepSleepComponent::ext1_wakeup_

protected

Definition at line 100 of file deep_sleep_component.h.

◆ next_enter_deep_sleep_

bool esphome::deep_sleep::DeepSleepComponent::next_enter_deep_sleep_ {false}

protected

Definition at line 105 of file deep_sleep_component.h.

◆ prevent_

bool esphome::deep_sleep::DeepSleepComponent::prevent_ {false}

protected

Definition at line 106 of file deep_sleep_component.h.

◆ run_duration_

optional<uint32_t> esphome::deep_sleep::DeepSleepComponent::run_duration_

protected

Definition at line 104 of file deep_sleep_component.h.

◆ sleep_duration_

optional<uint64_t> esphome::deep_sleep::DeepSleepComponent::sleep_duration_

protected

Definition at line 96 of file deep_sleep_component.h.

◆ touch_wakeup_

optional<bool> esphome::deep_sleep::DeepSleepComponent::touch_wakeup_

protected

Definition at line 101 of file deep_sleep_component.h.

◆ wakeup_cause_to_run_duration_

optional<WakeupCauseToRunDuration> esphome::deep_sleep::DeepSleepComponent::wakeup_cause_to_run_duration_

protected

Definition at line 102 of file deep_sleep_component.h.

◆ wakeup_pin_

InternalGPIOPin* esphome::deep_sleep::DeepSleepComponent::wakeup_pin_

protected

Definition at line 98 of file deep_sleep_component.h.

◆ wakeup_pin_mode_

WakeupPinMode esphome::deep_sleep::DeepSleepComponent::wakeup_pin_mode_ {WAKEUP_PIN_MODE_IGNORE}

protected

Definition at line 99 of file deep_sleep_component.h.

The documentation for this class was generated from the following files:

/opt/build/esphome/esphome/components/deep_sleep/deep_sleep_component.h
/opt/build/esphome/esphome/components/deep_sleep/deep_sleep_component.cpp

Public Member Functions

Protected Member Functions

Protected Attributes

Detailed Description

Member Function Documentation

◆ begin_sleep()

◆ dump_config()

◆ get_loop_priority()

◆ get_run_duration_()

◆ get_setup_priority()

◆ loop()

◆ prevent_deep_sleep()

◆ set_ext1_wakeup()

◆ set_run_duration() [1/2]

◆ set_run_duration() [2/2]

◆ set_sleep_duration()

◆ set_touch_wakeup()

◆ set_wakeup_pin()

◆ set_wakeup_pin_mode()

◆ setup()

Field Documentation

◆ ext1_wakeup_

◆ next_enter_deep_sleep_

◆ prevent_

◆ run_duration_

◆ sleep_duration_

◆ touch_wakeup_

◆ wakeup_cause_to_run_duration_

◆ wakeup_pin_

◆ wakeup_pin_mode_