Intégrer un onduleur dans Home Assistant

Je vous retrouve une nouvelle fois pour un nouveau tutoriel consacré à la solution domotique Home Assistant. Aujourd’hui je vous propose, en effet, de vous expliquer, pas à pas, comment ajouter son onduleur dans Home Assistant et mettre en place une alerte lorsque celui-ci perd sa source d’alimentation et passe sur batterie.

Un peu de contexte…

Pour réaliser ce tutoriel, je m’appuie sur le matériel dont je dispose, à savoir une installation de Home Assistant sur un Raspberry Pi 4, et un onduleur de marque Eaton (le Ellipse Eco 650). Il se peut donc que vous ayez à adapter certains éléments de configuration en fonction de votre matériel, notamment de votre onduleur. Mais rassurez-vous, rien de trop complexe ici.

Le Ellipse Eco 650 de Eaton
Le Ellipse Eco 650 de Eaton

Etapes préparatoires

Avant de commencer, à intégrer l’onduleur dans Home Assistant, il est nécessaire de le raccorder via son port USB à notre machines HA (pour ma part un Raspberry Pi 4).

Une fois que c’est fait, nous allons avoir besoin de quelques informations à son sujet. Connectez vous donc à Home Assistant avec un compte administrateur et ouvrez le menu Paramètres via le raccourci situé en bas à gauche, puis cliquez sur Système.

Ouvrez le menu paramètres et sélectionnez "Système"
Ouvrez le menu paramètres et sélectionnez « Système »

Cliquez ensuite sur Matériel pour accéder aux informations… sur le matériel !

Cliquez sur
Cliquez sur « Matériel »

Cliquez maintenant sur le bouton TOUT LE MATERIEL

Cliquez sur
Cliquez sur « TOUT LE MATERIEL »

Et là on arrive à la partie un peu chiante de ce tutoriel. Déroulez les différents éléments de type « 1-1 » afin d’identifier votre onduleur. Une fois que vous l’avez trouvé, faites un copier/coller du DEVPATH ainsi que du ID_USB_VENDOR_ID car nous aurons besoin de ces informations plus tard.

Trouvez la partie correspondant à votre onduleur
Trouvez la partie correspondant à votre onduleur

Pour ma part, ça donne :

/devices/platform/scb/fd500000.pcie/pci0000:00/0000:00:00.0/0000:01:00.0/usb1/1-1/1-1.3

0463

Enfin, pour pouvoir intégrer un onduleur dans Home Assistant, nous allons avoir besoin d’installer un module complémentaire issu du Home Assistant Community Store. Si vous n’avez pas installé ce composant sur votre instance HA, je vous renvoie à mon article dédié à l’installation de HACS.

Intégration de l’onduleur dans Home Assistant.

L’intégration de notre onduleur va se faire en deux étapes :

  • Installation et configuration du module complémentaire Network UPS Tools qui discutera avec l’onduleur
  • Installation de l’intégration NUT qui récupérera les données du module complémentaire pour les intégrer dans HA

Installation du module complémentaire

Dans la barre latérale, cliquez en bas à gauche sur Paramètres, puis rendez vous dans modules complémentaires

Ouvrez le menu paramètres et sélectionnez "Modules complémentaires"
Ouvrez le menu paramètres et sélectionnez « Modules complémentaires »

Cliquez ensuite en bas sur boutique des modules complémentaires.

Cliquez sur 'BOUTIQUE DES MODULES COMPLÉMENTAIRES
Cliquez sur ‘BOUTIQUE DES MODULES COMPLÉMENTAIRES » pour ajouter un module

Dans la barre de recherche, saisissez simplement UPS et sélectionnez Network UPS Tools.

Recherchez le module complémentaire 'Network UPS Tools'
Recherchez le module complémentaire ‘Network UPS Tools’

Cliquez ensuite sur Installer.

Installez le module complémentaire NUT
Installez le module complémentaire NUT

Une fois l’installation terminée (c’est assez rapide en principe), on va devoir configurer notre module complémentaire avant de pouvoir le démarrer. Rendez-vous dans l’onglet Configuration.

Une fois le module installé, rendez-vous dans l'onglet 'Configuration'
Une fois le module installé, rendez-vous dans l’onglet ‘Configuration’

Dans la partie users nous allons devoir définir un nom d’utilisateur et un mot de passe. Ceux-ci seront utilisées par l’intégration NUT pour communiquer avec le module complémentaire. renseignez donc ces deux champs. Pour ma part, voici ce que ça donne :

- username: nut
password: Pass2nut
instcmds:
- all
actions: []

Ensuite, dans la partie devices, on va devoir renseigner les informations relatives à notre onduleur que nous avons collectées au début de ce tutoriel, à savoir l’info DEVPATH et le ID_USB_VENDOR_ID. Il convient d’insérer ici les informations au bon endroit. Notez que vous pouvez également donner un nom et une description à votre onduleur. Voici ce que cela donne dans mon exemple :

