Après avoir présenté ma jauge connectée pour cuve à mazout et partagé l’architecture de ma box domotique sous Home Assistant il était temps de passer à la vitesse supérieure : développer ma propre intégration Home Assistant.
Pourquoi ? Parce que la jauge que j’utilise, fournie par Fullup, ne dispose pas (encore ?) d’intégration officielle dans Home Assistant. Pourtant, Fullup propose une API REST documentée — et c’est tout ce qu’il me fallait pour me lancer dans le développement de ma première intégration personnalisée.
Objectif : suivre le niveau de mazout depuis mon dashboard
Mon besoin était simple : récupérer automatiquement le niveau de mazout mesuré par la jauge Fullup et l’afficher dans mon tableau de bord Home Assistant.
Plutôt que de bricoler une automatisation avec RESTful Sensor dans le fichier YAML, j’ai préféré créer une intégration propre, en Python, avec tout ce qu’il faut : configuration dans l’UI, entités bien déclarées, support de l’authentification à l’API, etc.
Une première pour moi
C’est littéralement ma première intégration Home Assistant, et je dois bien avouer que j’ai été assez submergé par l’ensemble de leur framework
- Le système de plateformes (sensor, binary_sensor, button, etc.)
- La gestion des flux de configuration via le config_flow
- Et surtout… la patience que ça demande pour lire la doc et faire fonctionner tout ça
Mais au final, après quelques (lol plein) essais/erreurs, j’ai réussi à créer une intégration stable, qui :
- Se configure via l’interface
- Demande les identifiants Fullup (email + mot de passe)
- Récupère le(s) niveau(x) de cuve à intervalle régulier
- Affiche tout ça sous forme d’entité sensor, avec les bons attributs
À quoi ça ressemble dans Home Assistant ?
Une fois l’intégration installée et configurée, on retrouve un device avec les sensors suivants :
- Le volume total de la cuve
- Le volume courant
- Le niveau de la batterie
- La date de la dernière connexion à l’API
- La date du dernier relevé
- La température de la cuve
C’est parfait pour suivre la consommation de mazout dans le temps, déclencher une alerte si le niveau devient trop bas ou si le niveau de la batterie est trop faible.
Comment l’installer ?
Pour l’instant l’intégration est à installer manuellement, il faut ajouter mon repository git https://github.com/zedissime/ha-fullup comme repository custom.
