Class to display a hierarchical menu. More...

#include <lcd_menu.h>

Inheritance diagram for esphome::lcd_menu::LCDCharacterMenuComponent:

Public Member Functions
void	set_display (lcd_base::LCDDisplay *display)

void	set_dimensions (uint8_t columns, uint8_t rows)

void	set_mark_selected (uint8_t c)

void	set_mark_editing (uint8_t c)

void	set_mark_submenu (uint8_t c)

void	set_mark_back (uint8_t c)

void	setup () override

float	get_setup_priority () const override

void	dump_config () override

Public Member Functions inherited from esphome::display_menu_base::DisplayMenuComponent
void	set_root_item (MenuItemMenu *item)

void	set_active (bool active)

void	set_mode (MenuMode mode)

void	set_rows (uint8_t rows)

void	up ()

void	down ()

void	left ()

void	right ()

void	enter ()

void	show_main ()

void	show ()

void	hide ()

void	draw ()

bool	is_active () const

Public Member Functions inherited from esphome::Component
virtual void	loop ()
	This method will be called repeatedly.

float	get_actual_setup_priority () const

void	set_setup_priority (float priority)

virtual float	get_loop_priority () const
	priority of loop().

void	call ()

virtual void	on_shutdown ()

virtual void	on_safe_shutdown ()

virtual bool	teardown ()
	Called during teardown to allow component to gracefully finish operations.

virtual void	on_powerdown ()
	Called after teardown is complete to power down hardware.

uint8_t	get_component_state () const

void	reset_to_construction_state ()
	Reset this component back to the construction state to allow setup to run again.

bool	is_in_loop_state () const
	Check if this component has completed setup and is in the loop state.

virtual void	mark_failed ()
	Mark this component as failed.

void	mark_failed (const char *message)

void	disable_loop ()
	Disable this component's loop.

void	enable_loop ()
	Enable this component's loop.

void	enable_loop_soon_any_context ()
	Thread and ISR-safe version of enable_loop() that can be called from any context.

bool	is_failed () const

bool	is_ready () const

virtual bool	can_proceed ()

bool	status_has_warning () const

bool	status_has_error () const

void	status_set_warning (const char *message=nullptr)

void	status_set_warning (const LogString *message)

void	status_set_error (const char *message=nullptr)

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 LogString *source)
	Set where this component was loaded from for some debug messages.

const LogString *	get_component_log_str () const
	Get the integration where this component was declared as a LogString for logging.

bool	should_warn_of_blocking (uint32_t blocking_time)

Protected Member Functions
void	draw_item (const display_menu_base::MenuItem *item, uint8_t row, bool selected) override

void	update () override

Protected Member Functions inherited from esphome::display_menu_base::DisplayMenuComponent
void	reset_ ()

void	process_initial_ ()

bool	check_healthy_and_active_ ()

MenuItem *	get_selected_item_ ()

bool	cursor_up_ ()

bool	cursor_down_ ()

bool	enter_menu_ ()

bool	leave_menu_ ()

void	finish_editing_ ()

virtual void	draw_menu ()

virtual void	draw_and_update ()

virtual void	on_before_show ()

virtual void	on_after_show ()

virtual void	on_before_hide ()

virtual void	on_after_hide ()

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

virtual void	call_setup ()

virtual void	call_dump_config ()

void	set_component_state_ (uint8_t state)
	Helper to set component state (clears state bits and sets new state)

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

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

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

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

bool	cancel_interval (const char *name)

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

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

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

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

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

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

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

bool	cancel_timeout (const char *name)

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

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

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

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

Protected Attributes
lcd_base::LCDDisplay *	display_

uint8_t	columns_

char	mark_selected_

char	mark_editing_

char	mark_submenu_

char	mark_back_

Protected Attributes inherited from esphome::display_menu_base::DisplayMenuComponent
uint8_t	rows_

bool	active_

MenuMode	mode_

MenuItemMenu *	root_item_ {nullptr}

MenuItemMenu *	displayed_item_ {nullptr}

uint8_t	top_index_ {0}

uint8_t	cursor_index_ {0}

std::forward_list< std::pair< uint8_t, uint8_t > >	selection_stack_ {}

bool	editing_ {false}

bool	root_on_enter_called_ {false}

Protected Attributes inherited from esphome::Component
const LogString *	component_source_ {nullptr}

uint16_t	warn_if_blocking_over_ {WARN_IF_BLOCKING_OVER_MS}
	Warn if blocked for this many ms (max 65.5s)

