Skip to content

ldotlopez/ha-ideenergy

Repository files navigation

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

hacs_badge hassfest validation HACS validation

GitHub Release (latest SemVer including pre-releases) CodeQL 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 'FAQ', 'Dependencies' and 'Warning' sections

Features

  • Integration with the Home Assistant Energy Panel.

  • Accumulated and Instant consumption sensors.

  • Historical sensors (both consumption and solar generation) with better (sub-kWh) precision. This data is not realtime and usually has a 24-hour to 48-hour offset.

  • Support for multiple contracts (service points).

  • Configuration through Home Assistant Interface without the need to edit YAML files.

  • Update algorithm to read the meter 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.

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)

  1. Copy this repository URL: https://github.com/ldotlopez/ha-ideenergy

  2. In the HACS section, add this repository as a custom one:

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

Custom repositorysitory

  1. Restart HA

  2. Configure the integration

  • (Option A) Click the "Add integration" button → Open your Home Assistant instance and start setting up a new integration.

  • (Option B) Go to "Settings" "Devices & Services" and click "+ ADD INTEGRATION" and select "i-de.es energy sensors".
    image

  1. 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

  1. Download/clone this repository: https://github.com/ldotlopez/ha-ideenergy

  2. Copy the custom_components/ideenergy folder into your custom_components folder into your HA installation

  3. Restart HA

  4. Configure the integration

  • (Option A) Click on this button → Open your Home Assistant instance and start setting up a new integration.
  • (Option B) Go to "Settings" → "Devices & Services" and click "+ ADD INTEGRATION" and select "i-de.es energy sensors".
    image
  1. 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.