This component will set up the following platforms.
| Platform | Description |
|---|---|
binary_sensor |
Show something True or False. |
sensor |
Show info from Waterkotte Heatpump API. |
switch |
Switch something True or False. |
select |
Select a value from options. |
number |
Change a numeric value. |
service |
Provides services to interact with heatpump |
- Add a custom integration repository to HACS: waterkotte-integration
- Install the custom integration
- In the HA UI go to "Configuration" -> "Integrations" click "+" and search for "Waterkotte Heatpump"
- Setup the waterkotte custom integration as described below
- Using the tool of choice open the directory (folder) for your HA configuration (where you find
configuration.yaml). - If you do not have a
custom_componentsdirectory (folder) there, you need to create it. - In the
custom_componentsdirectory (folder) create a new folder calledwaterkotte_heatpump. - Download all the files from the
custom_components/waterkotte_heatpump/directory (folder) in this repository. - Place the files you downloaded in the new directory (folder) you created.
- Restart Home Assistant
- In the HA UI go to "Configuration" -> "Integrations" click "+" and search for "Waterkotte Heatpump"
Use the Config flow to add the integration. You will need the IP/Hostname and Username/Password to log in.
Not all available sensors are enabled by default.
To set the the times for the holiday mode use the provided service waterkotte_heatpump.set_holiday and set start and end parameter.
The Integration provides currently 3 services:
-
set_holiday Allows to set the start and end datetimes for the holiday mode
-
get_energy_balance Retrieves the overall energy consumption data for the year
-
get_energy_balance_monthly Retrieves the monthly breakdown energy consumption data for a moving 12 month window. 1 = January, 2 = February, etc...
The Heatpump only allows 2 sessions and there is not way to close a session. Sometimes you will get an error about the login. Just wait a few minutes and it should auto correct itself. Session usually time out within about 5 min.
The Heatpump will not always respond with data. This happens usually after the system changes status, e.g. start/stop the heating. There is not much we can do about this unfortunately. I try to cache the data in possible for a better UX.
This project was generated from @oncleben31's Home Assistant Custom Component Cookiecutter template.
Code template was mainly taken from @Ludeeus's integration_blueprint template