Cette intégration personnalisée permet de récupérer vos données de consommation d'eau depuis le portail Iléo (Métropole Européenne de Lille) et de les intégrer nativement dans Home Assistant. Elle gère intelligemment le décalage de publication des données pour offrir un suivi historique précis ou au choix un index de compteur a intégrer au jour le jour.
- Assurez-vous que HACS est installé.
- Allez dans HACS > Intégrations.
- Cliquez sur les trois points en haut à droite et choisissez Dépôts personnalisés.
- Copiez l'URL suivante :
https://github.com/hal01/ileo_direct. - Sélectionnez la catégorie Intégration et cliquez sur Ajouter.
- Cherchez Iléo Direct dans la liste, cliquez sur Télécharger, puis redémarrez Home Assistant.
- Téléchargez le dossier
ileo_directdepuis ce dépôt. - Copiez-le dans le répertoire
custom_components/de votre instance Home Assistant. - Redémarrez Home Assistant.
- Allez dans Paramètres > Appareils et services > Ajouter une intégration.
- Recherchez Iléo.
- Saisissez vos identifiants (Email et Mot de passe).
- Option Historique : Lors de la première installation ou via le bouton "Modifier les identifiants", vous pouvez cocher la case "Réécrire l'historique du Dashboard Énergie".
- Cochée : Importe les 6 derniers mois de données (recommandé pour une première installation).
- Décochée : Initialise le compteur à sa valeur actuelle sans importer le passé.
L'intégration génère trois capteurs pour répondre à tous vos besoins :
| Nom de l'entité | ID de l'entité | État visible | Usage |
|---|---|---|---|
| Ileo Compteur Eau (Index) | sensor.ileo_compteur_eau_index |
✅ Litres | Suivi de l'index réel et création de compteurs périodiques. |
| Ileo Consommation Eau (journalière) | sensor.ileo_consommation_eau_journaliere |
✅ Litres | Affichage de la consommation du dernier relevé connu. |
| Ileo Index Mode Ghost | sensor.ileo_index_mode_ghost |
❌ Unknown | Exclusif au Tableau de bord Énergie. |
Ce capteur est un "injecteur statistique pur". Son état court terme reste délibérément Unknown pour ne pas polluer votre base de données courante. Il travaille en arrière-plan pour injecter vos index directement dans la table des statistiques à long terme à la date exacte de consommation trouvée sur Iléo.
Pour un suivi précis, configurez votre consommation d'eau comme suit :
- Allez dans Paramètres > Tableaux de bord > Énergie.
- Dans la section Consommation d'eau, ajoutez une source.
- Méthode Recommandée : Choisissez le capteur
Ileo Index Mode Ghost.- Grâce à l'injection statistique, vos 200L consommés le lundi apparaîtront sur la colonne du lundi, même si Iléo ne publie l'info que le mercredi.
- A noter que ce mode est plus précis sur les dates de consommation, mais ne permet pas d'utiliser les couts.
- Méthode Alternative : Utilisez
Ileo Compteur Eau (Index). La consommation sera alors enregistrée au moment de la synchronisation (souvent avec 2 jours de décalage). Ainsi, la consommation du Lundi etant récupérée le Mercredi, elle apparaitra le Mercredi. - Après la mise a jour, il est recommandé d'utiliser l'outil statistiques présent dans le menu "outils de développement" pour corriger les valeurs abérantes ; c'est a dire souvent la première valeur intégrée qui donne une consommation en litre égale à l'index, alors que les suivantes sont basées sur une différence d'index.
En synthèse pour le choix du capteur du tableau énergie :
- Si la priorité c'est la consommation positionnée a la bonne date et avec un historique ==>
Ileo Index Mode Ghost. - Si la priorité c'est une conso globale sur une periode avec gestion des coûts ==>
Ileo Compteur Eau (Index).
Le capteur Ileo Compteur Eau (Index) étant de type total_increasing, il est parfait pour créer des compteurs mensuels ou annuels :
- Allez dans Paramètres > Appareils et services > Entrées.
- Cliquez sur Créer une entrée > Compteur de services publics.
- Sélectionnez
sensor.ileo_compteur_eau_indexcomme capteur d'entrée. - Définissez la période (Mensuelle, Hebdomadaire, etc.).
Le capteur Ghost interroge systématiquement votre historique en base de données avant chaque mise à jour. Il n'injecte que les données "nouvelles" pour éviter les doublons ou les pics erronés, tout en forçant la valeur de la somme égale à l'index pour une cohérence parfaite dans le tableau Énergie.