- name: eaton-ellipse-650
driver: usbhid-ups
port: >-
/devices/platform/scb/fd500000.pcie/pci0000:00/0000:00:00.0/0000:01:00.0/usb1/1-1/1-1.3
config:
- vendorid = 0463
- desc = "Eaton Allipse 650 - Cellier"

Si vous disposez de plusieurs onduleurs, alors il vous faudra répéter ce bloc pour chaque appareil. Une fois que vous avez terminé votre saisie, cela devrait ressembler à ceci :

La configuration du module
La configuration du module « Network UPS Tools »

Laissez le mode netserver activé et vous pouvez, au choix activer ou désactiver les deux fonctions shutdown_host et list_usb_devices.

  • shutdown_host : permet à l’onduleur d’éteindre la machine faisant tourner HA en cas de perte de courant électrique
  • list_usb_devices : permet d’avoir la liste des appareils connectés en USB lorsque le module démarre. Cette option peut être pratique si vous avez plusieurs onduleurs afin de pouvoir les identifier facilement.

Pour ma part, je laisse les deux options désactivées. Descendez ensuite dans la page de configuration.

Suite de la configuration du module
Suite de la configuration du module « Network UPS Tools »

Là encore, deux options sont proposées. Celles-ci devraient, selon moi, rester désactivées :

  • I_like_be_powned : cette option permet de contourner les exigences relatives aux mot de passe. Il est clairement recommandé de laisser cette option désactivée ! 😉
  • leave_front_door_open : cette option permet de supprimer l’authentification NUT. Si vous l’activez, laisser l’utilisateur et le mot de passe vides.

Une fois que vos paramètres sont renseignés, cliquez sur le bouton Enregistrer. Retournez maintenant dans l’onglet Info activez les options souhaitées (le démarrage automatique, le chien de garde et la mise à jour automatique) et cliquez sur le bouton Démarrer.

Démarrez maintenant le module complémentaire
Démarrez maintenant le module complémentaire

On est bon pour le module complémentaire. On va maintenant passer à l’intégration NUT.

Installation de l’intégration NUT

Pour pouvoir traiter et afficher les données recueillies par le module complémentaire Network UPS Tools nous allons devoir ajouter une intégration à Home Assistant. Ouvrez donc le menu Paramètres et cliquez sur Appareils et services.

Ouvrez le menu paramètres et sélectionnez
Ouvrez le menu paramètres et sélectionnez « Appareils et services »

Cliquez ensuite sur le bouton Ajouter une intégration situé en bas à droite.

Cliquez en bas à droite sur
Cliquez en bas à droite sur « Ajouter une intégration »

Recherchez ensuite l’intégration adéquate en saisissant UPS et cliquez dessus pour l’installer.

Recherchez l'intégration
Recherchez l’intégration « Network UPS Tools (NUT) »

Dans la fenêtre suivante, vous allez devoir renseigner les éléments de configuration permettant à l’intégration NUT de discuter avec le module complémentaire. Pour ce qui est du champs hôte, vous devez renseigner la valeur a0d7b954-nut. C’est par ce nom qu’est appelé votre module complémentaire. Pour le port, nous l’avons laissé par défaut dans la configuration du module, donc vous devez laisser 3493. Enfin, rentrez le nom l’utilisateur et le mot de passe que vous avez défini plus tôt dans ce tutoriel. Une fois tous les champs remplis, cliquez sur Valider.

Renseignez la configuration de votre module complémentaire NUT
Renseignez la configuration de votre module complémentaire NUT

Si la communication se fait bien, votre onduleur est détecté, et HA vous l’affiche. Vous pouvez alors lui assigner une pièce.

Ajout de l'onduleur dans HA
Ajout de l’onduleur dans HA

Et voilà, nous avons réussi a intégrer un onduleur dans Home Assistant comme le montre la fenêtre Aperçu de HA. On y retrouve en effet plusieurs données sur notre appareil comme son état, sa charge de courant ou encore le niveau de charge de sa batterie.

Les informations de l'onduleur dans Home Assistant
Les informations de l’onduleur dans Home Assistant

Et bien Mission Accomplie ! Notre onduleur fait maintenant partie de notre solution domotique. C’est pas mal, mais on va aller un peu plus loin. Il pourrait être en effet intéressant d’être notifié lorsque l’onduleur perd son alimentation et passe en mode batterie non ? Aller, on va regarder ça.

Définir des notifications pour l’onduleur

Pour ce tutoriel, nous allons créer une alerte par mail mentionnant le changement d’état de l’onduleur, avec horodatage de l’événement. On recevra alors une information de type :

