language

Plugin “Switch Assistant” pour Jeedom

Le plugin swassit permet d’envoyer un ordre d’enclenchement ou de déclenchemenet à un équipement. L’ordre sera ensuite automatiquement répété jusqu’à ce que l’on a un retour confirmant que l’ordre a bien été exécuté.

Fonctionnement du plugin

Les commandes d’assistance

Trois commandes sont nécessaires au fonctionnement d’un équipement swassist. Une de type info et deux de type action

L’info

Cette commande représente l’état de l’équipement assisté. Cette commande doit avoir le sous-type Binaire et être liée à la commande de l’équipement assisté qui indique si cet équipement est enclenché et déclenché.

Les deux actions

Ces deux commandes sont les commandes qui vont enclencher ou déclencher l’équipement assisté. Ces commandes doivent être liées aux commandes d’enclenchement et déclenchement de l’équipement assisté.
Trois paramètres en définissent le fonctionnment:

Commande

Ce paramètre indique si la commande est la commande d’enclenchement ou de déclenchement de l’équipement assisté. Une commande de type action n’ayant ni la valeur “ON” ni la valeur “OFF” ne sera pas assistée.

Répétitions

Le nombre maximun de répétions de l’ordre.

Délai

Le temps d’attente, en secondes, entre deux tentatives.

En outre, il faudra indiquer, pour chacune de ces deux commandes, quelle est l’info qui indique l’état de l’équipement assisté.

Info pour le comptage de répétitions

Une commande info peut être créée en cliquant sur le bouton + Nb tentatives dans le panneau Commandes ou en sélectionnant Créer Compteur de tentatives lors de l’importation d’un équipement à assister.

Cette info indique le nombre de tentatives qui ont été effectuées lors du dernier enclenchement/déclenchement de l’équipement. Cette valeur sera négative si l’enclenchement ou le déclenchement a échoué.
L’info contiendra donc la valeur

1

Si La commande à été effecutée du premier coup et qu’aucune répétition n’a été nécessaire.

3

S’il y a eu des problèmes lors de l’éxécution de la commande et qu’il a fallu relancer la commande à deux reprises.

6

Si l’équipement n’a pas pu être enclenché ou déclenché malgré 6 répétitions.

Par défaut, cette info est visible, historisée sans lissage et le graphique de cet historique est en mode barre.

Graphique de l'historique du nombre de répétitions

Info sur le statut

Une commande “info” peut être créée en cliquant sur le bouton + Statut dans le panneau Commandes ou en sélectionnant Créer statut lors de l’importation d’un équipement à assister.
Cette info peut prendre trois valeurs:

0

Une commande d’enclenchement ou de déclenchement est en cours d’exécution.

1

La dernière commande d’enclenchement ou de déclenchement a été exécutée correctement (après 0 ou plusieurs répétitions)

2

La dernière commande d’enclenchement ou de déclenchement a échoué après avoir effectué le nombre maximum de répétitions.

Par défaut, cette info n’est pas visible, historisée sans lissage et le graphique de cet historique est en mode barre

Configuration du plugin

Le plugin ne nécessite aucune configuration, il faut juste l’activer.

Page de configuration du plugin

Création d’un équipement

Il est possible de créer et configurer un équipement soi-même mais le plus simple est de créer un équipement “vide” puis de le lier au switch qui sera assisté.

Création automatique

Dans cet exemple, nous allons assister le fonctionnement d’un équipement nommé [bureau][ZW-lampe] qui a les actions et infos suivantes:

ON :

Action pour allumer la lampe.

OFF :

Action pour éteindre la lampe.

Allumé :

Info binaire qui indique si la lampe est allumée.

Puissance :

Puissance de la lampe.

Consommation :

Energie consommée par la lampe.

Equipement ZW-lampe

Création de l’équipement swassist

Ouvrir la page de gestion des équipements du plugin swassist et cliquer sur le bouton ajouter

Gestion des équipements

equipement créé

import de l’équipement à assister

panneau commandes avant import

selection de l'équipement à importer

Les commandes importées

On voit que:

L’équipement créé dans le dashboard

dashboard

On voit dans le dashboard que les définitions des widgets ont été reprises de l’équipement assisté et qu’une info Nb tentatives a été ajoutée.

Un click sur l’icône de l’ampoule de l’équipement swassist provoquera l’extinction ou l’allumage de l’équipement assisté. On peut donc rendre l’équipement assisté invisible et l’on utilisera uniquement l’équipement swassist et ses commandes pourront également être utilisées dans les alertes et scénarios à la place des commandes de l’équipement assisté.

Création manuelle

A titre d’exemple, nous allons créer manuellement un équipement swassist identique à celui qui a été créé automatiquement ci-dessus.

Création de l’équipement swassist

Ouvrir la page de gestion des équipements du plugin swassist et cliquer sur le bouton ajouter

Gestion des équipements

equipement créé

Ajout de la commande info pour le retour de l’état de la lampe

Ajout de la commande d’allumage

Ajout de la commande d’extinction

Ajout des commandes de puissance et consommation

Ces commandes sont optionnelles.

Ajout de l’info du nombre de tentatives

Cette commande est optionnelle.

Ajout de l’info du statut

Cette commande est optionnelle.