Skip to content

ideenergy integration for home-assistant

License

Notifications You must be signed in to change notification settings

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 a 'historical' sensor to incorporate past data into your Home Assistant database. For safety reasons, the sensor is disabled by default and must be enabled manually.

☠️ The historical sensor is based on a highly experimental hack and could corrupt your database and/or statistics. Use with extreme caution and 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.