home-assistant.io/source/_integrations/home_connect.markdown
2020-05-20 10:26:29 +02:00

2.0 KiB

title, description, logo, ha_category, ha_iot_class, ha_release, ha_domain, ha_codeowners, ha_config_flow
title description logo ha_category ha_iot_class ha_release ha_domain ha_codeowners ha_config_flow
Home Connect Instructions on how to set up the Home Connect integration within Home Assistant. homeconnect.png
Hub
Binary Sensor
Sensor
Switch
Cloud Push 0.110 home_connect
@DavidMStraub
true

The Home Connect integration will allow users to integrate their home appliances supporting the Home Connect standard using the official API.

The integration will add one Home Assistant device for each connected home appliance which will have the following entities:

  • A power switch
  • If the device has programs, switches for the individual programs. Note that program options cannot be configured at present.
  • If the device has programs, a timestamp sensor for remaining time and a numeric sensor for the progress in percent.

Note that it depends on the appliance and on API permissions which of the features are actually supported. A notable limitation is that oven programs cannot be started at present.

Installation

Installation using a developer account

  1. Visit https://developer.home-connect.com and sign up for a developer accouunt.
  2. Under Applications, register a new App:
  • Application ID: Home Assistant
  • OAuth Flow: Authorization Code Grant Flow
  • Redirect URI : <YOUR_HOME_ASSISTANT_URL>/auth/external/callback
  1. Add the client ID and client secret to your configuration.yaml (see below).
  2. Once Home Assistant restarted, go to Configuration > Integrations.
  3. Select the Home Connect integration.

Configuration

# Example configuration.yaml entry

home_connect:
  client_id: CLIENT_ID
  client_secret: CLIENT_SECRET

{% configuration %} client_id: description: Your Home Connect client ID. required: true type: string client_secret: description: Your Home Connect client secret. required: true type: string {% endconfiguration %}