Grünbeck Cloud Homeassistant Component

Custom Component to integrate Grünbeck Cloud based Water softeners into Home Assistant.

This integration will set up the following entities.

(*) Entity names are using translation, that means they will have a different name if you are not using english.

This integration provides following services.

Installation

HACS (Recommended)

This is currently not an official HACS integration and repository needs to be added to HACS.

Assuming you have already installed and configured HACS, follow these steps:

1. Navigate to the HACS integrations page
2. Choose Integrations under HACS
3. Click on the three small dots in the upper right corner and select Custom repositories and add this URL:

   https://github.com/p0l0/hagruenbeck_cloud/

4. Click the '+' button on the bottom of the page
5. Search for "Grünbeck Cloud", choose it, and click install in HACS
6. Ready! Now continue with the configuration.

Configuration

Through the interface

1. Navigate to Settings > Devices & Services and then click Add Integration
2. Search for Grünbeck Cloud
3. Enter your credentials for the Grünbeck Cloud

Energy/Water Dashboard

To get the real water consumption (at least for most people in Germany), you need to create a template sensor with following calculation (you need to change the sensors with your entity names):

template:
  - sensor:
      - name: "Total Water Usage"
        unit_of_measurement: L
        icon: mdi:water-pump
        state_class: total_increasing
        device_class: water
        state: >
          {%- set soft_water = states('sensor.<device_name>_soft_water') | float(0) -%}
          {%- set raw_water = states('sensor.<device_name>_raw_water') | float(0) -%}
          {%- set soft_water_quantity = states('sensor.<device_name>_soft_water_quantity') | float(0) -%}
          {%- if (is_number(soft_water_quantity) and (soft_water_quantity > 1)) and (is_number(raw_water) and (raw_water > 1)) and (is_number(soft_water) and (soft_water > 1)) -%}
            {%- set water_usage = ((soft_water*soft_water_quantity)/(raw_water-soft_water)+soft_water_quantity) | round(4) | float(unavailable) -%}
            {%- if is_number(water_usage) -%}
              {{water_usage}}
            {%- endif -%}
          {%- endif -%}

The sensor sensor.<device_name>_soft_water_quantity is not being pushed regularly via WebSocket, and to avoid overloading the Grünbeck Cloud API, this sensor will only be updated every 360 seconds.

If you get an error about missing statistics, it's because the entity needs to collect some data, it will be gone after a while.

REMEMBER: Entity names are using translation, that means they will have a different name if you are not using english.

LED Ring

If you have a Grünbeck model with LED Ring, the communication between integration and Grünbeck cloud is considered as "operation by user". You should change the configuration of the ring, to only be active in case of failure, to avoid permanent light on.

Known Issues

If you change the operation mode and nothing changes, check if the App shows the message "The mode of operation will be changed after next regeneration" when you try to change the operation mode there. I currently was not able to find out how to identify this state.

Water hardness unit is currently hardcoded to be shown in HA as °dH, but it's only a suffix nothing is being recalculated if you have a different unit in your installation.

Legal notice

This is a personal project and isn't in any way affiliated with, sponsored or endorsed by Grünbeck.

All product names, trademarks and registered trademarks in (the images in) this repository, are property of their respective owners. All images in this repository are used by the project for identification purposes only.