language
keyboard_arrow_up
language

Présentation

Ce plugin permet de gérer un humidificateur ou un déshumidificateur, non connecté, via une prise connectée et une sonde d’humidité.

Vous pouvez aussi l’utiliser pour piloter une VMC ou des ventilateurs.

Changelog

Voir le Changelog

Seules les modifications ayant un impact fonctionnel sur le plugin sont listées dans le changelog.

Configuration du plugin

Onglet Equipement

Configurez votre équipement :

  • Type : Humidificateur ou déshumidificateur
  • Sonde humidité : la commande de type info donnant la valeur de l’humidité à proximité de l’appareil
  • Consigne : la consigne d’humidité souhaitée. Cette consigne peut être une valeur fixe ou une commande de type info (d’un virtuel par exemple) ou une variable (format ‘#variable(ma_var)#’). Utilisez un virtuel ou une variable pour changer la valeur de la consigne via une requête http de l’API. Dans tous les cas la consigne peut être modifiée via le dashboard. Voir les exemples ci-dessous.
  • Hystérésis : Il s’agit de la valeur de tolérance souhaitée autour de la consigne donnée. Par exemple si votre consigne est à 60% avec un hystérésis de 5%, un humidificateur sera actif jusqu’à 65% puis il ne se réenclenchera qu’en dessous de 55%. Ceci permet de ne pas constamment déclencher/couper l’appareil lorsque l’humidité de la pièce est proche de la consigne. Par défaut l’hystérésis est à 0.

Configuration pour la génération des actions d’alertes (facultatif) :

  • Puissance électrique : Champs facultatif permettant de suivre le fonctionnement effectif de l’appareil et de générer une alerte en conséquence. Un humidificateur n’ayant plus d’eau ou un déshumidificateur dont le réservoir est plein ne consommeront plus autant que lors de leur fonctionnement nominal.
  • Seuils :
    • Seuil min : seuil minimum de consommation de l’appareil en fonctionnement nominal. Ce seuil permet de générer l’alerte lorsque la puissance devient inférieure au seuil. Par exemple pour un humidificateur consommant 8W en nominal et 1W en veille (lorsque son réservoir est vide), une bonne valeur est un seuil de 2W.
    • Seuil max : seuil maximum de consommation de l’appareil en fonctionnement nominal. Ce seuil permet de générer l’alerte lors d’une surconsommation.
    • Vous pouvez configurer un seuil min et un seuil max, dans ce cas les actions d’alertes (identique) seront exécutées dans les 2 cas.
    • Vous devez configurer le seuil min ou le seuil max pour recevoir les alertes, il n’y a pas de valeur par défaut si les champs ne sont pas remplis.
    • Lorsque les conditions d’alerte sont réunies, les actions d’alertes seront exécutées à chaque nouvelle valeur de puissance reçue. Ainsi si vous définissez un seuil max de 25W, vous recevrez une alerte si votre capteur de puissance remonte “26W”, puis une autre alerte pour “27W”, etc. Pour éviter ce comportement, vous pouvez configurer comme action d’alerte de couper l’appareil (qui n’est de toute façon plus en mesure de fonctionner !).
  • Sonde niveau d’eau : Champs facultatif permettant de déclarer une sonde de niveau d’eau pour générer une alerte directement selon l’état de ce capteur. L’alerte ne sera envoyée qu’au front montant (ou descendant si la case “inverser” est cochée), c’est à dire lors du passage de 0 à 1.

Onglet Actions

Cet onglet permet de configurer les actions à réaliser pour activer et arrêter votre appareil, ainsi que les actions d’alertes (uniquement disponible si Puissance électrique ou Sonde niveau d’eau est renseigné). Vous pouvez configurer plusieurs actions par état, elles seront réalisées simultanément.

Infos sur les actions :

  • Les actions peuvent être le lancement d’un scenario si besoin.
  • Sachant qu’un déshumidificateur sera d’autant plus efficace que la température est élevée, vous pouvez choisir de déclencher un chauffage en même temps que votre déshumidificateur.
  • Vous pouvez vous envoyer des messages pour mettre à jour un widget android, via Tasker, à chaque changement d’état par exemple. Ou pour suivre chaque changement de consigne ou nouvelle valeur d’humidité.
  • Les actions de lancement sont appelées lorsque le plugin est sur “On” et à chaque nouvelle valeur de consigne ou d’humidité si la consigne n’est pas atteinte.
  • Les actions d’arrêt sont appelées :
    • Une fois lors que le plugin passe sur “Off”
    • Lorsque le plugin est sur “On” et à chaque nouvelle valeur de consigne ou d’humidité si la consigne est atteinte.
  • Pour les actions de type message vous pouvez utiliser les tags suivants :
    • #humidity_name# => le nom de l’équipement donné dans l’onglet “Equipement”
    • #humidity_value# => la valeur courante de l’humidité dans la pièce
    • #humidity_order# => la consigne en cours
    • #humidity_state# => l’état de votre appareil (‘Allumé’ ou ‘Eteint’)
    • #humidity_mode# => le mode courant (‘On’ ou ‘Off’)

Onglet Commandes

Cet onglet vous permet une configuration fine des commandes utilisées par ce plugin grâce aux différentes fonctions du core de Jeedom. Vous pouvez notamment configurer l’affichage des infos sur le dashboard.

Widget (Dashboard)

Jeedom v4 (avec slider de type “button”) :

Jeedom v3 (avec slider de type “thermostat_perso”, sans la puissance consommée) :

Les informations disponibles sont :

  • Capteur humidité : Valeur du capteur d’humidité (passer la souris dessus vous indiquera la date de la valeur et la date de collecte et cliquer dessus vous affichera l’historique, comme pour toute info jeedom)
  • Puissance : La puissance courante consommé par votre appareil (si configurée)
  • Changer consigne : Le slider pour changer la consigne. Si vous avez défini une commande ou une variable dans la configuration pour changer la consigne, c’est la dernière requête qui sera prise en compte. La consigne commandée via une commande ou variable sera immédiatement actualisée sur le widget.
  • Etat : L’état courant de fonctionnement de votre appareil (tel que commandé par le plugin). Si votre humidificateur n’a plus d’eau, son état affiché ici pourra être “Actif” bien qu’il n’est plus en mesure de fonctionner.
  • Off : Couper l’appareil
  • On : Lance l’évaluation entre la consigne et la valeur courante et active ou coupe l’appareil au besoin.

Exemples

Changer la consigne

Pour toutes les méthodes décrites ci-dessous, un changement de la consigne sera pris en compte immédiatement.

Le mode (On/Off) n’est pas modifié à la réception d’une nouvelle valeur de consigne. (Ainsi si le plugin était sur “Off”, il ne passe pas sur “On” à la réeption d’une nouvelle valeur de consigne)

via une variable (et appel API)

Créer une variable :

  • jeedom v4 : Outils/Variables/Ajouter
  • jeedom v3 : Outils/Scenarios/Voir Variables/Ajouter

Dans le champs “Consigne” du plugin, utiliser cette variable, sans oublier de l’entourer par des ‘#’. Exemple : ‘#variable(consigne_humidity)#’.

Toute modification de la variable sera immédiatement prise en compte par le plugin.

Vous pouvez modifier la valeur par un appel API http sous le format suivant (voir doc API HTTP) :

  • http://#IP_JEEDOM#/jeedom/core/api/jeeApi.php?apikey=#APIKEY#&type=variable&name=#NAME#&value=VALUE

via un Virtuel (et appel API)

Créez un virtuel avec une commande de type info :

Dans le champs “Consigne” du plugin, utilisez cette commande (via le bouton de sélection de commandes).

Vous pouvez modifier la valeur par un appel API http avec l’une des commandes suivantes (voir la documentation du plugin Virtuel) :

  • http://#IP_JEEDOM#/core/api/jeeApi.php?apikey=#VIRTUAL_APIKEY#&type=virtual&id=#CMD_ID#&value=#VOTRE_CONSIGNE#
  • http://#IP_JEEDOM#/core/api/jeeApi.php?plugin=virtual&apikey=#VIRTUAL_APIKEY#&type=virtual&id=#CMD_ID#&value=#VOTRE_CONSIGNE#

via un scenario

Appelez la commande “Changer consigne” via un scenario avec la valeur voulue.

Piloter son humidificateur/déshumidificateur (On/Off)

selon les HP/HC (via un scenario)

Dans un scénario déclenché par le changement d’état HP/HC :

Appel API

Dans l’onglet “Commandes” du plugin, cliquer sur le bouton de configuration de la commande “On” ou “Off” puis sur “URL directe”. Utiliser cet URL via l’extérieur pour appeller la commande On ou Off. Par exemple via IFTTT ou via Tasker (Android) ou n’importe quel autre service.

via d’autres plugins

Vous pouvez notamment utiliser les plugin suivants pour commander votre appareil selon divers criteres :

Ou même le lier à votre chauffage via le plugin Thermostat, sachant qu’un déshumidificateur sera d’autant plus efficace que la température est élevée.

Support

Pour toute demande de support, d’information, remonter un bug ou faire une demande d’évolution : Forum Jeedom

Bonus - Utilisateurs avancés ! - Widget Android KWGT associé

Pour les utilisateurs avancés, je vous partage les widget KWGT et Tasker Web Screen que j’ai modifiés pour visualiser et controler ce plugin via un smartphone Android :

Pour celà vous aurez besoin du plugin jeedom TaskerAutoRemote, de Tasker (android) et de ses add-ons AutoRemote et AutoTools ainsi que de l’app de widget KWGT pro.

Sources : Le widget KWGT (Origine : bibliothèque de Komponents “Material Komponents” de Erik Bucik) Web Screen Slider (Design original : https://dribbble.com/shots/3529251-Thermostat-Knob-UI)

Voir les exemples de la documentation du plugin TaskerAutoremote pour plus d’infos sur l’implémentation.