ClimateDevice - This is the base class for all climate integrations. More...

#include <climate.h>

Inheritance diagram for esphome::climate::Climate:

Public Member Functions
	Climate ()

void	add_on_state_callback (std::function< void(Climate &)> &&callback)
	Add a callback for the climate device state, each time the state of the climate device is updated (using publish_state), this callback will be called.

void	add_on_control_callback (std::function< void(ClimateCall &)> &&callback)
	Add a callback for the climate device configuration; each time the configuration parameters of a climate device is updated (using perform() of a ClimateCall), this callback will be called, before any on_state callback.

ClimateCall	make_call ()
	Make a climate device control call, this is used to control the climate device, see the ClimateCall description for more info.

void	publish_state ()
	Publish the state of the climate device, to be called from integrations.

ClimateTraits	get_traits ()
	Get the traits of this climate device with all overrides applied.

void	set_visual_min_temperature_override (float visual_min_temperature_override)

void	set_visual_max_temperature_override (float visual_max_temperature_override)

void	set_visual_temperature_step_override (float target, float current)

void	set_visual_min_humidity_override (float visual_min_humidity_override)

void	set_visual_max_humidity_override (float visual_max_humidity_override)

bool	has_custom_fan_mode () const
	Check if a custom fan mode is currently active.

bool	has_custom_preset () const
	Check if a custom preset is currently active.

const char *	get_custom_fan_mode () const
	Get the active custom fan mode (read-only access).

const char *	get_custom_preset () const
	Get the active custom preset (read-only access).

Public Member Functions inherited from esphome::EntityBase
const StringRef &	get_name () const

void	set_name (const char *name)

bool	has_own_name () const

ESPDEPRECATED("object_id mangles names and all object_id methods are planned for removal " "(see https://github.com/esphome/backlog/issues/76). " "Now is the time to stop using object_id. If still needed, use get_object_id_to() " "which will remain available longer. get_object_id() will be removed in 2026.7.0", "2025.12.0") std void	set_object_id (const char *object_id)

void	set_name_and_object_id (const char name, const char object_id)

uint32_t	get_object_id_hash ()

StringRef	get_object_id_to (std::span< char, OBJECT_ID_MAX_LEN > buf) const
	Get object_id with zero heap allocation For static case: returns StringRef to internal storage (buffer unused) For dynamic case: formats into buffer and returns StringRef to buffer.

size_t	write_object_id_to (char *buf, size_t buf_size) const
	Write object_id directly to buffer, returns length written (excluding null) Useful for building compound strings without intermediate buffer.

bool	is_internal () const

void	set_internal (bool internal)

bool	is_disabled_by_default () const

void	set_disabled_by_default (bool disabled_by_default)

EntityCategory	get_entity_category () const

void	set_entity_category (EntityCategory entity_category)

ESPDEPRECATED("Use get_icon_ref() instead for better performance (avoids string copy). Will be removed in ESPHome 2026.5.0", "2025.11.0") std void	set_icon (const char *icon)

StringRef	get_icon_ref () const

uint32_t	get_device_id () const

void	set_device (Device *device)

bool	has_state () const

void	set_has_state (bool state)

uint32_t	get_preference_hash ()
	Get a unique hash for storing preferences/settings for this entity.

Data Fields
float	current_temperature {NAN}
	The current temperature of the climate device, as reported from the integration.

float	current_humidity {NAN}
	The current humidity of the climate device, as reported from the integration.

union {

float target_temperature
	The target temperature of the climate device. More...

struct {

float target_temperature_low {NAN}
	The minimum target temperature of the climate device, for climate devices with split target temperature. More...

float target_temperature_high {NAN}
	The maximum target temperature of the climate device, for climate devices with split target temperature. More...

}

};

float	target_humidity
	The target humidity of the climate device.

optional< ClimateFanMode >	fan_mode
	The active fan mode of the climate device.

optional< ClimatePreset >	preset
	The active preset of the climate device.

ClimateMode	mode {CLIMATE_MODE_OFF}
	The active mode of the climate device.

ClimateAction	action {CLIMATE_ACTION_OFF}
	The active state of the climate device.

ClimateSwingMode	swing_mode {CLIMATE_SWING_OFF}
	The active swing mode of the climate device.

