Skip to content

This custom integration for Home Assistant retrieves and imports energy consumption data from Enel Italia

License

Notifications You must be signed in to change notification settings

sathia-musso/enelgrid

Repository files navigation

Home Assistant - enelgrid Integration

This custom integration for Home Assistant retrieves and imports hourly and daily energy consumption data from Enel Italia, making it available in Home Assistant's Energy Dashboard.

📋 Features

  • 📊 Automatic login using Enel's SAML authentication process.
  • 🔄 Supports re-authentication if the login process encounters issues.
  • 🕒 Fetches and tracks hourly energy consumption (Enel provides data with a three-day delay).
  • 📈 Tracks monthly cumulative consumption.
  • ✅ Seamless integration with Home Assistant Energy Dashboard.
  • 🔁 Automatically updates data daily.

🛠️ Installation

Manual Installation

  1. Copy the enelgrid folder into:
    config/custom_components/enelgrid
    
  2. Restart Home Assistant.
  3. In Home Assistant, go to:
    Settings → Devices & Services → Add Integration
    Search for "enelgrid".
  4. Enter your Enel login credentials and POD details.

Installation via HACS (Recommended)

  1. In HACS, go to Integrations.
  2. Add this repository as a Custom Repository (if it's not already in HACS).
  3. Search for "enelgrid" and install.
  4. Restart Home Assistant.
  5. Follow the setup steps in Settings → Devices & Services.

⚙️ Configuration

During setup, you’ll need to provide:

  • Username Your Enel account email
  • Password
  • POD Number Found on your Enel bill
  • User Number Also found on your Enel bill
  • Price per Kwh - Take your total electricity bill amount and divide it by the total kWh consumed (as shown on your bill) to get a reasonable estimate for the price per kWh

These credentials are stored securely in Home Assistant's config_entries storage.

After this go to your Energy settings and configure the statistics like this:

Description of Image

if all goes well, you should see something like this:

Description of Image

🕒 Automatic Data Fetching

  • Data is automatically fetched every day.
  • Data is also fetched immediately upon first installation.

🏷️ Supported Features

Feature Status
Hourly Energy Data
Daily Energy Data
Monthly Cumulative Sensor
Energy Dashboard Integration
Automatic Login
Automatic Daily Fetch
Re-authentication Support

🔗 Links

🧑‍💻 Developer

This integration was developed by Sathia Francesco Musso.
Contributions and feedback are welcome!


📜 License

This project is licensed under the MIT License.

About

This custom integration for Home Assistant retrieves and imports energy consumption data from Enel Italia

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages