Skip to content

Commit 04f1605

Browse files
Discourage implementing new Device Automations (#2822)
Co-authored-by: Martin Hjelmare <[email protected]>
1 parent 10f4b4c commit 04f1605

File tree

4 files changed

+16
-0
lines changed

4 files changed

+16
-0
lines changed

docs/device_automation_action.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -3,6 +3,10 @@ title: "Device actions"
33
sidebar_label: Actions
44
---
55

6+
:::warning
7+
We are currently exploring alternatives to device automations. Existing device automations will continue to work but new device automations won't be accepted.
8+
:::
9+
610
Device actions allow a user to have a device do something. Examples are to turn a light on or open a door.
711

812
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.

docs/device_automation_condition.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -3,6 +3,10 @@ title: "Device conditions"
33
sidebar_label: Conditions
44
---
55

6+
:::warning
7+
We are currently exploring alternatives to device automations. Existing device automations will continue to work but new device automations won't be accepted.
8+
:::
9+
610
Device conditions allow a user to check if a certain condition is met. Examples are is a light on or is the floor wet.
711

812
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.

docs/device_automation_index.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -3,6 +3,10 @@ title: "Device automations"
33
sidebar_label: Introduction
44
---
55

6+
:::warning
7+
We are currently exploring alternatives to device automations. Existing device automations will continue to work but new device automations won't be accepted.
8+
:::
9+
610
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.
711

812
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.

docs/device_automation_trigger.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -3,6 +3,10 @@ title: "Device triggers"
33
sidebar_label: Triggers
44
---
55

6+
:::warning
7+
We are currently exploring alternatives to device automations. Existing device automations will continue to work but new device automations won't be accepted.
8+
:::
9+
610
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".
711

812
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.

0 commit comments

Comments
 (0)