Protected Member Functions
bool	set_fan_mode_ (ClimateFanMode mode)
	Set fan mode. Reset custom fan mode. Return true if fan mode has been changed.

bool	set_custom_fan_mode_ (const char *mode)
	Set custom fan mode. Reset primary fan mode. Return true if fan mode has been changed.

void	clear_custom_fan_mode_ ()
	Clear custom fan mode.

bool	set_preset_ (ClimatePreset preset)
	Set preset. Reset custom preset. Return true if preset has been changed.

bool	set_custom_preset_ (const char *preset)
	Set custom preset. Reset primary preset. Return true if preset has been changed.

void	clear_custom_preset_ ()
	Clear custom preset.

const char *	find_custom_fan_mode_ (const char *custom_fan_mode)
	Find and return the matching custom fan mode pointer from traits, or nullptr if not found.

const char *	find_custom_fan_mode_ (const char *custom_fan_mode, size_t len)

const char *	find_custom_preset_ (const char *custom_preset)
	Find and return the matching custom preset pointer from traits, or nullptr if not found.

const char *	find_custom_preset_ (const char *custom_preset, size_t len)

virtual ClimateTraits	traits ()=0
	Get the default traits of this climate device.

virtual void	control (const ClimateCall &call)=0
	Control the climate device, this is a virtual method that each climate integration must implement.

optional< ClimateDeviceRestoreState >	restore_state_ ()
	Restore the state of the climate device, call this from your setup() method.

void	save_state_ ()
	Internal method to save the state of the climate device to recover memory.

void	dump_traits_ (const char *tag)

Protected Member Functions inherited from esphome::EntityBase
void	calc_object_id_ ()

bool	is_object_id_dynamic_ () const
	Check if the object_id is dynamic (changes with MAC suffix)

Protected Attributes
friend	ClimateCall

LazyCallbackManager< void(Climate &)>	state_callback_ {}

LazyCallbackManager< void(ClimateCall &)>	control_callback_ {}

ESPPreferenceObject	rtc_

float	visual_min_temperature_override_ {NAN}

float	visual_max_temperature_override_ {NAN}

float	visual_target_temperature_step_override_ {NAN}

float	visual_current_temperature_step_override_ {NAN}

float	visual_min_humidity_override_ {NAN}

float	visual_max_humidity_override_ {NAN}

Protected Attributes inherited from esphome::EntityBase
StringRef	name_

const char *	object_id_c_str_ {nullptr}

const char *	icon_c_str_ {nullptr}

uint32_t	object_id_hash_ {}

Device *	device_ {}

struct esphome::EntityBase::EntityFlags	flags_

Detailed Description

ClimateDevice - This is the base class for all climate integrations.

Each integration needs to extend this class and implement two functions:

get_traits() - return the static traits of the climate device
control(ClimateDeviceCall call) - Apply the given changes from call.

To write data to the frontend, the integration must first set the properties using this->property = value; (for example this->current_temperature = 42.0;); then the integration must call this->publish_state(); to send the entire state to the frontend.

The entire state of the climate device is encoded in public properties of the base class (current_temperature, mode etc). These are read-only for the user and rw for integrations. The reason these are public is for simple access to them from lambdas if (id(my_climate).mode == climate::CLIMATE_MODE_HEAT_COOL) ...

Definition at line 181 of file climate.h.

Constructor & Destructor Documentation

◆ Climate()

esphome::climate::Climate::Climate ( )

inline

Definition at line 183 of file climate.h.

Member Function Documentation

◆ add_on_control_callback()

void esphome::climate::Climate::add_on_control_callback ( std::function< void(ClimateCall &)> && callback )

Add a callback for the climate device configuration; each time the configuration parameters of a climate device is updated (using perform() of a ClimateCall), this callback will be called, before any on_state callback.

Parameters

callback The callback to call.

Definition at line 355 of file climate.cpp.

◆ add_on_state_callback()

void esphome::climate::Climate::add_on_state_callback ( std::function< void(Climate &)> && callback )

Add a callback for the climate device state, each time the state of the climate device is updated (using publish_state), this callback will be called.

Parameters

callback The callback to call.

Definition at line 351 of file climate.cpp.

◆ clear_custom_fan_mode_()

void esphome::climate::Climate::clear_custom_fan_mode_ ( )

protected

Clear custom fan mode.

Definition at line 691 of file climate.cpp.

◆ clear_custom_preset_()

void esphome::climate::Climate::clear_custom_preset_ ( )

protected

Clear custom preset.

Definition at line 701 of file climate.cpp.

◆ control()

virtual void esphome::climate::Climate::control ( const ClimateCall & call )

protectedpure virtual

Control the climate device, this is a virtual method that each climate integration must implement.

See more info in ClimateCall. The integration should check all of its values in this method and set them accordingly. At the end of the call, the integration must call publish_state() to notify the frontend of a changed state.

Parameters

call	The ClimateCall instance encoding all attribute changes.

Implemented in esphome::anova::Anova, esphome::bang_bang::BangBangClimate, esphome::bedjet::BedJetClimate, esphome::climate_ir::ClimateIR, esphome::climate_ir_lg::LgIrClimate, esphome::coolix::CoolixClimate, esphome::daikin_arc::DaikinArcClimate, esphome::daikin_brc::DaikinBrcClimate, esphome::demo::DemoClimate, esphome::haier::HaierClimateBase, esphome::midea::ac::AirConditioner, esphome::midea_ir::MideaIR, esphome::noblex::NoblexClimate, esphome::pid::PIDClimate, esphome::thermostat::ThermostatClimate, esphome::tuya::TuyaClimate, esphome::uponor_smatrix::UponorSmatrixClimate, esphome::whirlpool::WhirlpoolClimate, esphome::whynter::Whynter, and esphome::yashima::YashimaClimate.

◆ dump_traits_()

void esphome::climate::Climate::dump_traits_ ( const char * tag )

protected

Definition at line 719 of file climate.cpp.

◆ find_custom_fan_mode_() [1/2]

const char * esphome::climate::Climate::find_custom_fan_mode_ ( const char * custom_fan_mode )

protected

Find and return the matching custom fan mode pointer from traits, or nullptr if not found.

Definition at line 703 of file climate.cpp.

◆ find_custom_fan_mode_() [2/2]

const char * esphome::climate::Climate::find_custom_fan_mode_	(	const char *	custom_fan_mode,
		size_t	len )

protected

Definition at line 707 of file climate.cpp.

◆ find_custom_preset_() [1/2]

const char * esphome::climate::Climate::find_custom_preset_ ( const char * custom_preset )

protected

Find and return the matching custom preset pointer from traits, or nullptr if not found.

Definition at line 711 of file climate.cpp.

◆ find_custom_preset_() [2/2]

const char * esphome::climate::Climate::find_custom_preset_	(	const char *	custom_preset,
		size_t	len )

protected

Definition at line 715 of file climate.cpp.

◆ get_custom_fan_mode()

const char * esphome::climate::Climate::get_custom_fan_mode ( ) const

inline

Get the active custom fan mode (read-only access).

Definition at line 270 of file climate.h.

◆ get_custom_preset()

const char * esphome::climate::Climate::get_custom_preset ( ) const

inline

Get the active custom preset (read-only access).

Definition at line 273 of file climate.h.

◆ get_traits()

ClimateTraits esphome::climate::Climate::get_traits ( )

Get the traits of this climate device with all overrides applied.

Traits are static data that encode the capabilities and static data for a climate device such as supported modes, temperature range etc.

Definition at line 487 of file climate.cpp.

◆ has_custom_fan_mode()

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

inline

Check if a custom fan mode is currently active.

Definition at line 229 of file climate.h.

◆ has_custom_preset()

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

inline

Check if a custom preset is currently active.

Definition at line 232 of file climate.h.

◆ make_call()

ClimateCall esphome::climate::Climate::make_call ( )

Make a climate device control call, this is used to control the climate device, see the ClimateCall description for more info.

Returns: A new ClimateCall instance targeting this climate device.

Definition at line 533 of file climate.cpp.

◆ publish_state()

void esphome::climate::Climate::publish_state ( )

Publish the state of the climate device, to be called from integrations.

This will schedule the climate device to publish its state to all listeners and save the current state to recover memory.

Definition at line 438 of file climate.cpp.

◆ restore_state_()

