This class is used to encode all control actions on a climate device. More...

#include <climate.h>

Public Member Functions
	ClimateCall (Climate *parent)

ClimateCall &	set_mode (ClimateMode mode)
	Set the mode of the climate device.

ClimateCall &	set_mode (optional< ClimateMode > mode)
	Set the mode of the climate device.

ClimateCall &	set_mode (const std::string &mode)
	Set the mode of the climate device based on a string.

ClimateCall &	set_mode (const char *mode, size_t len)
	Set the mode of the climate device based on a C string.

ClimateCall &	set_target_temperature (float target_temperature)
	Set the target temperature of the climate device.

ClimateCall &	set_target_temperature (optional< float > target_temperature)
	Set the target temperature of the climate device.

ClimateCall &	set_target_temperature_low (float target_temperature_low)
	Set the low point target temperature of the climate device.

ClimateCall &	set_target_temperature_low (optional< float > target_temperature_low)
	Set the low point target temperature of the climate device.

ClimateCall &	set_target_temperature_high (float target_temperature_high)
	Set the high point target temperature of the climate device.

ClimateCall &	set_target_temperature_high (optional< float > target_temperature_high)
	Set the high point target temperature of the climate device.

ClimateCall &	set_target_humidity (float target_humidity)
	Set the target humidity of the climate device.

ClimateCall &	set_target_humidity (optional< float > target_humidity)
	Set the target humidity of the climate device.

ClimateCall &	set_fan_mode (ClimateFanMode fan_mode)
	Set the fan mode of the climate device.

ClimateCall &	set_fan_mode (optional< ClimateFanMode > fan_mode)
	Set the fan mode of the climate device.

ClimateCall &	set_fan_mode (const std::string &fan_mode)
	Set the fan mode of the climate device based on a string.

ClimateCall &	set_fan_mode (optional< std::string > fan_mode)
	Set the fan mode of the climate device based on a string.

ClimateCall &	set_fan_mode (const char *custom_fan_mode)
	Set the custom fan mode of the climate device.

ClimateCall &	set_fan_mode (StringRef custom_fan_mode)
	Set the custom fan mode of the climate device (StringRef overload to resolve ambiguity, zero-copy).

ClimateCall &	set_fan_mode (const char *custom_fan_mode, size_t len)
	Set the custom fan mode of the climate device (zero-copy API path).

ClimateCall &	set_swing_mode (ClimateSwingMode swing_mode)
	Set the swing mode of the climate device.

ClimateCall &	set_swing_mode (optional< ClimateSwingMode > swing_mode)
	Set the swing mode of the climate device.

ClimateCall &	set_swing_mode (const std::string &swing_mode)
	Set the swing mode of the climate device based on a string.

ClimateCall &	set_swing_mode (const char *swing_mode, size_t len)
	Set the swing mode of the climate device based on a C string.

ClimateCall &	set_preset (ClimatePreset preset)
	Set the preset of the climate device.

ClimateCall &	set_preset (optional< ClimatePreset > preset)
	Set the preset of the climate device.

ClimateCall &	set_preset (const std::string &preset)
	Set the preset of the climate device based on a string.

ClimateCall &	set_preset (optional< std::string > preset)
	Set the preset of the climate device based on a string.

ClimateCall &	set_preset (const char *custom_preset)
	Set the custom preset of the climate device.

ClimateCall &	set_preset (StringRef custom_preset)
	Set the custom preset of the climate device (StringRef overload to resolve ambiguity, zero-copy).

ClimateCall &	set_preset (const char *custom_preset, size_t len)
	Set the custom preset of the climate device (zero-copy API path).

void	perform ()

const optional< float > &	get_target_temperature () const

const optional< float > &	get_target_temperature_low () const

const optional< float > &	get_target_temperature_high () const

const optional< float > &	get_target_humidity () const

const optional< ClimateMode > &	get_mode () const

const optional< ClimateFanMode > &	get_fan_mode () const

const optional< ClimateSwingMode > &	get_swing_mode () const

const optional< ClimatePreset > &	get_preset () const

StringRef	get_custom_fan_mode () const

StringRef	get_custom_preset () const

bool	has_custom_fan_mode () const

bool	has_custom_preset () const

Protected Member Functions
void	validate_ ()

Protected Attributes
Climate *const	parent_

optional< float >	target_temperature_

optional< float >	target_temperature_low_

optional< float >	target_temperature_high_

optional< float >	target_humidity_

optional< ClimateMode >	mode_

optional< ClimateFanMode >	fan_mode_

optional< ClimateSwingMode >	swing_mode_

