Skip to content

Latest commit

 

History

History
123 lines (94 loc) · 4.06 KB

README.md

File metadata and controls

123 lines (94 loc) · 4.06 KB
Raw

Home Assistant ThermIQ-MQTT Integration

hacs_badge

This integration allows you to use the ThermIQ-MQTT hardware interface to control and monitor your Thermia or Danfoss heatpump from Home Assistant. It is currently available as a custom component through HACS and will eventually be submit it as an official Home Assistant component.

Some info background information on the ThermIQ-MQTT interface can be found here: https://thermiq.net

This integration will evolve over time

Requirements

  • MQTT server and the MQTT integration set up in Home Assistant

  • ThermIQ-MQTT interface installed in your heatpump and properly configured to communicate over MQTT

  • A couple of Lovelace plugins

Quick start

  1. Make sure that ThermIQ is properly setup and communicating with the MQTT server
  2. Make sure that MQTT Integration in Home Assistant is setup and communicating with the MQTT server
  3. Make sure you have HACS set-up (https://github.com/custom-components/hacs).
  4. In HACS, Go to settings and install custom repository: https://github.com/ThermIQ/thermiq_mqtt-ha as Integration
  5. Go to the HACS integrations page, add ThermIQ integration.

Configuration

Component Configuration:

The complete configuration entry can be found in configuration_thermiq.yaml and should be copied to your configuration.yaml file.

# ThermIQ-MQTT configuration.yaml entry
# Set the mqtt_node name here. Thats all!
thermiq_mqtt:
  mqtt_node: ThermIQ/ThermIQ-mqtt
  
#Input entities for ThermIQ -> configuration.yaml
input_number:
  thermiq_rum_bor2:
    name: 'Indoor target temp.'
    initial: 11
    min:  0
    max:  50
    step: 1
    unit_of_measurement: 'C'
    icon: 'mdi:temperature'
    mode: slider

  thermiq_kurva:
    name: 'Curve'
    initial: 11
    min:  0
    max:  200
    step: 1
    unit_of_measurement: 'C'
    icon: 'mdi:temperature'
    mode: slider

Automations configuration

A complete automation between frontend input entities to the backend control is included in automations_thermiq.yaml and should be copied to your automations.yaml file.

Lovelace Configuration:

The file lovelace_config.yaml contains a complete setup of all available variables. A short example could look like:

#Input entities for ThermIQ -> configuration.yaml
input_number:
  thermiq_rum_bor2:
    name: 'Indoor target temp.'
    initial: 11
    min:  0
    max:  50
    step: 1
    unit_of_measurement: 'C'
    icon: 'mdi:temperature'
    mode: slider

  thermiq_kurva:
    name: 'Curve'
    initial: 11
    min:  0
    max:  200
    step: 1
    unit_of_measurement: 'C'
    icon: 'mdi:temperature'
    mode: slider

  thermiq_kurva_min:
    name: 'Curve min'
    initial: 11
    min:  0
    max:  200
    step: 1
    unit_of_measurement: 'C'
    icon: 'mdi:temperature'
    mode: slider

The lovelace setup requires the following custom card to be installed in HACS

- text-divider-row

Restart

The Home Assistant server needs to be restarted once all configuration is done

Features and Limitations

  • Currently provides all data from the heatpump in the form of sensors and binary sensors
  • Allows control over the heatpump

Contributing

Contributions are welcome! If you'd like to contribute, feel free to pick up anything on the current GitHub issues list! Also, help making a nice lovelace card would be great!

Code Formatting

This is a first hack. Our experience with Home Assistant is limited but expanding. In the future we should follow the core Home Assistant style guidelines. Code should be formatted with black and imports sorted with isort.