Comment ajouter un équipement virtuel sur Jeedom

Le plugin Virtuel de Jeedom offre de nombreuses possibilités, parfois abstraites, mais extrêmement puissantes pour personnaliser la gestion de vos équipements domotiques. Ce guide pratique détaille étape par étape comment créer un équipement virtuel sur Jeedom, en explorant divers cas d’usage et configurations avancées.

Pourquoi utiliser un équipement virtuel sur Jeedom ?

Le plugin Virtuel permet de réaliser plusieurs actions clés :

  • Fusionner des commandes de plusieurs équipements : par exemple, regrouper température, humidité et pression dans un seul équipement virtuel.
  • Séparer des commandes : si un équipement mesure plusieurs paramètres, on peut scinder ces commandes pour leur attribuer des widgets distincts.
  • Effectuer des calculs : comme calculer la moyenne de plusieurs capteurs pour n’afficher qu’une seule valeur représentative.

Ce plugin est aussi idéal pour associer des commandes à des widgets personnalisés via le plugin Widget, fournissant ainsi une interface personnalisée sur le dashboard Jeedom.

Comment installer et créer un équipement virtuel

  1. Installez le plugin Virtuel depuis le Market de Jeedom (gratuit).
  2. Accédez à la création d’un nouvel équipement en sélectionnant ce plugin.
  3. Donnez un nom à votre équipement virtuel, par exemple « test », puis validez.
  4. N’oubliez pas d’activer et de rendre visible l’équipement pour qu’il apparaisse sur le dashboard.
  5. Configurez l’auto-actualisation si nécessaire, notamment une mise à jour toutes les minutes pour les informations critiques (état On/Off, alimentation secteur/batterie).

En haut à droite, vous trouverez une option pour importer des équipements. Cette fonctionnalité permet d’importer plusieurs commandes issues de différents équipements que vous souhaitez regrouper ou filtrer pour ne garder que celles utiles.

Attention : en cas d’import de commandes avec les mêmes noms, certaines peuvent ne pas être importées. Dans ce cas, ajoutez les commandes individuellement via l’option « Ajouter une info virtuelle ».

Lire aussi: Modifier Activité Kbis Auto-Entrepreneur

Les types principaux d’équipements virtuels

Interrupteur virtuel On/Off

Pour créer un interrupteur avec deux états (On et Off) :

  1. Ajoutez deux commandes virtuelles.
  2. Pour la première, nommez-la « On », avec un nom de valeur « Etat » et la valeur « 1 ».
  3. Pour la seconde, nommez-la « Off », avec un nom de valeur « Etat » et la valeur « 0 ».
  4. Jeedom crée automatiquement une commande d’information virtuelle qu’il est conseillé de masquer si elle n’est pas utile pour l’affichage.
  5. Choisissez « Etat » dans la colonne correspondante pour les deux commandes et attribuez un widget, par exemple le widget « Light ».

Slider virtuel

Un slider est créé en ajoutant une commande virtuelle unique. Après réglage du sous-type et unité adaptés (par exemple température ou volume), sauvegardez. La commande d’information est créée automatiquement. Comme pour l’interrupteur, masquez cette information si elle n’est pas nécessaire à l’affichage.

Interrupteur de type toggle

Pour créer un interrupteur basculant (toggle) :

  • Ajoutez une commande virtuelle.
  • Configurez la commande avec la valeur « not(\#[…][…][Etat]#) » qui inverse l’état.
  • Ne masquez pas la commande d’information générée.

Ce type d’interrupteur est pratique pour basculer entre deux états sans commande distincte On/Off visible.

Virtuel pour réaliser un calcul

Ce type d’équipement virtuel permet d’effectuer des calculs sur plusieurs valeurs, par exemple :

Lire aussi: INPI et Micro-Entreprise : Démarches

  • Calculer la moyenne de plusieurs capteurs de température.
  • Transformer une valeur numérique en un format horaire.

Il est essentiel de choisir correctement le sous-type et l’unité dans la configuration pour que le résultat s’affiche bien. Avec un widget adapté, le résultat est lisible directement sur le dashboard.

Exécuter plusieurs commandes en une seule

Il est possible d’exécuter plusieurs actions avec une seule commande en mettant les commandes séparées par « && » sur la même ligne. Attention à ce que les sous-types des actions soient identiques pour assurer un bon fonctionnement.

Retour d’état virtuel

Ce virtuel est idéal pour avoir un retour fiable d’état d’un équipement On/Off. Par exemple :

  • Importer les commandes On et Off depuis une gateway Xiaomi.
  • Créer une commande d’information virtuelle associée avec les valeurs 0 (Off) et 1 (On).

Cette méthode est native à Jeedom et ne nécessite aucun plugin supplémentaire, garantissant ainsi la fiabilité du retour d’état.

Cas pratique : Virtuel du lever et coucher du soleil

Pour créer un virtuel indiquant les heures de lever et coucher du soleil :

Lire aussi: Comment Calculer la TVA ?

  1. Récupérez la latitude et la longitude de votre domicile.
  2. Programmez une auto-actualisation journalière, par exemple à 1h00 du matin.
  3. Dans l’onglet « Commandes », créez deux informations virtuelles avec les formules :
CommandeFormule
Lever du soleil date_sunrise(#timestamp# ,1, <latitude>, <longitude>, 90+35/60, date("Z",#timestamp#)/3600)
Coucher du soleil date_sunset(#timestamp# ,1, <latitude>, <longitude>, 90+35/60, date("Z",#timestamp#)/3600)

Ces valeurs s’afficheront sous la forme HH:MM. Pour une utilisation dans les blocs « A » de scénarios, créez deux autres informations virtuelles qui transforment ce format en Heure Minutes sans les deux-points, avec la fonction :

str_replace(":", "", #[Système][Lever - coucher du soleil][Lever du soleil]#)

et de même pour le coucher du soleil. Ces variables peuvent être utilisées ensuite pour automatiser l’ouverture et la fermeture des volets selon le lever ou le coucher du soleil.

Configurer et personnaliser son équipement virtuel

Au sein de la configuration avancée, vous trouverez la liste des commandes de votre virtuel. Il est possible de :

  • Ajouter ou supprimer des commandes virtuelles ou informations virtuelles.
  • Ranger les commandes dans l’ordre souhaité : cet ordre influe sur l'affichage du widget dans le dashboard.
  • choisir un widget adapté à chaque commande via la configuration.

Par exemple, certains préfèreront un bouton distinct « On » et « Off » plutôt qu’un unique bouton avec une ampoule. Cette personnalisation dépend des usages et des préférences tactiles.

Pour aller plus loin : utilisation avancée des virtuels

Cette flexibilité permet notamment de :

  • Dupliquer un équipement complexe pour le scinder en plusieurs virtuels.
  • Créer des scénarios activables via des commandes virtuelles personnalisées.
  • Associer vos virtuels avec d’autres plugins pour enrichir vos interfaces.

Ce guide souligne que l’utilisation du plugin Virtuel n’est pas une contrainte mais une énorme opportunité pour modeler précisément votre installation domotique selon vos besoins.

balises:

Articles populaires: