Merge branch 'main' of https://github.com/iluvdata/liebherr

Author: iluvdata

README.md

@@ -14,8 +14,6 @@ This is an *unofficial* custom integration for Home Assistant that allows you to
 
 ### HACS (Recommended)
 
-> [!Warning]
-> If you are upgrading from the `bhuebschen/liebherr` version, it's recommended to remove this first to avoid orphaned devices/entities.
 
 [![Open your Home Assistant instance and open a repository inside the Home Assistant Community Store.](https://my.home-assistant.io/badges/hacs_repository.svg)](https://my.home-assistant.io/redirect/hacs_repository/?category=integration&owner=iluvdata&repository=liebherr)
 
@@ -41,6 +39,7 @@ or search for the Liebherr integration in HACS
 
 1. Enter your Liebherr HomeAPI API key. (see [here](https://developer.liebherr.com/apis/smartdevice-homeapi/), how to get the key)
 2. Complete the setup process.
+3. (Optional):  Configure the polling interval and the entity type for Presentation Light (see below).
 
 ## Usage
 Once the integration is configured, your Liebherr devices will appear as entities in Home Assistant. You can:
@@ -51,14 +50,17 @@ Once the integration is configured, your Liebherr devices will appear as entitie
 Controls will map to the following domains:
 | Liebherr Control | Homeassistant Domain |
 | -----------------| ---------------------|
-| Ice Maker, BioFreshPlus | Select |
-| Presentation Light | Light |
+| Auto Door | Cover |
+|Ice Maker, BioFreshPlus | Select |
+| Presentation Light | Light or Number*|
 | SuperCool, SuperFreeze, PartyMode, NightMode | Switch|
 | HydroBreeze | Fan |
 | Temperature | Climate |
 | `image_url` (Device) | Image |
 | Bottle Timer | Not available |
 
+*\* In version ≥ 2025.12.5 the domain/type of control/entity created can be selected in the integration options.*
+
 ### Discover New Appliances
 
 Currently appliances added to your Liebherr account will not be automatically discovered. Once an appliance is connected to your Liebherr account (and accessible in the SmartHome app) manually reload the integration from the integration screen:
@@ -71,26 +73,21 @@ and click on "Reload" on the configuration menu:
 
 ## Update Interval
 
-### Version 2025.10.4
-
-Given rate limits imposed by Liebherr in the [SmartDevice Home API](https://developer.liebherr.com/apis/smartdevice-homeapi/#advice-for-implementation) the integration can only make a request to the API every 30s.  The interval between poll updates depends on the number of devices (since controls have to be requested separately for each device) and is determined by:
-
-$$
-   polling\ interval = number\ of\ devices\ ×\ 30\ seconds
-$$
-#### Example
-If you have 4 Liebherr devices associated with your account the update interval will be $4 × 30$ seconds $= 2$ minutes. Over this two minute period each device will be updated *sequentially* at 30 second intervals:
+Given rate limits imposed by Liebherr in the beta [SmartDevice Home API](https://developer.liebherr.com/apis/smartdevice-homeapi/#advice-for-implementation) the integration can only make a request to the device control API more often than every 30s.
 
->  Device 1 > 30 seconds > Device 2 > 30 seconds > Device 3 > 30 Seconds > Device 4 > 30 seconds > Device 1 > ...
+> [!NOTE] Last Updated Sensor
+> A diagnostic sensor will be created for each device showing the last timestamp of the most recent poll but is disabled by default (as it will quickly fill up your database with state changes).
 
-### Version 2025.12.0
+### Version ≥ 2025.12.0
 
 This version will calculate the polling interval based on the number of devices/appliances associated with your Liebherr account.  Essentially the goal is to poll each device's controls every 30 seconds and is calculated thusly:
 
 ```math
 poll\ interval=\frac{30\ seconds}{number\ of\ devices}
 ```
-With a minimun poll interval of 30 seconds.
+With a minimun poll interval of 30 seconds. 
+
+The polling interval can be adjusted manual (within some present limits) by changing the integration options.
 
 ## Troubleshooting
 - Ensure your Liebherr api key is correct.
@@ -102,8 +99,6 @@ With a minimun poll interval of 30 seconds.
 ## Acknowledgements
 This is a rewrite of the great [custom intergration](https://github.com/bhuebschen/liebherr) orginally maintained by @bhuebschen from a fork created by @skatsavos.  The original intergration stopped working in Oct 2025 and the orginal maintainer did not appear to be maintaining the project.
 
-> [!Warning]
-> This is nearly a complete rewrite to the orginal integration.  As such there is not a suitable upgrade path. Start by removing the prior liebherr entry and HACS respository from your Homeassistant **before** proceeding with installation.
 
 > [!Warning]
 > This was tested on a Liebherr Device lacking:
@@ -112,15 +107,7 @@ This is a rewrite of the great [custom intergration](https://github.com/bhuebsch
 >> - BioFreshPlus (reported to be working)
 >> - HydroBreeze (reported to be working)
 >
-> If you encounter an issue with these features please submit an issue [here](https://github.com/iluvdata/liebherr/issues).
-
-### Significant Changes from [bhuebschen/liebherr v0.1.1](https://github.com/bhuebschen/liebherr)
-- Data is now pulled from the API using a single "coordinated" pull set on a configurable interval per https://github.com/bhuebschen/liebherr/issues/44#issuecomment-3442421338 and https://developer.liebherr.com/apis/smartdevice-homeapi/ set to a default interval of 30s.
-- Added support for all the support features in the API such as IceMaker Control, BioFreshPlus, AutoDoor, Presentation Light (wine fridges) and HydroBreeze (see Caution above).
-- Translation support has been greatly expanded but please note I was not able to update the many translations (please feel free to contribute)!
-- Device/appliance list will only be queried upon setup.  If you add a new device to your Liebherr account you with have to "Reload" the integration in Homeassitant (or restart Homeassistant).
-- The integration was modernized to align better with Homeassistant's development standards https://developers.home-assistant.io/docs/development_index and remove the use of deprecated functions.
-
+> If you encounter an issue with these features please submit an issue.
 
 ## Support
 If you encounter any issues or have feature requests, please open an issue on the [GitHub Issues page](https://github.com/iluvdata/liebherr/issues).

custom_components/liebherr/__init__.py

@@ -1,6 +1,7 @@
 """Liebherr HomeAPI for HomeAssistant."""
 
 import logging
+from typing import Any
 
 from pyliebherr.exception import LiebherrAuthException
 
@@ -9,6 +10,7 @@
 from homeassistant.core import HomeAssistant
 from homeassistant.exceptions import ConfigEntryAuthFailed
 
+from .const import CONF_PRESENTATION_LIGHT_AS_NUMBER
 from .coordinator import LiebherrConfigEntry, LiebherrCoordinator
 
 _LOGGER = logging.getLogger(__name__)
@@ -18,7 +20,6 @@
     Platform.COVER,
     Platform.FAN,
     Platform.IMAGE,
-    Platform.LIGHT,
     Platform.SENSOR,
     Platform.SELECT,
     Platform.SWITCH,
@@ -40,31 +41,33 @@ async def async_setup_entry(hass: HomeAssistant, config_entry: LiebherrConfigEnt
 
     config_entry.runtime_data = coordinator
 
+    if config_entry.options.get(CONF_PRESENTATION_LIGHT_AS_NUMBER, False):
+        PLATFORMS.add(Platform.NUMBER)
+    else:
+        # Add Light to platforms
+        PLATFORMS.add(Platform.LIGHT)
+
     await hass.config_entries.async_forward_entry_setups(config_entry, PLATFORMS)
 
     return True
 
 
 async def async_migrate_entry(hass: HomeAssistant, config_entry: LiebherrConfigEntry):
     """Migrate old entry to newer version."""
-    _LOGGER.debug(
-        "Migrating configuration from version %s.%s",
-        config_entry.version,
-        config_entry.minor_version,
-    )
 
     if config_entry.version == 1:
         if config_entry.minor_version < 2:
-            # No longer using options for interval
+            # No longer using options for interval, since reverted
             hass.config_entries.async_update_entry(
                 config_entry, options={}, minor_version=2, version=1
             )
-
-    _LOGGER.debug(
-        "Migration to configuration version %s.%s successful",
-        config_entry.version,
-        config_entry.minor_version,
-    )
+        if config_entry.minor_version < 3:
+            # Add presentation_light_as_select option defaulting to False
+            options: dict[str, Any] = config_entry.options.copy()
+            options[CONF_PRESENTATION_LIGHT_AS_NUMBER] = False
+            hass.config_entries.async_update_entry(
+                config_entry, options=options, minor_version=3, version=1
+            )
 
     return True
 

custom_components/liebherr/climate.py

@@ -132,4 +132,5 @@ def _handle_coordinator_update(self) -> None:
                         self._attr_min_temp = control.min
                     if control.max:
                         self._attr_max_temp = control.max
-        self.async_write_ha_state()
+                    self.async_write_ha_state()
+                    return

custom_components/liebherr/config_flow.py

@@ -16,7 +16,9 @@
 )
 from homeassistant.const import CONF_API_KEY
 from homeassistant.core import callback
+from homeassistant.data_entry_flow import section
 from homeassistant.helpers.selector import (
+    BooleanSelector,
     NumberSelector,
     NumberSelectorConfig,
     NumberSelectorMode,
@@ -26,13 +28,44 @@
 from . import _LOGGER
 from .const import (
     CONF_POLL_INTERVAL,
+    CONF_PRESENTATION_LIGHT_AS_NUMBER,
     DEFAULT_UPDATE_INTERVAL,
     DOMAIN,
     MAX_UPDATE_INTERVAL,
     MIN_UPDATE_INTERVAL,
 )
 from .coordinator import LiebherrConfigEntry
 
+POLLING_SECTION: str = "polling_options"
+LIGHT_SECTION: str = "presentation_light_options"
+
+OPTIONS_SCHEMA: vol.Schema = vol.Schema(
+    {
+        vol.Required(POLLING_SECTION): section(
+            vol.Schema(
+                {
+                    vol.Required(CONF_POLL_INTERVAL): NumberSelector(
+                        NumberSelectorConfig(
+                            min=MIN_UPDATE_INTERVAL,
+                            max=MAX_UPDATE_INTERVAL,  # 5 minutes
+                            step=1,
+                            unit_of_measurement="s",
+                            mode=NumberSelectorMode.BOX,
+                        )
+                    )
+                }
+            )
+        ),
+        vol.Required(LIGHT_SECTION): section(
+            vol.Schema(
+                {
+                    vol.Required(CONF_PRESENTATION_LIGHT_AS_NUMBER): BooleanSelector(),
+                }
+            )
+        ),
+    }
+)
+
 
 def async_calculate_poll_interval(number_of_devices: int) -> int:
     """Calculate poll interval based on number of devices."""
@@ -57,33 +90,32 @@ async def async_step_init(
         if user_input is not None:
             return self.async_create_entry(
                 data={
-                    CONF_POLL_INTERVAL: user_input[CONF_POLL_INTERVAL],
+                    CONF_POLL_INTERVAL: user_input[POLLING_SECTION][CONF_POLL_INTERVAL],
+                    CONF_PRESENTATION_LIGHT_AS_NUMBER: user_input[LIGHT_SECTION][
+                        CONF_PRESENTATION_LIGHT_AS_NUMBER
+                    ],
                 }
             )
 
-        data_schema: vol.Schema = vol.Schema(
-            {
-                vol.Required(CONF_POLL_INTERVAL): NumberSelector(
-                    NumberSelectorConfig(
-                        min=MIN_UPDATE_INTERVAL,
-                        max=MAX_UPDATE_INTERVAL,  # 5 minutes
-                        step=1,
-                        unit_of_measurement="s",
-                        mode=NumberSelectorMode.BOX,
-                    )
-                ),
-            }
-        )
         suggested_values = {
-            CONF_POLL_INTERVAL: self.config_entry.options.get(
-                CONF_POLL_INTERVAL,
-                async_calculate_poll_interval(len(self.config_entry.runtime_data.data)),
-            ),
+            POLLING_SECTION: {
+                CONF_POLL_INTERVAL: self.config_entry.options.get(
+                    CONF_POLL_INTERVAL,
+                    async_calculate_poll_interval(
+                        len(self.config_entry.runtime_data.data)
+                    ),
+                )
+            },
+            LIGHT_SECTION: {
+                CONF_PRESENTATION_LIGHT_AS_NUMBER: self.config_entry.options.get(
+                    CONF_PRESENTATION_LIGHT_AS_NUMBER, False
+                ),
+            },
         }
         return self.async_show_form(
             step_id="init",
             data_schema=self.add_suggested_values_to_schema(
-                data_schema, suggested_values
+                OPTIONS_SCHEMA, suggested_values
             ),
             description_placeholders={
                 "min_int": str(MIN_UPDATE_INTERVAL),
@@ -103,7 +135,7 @@ class LiebherrConfigFlow(ConfigFlow, domain=DOMAIN):
 
     VERSION = 1
 
-    MINOR_VERSION = 2
+    MINOR_VERSION = 3
 
     async def async_step_user(
         self, user_input: dict[str, str] | None = None

custom_components/liebherr/const.py

@@ -10,6 +10,7 @@
 MAX_UPDATE_INTERVAL: Final[int] = 300  # in seconds, 5 minutes
 
 CONF_POLL_INTERVAL: Final[str] = "poll_interval"
+CONF_PRESENTATION_LIGHT_AS_NUMBER: Final[str] = "presentation_light_as_number"
 
 BRIGHTNESS_SCALE: Final[dict[str, tuple[int, int]]] = {"WPgbi 7472-20": (1, 5)}
 DEFAULT_BRIGHTNESS_SCALE: Final[tuple[int, int]] = (1, 4)

custom_components/liebherr/cover.py

@@ -117,8 +117,8 @@ def _handle_coordinator_update(self) -> None:
                     self._last_state = (
                         STATE_OPENING if self._attr_is_opening else STATE_CLOSING
                     )
-                break
-        self.async_write_ha_state()
+                self.async_write_ha_state()
+                return
 
     async def async_open_cover(self, **kwargs):
         """Send command to open the cover."""

custom_components/liebherr/diagnostics.py

@@ -23,5 +23,6 @@ async def async_get_config_entry_diagnostics(
 
     return {
         "entry_data": async_redact_data(entry.data, TO_REDACT),
+        "options": async_redact_data(entry.options, TO_REDACT),
         "data": async_redact_data(devices, TO_REDACT),
     }

custom_components/liebherr/fan.py

@@ -94,7 +94,8 @@ def _handle_coordinator_update(self) -> None:
                 self._attr_percentage = ordered_list_item_to_percentage(
                     list(HydroBreezeControlRequest.HydroBreezeMode), mode
                 )
-        self.async_write_ha_state()
+                self.async_write_ha_state()
+                return
 
     async def _async_set_mode(
         self, mode: HydroBreezeControlRequest.HydroBreezeMode

custom_components/liebherr/light.py

@@ -62,7 +62,8 @@ def _handle_coordinator_update(self) -> None:
                     self._attr_is_on = True
                 else:
                     self._attr_is_on = False
-        self.async_write_ha_state()
+                self.async_write_ha_state()
+                return
 
     async def async_turn_on(
         self,

custom_components/liebherr/manifest.json

@@ -12,5 +12,5 @@
   "loggers": ["pyliebherr"],
   "requirements": ["pyliebherr==2025.11.4", "Pillow>=11.0.0"],
   "single_config_entry": true,
-  "version": "2025.12.4"
+  "version": "2026.1.1"
 }