optional< ClimateDeviceRestoreState > esphome::climate::Climate::restore_state_ ( )

protected

Restore the state of the climate device, call this from your setup() method.

Definition at line 362 of file climate.cpp.

◆ save_state_()

void esphome::climate::Climate::save_state_ ( )

protected

Internal method to save the state of the climate device to recover memory.

This is automatically called from publish_state()

Definition at line 371 of file climate.cpp.

◆ set_custom_fan_mode_()

bool esphome::climate::Climate::set_custom_fan_mode_ ( const char * mode )

protected

Set custom fan mode. Reset primary fan mode. Return true if fan mode has been changed.

Definition at line 685 of file climate.cpp.

◆ set_custom_preset_()

bool esphome::climate::Climate::set_custom_preset_ ( const char * preset )

protected

Set custom preset. Reset primary preset. Return true if preset has been changed.

Definition at line 695 of file climate.cpp.

◆ set_fan_mode_()

bool esphome::climate::Climate::set_fan_mode_ ( ClimateFanMode mode )

protected

Set fan mode. Reset custom fan mode. Return true if fan mode has been changed.

Definition at line 681 of file climate.cpp.

◆ set_preset_()

bool esphome::climate::Climate::set_preset_ ( ClimatePreset preset )

protected

Set preset. Reset custom preset. Return true if preset has been changed.

Definition at line 693 of file climate.cpp.

◆ set_visual_max_humidity_override()

void esphome::climate::Climate::set_visual_max_humidity_override ( float visual_max_humidity_override )

Definition at line 528 of file climate.cpp.

◆ set_visual_max_temperature_override()

void esphome::climate::Climate::set_visual_max_temperature_override ( float visual_max_temperature_override )

Definition at line 515 of file climate.cpp.

◆ set_visual_min_humidity_override()

void esphome::climate::Climate::set_visual_min_humidity_override ( float visual_min_humidity_override )

Definition at line 524 of file climate.cpp.

◆ set_visual_min_temperature_override()

void esphome::climate::Climate::set_visual_min_temperature_override ( float visual_min_temperature_override )

Definition at line 511 of file climate.cpp.

◆ set_visual_temperature_step_override()

void esphome::climate::Climate::set_visual_temperature_step_override	(	float	target,
		float	current )

Definition at line 519 of file climate.cpp.

◆ traits()

virtual ClimateTraits esphome::climate::Climate::traits ( )

protectedpure virtual

Get the default traits of this climate device.

Traits are static data that encode the capabilities and static data for a climate device such as supported modes, temperature range etc. Each integration must implement this method and the return value must be constant during all of execution time.

Implemented in esphome::anova::Anova, esphome::bang_bang::BangBangClimate, esphome::bedjet::BedJetClimate, esphome::climate_ir::ClimateIR, esphome::daikin_arc::DaikinArcClimate, esphome::demo::DemoClimate, esphome::haier::HaierClimateBase, esphome::midea::ac::AirConditioner, esphome::mitsubishi::MitsubishiClimate, esphome::pid::PIDClimate, esphome::thermostat::ThermostatClimate, esphome::tuya::TuyaClimate, esphome::uponor_smatrix::UponorSmatrixClimate, and esphome::yashima::YashimaClimate.

Field Documentation

◆ [union]

union { ... } esphome::climate::Climate

◆ action

ClimateAction esphome::climate::Climate::action {CLIMATE_ACTION_OFF}

The active state of the climate device.

Definition at line 264 of file climate.h.

◆ ClimateCall

friend esphome::climate::Climate::ClimateCall

protected

Definition at line 276 of file climate.h.

◆ control_callback_

LazyCallbackManager<void(ClimateCall &)> esphome::climate::Climate::control_callback_ {}

protected

Definition at line 330 of file climate.h.

◆ current_humidity

float esphome::climate::Climate::current_humidity {NAN}

The current humidity of the climate device, as reported from the integration.

Definition at line 238 of file climate.h.

◆ current_temperature

float esphome::climate::Climate::current_temperature {NAN}

The current temperature of the climate device, as reported from the integration.

Definition at line 235 of file climate.h.

◆ fan_mode

optional<ClimateFanMode> esphome::climate::Climate::fan_mode

The active fan mode of the climate device.