optional< ClimatePreset >	preset_

Detailed Description

This class is used to encode all control actions on a climate device.

It is supposed to be used by all code that wishes to control a climate device (mqtt, api, lambda etc). Create an instance of this class by calling id(climate_device).make_call();. Then set all attributes with the set_x methods. Finally, to apply the changes call .perform();.

The integration that implements the climate device receives this instance with the control method. It should check all the properties it implements and apply them as needed. It should do so by getting all properties it controls with the getter methods in this class. If the optional value is set (check with .has_value()) that means the user wants to control this property. Get the value of the optional with the star operator (*call.get_mode()) and apply it.

Definition at line 31 of file climate.h.

Constructor & Destructor Documentation

◆ ClimateCall()

esphome::climate::ClimateCall::ClimateCall ( Climate * parent )

inlineexplicit

Definition at line 33 of file climate.h.

Member Function Documentation

◆ get_custom_fan_mode()

StringRef esphome::climate::ClimateCall::get_custom_fan_mode ( ) const

inline

Definition at line 124 of file climate.h.

◆ get_custom_preset()

StringRef esphome::climate::ClimateCall::get_custom_preset ( ) const

inline

Definition at line 125 of file climate.h.

◆ get_fan_mode()

const optional< ClimateFanMode > & esphome::climate::ClimateCall::get_fan_mode ( ) const

Definition at line 316 of file climate.cpp.

◆ get_mode()

const optional< ClimateMode > & esphome::climate::ClimateCall::get_mode ( ) const

Definition at line 315 of file climate.cpp.

◆ get_preset()

const optional< ClimatePreset > & esphome::climate::ClimateCall::get_preset ( ) const

Definition at line 318 of file climate.cpp.

◆ get_swing_mode()

const optional< ClimateSwingMode > & esphome::climate::ClimateCall::get_swing_mode ( ) const

Definition at line 317 of file climate.cpp.

◆ get_target_humidity()

const optional< float > & esphome::climate::ClimateCall::get_target_humidity ( ) const

Definition at line 313 of file climate.cpp.

◆ get_target_temperature()

const optional< float > & esphome::climate::ClimateCall::get_target_temperature ( ) const

Definition at line 310 of file climate.cpp.

◆ get_target_temperature_high()

const optional< float > & esphome::climate::ClimateCall::get_target_temperature_high ( ) const

Definition at line 312 of file climate.cpp.

◆ get_target_temperature_low()

const optional< float > & esphome::climate::ClimateCall::get_target_temperature_low ( ) const

Definition at line 311 of file climate.cpp.

◆ has_custom_fan_mode()

bool esphome::climate::ClimateCall::has_custom_fan_mode ( ) const

inline

Definition at line 126 of file climate.h.

◆ has_custom_preset()

bool esphome::climate::ClimateCall::has_custom_preset ( ) const

inline

Definition at line 127 of file climate.h.

◆ perform()

void esphome::climate::ClimateCall::perform ( )

Definition at line 47 of file climate.cpp.

◆ set_fan_mode() [1/7]

ClimateCall & esphome::climate::ClimateCall::set_fan_mode ( ClimateFanMode fan_mode )

Set the fan mode of the climate device.

Definition at line 190 of file climate.cpp.

◆ set_fan_mode() [2/7]

ClimateCall & esphome::climate::ClimateCall::set_fan_mode ( const char * custom_fan_mode )

Set the custom fan mode of the climate device.

Definition at line 196 of file climate.cpp.

◆ set_fan_mode() [3/7]

ClimateCall & esphome::climate::ClimateCall::set_fan_mode	(	const char *	custom_fan_mode,
		size_t	len )

Set the custom fan mode of the climate device (zero-copy API path).

Definition at line 204 of file climate.cpp.

◆ set_fan_mode() [4/7]

ClimateCall & esphome::climate::ClimateCall::set_fan_mode ( const std::string & fan_mode )

Set the fan mode of the climate device based on a string.

Definition at line 200 of file climate.cpp.

◆ set_fan_mode() [5/7]

ClimateCall & esphome::climate::ClimateCall::set_fan_mode ( optional< ClimateFanMode > fan_mode )

Set the fan mode of the climate device.

Definition at line 345 of file climate.cpp.

◆ set_fan_mode() [6/7]

ClimateCall & esphome::climate::ClimateCall::set_fan_mode ( optional< std::string > fan_mode )

Set the fan mode of the climate device based on a string.

Definition at line 222 of file climate.cpp.

◆ set_fan_mode() [7/7]

ClimateCall & esphome::climate::ClimateCall::set_fan_mode ( StringRef custom_fan_mode )

