WundaSmart Integration for Home Assistant

A Home Assistant integration to monitor and control WundaSmart heating systems.

Individual rooms can be monitored and controled as Climate entities in Home Assistant, for example, using the basic Thermostat card.

If you have a water heater connected to your WundaSmart Hub Switch that can be controlled as a Water Heater Home Assistant entity.

This integration is still in development and may not work for your specific requirements.

If you find this integration useful, please consider supporting the development of this and my other addons and integrations by buying me a coffee

Installation

Installing via HACS is recommended.

Install using HACS:

1. Go to HACS, select Integrations, click the three dots menu and select Custom Repositories.

2. Add the path to this Github repository in the first field, select Integration as category and click Add.

3. Restart Home Assistant.

4. Got to the Integrations screen under Settings / Devices and Services.

5. Click the Add Integration button and select the WundaSmart integration.

6. Enter the IP address or host name of your WundaSmart Hub Switch, username and password.

When set up correctly all rooms configured in your Hub Switch will appear as climate entities automatically.

Finding your user name and password

The easiest way of finding your local username and password for the Hub Switch is to use a network traffic capture app on your device that you used to set up and configure the Hub Switch.

One example you can use is the iPhone app HTTP Traffic Capture. This installs a VPN on your phone, allowing you to capture traffic between your phone and the Hub Switch.

Start capturing traffic in the traffic capture app, then switch to the WundaSmart app and perform some action that will send a request to the Hub Switch such as changing the temperature in a room. Then switch back to the traffic capture app and look at the captured traffic for any HTTP requests from your phone to your Hub Switch.

There can be a delay between performing an action in the WundaSmart app and it sending traffic to the Hub Switch, so wait a minute or two before stopping the traffic capture if you don't see any requests immediately.

In the captured HTTP request, look at the headers and find the basic auth Authorization header.

Once you have the basic auth Authorization token from the request headers, you will then need to decode it using any online base64 decoder such as https://decodebase64.com. The decoded string will be in the form username:password.

Tested Hardware

This integration is still in development but has been used with the following WundaSmart devices:

• WundaSmart Hub Switch v4
• WundaSmart Underfloop Heating Connection Box
• WundaSmart Radiator Head
• WundaSmart Room Thermostat
• WundaSmart Screenless Room Thermostat

Credits

This project was originally a fork of https://github.com/ob0t/hawundasmart.