Skip to content

Settings in Home Assistant

Everything on Settings on the screen is also a Home Assistant entity. This page covers what is only in Home Assistant: the microphones, the assistants’ timing, ducking, photos and more, plus the sensors, buttons, events and actions.

Find them on the display’s page under Settings → Devices & services → ESPHome. The Entity column is the entity id Home Assistant gives each one by default, with <device> standing for your display’s name.

The entities are on sub-devices named after the display: screen, microphone, playback, camera, assistant 1 and assistant 2, voice triggers, and dashboard, landscape and portrait (Tessera).

Entity Name What it does Range Default
media_player.<device>_speaker Speaker The media player: announcements, TTS, music, volume
number.<device>_playback_music_ducking Music ducking How far music drops while the assistant listens or talks −40 to −3 dB −15 dB
select.<device>_playback_sound_machine_layer_1, select.<device>_playback_sound_machine_layer_2 Sound machine layer 1, 2 Two layers of steady sound, mixed, ducking under everything else Off, White, Pink, Brown, Rain, Ocean, Brook, Wind, Fire, Crickets, Fan, Cabin Off
volume_* Volumes The same sliders as Settings → Sound 0–100 %

See Microphones for what these do and how to tune them. Apart from Mute sound, none of them are copied by config sync.

Entity Name Range Default
number.<device>_microphone_microphone_gain Microphone gain 0–20 dB on the Smart Display 10, 8 and ThinkSmart View; 0–32 on the JBL Link View; 0–40 on the Smart Display 7 0 dB
switch.<device>_microphone_microphone_leveling Microphone leveling On, Off On
switch.<device>_microphone_noise_suppression Noise suppression On, Off On
number.<device>_microphone_room_sensitivity Room sensitivity 4–20 dB above the room 8 dB

Each assistant has its own set, on its own sub-device. N is 1 or 2.

Entity Name What it does Range Default
button.<device>_assistant_N_wake Wake Start this assistant without the wake word (button)
number.<device>_assistant_N_wake_word_sensitivity Wake word sensitivity Higher needs a clearer wake word 0.5–0.99 0.85
select.<device>_assistant_N_wake_word_tone Wake word tone The sound when it wakes Chimes, custom tones Chirp
select.<device>_assistant_N_reply_delivery Reply delivery Download the reply first, or stream it Download first, Stream Download first
number.<device>_assistant_N_reply_buffer Reply buffer How much of a streamed reply to collect before playing 0–3000 ms 650 ms
number.<device>_assistant_N_follow_up_time Follow-up time Keep listening this long after a reply, for another request without the wake word 0–30 s 0
number.<device>_assistant_N_max_listening_time Max listening time Stop listening after this long 5–60 s 15 s
number.<device>_assistant_N_max_thinking_time Max thinking time Give up waiting for Home Assistant after this long 5–300 s 90 s
number.<device>_assistant_N_recordings_kept Recordings kept Keep the last N requests’ audio, for the recordings action 0–10 0

The wake word and the Assist pipeline are picked with Home Assistant’s own selects on the same device.

Entity Name What it does Range Default
number.<device>_microphone_stop_word_sensitivity Stop word sensitivity How sure “Stop” has to be. 1 turns it off 0.5–1 0.7
sensor.<device>_last_wake_word, sensor.<device>_last_heard, sensor.<device>_last_reply The last wake word, what was heard, and the reply (sensors)
sensor.<device>_timers Timers Running timers (sensor)

The voice actions and commands have their switches on the voice triggers sub-device; see Settings on the screen.

Entity Name What it does Range Default
switch.<device>_receive_broadcasts Receive broadcasts Play broadcasts from other devices in this home On, Off On
Entity Name What it does Range Default
select.<device>_bluetooth_scanning Bluetooth scanning How much of the radio’s time the Bluetooth proxy spends scanning. Lower leaves more for Wi‑Fi and the Bluetooth speaker 9, 5, 2, 1 % 9 %
Entity Name What it does Range Default
number.<device>_screen_visualizer_lift Visualizer lift Extra gain on the microphone for the visuals only, so quiet rooms still move them 0–40 dB 10 dB
photos_* Photos Where wallpaper photos come from; see Photos and wallpaper
sensor.<device>_screen_screen_brightness Screen brightness The backlight right now (sensor)
sensor.<device>_ambient_light, sensor.<device>_proximity, binary_sensor.<device>_presence, sensor.<device>_orientation Sensors
Entity What it does
button.<device>_restart Restart LANovo
button.<device>_check_for_updates Check for an update now
button.<device>_install_selected_version Install the version picked in install_version (Other versions)
button.<device>_purge_cache, with sensor sensor.<device>_cached_data Delete cached wake word models; they download again when needed
button.<device>_screen_next_poster Show the next wallpaper photo
button.<device>_camera_reset_camera_settings Put every camera setting back to its default

CPU usage, load average, free memory and disk, ambient light, proximity, presence, orientation, microphone muted, camera covered, now playing, timers, and the call state.

Event When
update_outcome An update finished or failed
esphome.alarm_ringing, esphome.alarm_snoozed, esphome.alarm_stopped An alarm rings, is snoozed or stopped
esphome.screen_alert A Tessera alert was dismissed or a button on it tapped (action, title, screen)
esphome.echolocal_turn An assistant turn finished, with its timings

Call these as esphome.<device>_<action>, for example esphome.kitchen_show_message.

Action What it does
show_message, clear_message Show or clear a message
alarm_list, alarm_set, alarm_enable, alarm_delete, alarm_stop, alarm_snooze Alarms
tone_write, tone_rename, tone_remove Custom tones
recordings, turn_audio The kept recordings of recent requests
settings_export Every setting that can be copied to another device, with its section, title and value
settings_import Apply settings from another device: settings is JSON of domain → setting → value, the shape settings_export lists. Answers how many changed and which were skipped
call Call another device: peer is its name, video true for a video call. Replies with the reason when the call can’t be made (Intercom)
broadcast Send a broadcast: message empty to record from the microphone, or the address of an audio clip
<orientation>_show_page, _show_alert, _show_alert_choice, _dismiss_alert, _screen_message Tessera pages and alerts