Skip to content

Latest commit

 

History

History
103 lines (76 loc) · 4.09 KB

README.md

File metadata and controls

103 lines (76 loc) · 4.09 KB
Raw

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

  • name (Optional): Friendly name for this fan
  • ip_address (Required): IP address of this fan
  • port (Optional): Port of device. Need to be set if you have changed port or your device has a different port than the default value. The default port is 4000
  • device_id (Optional): The ID of the device. Sometimes the integration fails to get the device ID. In this case, try restarting HomeAssistant or manually enter your device ID in this field.
  • password (Optional): Password of the fan. Necessary to set if you have changed password or your device has a different password than the default. The default pass is 1111

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.