Supervision d'onduleurs Eaton sous Home Assistant

À la maison, nous avons 6 onduleurs pour palier aux différentes coupures électriques que nous pouvons subir. Pour le moment, seulement deux sont accessibles depuis mon Home Assistant.

Eaton Ellipse PRO 650

Eaton Ellipse PRO 650
Eaton Ellipse PRO 650 (source : Eaton)

L'Eaton Ellipse PRO 650 est connecté en usb à ma box domotique lui offrant une autonomie de plusieurs jours.

Eaton 5P 1550

Eaton 5P 1550
Eaton 5P 1550 (source : Eaton)

L'Eaton 5P 1550 protège l'ensemble du matériel présent dans ma baie informatique. En cas de coupure, il fournit assez d'énergie pendant environ 1h. Pour avoir un contrôle à distance, j'ai ajouté une Eaton UPS Web Card. J'ai donc accès aux différentes métriques grâce au protocole SNMP v3.

Supervision depuis Home Assistant

Pour simplifier la récupération des données des deux onduleurs, j'utilise l'excellent add-on Network UPS Tools disponible sur le dépôt d'Home Assistant Community Add-ons.

Je vous conseille, fortement, d'activer le watchdog sur cet add-on et de jeter un œil à la documentation du logiciel NUT.

Configuration

devices:
  - driver: usbhid-ups
    name: eaton-ellipse-pro-650
    port: auto
    config:
      - vendorid = 0463
      - desc = "Bureau - Eaton Ellipse PRO 650"
  - driver: snmp-ups
    name: eaton-5P-1550
    port: 192.0.2.255
    config:
      - snmp_version = v3
      - secLevel = authNoPriv
      - secName = readuser
      - authPassword = MonSuperMotDePasse
      - desc = "Garage - Eaton 5P 1550"
mode: netserver
shutdown_host: false
users:
  - actions: []
    instcmds:
      - all
    password: MonMotDePasseSecret
    username: nut
i_like_to_be_pwned: true

La partie desc de la configuration n'est pas obligatoire mais si vous avez plusieurs onduleurs comme moi, il sera beaucoup plus simple de les retrouver lors de l'ajout à Home Assistant. J'ai désactivé HaveIBeenPwned car mon serveur NUT n'est accessible que depuis Home Assistant.

Documentation du site Network UPS Tools :

Intégration à Home Assistant

Comme d'habitude l'ajout à Home Assistant se fait simplement par l'utilisation de l'intégration prévue : Network UPS Tools (NUT).

Intégration NUT - Connexion au serveur NUT - Description des champs à remplir en dessous
Intégration NUT - Connexion au serveur NUT
Host : a0d7b954-nut
Port : 3493
Username : nut
Password : MonMotDePasseSecret
Intégration NUT - Choix de l'onduleur
Intégration NUT - Choix de l'onduleur

Il ne vous reste plus qu'à choisir l'onduleur et de recommencer l'intégration à Home Assistant pour chacun de vos onduleurs !

Changement de status de l'onduleur

Maintenant que les onduleurs remontent leurs données sur Home Assistant, un point important est d'être informé des changements de statut de l'onduleur. Voici l'automation que j'utilise pour recevoir le message, à la fois sur Telegram mais également par SMS (n'oubliez pas de la modifier pour que les notifications correspondent à ce que vous avez sur votre propre Home Assistant) :

automation:
  - description: UPS state changed
    alias: ups_state_changed
    id: c96873c5-c8e3-4e25-bb90-0496f54e71bc
    mode: queued
    max: 40
    trigger:
      - platform: event
        event_type: nut.ups_event
    action:
      - continue_on_error: true
        service: notify.maison_telegram
        data:
          message: "⚡ {{ trigger.event.data.notify_type }} - {{ trigger.event.data.notify_msg }}"
      - service: esphome.sim800l_send_sms
        data:
          recipient: !secret phone_number_xxx
          message: "{{ trigger.event.data.notify_type }} - {{ trigger.event.data.notify_msg }}"

Tous les types de notification sont disponibles dans la documentation si vous souhaitez affiner les alertes.

SMS reçus suite à une coupure de courant
SMS reçus suite à une coupure de courant

Conclusion

Il est assez simple de récupérer les données d'un ou plusieurs onduleurs depuis Home Assistant et de s'alerter en cas de changement. Je vous invite à faire un tour sur l'article écrit par Lionel sur son blog qui explique l'intégration avec des onduleurs de la marque APC ainsi que plusieurs méthodes pour dialoguer avec ces derniers : Home Assistant & UPS.