Update Core¶
The update component allows your ESPHome devices to install updates from a remote source; instead of “pushing” an update to your device, the device can retrieve an update and install it on its own.
# Example configuration entry
update:
- platform: ...
Configuration variables:¶
id (Optional, ID): Manually specify the ID used for code generation. At least one of id and name must be specified.
name (Optional, string): The name of the update entity. At least one of id and name must be specified.
Note
If you have a friendly_name set for your device and you want the light to use that name, you can set
name: None
.device_class (Optional, string): The device class for the update entity. See https://www.home-assistant.io/integrations/binary_sensor/#device-class for a list of available options.
disabled_by_default (Optional, boolean): If true, then this entity should not be added to any client’s frontend (usually Home Assistant) without the user manually enabling it (via the Home Assistant UI). Defaults to
false
.entity_category (Optional, string): The category of the update entity. See https://developers.home-assistant.io/docs/core/entity/#generic-properties for a list of available options.
icon (Optional, icon): The icon to use for the update entity in the frontend.
internal (Optional, boolean): Mark this component as internal. Internal components will not be exposed to the frontend (like Home Assistant). Specifying an
id
without aname
willon_update_available (Optional, Action): An automation to perform when an update is available.
If Webserver enabled and version 3 is selected, All other options from Webserver Component.. See Webserver Version 3.
Automations¶
update.perform
Action¶
This action allows you to trigger the update entity to start the update process.
Configuration variables:
id (Required, ID): The ID of the update entity.
force_update (Optional, boolean): Perform the update even if the device is already running the same version. Defaults to
false
.
update.is_available
Condition¶
This condition checks if an update is available for the device.
Configuration variables:
id (Required, ID): The ID of the update entity.