Tvalley71 / dantherm

Dantherm Integration for Home Assistant

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Dantherm

Home Assistant integration for Dantherm ventilation units

Currently only support for Modbus over TCP/IP.

Known supported units:

  • HCV300 ALU
  • HCV400 P2
  • RCV320

Note

The listed units are known to have been tested with the integration. There may be other Dantherm units that are also supported. 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
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
filter_remain Remaining filter time sensor
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.

Installation

Important

Installation directly through HACS is not yet available because the integration is not yet included. 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-05-13 070737 Skærmbillede 2024-05-13 070838 Skærmbillede 2024-05-04 090422

Note

Preheater and 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 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.

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 create the below helper template 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
          text-align: center;
          font-size: 100%
      - type: state-label
        entity: sensor.dantherm_humidity
        style:
          top: 29%
          left: 38%
          font-size: 125%
      - type: state-label
        entity: select.dantherm_fan_selection
        style:
          top: 29%
          left: 63%
          font-weight: bold
          font-size: 100%

Helper template sensor.

Skærmbillede 2024-05-04 094747

Mushroom-chips card

Example of a Mushroom-chips card displaying the current state of operation and fan level, in the order automatic, week program, manual, and standby mode.

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

Disclaimer

The trademark "Dantherm" is owned by Dantherm Group A/S, a leading supplier of climate control solutions.

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

I am not affiliated with Dantherm, except as an owner of one of their units, the HCV400 P2.

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

Tvalley71

About

Dantherm Integration for Home Assistant

License:Apache License 2.0


Languages

Language:Python 100.0%