Dantherm

Home Assistant integration for Dantherm ventilation units.

Tip

The integration also exist in a version for Pluggit ventilation units here.

⚠️ Compatibility Notice

This custom integration requires:

Home Assistant version 2025.1.0 or newer

Only support for Modbus over TCP/IP.

Known supported units:

HCV300 ALU
HCV700 ALU
HCV400 P2
HCV460 P2
RCV320 P1/P2
HCH5 MKII
RCC220 P2

Note

The listed units are known to have been used with this integration. Basicly all units that can be used with the Dantherm Residential app ought to work with the integration (Google Play or Apple Store). If you know of any not included in the list, please feel free to contact me here.

Controls and sensors

Buttons Entities

Entity	Description
`alarm_reset`	Reset alarm
`filter_reset`	Reset remain filter time

Calendar Entity

Entity	Description
~~`calendar`~~	~~Operation Calendar~~

Cover Entity

Entity	Description
`bypass_damper`	Bypass damper [1]

Number Entities

Entity	Description
`boost_mode_timeout`	Boost mode timeout [3]
`bypass_minimum_temperature`	Bypass minimum temperature [2]
`bypass_maximum_temperature`	Bypass maximum temperature [2]
`eco_mode_timeout`	Eco mode timeout [3]
`filter_lifetime`	Filter lifetime [2]
`home_mode_timeout`	Home mode timeout [3]
`manual_bypass_duration`	Manual bypass duration [1][2]

Select Entities

Entity	Description
`boost_operation_selection`	Boost operation selection [3]
~~`default_operation_selection`~~	~~Default operation selection~~
`eco_operation_selection`	Eco operation selection [3]
`fan_level_selection`	Fan level selection
`home_operation_selection`	Home operation selection [3]
`operation_selection`	Mode of operation selection
`week_program_selection`	Week program selection [2]

Sensor Entities

Entity	Description
`air_quality`	Air quality sensor [1]
`alarm`	Alarm sensor
`exhaust_temperature`	Exhaust temperature sensor
`extract_temperature`	Extract temperature sensor
`fan_level`	Fan level
`fan1_speed`	Fan 1 speed [2]
`fan2_speed`	Fan 2 speed [2]
`filter_remain`	Remaining filter time
`filter_remain_level`	Remaining filter time level [2]
`humidity`	Humidity sensor [1]
`adaptive_state`	Adaptive state [4]
`internal_preheater_dutycycle`	Preheater power dutycycle [1][2]
`operation_mode`	Operation mode
`outdoor_temperature`	Outdoor temperature sensor
`room_temperature`	Room temperature sensor [1][2]
`supply_temperature`	Supply temperature sensor
`work_time`	Work time [2]

Switch Entities

Entity	Description
`away_mode`	Away mode
`boost_mode`	Boost mode [3]
`eco_mode`	Eco mode [3]
`fireplace_mode`	Fireplace mode
`home_mode`	Home mode [3]
`manual_bypass_mode`	Manual bypass mode [1]
`night_mode`	Night mode [2]
`sensor_filtering`	Sensor spike filtering [2]
`summer_mode`	Summer mode

Text Entities

Entity	Description
`night_mode_end_time`	Night mode end time text [2]
`night_mode_start_time`	Night mode start time text [2]

Notes

[1] The entity may not install due to lack of support or installation in the particular unit.
[2] The entity is disabled by default.
[3] The entity will be enabled or disabled depending on whether the corresponding adaptive trigger is configured.
[4] The entity can only be enabled if any of the adaptive triggers are configured.

~~Strikethrough~~ is a work in progress, planned for version 0.5.0.

Installation

Installation via HACS (Home Assistant Community Store)

Ensure you have HACS installed and configured in your Home Assistant instance.
Open the HACS (Home Assistant Community Store) by clicking HACS in the side menu.
Click on Integrations and then click the Explore & Download Repositories button.
Search for "Dantherm" in the search bar.
Locate the "Dantherm Integration" repository and click on it.
Click the Install button.
Once installed, restart your Home Assistant instance.

Manual Installation

Navigate to your Home Assistant configuration directory.
- For most installations, this will be '/config/'.
Inside the configuration directory, create a new folder named 'custom_components' if it does not already exist.
Inside the 'custom_components' folder, create a new folder named 'dantherm'.
Download the latest release of the Dantherm integration from the releases page into the 'custom_components/dantherm' directory:
Once the files are in place, restart your Home Assistant instance.

Configuration

After installation, add the Dantherm integration to your Home Assistant configuration.

