Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/ldotlopez/ha-ideenergy
ideenergy integration for home-assistant
https://github.com/ldotlopez/ha-ideenergy
automation energy energy-consumption home-assistant home-assistant-component spain
Last synced: 14 days ago
JSON representation
ideenergy integration for home-assistant
- Host: GitHub
- URL: https://github.com/ldotlopez/ha-ideenergy
- Owner: ldotlopez
- License: gpl-3.0
- Created: 2021-08-26T15:53:08.000Z (about 3 years ago)
- Default Branch: main
- Last Pushed: 2024-10-16T07:12:54.000Z (28 days ago)
- Last Synced: 2024-10-19T07:16:07.472Z (25 days ago)
- Topics: automation, energy, energy-consumption, home-assistant, home-assistant-component, spain
- Language: Python
- Homepage:
- Size: 1.01 MB
- Stars: 74
- Watchers: 14
- Forks: 13
- Open Issues: 18
-
Metadata Files:
- Readme: README.es.md
- License: LICENSE
Awesome Lists containing this project
README
# i-DE (Iberdrola Distribución) Custom Integration for Home Assistant
[![hacs_badge](https://img.shields.io/badge/HACS-Custom-orange.svg)](https://github.com/custom-components/hacs)
[![hassfest validation](https://github.com/ldotlopez/ha-ideenergy/workflows/Validate%20with%20hassfest/badge.svg)](https://github.com/ldotlopez/ha-ideenergy/actions/workflows/hassfest.yml)
[![HACS validation](https://github.com/ldotlopez/ha-ideenergy/workflows/Validate%20with%20HACS/badge.svg)](https://github.com/ldotlopez/ha-ideenergy/actions/workflows/hacs.yml)![GitHub Release (latest SemVer including pre-releases)](https://img.shields.io/github/v/release/ldotlopez/ha-ideenergy?include_prereleases)
[![CodeQL](https://github.com/ldotlopez/ha-ideenergy/actions/workflows/codeql-analysis.yml/badge.svg)](https://github.com/ldotlopez/ha-ideenergy/actions/workflows/codeql-analysis.yml)
[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/ambv/black)[ideenergy](https://github.com/ldotlopez/ideenergy) integration for [home-assistant](https://home-assistant.io/)
Esta integración provee sensores para el distribuidor de energía español [i-DE](i-de.es).
Require de un usuario **avanzado** en la página web del distribuidor.
**⚠️ Asegurese de leer la [FAQ](https://github.com/ldotlopez/ha-ideenergy/blob/main/FAQ.md)' y las secciones 'advertencias' y 'dependencias'.**
## Características
* Integración con el panel del energía de Home Assistant
* Sensores de consumo instantaneo y acumulado.
* Sensores históricos (consumulo y generación solar) con mayor precisión (sub-kWh). Estos datos no son tiempo real y normalmente llevan un retraso de entre 24 y 48 horas.
* Soporte para varios contratos (puntos de servicio).
* Configuración a través del [interfaz web de Home Assistant](https://developers.home-assistant.io/docs/config_entries_options_flow_handler) sin necesidad de editar ficheros YAML.
* Algoritmo de actualización para leer el contador cerca del final de cada periodo horario (entre el minuto 50 y 59) y una mejor representación del consumo en el panel de energía de Home Assistant
* Totalmente [asíncrono](https://developers.home-assistant.io/docs/asyncio_index) e integrado en Home Assistant.
## Dependencies
Es necesario disponer de acceso al área de clientes de i-DE.
Puedes registrarte en el siguiente link: [Área Clientes | I-DE - Grupo Iberdrola](https://www.i-de.es/consumidores/web/guest/login).Además es necesario disponer del perfil de "Usuario avanzado". Si no se dispone de él hay que rellenar un formulario del [Perfil de cliente](https://www.i-de.es/consumidores/web/home/personal-area/userData).
### Usando [HACS](https://hacs.xyz/) (recomendado)
1. Copia la dirección de este repositorio: [https://github.com/ldotlopez/ha-ideenergy](https://github.com/ldotlopez/ha-ideenergy/)
2. Añade este repositorio en HACS como "repositorio manual":
- En el campo "Repositorio" pega la URL anterior.
- En el campo "Categoría" elige "Integración"
- Pulsa el botón "Descargar" y elige la última versión.![Custom repository](https://user-images.githubusercontent.com/59612788/171965822-4a89c14e-9eb2-4134-8de2-1d3f380663e4.png)
3. Reinicia Home Assistant
4. Configura la integración
- (Opción A) Pulsa el botón "Añadir integración" → [![Open your Home Assistant instance and start setting up a new integration.](https://my.home-assistant.io/badges/config_flow_start.svg)](https://my.home-assistant.io/redirect/config_flow_start/?domain=ideenergy)
- (Opción B) Navega a "Ajustes" → "Dispositivos y servicios" y pulsa "Añadir integración". Elige "i-DE.es sensores de energía".
![image](https://user-images.githubusercontent.com/59612788/171966005-e58f6b88-a952-4033-82c6-b1d4ea665873.png)5. Sigue los pasos del asistente: Proporciona tus credenciales de acceso para el área de cliente de "i-DE", después elige el contrato qu deseas monitorizar. Si necesitas añadir más contratos repite los pasos anteriores para cada uno de ellos.
## Instalación
A través de custom_components o [HACS](https://hacs.xyz/)
1. Descarga o clona este repositorio: [https://github.com/ldotlopez/ha-ideenergy](https://github.com/ldotlopez/ha-ideenergy)
2. Copia la carpeta `custom_components/ideenergy` en tu carpeta `custom_components` de tu instalación de Home Assistant.
3. Reinicia Home Assistant
4. Configura la integración- (Opción A) Pulsa el botón "Añadir integración" → [![Open your Home Assistant instance and start setting up a new integration.](https://my.home-assistant.io/badges/config_flow_start.svg)](https://my.home-assistant.io/redirect/config_flow_start/?domain=ideenergy)
- (Opción B) Navega a "Ajustes" → "Dispositivos y servicios" y pulsa "Añadir integración". Elige "i-DE.es sensores de energía".
![image](https://user-images.githubusercontent.com/59612788/171966005-e58f6b88-a952-4033-82c6-b1d4ea665873.png)5. Sigue los pasos del asistente: Proporciona tus credenciales de acceso para el área de cliente de "i-DE", después elige el contrato qu deseas monitorizar. Si necesitas añadir más contratos repite los pasos anteriores para cada uno de ellos.
## Capturas
*Sensor de energía acumulada*
![snapshot](screenshots/accumulated.png)
*Sensor de histórico de energía*
![snapshot](screenshots/historical.png)
*Asistente de configuración*
![snapshot](screenshots/configuration-1.png)
![snapshot](screenshots/configuration-2.png)## Advertencias
Esta integración provee un sensor 'histórico' que incorpora datos del pasado en la base de datos de Home Assistant. Por su propia seguridad este sensor no está habilitado y debe activarse manualmente.☠️ El sensor histórico está basado en un **hack extremadamente experimental** y puede romper y/o corromper su base de datos y/o estadísticas. **Use lo bajo su propio riesgo**.