#include <fan.h>

Inheritance diagram for esphome::fan::Fan:

Public Member Functions
FanCall	turn_on ()

FanCall	turn_off ()

FanCall	toggle ()

FanCall	make_call ()

void	add_on_state_callback (std::function< void()> &&callback)
	Register a callback that will be called each time the state changes.

void	publish_state ()

virtual FanTraits	get_traits ()=0

void	set_restore_mode (FanRestoreMode restore_mode)
	Set the restore mode of this fan.

const char *	get_preset_mode () const
	Get the current preset mode (returns pointer to string stored in traits, or nullptr if not set)

bool	has_preset_mode () const
	Check if a preset mode is currently active.

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

void	set_name (const char *name)

bool	has_own_name () const

std::string	get_object_id () const

void	set_object_id (const char *object_id)

uint32_t	get_object_id_hash ()

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
bool	state {false}
	The current on/off state of the fan.

bool	oscillating {false}
	The current oscillation state of the fan.

int	speed {0}
	The current fan speed level.

FanDirection	direction {FanDirection::FORWARD}
	The current direction of the fan.

Protected Member Functions
virtual void	control (const FanCall &call)=0

optional< FanRestoreState >	restore_state_ ()

void	save_state_ ()

void	dump_traits_ (const char tag, const char prefix)

bool	set_preset_mode_ (const char *preset_mode)
	Set the preset mode (finds and stores pointer from traits). Returns true if changed.

bool	set_preset_mode_ (const std::string &preset_mode)
	Set the preset mode (finds and stores pointer from traits). Returns true if changed.

void	clear_preset_mode_ ()
	Clear the preset mode.

const char *	find_preset_mode_ (const char *preset_mode)
	Find and return the matching preset mode pointer from traits, or nullptr if not found.

Protected Member Functions inherited from esphome::EntityBase
StringRef	get_object_id_ref_for_api_ () const

void	calc_object_id_ ()

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

Protected Attributes
friend	FanCall

CallbackManager< void()>	state_callback_ {}

ESPPreferenceObject	rtc_

FanRestoreMode	restore_mode_

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

Definition at line 104 of file fan.h.

Member Function Documentation

◆ add_on_state_callback()

void esphome::fan::Fan::add_on_state_callback ( std::function< void()> && callback )

Register a callback that will be called each time the state changes.

Definition at line 166 of file fan.cpp.

◆ clear_preset_mode_()

void esphome::fan::Fan::clear_preset_mode_ ( )

protected

Clear the preset mode.

Definition at line 164 of file fan.cpp.

◆ control()

virtual void esphome::fan::Fan::control ( const FanCall & call )

protectedpure virtual

Implemented in esphome::bedjet::BedJetFan, esphome::binary::BinaryFan, esphome::copy::CopyFan, esphome::demo::DemoFan, esphome::hbridge::HBridgeFan, esphome::speed::SpeedFan, esphome::template_::TemplateFan, and esphome::tuya::TuyaFan.

◆ dump_traits_()

void esphome::fan::Fan::dump_traits_	(	const char *	tag,
		const char *	prefix )

protected

Definition at line 253 of file fan.cpp.

◆ find_preset_mode_()

const char * esphome::fan::Fan::find_preset_mode_ ( const char * preset_mode )

protected

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

Definition at line 143 of file fan.cpp.

◆ get_preset_mode()

const char * esphome::fan::Fan::get_preset_mode ( ) const

inline

Get the current preset mode (returns pointer to string stored in traits, or nullptr if not set)

Definition at line 131 of file fan.h.

◆ get_traits()

virtual FanTraits esphome::fan::Fan::get_traits ( )

pure virtual

Implemented in esphome::bedjet::BedJetFan, esphome::binary::BinaryFan, esphome::copy::CopyFan, esphome::demo::DemoFan, esphome::hbridge::HBridgeFan, esphome::speed::SpeedFan, esphome::template_::TemplateFan, and esphome::tuya::TuyaFan.

◆ has_preset_mode()

bool esphome::fan::Fan::has_preset_mode ( ) const

inline

Check if a preset mode is currently active.

Definition at line 134 of file fan.h.

◆ make_call()

FanCall esphome::fan::Fan::make_call ( )

Definition at line 141 of file fan.cpp.

◆ publish_state()

void esphome::fan::Fan::publish_state ( )

Definition at line 167 of file fan.cpp.

◆ restore_state_()

optional< FanRestoreState > esphome::fan::Fan::restore_state_ ( )

protected

Definition at line 194 of file fan.cpp.

◆ save_state_()

void esphome::fan::Fan::save_state_ ( )

protected

Definition at line 225 of file fan.cpp.

◆ set_preset_mode_() [1/2]

bool esphome::fan::Fan::set_preset_mode_ ( const char * preset_mode )

protected

Set the preset mode (finds and stores pointer from traits). Returns true if changed.

Definition at line 145 of file fan.cpp.

◆ set_preset_mode_() [2/2]

bool esphome::fan::Fan::set_preset_mode_ ( const std::string & preset_mode )

protected

Set the preset mode (finds and stores pointer from traits). Returns true if changed.

Definition at line 162 of file fan.cpp.

◆ set_restore_mode()

void esphome::fan::Fan::set_restore_mode ( FanRestoreMode restore_mode )

inline

Set the restore mode of this fan.

Definition at line 128 of file fan.h.

◆ toggle()

FanCall esphome::fan::Fan::toggle ( )

Definition at line 140 of file fan.cpp.

◆ turn_off()

FanCall esphome::fan::Fan::turn_off ( )

Definition at line 139 of file fan.cpp.

◆ turn_on()

FanCall esphome::fan::Fan::turn_on ( )

Definition at line 138 of file fan.cpp.

Field Documentation

◆ direction

FanDirection esphome::fan::Fan::direction {FanDirection::FORWARD}

The current direction of the fan.

Definition at line 113 of file fan.h.

◆ FanCall

friend esphome::fan::Fan::FanCall

protected

Definition at line 137 of file fan.h.

◆ oscillating

bool esphome::fan::Fan::oscillating {false}

The current oscillation state of the fan.

Definition at line 109 of file fan.h.

◆ restore_mode_

FanRestoreMode esphome::fan::Fan::restore_mode_

protected

Definition at line 158 of file fan.h.

◆ rtc_

ESPPreferenceObject esphome::fan::Fan::rtc_

protected

Definition at line 157 of file fan.h.

◆ speed

int esphome::fan::Fan::speed {0}

The current fan speed level.

Definition at line 111 of file fan.h.

◆ state

bool esphome::fan::Fan::state {false}

The current on/off state of the fan.

Definition at line 107 of file fan.h.

◆ state_callback_

CallbackManager<void()> esphome::fan::Fan::state_callback_ {}

protected

Definition at line 156 of file fan.h.

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

esphome/components/fan/fan.h
esphome/components/fan/fan.cpp

Public Member Functions

Data Fields

Protected Member Functions

Protected Attributes

Detailed Description

Member Function Documentation

◆ add_on_state_callback()

◆ clear_preset_mode_()

◆ control()

◆ dump_traits_()

◆ find_preset_mode_()

◆ get_preset_mode()

◆ get_traits()

◆ has_preset_mode()

◆ make_call()

◆ publish_state()

◆ restore_state_()

◆ save_state_()

◆ set_preset_mode_() [1/2]

◆ set_preset_mode_() [2/2]

◆ set_restore_mode()

◆ toggle()

◆ turn_off()

◆ turn_on()

Field Documentation

◆ direction

◆ FanCall

◆ oscillating

◆ restore_mode_

◆ rtc_

◆ speed

◆ state

◆ state_callback_