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.

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.

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

Cliquez maintenant sur le bouton 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.

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. 

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

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

Cliquez ensuite sur Installer.

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.

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 :

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.

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.

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.

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

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

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.

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

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.

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.

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

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

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

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électionner ensuite N’importe quel état dans les champs De et A.

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

Saisissez ‘notifications’ et 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.

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 :

Cliquer sur Enregistrer, donner un nom à cette automatisation et cliquez 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…)