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
- 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.
| 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 |
| 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.
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.
- 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.
- 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.
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.
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.
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.
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.
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.
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 create the below helper template sensor.
- 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%
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.
The following cards need the Mushroom frontend repository installed under HACS.
- 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 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.
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.
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.
The author does not guarantee the functionality of this integration and is not responsible for any damage.
Tvalley71