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 |