In Home Assistant, go to Configuration > Integrations.
Click the + button to add a new integration.
Search for "Dantherm" and select it from the list of available integrations.
Follow the on-screen instructions to complete the integration setup.

Support

If you encounter any issues or have questions regarding the Dantherm integration for Home Assistant, feel free to open an issue or start a discussion on this repository. I welcome any contributions or feedback.

Languages

Currently supported languages:

Danish, Dutch, English, German and French.

Note

Want to help translate? Grab a language file on GitHub here and post it here. You are also welcome to submit a PR.

Screenshots

Note

The HAC module functions are currently unsupported due to limited testing possibilities. If support for these functions are desired, please contact me for potential collaborative efforts to provide the support.

Examples

Picture-elements card

This picture-elements card provides a dynamic and intuitive interface for monitoring and controlling your Dantherm ventilation unit. Designed to resemble the Dantherm app, it visually adapts based on the unit’s bypass state while displaying key real-time data:

Alarms – Stay alerted to system issues.
Filter Remaining Level – Easily check when filter replacement is needed.
Ventilation Temperatures – View four key temperature readings: Supply, Extract, Outdoor, and Exhaust.
Humidity Level – Monitor indoor humidity for optimal air quality.

Clicking on any displayed entity allows you to adjust its state or explore detailed history graphs for deeper insights.

The details for the above picture-elements card 👈 Click to open

To integrate this into your dashboard, begin by downloading and extracting this zip file. Copy the contained files into the "www" folder within your configuration directory on Home Assistant. You can use the Samba share add-on, the upload feature in the Studio Code Server add-on, or other preferred methods.

Next, insert the following code into your dashboard. If your Home Assistant setup uses a language other than English, make sure to modify the entity names in the code accordingly. You also need to enable the filter_remain_level sensor.

The code

type: picture-elements
image: /local/dantherm1.png
elements:
  - type: image
    entity: sensor.dantherm_filter_remain_level
    state_image:
      '0': /local/dantherm4.png
      '1': /local/dantherm5.png
      '2': /local/dantherm6.png
      '3': /local/dantherm7.png
    style:
      transform: scale(1,1)
      left: 0%
      top: 0%
    tap_action:
      action: more-info
  - type: conditional
    conditions:
      - entity: switch.dantherm_summer_mode
        state: 'off'
    elements:
      - type: image
        entity: cover.dantherm_bypass_damper
        state_image:
          closed: /local/dantherm2.png
          closing: /local/dantherm2.png
          open: /local/dantherm3.png
          opening: /local/dantherm3.png
        style:
          left: 26.6%
          top: 50%
          transform: scale(0.693,0.693)
        tap_action:
          action: more-info
      - type: conditional
        conditions:
          - entity: cover.dantherm_bypass_damper
            state:
              - closed
              - closing
        elements:
          - type: state-label
            entity: sensor.dantherm_outdoor_temperature
            style:
              top: 64.5%
              left: 78%
          - type: state-label
            entity: sensor.dantherm_extract_temperature
            style:
              top: 64.5%
              left: 49%
          - type: state-label
            entity: sensor.dantherm_exhaust_temperature
            style:
              top: 81%
              left: 78%
          - type: state-label
            entity: sensor.dantherm_supply_temperature
            style:
              top: 81%
              left: 49%
      - type: conditional
        conditions:
          - entity: cover.dantherm_bypass_damper
            state:
              - open
              - opening
        elements:
          - type: state-label
            entity: sensor.dantherm_extract_temperature
            style:
              top: 64.5%
              left: 49%
          - type: state-label
            entity: sensor.dantherm_outdoor_temperature
            style:
              top: 81%
              left: 78%
  - type: conditional
    conditions:
      - entity: switch.dantherm_summer_mode
        state: 'on'
    elements:
      - type: image
        image: /local/dantherm8.png
        style:
          left: 26.6%
          top: 50%
          transform: scale(0.693,0.693)
        tap_action:
          action: none
      - type: state-label
        entity: sensor.dantherm_extract_temperature
        style:
          top: 64.5%
          left: 49%
  - type: conditional
    conditions:
      - entity: sensor.dantherm_alarm
        state_not: '0'
    elements:
      - type: state-label
        entity: sensor.dantherm_alarm
        style:
          top: 15%
          left: 50%
          width: 100%
          font-weight: bold
          text-align: center
          color: white
          background-color: red
          opacity: 70%
  - type: state-label
    entity: select.dantherm_operation_selection
    style:
      top: 45%
      left: 36%
      font-weight: bold
      font-style: italic
      text-align: center
      font-size: 100%
  - type: state-label
    entity: sensor.dantherm_humidity
    style:
      top: 29%
      left: 38%
      font-size: 100%
  - type: state-label
    entity: select.dantherm_fan_selection
    style:
      top: 29%
      left: 63%
      font-weight: bold
      font-style: italic
      font-size: 100%

