Plugin JeeWatchdog (jeewatchdog) pour Jeedom

Le plugin est en cours de préparation et donc pas encore disponible sur le market

Le plugin JeeWatchdog gère un équipement externe qui doit recevoir régulièrement un signe de vie de Jeedom. Si aucun signe de vie n’est reçue durant un certain temps, l’équipement externe coupe l’alimentation de Jeedom durant quelques secondes pour forcer un redémarrage.

Un mode maintenance est prévu pour éviter d’avoir une coupure de l’alimentation lorsque une indisponibilité de Jeedom est prévue.

L’équipement externe

Le plugin est prévu pour fonctionner avec les appareils suivants:

• Shelly plus 1
• Shelly 1 Gen3
• Shelly 1 Mini Gen3
• Shelly 1 Gen4
• Shelly 1 Mini Gen4

Le plugin a été testé avec un Shelly plus 1 et un Shelly Gen4. Tout retour d’expérience avec les autres appareils est le bienvenu.

Schéma de câblage de l’équipement

L’équipement de watchdog peut être prévu pour couper une alimentation USB ou 220V~

J’ai réalisé un équipement avec les composants suivants:

• Deux ports USB-c
• Un interrupteur
• Un connecteur 220V
• Un câble 220V
• Un boitier (le modèle 58-80-26)
• Un Shelly

Préconfiguration du Shelly

Une fois le câblage prêt, vous pouvez alimenter le Shelly et y configurer une adresse IP fixe et fixe un password (le password n’est pas obligatoire mais fortement recommandé). Le reste de la configuration sera effectué par le plugin JeeWatchdog

Ne pas alimenter Jeedom via cet équipement avant d’avoir terminé la configuration de l’équipement dans le plugin

Activation de l’access-point

Vérifiez si vous avez un réseau WiFi dont le SSID est du genre Shelly<YYY>-<MAC> ( correspond au modèle Shelly, est l'adresse MAC du Shelly).

Si vous avez trouver un réseau pour votre Shelly, l’access-point est déjà activé et vous pouvez passer à la configuration du Wifi

Si vous n’avez pas trouver ce réseau, c’est probablement parce que la version du firmware est 2.0.0 (ou plus) et que votre Shelly est un Gen4. Dans ce cas, le zigbee est activé par défaut et l’access point est désactivé. Vous pouvez avtier l’access-point avec la procédure suivante:

1. Appuyez sur le bouton physique à l’arrière du Shelly et maintenez-le enfoncé durant pendant 10 secondes
2. Lorsque vous relâchez le bouton, la LED s’étteint 2 à 3 secondes puis clignote rapidement.
3. Appuyez à nouveau sur le bouton physique durant exactement 5 secondes
4. La Led clignote lentement que le réseau WiFI Shelly<yyy>-<MAC> est visible
5. Passer à la configuration du WiFi décrit ci-dessous.
6. L’access point sera désactiver au bout de 5 minutes. Vous devrez alors recommencer cette procédure si le Wifi n’a pas été configuré.

Il est aussi possible d’utiliser l’app Shelly smart control pour se connecter via bluetooth et activer l’AP.

Configuration du WiFi

Pour configurer WiFi du Shelly, il faut

1. Se connecter à son access point (SSID: “Shelly…-…”)
2. Ouvrir la page WB http://192.168.33.1
3. Cliquer sur Settings dans le menu à gauche
4. Cliquer sur Wifi dans la partie centrale de la page
5. Dans le panneau Wi-Fi 1 settings

   • Sélectionner le réseau Wifi et saisir le Password

     

   • Si vous n’avez pas un DHCP avec une adresse IP réservée pour le Shelly

     • Sélectionner Static IP
     • Saisir les informations de configuration réseau

     

6. Cliquer sur “Save settings”

Vous pouvez vous reconnecter à votre réseau wifi.

Configuration du password d’administration

1. Ouvrir la page WEB à la nouvelle adresse du Shelly
2. Cliquer sur Settings dans le menu à gauche

3. Cliquer sur Authentication dans la partie centrale de la page (sous Device Settings)

   

4. Sélectionner Enable password protected device

5. Saisir un password

   

6. Cliquer sur Save Settings

Installation et configuration du plugin

Le plugin s’installe simplement via le market. Il n’a ni dépendance ni démon et ne nécessite aucun paramétrage. Il suffit de l’activer après l’installation.

Création et configuration d’un équipement

La configuration d’un équipement se fait à partir du menu plugins → Monitoring → jeewatchdog. Le bouton Ajouter permet de créer un nouvel équipement, un click sur un équipement ouvre sa page de configuration.

Outre les iparamètres standard de configuation Jeedom, quelques paramètreis spécifiques doivents être configurés:

• Modèle d’équipement
  Le modèle de l’appareil Shelly.

• Adresse IP du switch
  Adresse IP du Shelly (un nom DNS est aussi accepté).
  Le bouton à droite de la saisie permet d’ouvrir la page d’administration du Shelly

• Mot de passe
  Password du shelly

• Temps max d’inactivé
  L’alimentation du jeedom sera coupée quelques secondes si Jeedom n’y pas envoyé de kick durant ce délai. Cette durée est exprimée en minutes.

• Temp de coupure
  Durée, exprimée en secondes, de la coupure de l’alimentation.

• Déclencheur du Kick
  Indique si le Kick doit être envoyé au Shelly par un cron et un scénario. Voir explications plus bas

• Bouton configurer le switch
  Bouton pour envoyer la configuration au Shelly. L’équipement doit avoir été sauvegardé avant de cliquer sur ce bouton.

Ne pas oublier de clicker sur le bouton Configurer le switch après avoir sauvegardé l’équipement si un paramètre du watchdog a été modifié.

Les commandes

Les deux commandes suivantes sont créées pour chaque équipement:

1. LogicalId: maintenance
   type: info
   sous-type: binary
   Indique la position de l’interrupteur de maintenance.

2. LogicalId: kick
   type: action
   sous-type: other
   Commande pour envoyer un message au Shelly pour réinitialiser sous compteur.

Le déclencheur de Kick

Les Kicks peuvent être déclenchés par un cron ou un scénario

Le cron

Le plugin créé un cron qui déclenchera régulièrement un Kick. La fréquence de ce cron dépend de la valeur du paramètre Temps max d’inactivité:

1 minute	Si temps max <= 10 minutes
3 minutes	Si 10 minutes < temps max <= 15 minutes
5 minutes	Si 15 minutes < temps max <= 30 minutes
10 minutes	Si 30 minutes < temps max

Le scénario

L’utilisation d’un scénario permet d’effectuer des tests pour vérifier plus précisément si jeedom fonctionne correctement avec d’envoyer un kick.

Voici un exemple de scénarion qui n’enverra un kick que si un équipement zigbee a pu être activé:

Ce scénario sera lancé régulièrement (toutes les 3 minutes par exemple) et immédiatement après le démarrage de Jeedom.