ldotlopez / ha-ideenergy

ideenergy integration for home-assistant
GNU General Public License v3.0
74 stars 13 forks source link
automation energy energy-consumption home-assistant home-assistant-component spain

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

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

  3. Restart HA

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

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