Definition at line 255 of file climate.h.

◆ mode

ClimateMode esphome::climate::Climate::mode {CLIMATE_MODE_OFF}

The active mode of the climate device.

Definition at line 261 of file climate.h.

◆ preset

optional<ClimatePreset> esphome::climate::Climate::preset

The active preset of the climate device.

Definition at line 258 of file climate.h.

◆ rtc_

ESPPreferenceObject esphome::climate::Climate::rtc_

protected

Definition at line 331 of file climate.h.

◆ state_callback_

LazyCallbackManager<void(Climate &)> esphome::climate::Climate::state_callback_ {}

protected

Definition at line 329 of file climate.h.

◆ swing_mode

ClimateSwingMode esphome::climate::Climate::swing_mode {CLIMATE_SWING_OFF}

The active swing mode of the climate device.

Definition at line 267 of file climate.h.

◆ target_humidity

float esphome::climate::Climate::target_humidity

The target humidity of the climate device.

Definition at line 252 of file climate.h.

◆ target_temperature

float esphome::climate::Climate::target_temperature

The target temperature of the climate device.

Definition at line 242 of file climate.h.

◆ target_temperature_high

float esphome::climate::Climate::target_temperature_high {NAN}

The maximum target temperature of the climate device, for climate devices with split target temperature.

Definition at line 247 of file climate.h.

◆ target_temperature_low

float esphome::climate::Climate::target_temperature_low {NAN}

The minimum target temperature of the climate device, for climate devices with split target temperature.

Definition at line 245 of file climate.h.

◆ visual_current_temperature_step_override_

float esphome::climate::Climate::visual_current_temperature_step_override_ {NAN}

protected

Definition at line 336 of file climate.h.

◆ visual_max_humidity_override_

float esphome::climate::Climate::visual_max_humidity_override_ {NAN}

protected

Definition at line 338 of file climate.h.

◆ visual_max_temperature_override_

float esphome::climate::Climate::visual_max_temperature_override_ {NAN}

protected

Definition at line 334 of file climate.h.

◆ visual_min_humidity_override_

float esphome::climate::Climate::visual_min_humidity_override_ {NAN}

protected

Definition at line 337 of file climate.h.

◆ visual_min_temperature_override_

float esphome::climate::Climate::visual_min_temperature_override_ {NAN}

protected

Definition at line 333 of file climate.h.

◆ visual_target_temperature_step_override_

float esphome::climate::Climate::visual_target_temperature_step_override_ {NAN}

protected

Definition at line 335 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

Data Fields

Protected Member Functions

Protected Attributes

Detailed Description

Constructor & Destructor Documentation

◆ Climate()

Member Function Documentation

◆ add_on_control_callback()

◆ add_on_state_callback()

◆ clear_custom_fan_mode_()

◆ clear_custom_preset_()

◆ control()

◆ dump_traits_()

◆ find_custom_fan_mode_() [1/2]

◆ find_custom_fan_mode_() [2/2]

◆ find_custom_preset_() [1/2]

◆ find_custom_preset_() [2/2]

◆ get_custom_fan_mode()

◆ get_custom_preset()

◆ get_traits()

◆ has_custom_fan_mode()

◆ has_custom_preset()

◆ make_call()

◆ publish_state()

◆ restore_state_()

◆ save_state_()

◆ set_custom_fan_mode_()

◆ set_custom_preset_()

◆ set_fan_mode_()

◆ set_preset_()

◆ set_visual_max_humidity_override()

◆ set_visual_max_temperature_override()

◆ set_visual_min_humidity_override()

◆ set_visual_min_temperature_override()

◆ set_visual_temperature_step_override()

◆ traits()

Field Documentation

◆ [union]

◆ action

◆ ClimateCall

◆ control_callback_

◆ current_humidity

◆ current_temperature

◆ fan_mode

◆ mode

◆ preset

◆ rtc_

◆ state_callback_

◆ swing_mode

◆ target_humidity

◆ target_temperature

◆ target_temperature_high

◆ target_temperature_low

◆ visual_current_temperature_step_override_

◆ visual_max_humidity_override_

◆ visual_max_temperature_override_

◆ visual_min_humidity_override_

◆ visual_min_temperature_override_

◆ visual_target_temperature_step_override_