inline

Set the custom fan mode of the climate device (StringRef overload to resolve ambiguity, zero-copy).

Definition at line 83 of file climate.h.

◆ set_mode() [1/4]

ClimateCall & esphome::climate::ClimateCall::set_mode ( ClimateMode mode )

Set the mode of the climate device.

Definition at line 171 of file climate.cpp.

◆ set_mode() [2/4]

ClimateCall & esphome::climate::ClimateCall::set_mode	(	const char *	mode,
		size_t	len )

Set the mode of the climate device based on a C string.

Definition at line 178 of file climate.cpp.

◆ set_mode() [3/4]

ClimateCall & esphome::climate::ClimateCall::set_mode ( const std::string & mode )

Set the mode of the climate device based on a string.

Definition at line 176 of file climate.cpp.

◆ set_mode() [4/4]

ClimateCall & esphome::climate::ClimateCall::set_mode ( optional< ClimateMode > mode )

Set the mode of the climate device.

Definition at line 340 of file climate.cpp.

◆ set_preset() [1/7]

ClimateCall & esphome::climate::ClimateCall::set_preset ( ClimatePreset preset )

Set the preset of the climate device.

Definition at line 229 of file climate.cpp.

◆ set_preset() [2/7]

ClimateCall & esphome::climate::ClimateCall::set_preset ( const char * custom_preset )

Set the custom preset of the climate device.

Definition at line 235 of file climate.cpp.

◆ set_preset() [3/7]

ClimateCall & esphome::climate::ClimateCall::set_preset	(	const char *	custom_preset,
		size_t	len )

Set the custom preset of the climate device (zero-copy API path).

Definition at line 243 of file climate.cpp.

◆ set_preset() [4/7]

ClimateCall & esphome::climate::ClimateCall::set_preset ( const std::string & preset )

Set the preset of the climate device based on a string.

Definition at line 239 of file climate.cpp.

◆ set_preset() [5/7]

ClimateCall & esphome::climate::ClimateCall::set_preset ( optional< ClimatePreset > preset )

Set the preset of the climate device.

Definition at line 351 of file climate.cpp.

◆ set_preset() [6/7]

ClimateCall & esphome::climate::ClimateCall::set_preset ( optional< std::string > preset )

Set the preset of the climate device based on a string.

Definition at line 261 of file climate.cpp.

◆ set_preset() [7/7]

ClimateCall & esphome::climate::ClimateCall::set_preset ( StringRef custom_preset )

inline

Set the custom preset of the climate device (StringRef overload to resolve ambiguity, zero-copy).

Definition at line 107 of file climate.h.

◆ set_swing_mode() [1/4]

ClimateCall & esphome::climate::ClimateCall::set_swing_mode ( ClimateSwingMode swing_mode )

Set the swing mode of the climate device.

Definition at line 268 of file climate.cpp.

◆ set_swing_mode() [2/4]

ClimateCall & esphome::climate::ClimateCall::set_swing_mode	(	const char *	swing_mode,
		size_t	len )

Set the swing mode of the climate device based on a C string.

Definition at line 277 of file climate.cpp.

◆ set_swing_mode() [3/4]

ClimateCall & esphome::climate::ClimateCall::set_swing_mode ( const std::string & swing_mode )

Set the swing mode of the climate device based on a string.

Definition at line 273 of file climate.cpp.

◆ set_swing_mode() [4/4]

ClimateCall & esphome::climate::ClimateCall::set_swing_mode ( optional< ClimateSwingMode > swing_mode )

Set the swing mode of the climate device.

Definition at line 357 of file climate.cpp.

◆ set_target_humidity() [1/2]

ClimateCall & esphome::climate::ClimateCall::set_target_humidity ( float target_humidity )

Set the target humidity of the climate device.

Definition at line 305 of file climate.cpp.

◆ set_target_humidity() [2/2]

ClimateCall & esphome::climate::ClimateCall::set_target_humidity ( optional< float > target_humidity )

Set the target humidity of the climate device.

Definition at line 335 of file climate.cpp.

◆ set_target_temperature() [1/2]

ClimateCall & esphome::climate::ClimateCall::set_target_temperature ( float target_temperature )

Set the target temperature of the climate device.

Definition at line 290 of file climate.cpp.

◆ set_target_temperature() [2/2]

ClimateCall & esphome::climate::ClimateCall::set_target_temperature ( optional< float > target_temperature )

Set the target temperature of the climate device.

Definition at line 330 of file climate.cpp.

◆ set_target_temperature_high() [1/2]