Mushroom-chips card

An example of a Mushroom-chips card showing the current state of operation and fan level in a single display. This can also be achieved with many of the other entities.

Mushroom-chips card details 👈 Click to open

The following cards need the Mushroom frontend repository installed under HACS.

Mode of operation and fan level chips card (shown above)

type: custom:mushroom-chips-card
chips:
  - type: conditional
    conditions:
      - condition: state
        entity: sensor.dantherm_fan_level
        state_not: unavailable
    chip:
      type: entity
      entity: sensor.dantherm_fan_level
      icon_color: blue

Alert chips card

Alert chip displaying any current alert along with its descriptions. A hold action is available to attempt resetting the alarm.

type: custom:mushroom-chips-card
    chips:
      - type: conditional
        conditions:
          - condition: state
            entity: sensor.dantherm_alarm
            state_not: unavailable
          - condition: state
            entity: sensor.dantherm_alarm
            state_not: '0'
        chip:
          type: entity
          entity: sensor.dantherm_alarm
          icon_color: red
          hold_action:
            action: call-service
            service: button.press
            data: {}
            target:
              entity_id: button.dantherm_reset_alarm

Note

Starting from version 2024.8 of Home Assistant, the new badges can be used to achieve same results as the Mushroom chips card.

Dashboard Badges

Here are some examples of badges added to the dashboard. The pop-up that appears when clicking on a badge will vary depending on the selected entities, either displaying information or enabling manipulation of the Dantherm unit.

Sensor Filtering

To improve the stability and reliability of sensor readings, the integration now supports sensor filtering for key environmental data collected from the Dantherm unit. This filtering mechanism is applied to the following sensors:

Humidity
Air Quality
Exhaust Temperature
Extract Temperature
Supply Temperature
Outdoor Temperature
Room Temperature

Control via Home Assistant Switch

The filtering feature can be enabled or disabled via the "Sensor Filtering" switch entity. By default, the filtering is disabled, ensuring the system behaves as it did previously. When the switch is enabled, the filtering logic described below will be applied.

How It Works

Each sensor is equipped with a sliding history buffer, storing the last 5 readings. The filter applies two techniques:

Initialization Smoothing
For the first few readings (up to 5), the filter calculates a simple average. This helps the sensor start off with a stable baseline, preventing a single bad initial reading from influencing the system.
Spike Filtering
After initialization, every new reading is compared to a rolling average of the last 5 readings.
If the new reading changes more than a defined threshold (max_change) compared to the rolling average, the spike is rejected, and the system uses the current rolling average instead.

Individual Thresholds per Sensor

Each sensor type has a predefined maximum allowed change per reading:

Sensor	Max Change
Humidity	5% RH
Air Quality	50 PPM
Temperatures	2°C

This ensures the filtering logic fits the natural dynamics of each sensor type.

This feature was inspired by issue #68, reported by a community user.

Actions

Using the "Dantherm: Set State" and "Dantherm: Set configuration" Actions

The Dantherm: Set state action allows you to control the state of your Dantherm ventilation unit directly from a Home Assistant automation. This action provides a wide range of options to customize the operation of your unit, making it suitable for various scenarios.

Steps to Use the "Set State" Action

Create a New Automation:
- Navigate to Settings > Automations & Scenes.
- Click on Add Automation and select Start with an empty automation.
Configure a Trigger:
- Add a trigger that fits your use case. For example:
  - A time-based trigger to schedule changes.
  - A sensor-based trigger to react to environmental changes.
    - Air Quality Sensor: Trigger when CO2 levels exceed a threshold, e.g., 1000 ppm.
    - Humidity Sensor: Trigger when humidity exceeds, e.g., 70%.
    - Window Sensor: Trigger when a window opens.
    - Cooker Hood: Trigger when the smart plug detects power usage above a threshold.
Add the "Dantherm: Set State" Action:
- Under the Actions section, click Add Action.
- Search for Dantherm: Set state in the action picker and select it.
Configure the Action:
- Use the options provided to control the Dantherm ventilation unit:
  - Targets: Choose the area, device, or entity to apply the action.
  - Operation Selection: Set the desired operating mode (e.g., Standby, Automatic, Manual, or Week Program).
  - Fan Selection: Choose the desired fan level (Level 0–4).
  - Modes: Toggle special modes like:
    - Away Mode: Enable or disable away mode.
    - Summer Mode: Turn summer mode on or off.
    - Fireplace Mode: Activate fireplace mode for a limited period.
    - Manual Bypass Mode: Enable or disable manual bypass.