uint8_t	component_state_ {0x00}
	State of this component - each bit has a purpose: Bits 0-2: Component state (0x00=CONSTRUCTION, 0x01=SETUP, 0x02=LOOP, 0x03=FAILED, 0x04=LOOP_DONE) Bit 3: STATUS_LED_WARNING Bit 4: STATUS_LED_ERROR Bits 5-7: Unused - reserved for future expansion.

volatile bool	pending_enable_loop_ {false}
	ISR-safe flag for enable_loop_soon_any_context.

Detailed Description

Class to display a hierarchical menu.

Definition at line 15 of file lcd_menu.h.

Member Function Documentation

◆ draw_item()

void esphome::lcd_menu::LCDCharacterMenuComponent::draw_item	(	const display_menu_base::MenuItem *	item,
		uint8_t	row,
		bool	selected )

overrideprotectedvirtual

Implements esphome::display_menu_base::DisplayMenuComponent.

Definition at line 33 of file lcd_menu.cpp.

◆ dump_config()

void esphome::lcd_menu::LCDCharacterMenuComponent::dump_config ( )

overridevirtual

Reimplemented from esphome::Component.

Definition at line 21 of file lcd_menu.cpp.

◆ get_setup_priority()

float esphome::lcd_menu::LCDCharacterMenuComponent::get_setup_priority ( ) const

overridevirtual

Reimplemented from esphome::display_menu_base::DisplayMenuComponent.

Definition at line 19 of file lcd_menu.cpp.

◆ set_dimensions()

void esphome::lcd_menu::LCDCharacterMenuComponent::set_dimensions	(	uint8_t	columns,
		uint8_t	rows )

inline

Definition at line 18 of file lcd_menu.h.

◆ set_display()

void esphome::lcd_menu::LCDCharacterMenuComponent::set_display ( lcd_base::LCDDisplay * display )

inline

Definition at line 17 of file lcd_menu.h.

◆ set_mark_back()

void esphome::lcd_menu::LCDCharacterMenuComponent::set_mark_back ( uint8_t c )

inline

Definition at line 25 of file lcd_menu.h.

◆ set_mark_editing()

void esphome::lcd_menu::LCDCharacterMenuComponent::set_mark_editing ( uint8_t c )

inline

Definition at line 23 of file lcd_menu.h.

◆ set_mark_selected()

void esphome::lcd_menu::LCDCharacterMenuComponent::set_mark_selected ( uint8_t c )

inline

Definition at line 22 of file lcd_menu.h.

◆ set_mark_submenu()

void esphome::lcd_menu::LCDCharacterMenuComponent::set_mark_submenu ( uint8_t c )

inline

Definition at line 24 of file lcd_menu.h.

◆ setup()

void esphome::lcd_menu::LCDCharacterMenuComponent::setup ( )

overridevirtual

Reimplemented from esphome::Component.

Definition at line 10 of file lcd_menu.cpp.

◆ update()

void esphome::lcd_menu::LCDCharacterMenuComponent::update ( )

inlineoverrideprotectedvirtual

Reimplemented from esphome::display_menu_base::DisplayMenuComponent.

Definition at line 34 of file lcd_menu.h.

Field Documentation

◆ columns_

uint8_t esphome::lcd_menu::LCDCharacterMenuComponent::columns_

protected

Definition at line 37 of file lcd_menu.h.

◆ display_

lcd_base::LCDDisplay* esphome::lcd_menu::LCDCharacterMenuComponent::display_

protected

Definition at line 36 of file lcd_menu.h.

◆ mark_back_

char esphome::lcd_menu::LCDCharacterMenuComponent::mark_back_

protected

Definition at line 41 of file lcd_menu.h.

◆ mark_editing_

char esphome::lcd_menu::LCDCharacterMenuComponent::mark_editing_

protected

Definition at line 39 of file lcd_menu.h.

◆ mark_selected_

char esphome::lcd_menu::LCDCharacterMenuComponent::mark_selected_

protected

Definition at line 38 of file lcd_menu.h.

◆ mark_submenu_

char esphome::lcd_menu::LCDCharacterMenuComponent::mark_submenu_

protected

Definition at line 40 of file lcd_menu.h.

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

esphome/components/lcd_menu/lcd_menu.h
esphome/components/lcd_menu/lcd_menu.cpp

Public Member Functions

Protected Member Functions

Protected Attributes

Detailed Description

Member Function Documentation

◆ draw_item()

◆ dump_config()

◆ get_setup_priority()

◆ set_dimensions()

◆ set_display()

◆ set_mark_back()

◆ set_mark_editing()

◆ set_mark_selected()

◆ set_mark_submenu()

◆ setup()

◆ update()

Field Documentation

◆ columns_

◆ display_

◆ mark_back_

◆ mark_editing_

◆ mark_selected_

◆ mark_submenu_