Home Connect
The Home Connect integration allows users to integrate their home appliances supporting the Home Connect standard for Bosch and Siemens using the official cloud 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 each of the individual programs will be added. Note that program options cannot be configured currently.
- If the device has programs, a timestamp sensor for remaining time and a numeric sensor for the progress percentage.
- For hood’s functional light a light switch including brightness control will be added.
- For hood’s and dishwasher’s ambient light a light switch including brightness and color control will be added.
Note that it depends on the appliance and on API permissions which of the features are supported.
Prerequisites
- Visit https://developer.home-connect.com and sign up for a developer account.
- Enter the email of your login for the original Home Connect App from Bosch/Siemens under “Default Home Connect User Account for Testing” in the sign up process.
- Under Applications, register a new App:
- Application ID: Home Assistant (or whatever name makes sense to you)
- OAuth Flow: Authorization Code Grant Flow
- Redirect URI:
https://my.home-assistant.io/redirect/oauth
If you don’t have My Home Assistant on your installation,
you can use <HOME_ASSISTANT_URL>/auth/external/callback as the redirect URI
instead.
The <HOME_ASSISTANT_URL> must be the same as used during the configuration/
authentication process.
Internal examples: http://192.168.0.2:8123/auth/external/callback, http://homeassistant.local:8123/auth/external/callback.”
Configuration
Adding Home Connect to your Home Assistant instance can be done via the user interface, by using this My button:
If the above My button doesn’t work, you can also perform the following steps manually:
-
Browse to your Home Assistant instance.
-
In the sidebar click on Settings.
-
From the configuration menu select: Devices & Services.
-
In the bottom right, click on the Add Integration button.
-
From the list, search and select “Home Connect”.
-
Follow the instruction on screen to complete the set up.
The integration configuration will ask for the Client ID and Client Secret created above. See Application Credentials for more details.
Services
The Home Connect integration makes various services available.
Available services: set_option_active, set_option_selected, pause_program, resume_program, select_program, start_program and change_setting
Service home_connect.set_option_active
Sets an option for the active program.
| Service data attribute | Optional | Description |
|---|---|---|
device_id |
no | Id of a device associated with the home appliance. |
key |
no | Key of the option. |
value |
no | Value of the option. |
unit |
yes | Unit for the option. |
Service home_connect.set_option_selected
Sets an option for the selected program.
| Service data attribute | Optional | Description |
|---|---|---|
device_id |
no | Id of a device associated with the home appliance. |
key |
no | Key of the option. |
value |
no | Value of the option. |
unit |
yes | Unit for the option. |
Service home_connect.pause_program
Pauses the current running program.
| Service data attribute | Optional | Description |
|---|---|---|
device_id |
no | Id of a device associated with the home appliance. |
Service home_connect.resume_program
Resumes a paused program.
| Service data attribute | Optional | Description |
|---|---|---|
device_id |
no | Id of a device associated with the home appliance. |
Service home_connect.select_program
Selects a program without starting it.
| Service data attribute | Optional | Description |
|---|---|---|
device_id |
no | Id of a device associated with the home appliance. |
program |
no | Program to select. |
key |
yes | Key of the option. |
value |
yes | Value of the option. |
unit |
yes | Unit for the option. |
Service home_connect.start_program
Selects a program and starts it.
| Service data attribute | Optional | Description |
|---|---|---|
device_id |
no | Id of a device associated with the home appliance. |
program |
no | Program to select. |
key |
yes | Key of the option. |
value |
yes | Value of the option. |
unit |
yes | Unit for the option. |
Service home_connect.change_setting
Changes a setting.
| Service data attribute | Optional | Description |
|---|---|---|
device_id |
no | Id of a device associated with the home appliance. |
key |
no | Key of the setting. |
value |
no | Value of the setting. |