L’onduleur du Cellier est passé en mode ONLINE le 10/2/2022 à 18:37:53

Ouvrez donc le menu Paramètres et cliquez sur Automatisations et scènes.

Ouvrez le menu paramètres et sélectionnez
Ouvrez le menu paramètres et sélectionnez « Automatisations et scènes »

Cliquez en bas sur le bouton Créer une automatisation.

Cliquez sur le bouton
Cliquez sur le bouton « Créer une automatisation »

Sélectionnez ensuite l’option Créer une nouvelle automatisation.

Sélectionnez l'option
Sélectionnez l’option « Créer une nouvelle automatisation »

Dans la partie Quand, cliquez sur le bouton Ajouter un déclencheur.

Cliquez sur le bouton "Ajouter un déclencheur"
Cliquez sur le bouton « Ajouter un déclencheur »

Sélectionnez Entité puis Etat.

Sélectionnez
Sélectionnez « Entité » puis « Etat »

Dans le menu déroulant de l’entité, sélectionner l’entité état de votre onduleur. Pour ma part cette entité s’appelle Eaton-Ellipse-650 Etat.

Sélectionnez l'entité d'état de votre onduleur
Sélectionnez l’entité d’état de votre onduleur

Sélectionner ensuite N’importe quel état dans les champs De et A.

Définir l'état "De" et "A" sur "N'importe quel état"
Définir l’état « De » et « A » sur « N’importe quel état »

Rendez-vous maintenant dans la partie Alors faire et cliquez sur le bouton Ajouter une action.

Cliquez maintenant sur le bouton "Ajouter une action" en bas de la page
Cliquez maintenant sur le bouton « Ajouter une action » en bas de la page

Saisissez ‘notifications’ et sélectionnez Notifications : Send a notification with email.

Sélectionnez "Notifications: Send a notification with email"
Sélectionnez « Notifications: Send a notification with email »

L’idée va être de définir une alerte mail en cas de changement de statut de l’onduleur ressemblant à ceci :

Onduleur du Cellier est passé en mode ONLINE le 23/2/2025 à 11:54:37

Pour cela, on va devoir passer par l’éditeur YAML car l’interface graphique de HA ne permet pas d’aller aussi loin dans les notifications. Cliquez donc sur les trois points et sélectionnez modifier en yaml.

Un exemple de notification email en cas de coupure de courant.

Cliquez sur
Cliquez sur « Modifier n YAML »

Copiez maintenant le code ci-dessous dans l’éditeur YAML :

action: notify.email
metadata: {}
data:
message: >-
Onduleur du Cellier est passé en mode {% if
states.sensor.eaton_ellipse_650_etat.state == 'Online' %}ONLINE{% elif
states.sensor.eaton_ellipse_650_etat.state == 'On Battery' %}SUR BATTERIE{%
endif %} le {{ now().day }}/{{now().month}}/{{ now().year }} à {{ now().hour
}}:{{ now().minute }}:{{ now().second }}
target: mail.exemple@mail.com
title: Onduleur Cellier

Bien évidemment, il va falloir adapter ce code. Première chose à faire, nous pouvez remplacer mail.exemple@mail.com par l’adresse mail qui sera destinataire de l’alerte mail. Ensuite, vous allez devoir remplacer les entités pour qu’elles correspondent à votre onduleur. Supprimez donc les deux states.sensor.eaton_ellipse_650_etat.state et saisissez states.sensor. et Home Assistant devrait ensuite vous proposer des entités… Il ne reste plus qu’à sélectionnez celle qui correspond à l’état de votre onduleur, et à ajouter .state à la fin. Vous devriez alors avoir quelque chose qui ressemble à ça :

Voici un exemple de définition de notification avancée pour un onduleur
Voici un exemple de définition de notification avancée pour un onduleur

Cliquer sur Enregistrer, donner un nom à cette automatisation et cliquez sur Enregistrer

Donnez un nom à votre alerte en cliquer sur 'Enregistrer'
Donnez un nom à votre alerte en cliquer sur ‘Enregistrer’

Aperçu des notifications

Et voilà ! Dorénavant lorsque vous subirez une coupure de courant, vous recevrez une notification comme celle-ci à chaque changement d’état (passage Offline, passage Online…)

Exemple d'email de notification
Exemple d’email de notification

Sandstorm

Ingénieur Systèmes passionné d'informatique et de High-Tech, Sandstorm a créé JusteGeek.fr en 2013. Il aime les geekeries en tout genre. "Si un produit s'allume c'est un bon point. S'il est connecté, c'est encore mieux !"

Vous aimerez aussi...

Laisser un commentaire

Votre adresse e-mail ne sera pas publiée. Les champs obligatoires sont indiqués avec *

Ce site utilise Akismet pour réduire les indésirables. En savoir plus sur la façon dont les données de vos commentaires sont traitées.