Liebherr

The Liebherr integrationIntegrations connect and integrate Home Assistant with your devices, services, and more. [Learn more] allows you to control and monitor Liebherr SmartDevice refrigerators and freezers via the cloud-based SmartDevice HomeAPI. With this integration, you can monitor temperatures, adjust cooling settings, and create automations to alert you when temperatures exceed safe food storage thresholds.

Use case: Monitor food storage temperatures, send alerts when thresholds are exceeded, optimize energy consumption, and automatically adjust cooling settings when you’re away from home.

Supported devices

The following appliances are supported by the integration:

• Liebherr SmartDevice refrigerators and freezers with Wi-Fi connectivity

Prerequisites

Before setting up the integration, you need to obtain an API key from the Liebherr SmartDevice app:

1. Connect your appliance: Download the SmartDevice app and connect your Liebherr appliance to your home WiFi network. Follow the setup instructions to complete the initial configuration.

2. Get your API key:

   • Open the SmartDevice app.
   • Go to Settings.
   • Select Become a beta tester.
   • Activate the Beta testing HomeAPI.
   • Select Generate new key.
   • Copy the API key. The API key can only be copied once from the app.

3. Verify connectivity: Only appliances that are connected to the internet via the SmartDevice app can be accessed through the HomeAPI. Appliances that are only registered but not actively connected will not appear in Home Assistant.

Configuration

To add the Liebherr hub to your Home Assistant instance, use this My button:

Liebherr can be auto-discovered by Home Assistant. If an instance was found, it will be shown as Discovered. You can then set it up right away.

The integration can be automatically discovered when your appliances are on the same network. If automatic discovery does not work, you can manually add the integration.

Supported functionality

The Liebherr integration provides temperature monitoring and control for refrigerator and freezer zones in your SmartDevice appliances.

Numbers

The integration creates number entities for controlling the setpoint temperature of each cooling zone.

• Setpoint: The target temperature for the cooling zone. Adjust this value to change the desired temperature.

The temperature range and unit depend on your appliance’s capabilities and settings.

For appliances with multiple cooling zones (like a fridge-freezer combination), a separate number entity is created for each zone:

• Top zone setpoint: Target temperature for the uppermost compartment
• Middle zone setpoint: Target temperature for the middle compartment (if present)
• Bottom zone setpoint: Target temperature for the lowermost compartment (if present)

Sensors

The integration creates temperature sensors for each cooling zone in your appliance.

• Zone temperature: The current temperature measured inside the cooling zone.

For appliances with multiple cooling zones (like a fridge-freezer combination), a separate sensor is created for each zone:

• Top zone: The uppermost cooling compartment
• Middle zone: The middle compartment (if present)
• Bottom zone: The lowermost cooling compartment (if present)

Selects

The integration creates select entities for special features available on your appliance. Not all selects may be available depending on your appliance model and its capabilities. For appliances with multiple cooling zones, a separate select entity is created for each zone.

• IceMaker: Controls the automatic ice maker. Options are Off, On, and MaxIce (if supported by the appliance). MaxIce temporarily increases ice production for occasions when you need more ice.
• HydroBreeze: Controls the HydroBreeze misting system that keeps fruits and vegetables fresh by periodically spraying a fine mist. Options are Off, Low, Medium, and High.
• BioFresh-Plus: Controls the BioFresh-Plus compartment temperature setting. Options represent temperature combinations for the two BioFresh-Plus drawers (for example 0|0, 0|-2, -2|-2, -2|0), allowing you to optimize storage conditions for different types of fresh food.

Switches

The integration creates switch entities for special operating modes available on your appliance. Not all switches may be available depending on your appliance model and its capabilities.

Zone-based switches

These switches apply to individual cooling zones. For appliances with multiple zones, a separate switch is created for each zone:

• SuperCool: Rapidly lowers the refrigerator compartment temperature to +2°C for up to 12 hours. Designed to quickly cool large amounts of newly stored food or drinks, preventing the interior temperature from rising and ensuring optimal food preservation.
• SuperFrost: Quickly lowers the freezer temperature to -32°C (-26°F), creating cold reserves for vitamin-preserving freezing. The function automatically returns to normal mode once the freezing process is complete, after 65 hours at the most, helping to save electricity.

Device-wide switches

These switches apply to the entire appliance:

• PartyMode: A 24-hour convenience setting that prepares the appliance for entertaining by maximizing cooling performance. It automatically activates SuperCool for rapid chilling of drinks and SuperFrost for freezing food, while boosting ice production if available.
• NightMode: Optimizes kitchen tranquility by silencing all appliance sounds, halting the IceMaker, and dimming interior LED lighting to a soft glow.

Automations

Examples of automations you can create using the Liebherr integration.

Night mode schedule

Schedule your Liebherr appliance to automatically enable night mode at bedtime and disable it in the morning for quieter overnight operation.

alias: "Liebherr Night Mode Schedule"
description: >-
  Automatically enable night mode at bedtime and disable it in the morning for
  quieter overnight operation.
triggers:
  - trigger: time
    at: "22:00:00"
    id: night_mode_on
  - trigger: time
    at: "07:00:00"
    id: night_mode_off
actions:
  - choose:
      - conditions:
          - condition: trigger
            id: night_mode_on
        sequence:
          - action: switch.turn_on
            target:
              entity_id: switch.my_fridge_night_mode
      - conditions:
          - condition: trigger
            id: night_mode_off
        sequence:
          - action: switch.turn_off
            target:
              entity_id: switch.my_fridge_night_mode
mode: single

Data updates

The Liebherr integration pollsData polling is the process of querying a device or service at regular intervals to check for updates or retrieve data. By defining a custom polling interval, you can control how frequently your system checks for new data, which can help optimize performance and reduce unnecessary network traffic. [Learn more] data from the SmartDevice HomeAPI cloud service every 1 minute.

If you have more than 2 devices, it is recommended to increase the polling interval to avoid hitting API rate limits.

Known limitations

• Cloud dependency: The integration requires internet connectivity to communicate with the Liebherr SmartDevice HomeAPI cloud service. If your internet connection is down, you won’t be able to control your appliances through Home Assistant.
• Beta API: The SmartDevice HomeAPI is currently in beta. Features and functionality may change as Liebherr continues to develop the API.
• API key limitations: The API key can only be copied once from the SmartDevice app. If you lose it, you’ll need to generate a new one.
• Connected devices only: Only appliances that are actively connected to the internet via Wi-Fi appear in Home Assistant. Registered but disconnected appliances are not accessible.

Troubleshooting

Removing the integration

This integration follows standard integration removal. No extra steps are required.

To remove an integration instance from Home Assistant

1. Go to Settings > Devices & services and select the integration card.
2. From the list of devices, select the integration instance you want to remove.
3. Next to the entry, select the three dots menu. Then, select Delete.

After removing the integration, your API key remains active in the SmartDevice app. To revoke access, generate a new API key in the app, which will invalidate the old one.