Discourage implementing new Device Automations (#2822)

Co-authored-by: Martin Hjelmare <marhje52@gmail.com>
This commit is contained in:
Abílio Costa
2025-10-11 21:52:02 +01:00
committed by GitHub
parent 10f4b4c308
commit 04f16058aa
4 changed files with 16 additions and 0 deletions

View File

@@ -3,6 +3,10 @@ title: "Device actions"
sidebar_label: Actions sidebar_label: Actions
--- ---
:::warning
We are currently exploring alternatives to device automations. Existing device automations will continue to work but new device automations won't be accepted.
:::
Device actions allow a user to have a device do something. Examples are to turn a light on or open a door. Device actions allow a user to have a device do something. Examples are to turn a light on or open a door.
Device actions are defined as dictionaries. These dictionaries are created by your integration and are passed to your integration to create a function that performs the action. Device actions are defined as dictionaries. These dictionaries are created by your integration and are passed to your integration to create a function that performs the action.

View File

@@ -3,6 +3,10 @@ title: "Device conditions"
sidebar_label: Conditions sidebar_label: Conditions
--- ---
:::warning
We are currently exploring alternatives to device automations. Existing device automations will continue to work but new device automations won't be accepted.
:::
Device conditions allow a user to check if a certain condition is met. Examples are is a light on or is the floor wet. Device conditions allow a user to check if a certain condition is met. Examples are is a light on or is the floor wet.
Device conditions are defined as dictionaries. These dictionaries are created by your integration and are passed to your integration to create a function that checks the condition. Device conditions are defined as dictionaries. These dictionaries are created by your integration and are passed to your integration to create a function that checks the condition.

View File

@@ -3,6 +3,10 @@ title: "Device automations"
sidebar_label: Introduction sidebar_label: Introduction
--- ---
:::warning
We are currently exploring alternatives to device automations. Existing device automations will continue to work but new device automations won't be accepted.
:::
Device Automations provide users with a device-centric layer on top of the core concepts of Home Assistant. When creating automations, users no longer have to deal with core concepts like states and events. Instead, they will be able to pick a device and then pick from a list of pre-defined triggers, conditions and actions. Device Automations provide users with a device-centric layer on top of the core concepts of Home Assistant. When creating automations, users no longer have to deal with core concepts like states and events. Instead, they will be able to pick a device and then pick from a list of pre-defined triggers, conditions and actions.
Integrations can hook into this system by exposing functions to generate the pre-defined triggers, conditions, actions and having functions that can listen for the triggers, check the condition and execute the action. Integrations can hook into this system by exposing functions to generate the pre-defined triggers, conditions, actions and having functions that can listen for the triggers, check the condition and execute the action.

View File

@@ -3,6 +3,10 @@ title: "Device triggers"
sidebar_label: Triggers sidebar_label: Triggers
--- ---
:::warning
We are currently exploring alternatives to device automations. Existing device automations will continue to work but new device automations won't be accepted.
:::
Device triggers are automation triggers that are tied to a specific device and an event or state change. Examples are "light turned on" or "water detected". Device triggers are automation triggers that are tied to a specific device and an event or state change. Examples are "light turned on" or "water detected".
Device triggers can be provided by the integration that provides the device (e.g. ZHA, deCONZ) or the entity integrations that the device has entities with (e.g. light, switch). An example of the former is events not tied to an entity e.g. key press on a remote control or touch panel, while an example of the latter could be that a light has been turned on. Device triggers can be provided by the integration that provides the device (e.g. ZHA, deCONZ) or the entity integrations that the device has entities with (e.g. light, switch). An example of the former is events not tied to an entity e.g. key press on a remote control or touch panel, while an example of the latter could be that a light has been turned on.