jontofront / ecoNET-300-Home-Assistant-Integration

ecoNET 300 integration to HA
11 stars 2 forks source link
custom-components custom-integration ecomax econet econet300 home-assistant plum

Disclaimer

Due to a stall on the original pblxptr/ecoNET-300-Home-Assistant-Integration repo, we have forked. Most of the work was done by pblxpt, for which we're very thankful as the community.

ecoNET300 Home Assistant integration

Code_formatter hacs_badge HACS Action stability-alpha Validate with hassfest

| Home Assistant | ecoNET300 | device | | --------------- | ------------- | ------------- | | | | |

Overview

ecoNET300 Home Assistant is a custom integration for ecoNET300 devices.

It works locally, which means it connects directly to your local device using local IP address. It doesn't forward commands/requests through econet24.com. It uses rest api exposed by ecoNET300 device.

This integration is available from the Lovelace frontend without the need to configure the devices in the file configuration.yaml

Integration tested with ecoMAX controller ecoMAX810P-L TOUCH manufactured by Plum Sp. z o.o.

Bear in mind that the project is in a very early, pre-alpha phase.

versions

:arrow_up: Migration to version 2 (v1.0.0_beta)

❗ This is a "version reset" release ❗ Migrations are not supported from previous versions! Please remove the integration and start anew with this version.

Example

Here is an example setup showing econet300 device entities:

HACS Installation

Follow this guide to add ecoNET-300-Home-Assistant-Integration as a custom repository to the HACS. Use this url as a repo:

https://github.com/jontofront/ecoNET-300-Home-Assistant-Integration

Manual Installation

Copy the custom_components folder your configuration directory. It should look similar to this:

<config directory>/
|-- custom_components/
|   |-- econet300/
|       |-- [...]

Configuration

Adding ecoNET300 integration to your Home Assistant instance can be done via user interface, by using this My button:

Add integration

Manual Configuration Steps Apart from using 'My button' (in case it doesn't work) you can also perform the following steps manually: 1. Browse to your Home Assistant instance. 2. In the sidebar click on Settings. 3. From the configuration menu select: Devices & Services. 4. In the bottom right, click on the Add Integration button. 5. From the list, search and select "ecoNET300". ![Search dialog](images/search.png) 6. Enter your connection details and click `Submit`. __Host__: Local IP/domain of your device. __Username__: Local username (NOT the username that you use to login to econet24.com!). __Password__: Local password (NOT the password that you use to login to econet24.com!). ![Configuration dialog](images/configure.png) 7. Your device should now be available in your Home Assistant installation. ![Success](images/success.png)


Entities

Sensors

Binary sensors

Contributing

This is HA integration open-source project. We are always open to people who want to use the code or contribute to it.

Contributors

Many thanks to @denpamusic for his help and pointing me in the right direction


DISCLAIMER

I AM NOT RESPONSIBLE FOR ANY USE OR DAMAGE THIS SOFTWARE MAY CAUSE. THIS IS INTENDED FOR EDUCATIONAL PURPOSES ONLY. USE AT YOUR OWN RISK.