From 083710773ab9dc50e91355a31dd2a2d999189375 Mon Sep 17 00:00:00 2001 From: Jan Bouwhuis Date: Wed, 20 Dec 2023 22:07:06 +0100 Subject: [PATCH] Add water_heater to alexa (#30400) * Add water_heater to alexa * Update source/_integrations/alexa.smart_home.markdown --------- Co-authored-by: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com> --- .../_integrations/alexa.smart_home.markdown | 164 +++++++++++------- 1 file changed, 106 insertions(+), 58 deletions(-) diff --git a/source/_integrations/alexa.smart_home.markdown b/source/_integrations/alexa.smart_home.markdown index 51ecabf6073..099b0f90350 100644 --- a/source/_integrations/alexa.smart_home.markdown +++ b/source/_integrations/alexa.smart_home.markdown @@ -7,6 +7,7 @@ ha_release: "0.54" ha_codeowners: - '@home-assistant/cloud' - '@ochlocracy' + - '@jbouwh' ha_domain: alexa --- @@ -38,18 +39,18 @@ Steps to Integrate an Amazon Alexa Smart Home Skill with Home Assistant: - [Add Code to the Lambda Function](#add-code-to-the-lambda-function) - [Test the Lambda Function](#test-the-lambda-function) - [Configure the Smart Home Service Endpoint](#configure-the-smart-home-service-endpoint) -- [Account Linking](#account-linking) +- [Account linking](#account-linking) - [Alexa Smart Home Integration Configuration](#alexa-smart-home-integration-configuration) -- [Supported Platforms](#supported-platforms) +- [Supported platforms](#supported-platforms) - [Alarm control panel](#alarm-control-panel) - [Arming](#arming) - [Disarming](#disarming) - [Alert, Automation, Group](#alert-automation-group) - - [Binary Sensor](#binary-sensor) + - [Binary sensor](#binary-sensor) - [Routines](#routines) - [Button, Input Button](#button-input-button) - [Routines](#routines-1) - - [Doorbell Announcement with binary\_sensor](#doorbell-announcement-with-binary_sensor) + - [Doorbell announcement with binary\_sensor](#doorbell-announcement-with-binary_sensor) - [Presence Detection with Binary Sensor](#presence-detection-with-binary-sensor) - [Camera](#camera) - [Climate](#climate) @@ -59,11 +60,11 @@ Steps to Integrate an Amazon Alexa Smart Home Skill with Home Assistant: - [Open/Close/Raise/Lower](#opencloseraiselower) - [Set Cover Position](#set-cover-position) - [Set Cover Tilt](#set-cover-tilt) - - [Garage Doors](#garage-doors) + - [Garage doors](#garage-doors) - [Event entities](#event-entities) - - [Doorbell Events](#doorbell-events) + - [Doorbell events](#doorbell-events) - [Fan](#fan) - - [Fan Speed](#fan-speed) + - [Fan speed](#fan-speed) - [Fan Preset Mode](#fan-preset-mode) - [Fan Direction](#fan-direction) - [Fan Oscillation](#fan-oscillation) @@ -92,6 +93,9 @@ Steps to Integrate an Amazon Alexa Smart Home Skill with Home Assistant: - [Routines](#routines-2) - [Timer](#timer) - [Vacuum](#vacuum) + - [Water heater](#water-heater) + - [Set target temperature](#set-target-temperature) + - [Operation Mode](#operation-mode) - [Alexa Web-Based App](#alexa-web-based-app) - [Troubleshooting](#troubleshooting) - [Debugging](#debugging) @@ -458,57 +462,73 @@ Home Assistant supports the following integrations through Alexa using a Smart H The following platforms are currently supported: -- [Alarm control panel](#alarm-control-panel) - - [Arming](#arming) - - [Disarming](#disarming) -- [Alert, Automation, Group](#alert-automation-group) -- [Binary Sensor](#binary-sensor) - - [Routines](#routines) -- [Button, Input Button](#button-input-button) - - [Routines](#routines-1) - - [Doorbell Announcement with binary\_sensor](#doorbell-announcement-with-binary_sensor) - - [Presence Detection with Binary Sensor](#presence-detection-with-binary-sensor) -- [Camera](#camera) -- [Climate](#climate) - - [Set Thermostat Temperature](#set-thermostat-temperature) - - [Thermostat Mode](#thermostat-mode) -- [Cover](#cover) - - [Open/Close/Raise/Lower](#opencloseraiselower) - - [Set Cover Position](#set-cover-position) - - [Set Cover Tilt](#set-cover-tilt) - - [Garage Doors](#garage-doors) -- [Event entities](#event-entities) - - [Doorbell Events](#doorbell-events) -- [Fan](#fan) - - [Fan Speed](#fan-speed) - - [Fan Preset Mode](#fan-preset-mode) - - [Fan Direction](#fan-direction) - - [Fan Oscillation](#fan-oscillation) -- [Humidifier](#humidifier) - - [Humidifier target humidity](#humidifier-target-humidity) - - [Humidifier Mode](#humidifier-mode) -- [Image Processing](#image-processing) - - [Presence Detection Notification](#presence-detection-notification) -- [Input Number and Number](#input-number-and-number) -- [Light](#light) - - [Brightness](#brightness) - - [Color Temperature](#color-temperature) - - [Color](#color) -- [Lock](#lock) - - [Unlocking](#unlocking) -- [Media Player](#media-player) - - [Change Channel](#change-channel) - - [Speaker Volume](#speaker-volume) - - [Equalizer Mode](#equalizer-mode) - - [Inputs](#inputs) - - [Playback State](#playback-state) -- [Scene](#scene) -- [Script](#script) -- [Sensor](#sensor) -- [Switch, Input Boolean](#switch-input-boolean) - - [Routines](#routines-2) -- [Timer](#timer) -- [Vacuum](#vacuum) +- [Requirements](#requirements) +- [Create an Amazon Alexa Smart Home Skill](#create-an-amazon-alexa-smart-home-skill) +- [Create an AWS Lambda Function](#create-an-aws-lambda-function) + - [Create an IAM Role for Lambda](#create-an-iam-role-for-lambda) + - [Add Code to the Lambda Function](#add-code-to-the-lambda-function) + - [Test the Lambda Function](#test-the-lambda-function) +- [Configure the Smart Home Service Endpoint](#configure-the-smart-home-service-endpoint) +- [Account linking](#account-linking) +- [Alexa Smart Home Integration Configuration](#alexa-smart-home-integration-configuration) +- [Supported platforms](#supported-platforms) + - [Alarm control panel](#alarm-control-panel) + - [Arming](#arming) + - [Disarming](#disarming) + - [Alert, Automation, Group](#alert-automation-group) + - [Binary sensor](#binary-sensor) + - [Routines](#routines) + - [Button, Input Button](#button-input-button) + - [Routines](#routines-1) + - [Doorbell announcement with binary\_sensor](#doorbell-announcement-with-binary_sensor) + - [Presence Detection with Binary Sensor](#presence-detection-with-binary-sensor) + - [Camera](#camera) + - [Climate](#climate) + - [Set Thermostat Temperature](#set-thermostat-temperature) + - [Thermostat Mode](#thermostat-mode) + - [Cover](#cover) + - [Open/Close/Raise/Lower](#opencloseraiselower) + - [Set Cover Position](#set-cover-position) + - [Set Cover Tilt](#set-cover-tilt) + - [Garage doors](#garage-doors) + - [Event entities](#event-entities) + - [Doorbell events](#doorbell-events) + - [Fan](#fan) + - [Fan speed](#fan-speed) + - [Fan Preset Mode](#fan-preset-mode) + - [Fan Direction](#fan-direction) + - [Fan Oscillation](#fan-oscillation) + - [Humidifier](#humidifier) + - [Humidifier target humidity](#humidifier-target-humidity) + - [Humidifier Mode](#humidifier-mode) + - [Image Processing](#image-processing) + - [Presence Detection Notification](#presence-detection-notification) + - [Input Number and Number](#input-number-and-number) + - [Light](#light) + - [Brightness](#brightness) + - [Color Temperature](#color-temperature) + - [Color](#color) + - [Lock](#lock) + - [Unlocking](#unlocking) + - [Media Player](#media-player) + - [Change Channel](#change-channel) + - [Speaker Volume](#speaker-volume) + - [Equalizer Mode](#equalizer-mode) + - [Inputs](#inputs) + - [Playback State](#playback-state) + - [Scene](#scene) + - [Script](#script) + - [Sensor](#sensor) + - [Switch, Input Boolean](#switch-input-boolean) + - [Routines](#routines-2) + - [Timer](#timer) + - [Vacuum](#vacuum) + - [Water heater](#water-heater) + - [Set target temperature](#set-target-temperature) + - [Operation Mode](#operation-mode) +- [Alexa Web-Based App](#alexa-web-based-app) +- [Troubleshooting](#troubleshooting) +- [Debugging](#debugging) ### Alarm control panel @@ -1066,6 +1086,34 @@ Support _"turn on"_ and _"turn off"_ utterances. Pause and Resume - _"Alexa, pause the vacuum."_ - _"Alexa, restart the vacuum."_ +### 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). + +#### Set target temperature + +- _"Alexa, set the boiler's target temperature to 50."_ + +You can ask Alexa about the current temperature and current target temperature. + +- _"Alexa, what is the boiler's target temperature?"_ +- _"Alexa, what is the boiler's current temperature?"_ + +#### Operation Mode + +The operation mode can be set from the UI. All Home Assistant operation modes can be set (English only). + +- _"Alexa, set main boiler to eco."_ + +To change the water heater's mode, the exact utterance must be used: + +- _"Alexa, set [entity name] to [mode utterance]."_ + +If the water heater entity supports on/off, use _"turn on"_ and _"turn off"_ utterances with the entity name or the mode utterance. + +- _"Alexa, turn on the [mode utterance]."_ +- _"Alexa, turn off the [entity name]."_ + ## Alexa Web-Based App The following is a list of regions and the corresponding URL for the web-based Alexa app: