Skip to content

Latest commit

 

History

History
423 lines (332 loc) · 17.4 KB

README.md

File metadata and controls

423 lines (332 loc) · 17.4 KB

Dantherm

Home Assistant integration for Dantherm ventilation units

Tip

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

Currently only support for Modbus over TCP/IP.

Known supported units:

  • HCV300 ALU
  • HCV700 ALU
  • HCV400 P2
  • RCV320 P1/P2

Note

The listed units are known to have been used with the integration. Basicly all units that use 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

key description
operation_selection Mode of operation selection
fan_level_selection Fan level selection
week_program_selection Week program selection*
bypass_damper Bypass damper cover*
filter_lifetime Input filter lifetime box
bypass_minimum_temperature Bypass minimum temperature slider†
bypass_maximum_temperature Bypass maximum temperature slider†
manual_bypass_duration Manual bypass duration slider* †
operation_mode Operation mode sensor
alarm Alarm sensor
fan_level Fan level sensor
fan1_speed Fan 1 speed sensor†
fan2_speed Fan 2 speed sensor†
humidity Humidity sensor*
air_quality Air quality sensor*
exhaust_temperature Exhaust temperature sensor
extract_temperature Extract temperature sensor
supply_temperature Supply temperature sensor
outdoor_temperature Outdoor temperature sensor
room_temperature Room temperature sensor* †
filter_remain Remaining filter time sensor
filter_remain_level Remaining filter time sensor level†
work_time Work time sensor†
internal_preheater_dutycycle Preheater power dutycycle* †
away_mode Away mode switch
night_mode Night mode switch
fireplace_mode Fireplace mode switch
manual_bypass_mode Manual bypass mode switch*
summer_mode Summer mode switch
filter_reset Reset remain filter time button
alarm_reset Reset alarm button

* Some of the entities may not install due to lack of support or installation in the particular unit.

† The entity is disabled by default.

Installation

Important

Installation directly through HACS is not yet available because the integration is not yet official included into HACS. This process will take some time. In the meantime, please use the manual installation method or click the below Open HACS Repository button.

Open your Home Assistant instance and open a repository inside the Home Assistant Community Store.

Installation via HACS (Home Assistant Community Store)

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

Manual Installation

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

Configuration

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

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

Skærmbillede 2024-05-04 090018 Skærmbillede 2024-05-04 090125

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.

Screenshots

Skærmbillede 2024-05-04 090219

Skærmbillede 2024-08-04 084300 Skærmbillede 2024-08-04 084328

Skærmbillede 2024-08-04 084347 Skærmbillede 2024-08-04 084404

Skærmbillede 2024-08-04 084430

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.

Languages

Currently supported languages:

Danish, 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.

Examples of use

Picture-elements card

This is a modified version of a dashboard card posted by @cronner on Home Assistant Community. This will show alarms, filter remain level and change according to the current bypass state. Kinda like the Dantherm app.

Skærmbillede 2024-05-21 182357

Skærmbillede 2024-05-21 182443

Skærmbillede 2024-05-21 182154

The details for the above picture-elements card (challenging).

I might consider creating a custom card based on this in the future.

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.

Skærmbillede 2024-05-21 104804

Mushroom-chips card details.

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.

Skærmbillede badge example

Using the "Dantherm: Set State" Action in Automations

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

  1. Create a New Automation:

    • Navigate to Settings > Automations & Scenes.
    • Click on Add Automation and select Start with an empty automation.

  2. 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.

  3. 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.

  4. 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.

image

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

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