Save the Automation:
- Once configured, save the automation. The Dantherm unit will now respond to the specified trigger and perform the desired action.

The Dantherm: Set configuration action allows you to adjust various configuration settings of your Dantherm device directly from Home Assistant. This action can be used in automations, scripts, or manually through the Developer Tools.

⏳ The following sections are a work in progress

These features are planned for version 0.5.0. The calendar function is currently still under development.

Integration enhancements

The integration enhances the control of Dantherm ventilation units by introducing Boost Mode, Eco Mode, Home Mode, and a Calendar Function for advanced scheduling and automation. These features ensure efficient operation based on both schedules and various triggers, providing a comfortable and energy-efficient environment.

Boost Mode 🚀

Boost Mode is designed for short bursts of increased ventilation, useful after activities like cooking or showering.

Boost Mode Switch: This must be enabled for Boost Mode to activate.
Trigger-Based Activation: If Boost Mode is enabled and the Boost Mode Trigger is active, the unit switches to the Boost Operation Selection.
Timeout Handling: See Trigger Timeout for details on how long Boost Mode remains active after the trigger is deactivated.
Available Operations: Level 4, Level 3, or Level 2.

Important
The Dantherm unit has a built-in automatic setback from Level 4 to Level 3 after a fixed time period. This may cause Boost Mode to behave unexpectedly if Level 4 is used for longer periods.

Eco Mode 🌱

Eco Mode is designed to reduce fan speed under specific environmental conditions, optimizing efficiency and supporting the unit’s defrost mechanism in cold weather.

Eco Mode Switch: This must be enabled for Eco Mode to activate.
Trigger-Based Activation: If Eco Mode is enabled and the Eco Mode Trigger is active, the unit switches to the Eco Operation Selection.
Timeout Handling: See Trigger Timeout for details on how long Eco Mode remains active after the trigger is deactivated.
Available Operations: Standby and Level 1.

Important
The Dantherm unit has a built-in automatic setback from Standby to Level 3 after a fixed time period. This may cause Eco Mode to behave unexpectedly if Standby is used for longer periods.

Home Mode 🏡

Home Mode allows for automatic adjustments based on a Home Mode Trigger, ensuring efficient ventilation when you are at home.

Home Mode Switch: This must be enabled for Home Mode to activate.
Trigger-Based Activation: If Home Mode is enabled and the Home Mode Trigger is active, the unit switches to the Home Operation Selection.
Timeout Handling: See Trigger Timeout for details on how long Home Mode remains active after the trigger is deactivated.
Available Operations: Automatic, Level 3, Level 2, Level 1, or Week Program.

Trigger Timeout ⏱️

Each mode trigger (Boost, Eco, Home) includes a configurable timeout that defines how long the mode remains active after the trigger is deactivated.

Timeout Behavior: After the trigger turns off, the unit continues operating in the triggered mode for the remaining timeout period.
Reset on Re-trigger: If the trigger is activated again within the timeout window, the countdown restarts.
Automatic Revert: When the timeout expires without further trigger activity, the unit reverts to the operation mode that was active before the trigger event—unless this has been overridden by a calendar schedule.

This mechanism ensures that temporary conditions (e.g., presence, humidity, low temperature) cause a short-term mode change without disrupting long-term schedules.

Adaptive Triggers ⚡

Boost, Eco, and Home Modes rely on Adaptive Triggers — binary sensors or helpers that determine when a mode should activate.

An Adaptive Trigger can be:

A motion sensor (e.g., presence detection for Home Mode)
A humidity sensor (e.g., high humidity after a shower for Boost Mode)
A power sensor (e.g., detecting stove or shower fan usage)
An outdoor temperature sensor (e.g., reducing fan speed in cold weather for Eco Mode)
A custom helper combining multiple conditions

Adaptive Triggers are configured manually in the integration options and linked to each mode individually.

⚠️ Note
Only entities of type binary_sensor or input_boolean are supported as Adaptive Triggers.
Make sure the entity returns an on or off state.

Trigger Entity Availability 🛑

Entities related to Boost, Eco, and Home Modes (e.g., mode switch, timeout, operation selection) are disabled by default unless a corresponding trigger is configured.

