naveda89 / ha-ideenergy

ideenergy integration for home-assistant

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

i-DE (Iberdrola Distribución) Custom Integration for Home Assistant

hacs_badge GitHub Release (latest SemVer including pre-releases) hassfest validation HACS validation Code style: black

ideenergy integration for home-assistant

i-DE (Iberdrola Distribución) Custom Integration for Home Assistant, providing sensors for Spanish Energy Distributor i-DE.

This integration requires an advanced user profile on i-DE website.

⚠️ Make sure to read the 'Remarks', 'Dependencies' and 'Warning' sections

Features

  • Integration with the Home Assistant Energy Panel.
  • Support for several contracts.
  • Accumulated consumption sensor.
  • Experimental sensor for historical consumption data with better (sub-kWh) precision. Same data as available on i-DE website. This data is not realtime and usually has a 24-hour to 48-hour offset.
  • Configuration through Home Assistant Interface without the need to edit YAML files.
  • Update algorithm to read the ICP near the end of each hourly period (between minute 50 and 59) with a better representation of consumption in the Home Assistant energy panel.
  • Fully asynchronous and integrated with HomeAssistant.

Remarks

  • The reading is done directly to your meter. Due to connectivity issues or i-DE server issues, you may not always obtain readings as expected. Keep in mind that sometimes a delay on the reading may occurr.
  • The reading only returns integer values. If from the last reading your meter indicates a variance minor then 1 kWh, the integration will not reflect any variance and that will only be recorded once the variance from the previous reading is greater then 1.
  • Solar Production (if applies on your case) is under development.

Dependencies

You must have an i-DE username and access to the Clients' website. You may register here: Área Clientes | I-DE - Grupo Iberdrola.

It also necessary to have an "Advanced User" profile. Should you not have one already, you need to fill the request for from your Profile Area.

Installation

Using HACS (recommended)

  • Copy this repo URL

  • In the HACS section, add this repo as a custom one:

    Custom repository

    • On the "Repository" field put the URL copied before
    • On the "Category" select "Integration"
    • Click the "Download" button and download latest version.
  • Restart HA

  • Click this button >> Open your Home Assistant instance and start setting up a new integration.

  • or Go to "Settings" >> "Devices & Services" and click "+ ADD INTEGRATION" and select "i-de.es energy sensors"
    image

  • Follow the configuration steps: provide your credentials for access to i-DE and select the contract that you want to monitor. (Should you need to add more contracts, just follow the previous step as many times as needed).

Manually

  • Download/clone this repo
  • Copy the custom_components/ide folder into your custom_components folder into your HA installation
  • Restart HA
  • Click this button >> Open your Home Assistant instance and start setting up a new integration.
  • or Go to "Settings" >> "Devices & Services" and click "+ ADD INTEGRATION" and select "i-de.es energy sensors" image
  • Follow the configuration steps: provide your credentials for access to i-DE and select the contract that you want to monitor. (Should you need to add more contracts, just follow the previous step as many times as needed).

Snapshots

Accumulated energy sensor

snapshot

Historical energy sensor

snapshot

Configuration wizard

snapshot snapshot

Warnings

This extension provides an 'historical' sensor to incorporate data from the past into Home Assistant database. For your own safety the sensor is not enabled by default and must be enabled manually.

☠️ Historic sensor is based on a high experimental hack and can broke and/or corrupt your database and/or statistics. Use at your own risk.

License

This project is licensed under the GNU General Public License v3.0 License - see the LICENSE file for details

Disclaimer

THIS PROJECT IS NOT IN ANY WAY ASSOCIATED WITH OR RELATED TO THE IBERDROLA GROUP COMPANIES OR ANY OTHER. The information here and online is for educational and resource purposes only and therefore the developers do not endorse or condone any inappropriate use of it, and take no legal responsibility for the functionality or security of your devices.

About

ideenergy integration for home-assistant

License:GNU General Public License v3.0


Languages

Language:Python 100.0%