The old ha-waterkotte repository is deprecated and have now been renamed to ha-waterkotte-the-fork. After the refactoring process have been completed, I have decided to create an independent repository - since the refactored version does not have much in common with the origin sources.
Unfortunately HACS does not 'like' renaming of repositories, so you have to perform few steps in order to upgrade your home assistant installation to the latest ha-waterkotte integration version - sorry for this inconvenience!
-
make a backup (just in case)
-
go to HACS menu of your home assistant installation
-
remove the (old) custom HACS repository 'https://github.com/marq24/ha-waterkotte'
(This step will/should remove the Waterkotte Integration entry from the list of installed HACS Integrations)
-
add the new repository 'https://github.com/marq24/ha-waterkotte' to HACS
-
install the waterkotte integration to your local HACS
-
restart your home assistant system
YES - this procedure sounds totally silly - but HACS stores a custom-id for each repository - And since I have decided to rename the old repository which base on the work from pattisonmichael to 'https://github.com/marq24/ha-waterkotte-the-fork' and created an independent repository, this procedure is necessary in order to be notified about any future updates.
This Home Assistant Integration is providing information from the German heatpump pioneer Waterkotte. In addition and where possible functions are provided to control the system.
All data will be fetched (or send) to your Waterkotte via the build in webserver of the unit. So the functionality is based on the data and settings that are available also via the frontend that you can directly access via a web-browser.
| 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 |
adjustable Temperatures (demanded or heating curves) |
service |
Provides services to interact with heatpump |
Please be aware, that we are developing this integration to best of our knowledge and belief, but cant give a guarantee. Therefore, use this integration at your own risk.
[Get the sources for the sample dashboard_above]
- Add a custom integration repository to HACS: ha-waterkotte
- Install the custom integration
- In the HA UI go to "Configuration" -> "Integrations" click "+" and search for "Waterkotte Heatpump [+2020]"
- 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 [+2020]"
Just click the following Button to start the configuration automatically:
Use the following steps for a manual configuration by adding the custom integration using the web interface and follow instruction on screen:
- Go to
Configuration -> Integrationsand add "Waterkotte" integration - Provide display name for the device, and it's address (hostname or IP)
- Select the number of TAGs that can be fetched in a single call to your device (older devices might need to adjust this value - for my in 2022 installed Waterkotte 75 is totally fine)
- Provide area where the heatpump is located
After the integration was added you can use the 'config' button to adjust your settings and you can additionally modify the update intervall
Please note, that most of the available sensors are not enabled by default.
The Integration provides currently 4 services:
-
SET_HOLIDAY
To set the times for the holiday mode use the provided service
waterkotte_heatpump.set_holidayand setstartandendparameter. -
SET_DISINFECTION_START_TIME
To set the water disinfection start time (HH:MM) use the provided service
waterkotte_heatpump.set_disinfection_start_timeand setstarthhmmparameter (seconds will be ignored).
-
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 is a fork from @pattisonmichael' s Waterkotte-Integration
The original project was generated from @oncleben31' s Home Assistant Custom Component Cookiecutter template.
The original code template was mainly taken from @Ludeeus' s integration_blueprint template
Be smart switch to Tibber - that's what I did in october 2023. If you want to join Tibber (become a customer), you might want to use my personal invitation link. When you use this link, Tibber will we grant you and me a bonus of 50,-€ for each of us. This bonus then can be used in the Tibber store (not for your power bill) - e.g. to buy a Tibber Bridge. If you are already a Tibber customer and have not used an invitation link yet, you can also enter one afterward in the Tibber App (up to 14 days). [see official Tibber support article]
Please consider using my personal Tibber invitation link to join Tibber today or Enter the following code: 6o0kqvzf (six, oscar, zero, kilo, quebec, victor, zulu, foxtrot) afterward in the Tibber App - TIA!