From 88a3a7a721f24fdf2b83eb7705a68e5f2dfbcd0e Mon Sep 17 00:00:00 2001 From: Jan Bouwhuis Date: Fri, 22 Dec 2023 12:08:37 +0100 Subject: [PATCH] Add valve platform alexa (#30414) * Add valve platform alexa * Update * tiny tweaks --------- Co-authored-by: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com> --- .../_integrations/alexa.smart_home.markdown | 37 +++++++++++++++++++ 1 file changed, 37 insertions(+) diff --git a/source/_integrations/alexa.smart_home.markdown b/source/_integrations/alexa.smart_home.markdown index 099b0f90350..850b6e6fce9 100644 --- a/source/_integrations/alexa.smart_home.markdown +++ b/source/_integrations/alexa.smart_home.markdown @@ -93,6 +93,10 @@ Steps to Integrate an Amazon Alexa Smart Home Skill with Home Assistant: - [Routines](#routines-2) - [Timer](#timer) - [Vacuum](#vacuum) + - [Valve](#valve) + - [Open/Close](#openclose) + - [Set Valve Position](#set-valve-position) + - [Stop the Valve](#stop-the-valve) - [Water heater](#water-heater) - [Set target temperature](#set-target-temperature) - [Operation Mode](#operation-mode) @@ -523,6 +527,10 @@ The following platforms are currently supported: - [Routines](#routines-2) - [Timer](#timer) - [Vacuum](#vacuum) + - [Valve](#valve) + - [Open/Close](#openclose) + - [Set Valve Position](#set-valve-position) + - [Stop the Valve](#stop-the-valve) - [Water heater](#water-heater) - [Set target temperature](#set-target-temperature) - [Operation Mode](#operation-mode) @@ -1086,6 +1094,35 @@ Support _"turn on"_ and _"turn off"_ utterances. Pause and Resume - _"Alexa, pause the vacuum."_ - _"Alexa, restart the vacuum."_ +### Valve + +Valves are not supported natively within Alexa. So within Alexa, they are represented as a device of an unknown type. + +#### Open/close + +Home Assistant configures valves with semantics that provide _"open"_ and _"close"_ utterances. + +- _"Alexa, open the water valve."_ +- _"Alexa, close the gas valve."_ + +#### Set valve position + +Valves that support a set position can be controlled using percentages. + +- _"Alexa, set the [entity name] position to thirty percent."_ +- _"Alexa, increase [entity name] position by ten percent."_ +- _"Alexa, decrease [entity name] position by twenty percent."_ + +| Locale | Friendly Name Synonyms | +| ------- | ------------------------- | +| `en-US` | _"position"_, _"opening"_ | + +Currently, Alexa only supports friendly name synonyms for the `en-US` locale. + +#### Stop the valve + +Valves that support `stop` closing or opening will have an extra toggle control that allows to stop the valve closing or opening operation. + ### Water heater Single, double, and triple set-point thermostats are supported. The temperature value from the thermostat will also be exposed at a separate [temperature sensor](#sensor).