ClimateCall & esphome::climate::ClimateCall::set_target_temperature_high ( float target_temperature_high )

Set the high point target temperature of the climate device.

For climate devices with two point target temperature control

Definition at line 300 of file climate.cpp.

◆ set_target_temperature_high() [2/2]

ClimateCall & esphome::climate::ClimateCall::set_target_temperature_high ( optional< float > target_temperature_high )

Set the high point target temperature of the climate device.

For climate devices with two point target temperature control

Definition at line 320 of file climate.cpp.

◆ set_target_temperature_low() [1/2]

ClimateCall & esphome::climate::ClimateCall::set_target_temperature_low ( float target_temperature_low )

Set the low point target temperature of the climate device.

For climate devices with two point target temperature control

Definition at line 295 of file climate.cpp.

◆ set_target_temperature_low() [2/2]

ClimateCall & esphome::climate::ClimateCall::set_target_temperature_low ( optional< float > target_temperature_low )

Set the low point target temperature of the climate device.

For climate devices with two point target temperature control

Definition at line 325 of file climate.cpp.

◆ validate_()

void esphome::climate::ClimateCall::validate_ ( )

protected

Definition at line 92 of file climate.cpp.

Field Documentation

◆ fan_mode_

optional<ClimateFanMode> esphome::climate::ClimateCall::fan_mode_

protected

Definition at line 138 of file climate.h.

◆ mode_

optional<ClimateMode> esphome::climate::ClimateCall::mode_

protected

Definition at line 137 of file climate.h.

◆ parent_

Climate* const esphome::climate::ClimateCall::parent_

protected

Definition at line 132 of file climate.h.

◆ preset_

optional<ClimatePreset> esphome::climate::ClimateCall::preset_

protected

Definition at line 140 of file climate.h.

◆ swing_mode_

optional<ClimateSwingMode> esphome::climate::ClimateCall::swing_mode_

protected

Definition at line 139 of file climate.h.

◆ target_humidity_

optional<float> esphome::climate::ClimateCall::target_humidity_

protected

Definition at line 136 of file climate.h.

◆ target_temperature_

optional<float> esphome::climate::ClimateCall::target_temperature_

protected

Definition at line 133 of file climate.h.

◆ target_temperature_high_

optional<float> esphome::climate::ClimateCall::target_temperature_high_

protected

Definition at line 135 of file climate.h.

◆ target_temperature_low_

optional<float> esphome::climate::ClimateCall::target_temperature_low_

protected

Definition at line 134 of file climate.h.

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

esphome/components/climate/climate.h
esphome/components/climate/climate.cpp

Public Member Functions

Protected Member Functions

Protected Attributes

Detailed Description

Constructor & Destructor Documentation

◆ ClimateCall()

Member Function Documentation

◆ get_custom_fan_mode()

◆ get_custom_preset()

◆ get_fan_mode()

◆ get_mode()

◆ get_preset()

◆ get_swing_mode()

◆ get_target_humidity()

◆ get_target_temperature()

◆ get_target_temperature_high()

◆ get_target_temperature_low()

◆ has_custom_fan_mode()

◆ has_custom_preset()

◆ perform()

◆ set_fan_mode() [1/7]

◆ set_fan_mode() [2/7]

◆ set_fan_mode() [3/7]

◆ set_fan_mode() [4/7]

◆ set_fan_mode() [5/7]

◆ set_fan_mode() [6/7]

◆ set_fan_mode() [7/7]

◆ set_mode() [1/4]

◆ set_mode() [2/4]

◆ set_mode() [3/4]

◆ set_mode() [4/4]

◆ set_preset() [1/7]

◆ set_preset() [2/7]

◆ set_preset() [3/7]

◆ set_preset() [4/7]

◆ set_preset() [5/7]

◆ set_preset() [6/7]

◆ set_preset() [7/7]

◆ set_swing_mode() [1/4]

◆ set_swing_mode() [2/4]

◆ set_swing_mode() [3/4]

◆ set_swing_mode() [4/4]

◆ set_target_humidity() [1/2]

◆ set_target_humidity() [2/2]

◆ set_target_temperature() [1/2]

◆ set_target_temperature() [2/2]

◆ set_target_temperature_high() [1/2]

◆ set_target_temperature_high() [2/2]

◆ set_target_temperature_low() [1/2]

◆ set_target_temperature_low() [2/2]

◆ validate_()

Field Documentation

◆ fan_mode_

◆ mode_

◆ parent_

◆ preset_

◆ swing_mode_

◆ target_humidity_

◆ target_temperature_

◆ target_temperature_high_

◆ target_temperature_low_