If you manually enable these entities via Home Assistant, they will be automatically disabled again after a reload of the integration unless a valid trigger is set in the integration options.

Configuring an Adaptive Trigger

Steps to set up an Adaptive Trigger:

Go to Home Assistant → Integrations → Dantherm.

Click the Configure button for the desired Dantherm integration instance.

Enter the trigger entity:
- Use the appropriate field (e.g., Boost Mode Trigger, Eco Mode Trigger, Home Mode Trigger)
- Examples: binary_sensor.kitchen_motion, binary_sensor.living_room_presence, binary_sensor.outdoor_temperature_low
Click Submit to save the configuration.
Enable the corresponding mode in the UI.

Once configured, the Dantherm unit will automatically switch to the selected operation mode whenever the Adaptive Trigger becomes active. ⚡

Calendar Function 📅

The Calendar Function allows precise scheduling of different operation modes, providing full automation of the ventilation system.

Integration - Calendar Events:
By entering an event word into the summary of a calendar event, the selected operation will take effect when the event starts, assuming it has a higher priority event words than an ongoing event. When the event ends, the system will revert to the previously active event. If no underlying event exists, the unit will revert to the Default Operation Selection.
Event Words: You can schedule "Level 1", "Level 2", "Level 3", "Automatic", "Away Mode", "Night Mode", "Boost Mode", "Home Mode", "Eco Mode", and "Week Program". These terms will be translated according to the selected language in Home Assistant, assuming your language is supported by the integration.
- If Level 1 to Level 3 is scheduled, the unit will run in Manual mode at the selected fan level.
- If Automatic is scheduled, the unit will operate in Demand Mode.
- If Away Mode is scheduled, Away Mode will be enabled at the start and disabled at the end of the event.
- If Night Mode is scheduled, Night Mode will be enabled at the start and disabled at the end of the event.
- If Boost Mode, Home Mode, or Eco Mode is scheduled, the respective mode’s trigger will be enabled at the start and disabled at the end, allowing the unit to switch modes dynamically.
- If Week Program is scheduled, the unit will follow the selected program in Week Program Selection.
Priority System: The following is the priority order for calendar scheduling:
1. Away Mode (highest priority)
2. Boost Mode
3. Night Mode
4. Home Mode
5. Eco Mode
6. Level 3
7. Level 2
8. Level 1
9. Automatic
10. Week Program (lowest priority)

The available operations in Default Operation Selection are Automatic, Level 3, Level 2, Level 1, or Week Program.

Important

The Dantherm unit has built-in Night Mode Start Time and Night Mode End Time. Scheduling Night Mode outside of these times may not function as expected.

These features provide seamless automation and intelligent airflow control, ensuring the ventilation system adapts dynamically to both planned schedules and real-time environmental conditions. 🚀🏡🌱📅

Disclaimer

The trademark "Dantherm" is owned by Dantherm Group A/S.

The trademark "Pluggit" is owned by Pluggit GmbH.

All product names, trademarks, and registered trademarks mentioned in this repository are the property of their respective owners.

I am not affiliated with Dantherm or Pluggit, except as the owner of a Dantherm HCV400 P2 unit.

The author does not guarantee the functionality of this integration and is not responsible for any damage.

Tvalley71

Files

README.md

Latest commit

History

README.md

File metadata and controls

Dantherm

⚠️ Compatibility Notice

Controls and sensors

Buttons Entities

Calendar Entity

Cover Entity

Number Entities

Select Entities

Sensor Entities

Switch Entities

Text Entities

Notes

Installation

Installation via HACS (Home Assistant Community Store)

Manual Installation

Configuration

Support

Languages

Screenshots

Examples

Picture-elements card

The code

Mushroom-chips card

Mode of operation and fan level chips card (shown above)

Alert chips card

Dashboard Badges

Sensor Filtering

Control via Home Assistant Switch

How It Works

Individual Thresholds per Sensor

Actions

Using the "Dantherm: Set State" and "Dantherm: Set configuration" Actions

Steps to Use the "Set State" Action

⏳ The following sections are a work in progress

Integration enhancements

Boost Mode 🚀

Eco Mode 🌱

Home Mode 🏡

Trigger Timeout ⏱️

Adaptive Triggers ⚡

Trigger Entity Availability 🛑

Configuring an Adaptive Trigger

Steps to set up an Adaptive Trigger:

Calendar Function 📅

Disclaimer

I am not affiliated with Dantherm or Pluggit, except as the owner of a Dantherm HCV400 P2 unit.

The author does not guarantee the functionality of this integration and is not responsible for any damage.