EHEIM Digital

The EHEIM Digital integrationIntegrations connect and integrate Home Assistant with your devices, services, and more. [Learn more] allows you to control your EHEIM Digital smart aquarium devices from Home Assistant.

Configuration

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

EHEIM Digital 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.

Data updates

The integration connects locally via WebSocket to the EHEIM Digital main device and requests data updates for all devices every 15 seconds by default.

How you can use this integration

You can use this integration to control and monitor your EHEIM Digital aquarium devices directly from Home Assistant. This includes adjusting settings such as temperature, light brightness, and filter speed, as well as monitoring the status of your devices.

• Receive notifications: Get notified about important events, such as when the filter needs servicing or if there is an error with the device.
• More flexible day/night cycles: Use Home Assistant’s automation and scripting capabilities to create more complex day/night cycles for your aquarium devices than the native EHEIM Digital interface allows.
• Integrate with other devices: While EHEIM Digital devices can interact with each other in a limited sense (for example, the EHEIM autofeeder can pause the filter pump after feeding), this integration allows you to automate and control your EHEIM Digital devices in conjunction with other smart home devices.

Supported devices and entities

Currently, the following devices and entities are supported:

All devices

Number

• System LED brightness: Controlling the brightness of the system LED

EHEIM classicLEDcontrol+e

Lights

• Brightness: Controlling the brightness of both light channels
• Daycycle mode effect: Automatically controls the brightness based on the daytime as configured on the device

EHEIM thermocontrol+e

Climate

• Target temperature: Controlling the target temperature of the heater (which corresponds to the day temperature in Bio and Smart mode)
• Presets / Operation mode: Switching between Manual, Bio and Smart mode

Number

• Temperature offset: Setting an offset between the measured temperature and the real temperature
• Night temperature offset: Setting the offset for the night temperature in Bio mode

Time

• Day start time: Setting the start time for the day temperature in Bio mode
• Night start time: Setting the start time for the night temperature in Bio mode

EHEIM classicVARIO+e

Number

• Manual speed: Setting the pump speed in Manual mode
• Day speed: Setting the pump speed for the day in Bio mode
• Night speed: Setting the pump speed for the night in Bio mode

Select

• Filter mode: Setting the filter mode
  • Manual mode: The filter uses the manual speed
  • Pulse mode: The filter uses a high and low pulse, the speeds are configured via high pulse speed and low pulse speed, the durations are configured via high pulse duration and low pulse duration
  • Bio mode: The filter uses a day and night rhythm, the speeds are configured via day speed and night speed, the start times of day and night are configured via day start time and night start time

Sensor

• Current pump speed: Displays the current pump speed
• Remaining hours until service: Displays the remaining time until the filter needs to be serviced
• Error code: Displays the current error code of the device (No error, Rotor stuck, air in filter)

Switch

• Pump: Turning on and off the filter pump

Time

• Day start time: Setting the start time for the day pump speed in Bio mode
• Night start time: Setting the start time for the night pump speed in Bio mode

Support for additional EHEIM Digital devices and entities will be added in future updates.

Automations

Send a notification when the filter has an error

You can set up an automation to notify you when the filter has an error. This example uses the notify.notify service to send a notification:

alias: Notify about filter error
description: "This automation sends a notification when the filter has an error."
mode: single
triggers:
  - trigger: state
    entity_id:
      - sensor.aquarienfilter_error_code
    to:
      - rotor_stuck
      - air_in_filter
conditions: []
actions:
  - action: notify.notify
    metadata: {}
    data:
      title: The filter has a problem!

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.