Home Connect Local

The Home Connect Local allows users to integrate their home appliances supporting the Home Connect standard for Bosch and Siemens using direct communication over the local network.

Install the Integration

1. Go to the HACS -> Custom Repositories and add this repository as a Custom Repository See HACS Documentation for help

2. Click the button bellow and click 'Download' to install the Integration:

   

3. Restart Home Assistant.

Prerequisites

To use this integration, you must first create a Home Connect account and connect your appliances.

Setup

1. Use the Home Connect Profile Downloader to download your Appliance profiles, select "openHAB" as target. The downloaded ZIP-file contains each Appliance encryption Key and feature descriptions

2. Click the button below or use "Add Integration" in Home Assistant and select "Home Connect Local".

   

3. Upload the downloaded Profile file.

4. Select the Appliance you want to setup.

5. When the initial connection to the Appliance fails, your asked to manually enter your Appliance IP-Address.

6. Repeat from Step 2 if you want to setup more than one Appliances.

Configuration parameters

• Profile file: The Profile File you've downloaded with the Home Connect Profile Downloader
• Select Appliance: Select the Appliance you want to setup
• Host / IP-Address: Manually enter your Appliance Hostname or IP-Address

Remove integration

This integration follows standard integration removal, no extra steps are required.

Reporting Issues and Bugs

Bug report requirements

• A full debug log of at least reloading the config entry and any actions leading to an error
• The Diagnostics of the Config Entry
• For reports relating to adding a new Appliance: the *_DeviceDescription.xml and *_FeatureMapping.xml files from the Profile File

Enabling debug logging

Use one of these two methods enable debug logging:

• Through the UI:

  1. Enable Debug logging on the detail page of the integration
  2. Reload the config entry
  3. Perform the actions that lead to an error
  4. Disable Debug logging on the detail page of the integration

• OR -

• Through configuration.yaml:

  1. Add the following to your configuration.yaml file:

     logger:
     logs:
         custom_components.homeconnect_ws: debug # Home Connect Local Integration
         homeconnect_ws: debug
         homeconnect_websocket: debug # Homeconnect websocket Python package

  2. Restart Home Assistant

  3. Perform the actions that lead to an error

  4. Click the button below or navigate to "Settings" -> "Logs".

     

  5. Download the log file using download button on the left