49jan / hass-ecovent

Custom component for Home Asistant.
MIT License
14 stars 3 forks source link
blauberg home-assistant home-assistant-custom homeassistant ventilation

EcoVent Home Assistant Integration

HACS Badge

Home Assistant custom component for heat recovery ventilation units. See below sections for details about 'supported' ventilation units.

Installation

HACS

The recommended way of installing this component is using the Home Assistant Community Store. To install the integration follow these steps:

  1. Go to the HACS Settings and add the custom repository 49jan/hass-ecovent with category "Integration".
  2. Open the "Integrations" tab and search for "EcoVent".
  3. Follow the instructions on the page to set the integration up.

Manual installation

Copy the contents of the custom_components folder to the custom_components folder in your Home Assistant config directory. You may need to create the custom_components folder if this is the first integration you're installing. It should look something like this:

├── custom_components
│   └── ecovent
│       ├── __init__.py
│       ├── configuration.yaml
│       ├── const.py
│       ├── fan.py
│       ├── manifest.json
│       └── services.yaml

Follow the instructions in the info.md file for the configuration and usage documentation.

Configure Home Assistant

The device must be pre-connected to the network and in the same LAN as home-assistant.

Configuration Variables

Configuration Example

This configuration example assumes that the fan is already paired on the local network.

fan:
  - platform: ecovent
    ip_address: "192.168.1.200"

  - platform: ecovent
    name: Kitchen fan
    ip_address: "192.168.1.205"
    device_id: "85481285"
    port: 4000
    password: !secret blauberg_pass

Add Lovelace Card

The following is a basic Lovelace card using the fan-percent-button-row customization:

Blauberg Simple Example

- entity: fan.basement_fan 
  type: custom:fan-percent-button-row

And another example with multiple Blauberg ventilation fans and ability to turn on/off the entire house:

Blauberg Simple Example

type: entities
title: Blauberg Ventilation
entities:
  - entity: fan.basement_fan 
    name: Basement
    type: 'custom:fan-percent-button-row'
  - entity: fan.bedrooms_fan
    type: 'custom:fan-percent-button-row'
  - entity: fan.bathroom_fan
    name: Master Bathroom
    type: 'custom:fan-percent-button-row'

Tested fans

This component has only been tested on two Blauberg Vento Expert A50-1 W which are configured as master.

There are fans from Blauberg and Flexit that are identical and should work, but I have not verified that.