Créer / supprimer une variable
1- Créer une variable
Il est possible de créer des variables afin de répondre à des besoins fonctionnels spécifiques.
Depuis la page d’accueil, cliquer sur le bouton « Variables » situé dans le bloc Variable (zone jaune),
ou accéder à cette fonction via le menu « Objet ».
Cliquer sur le bouton +Ajouter
La variable récemment créée apparaitra à la suite des variables déjà configurées.
Le nombre de variables maximal est limité à 32.
Une variable peut être utilisée simultanément dans plusieurs scénarios.
1.1- Paramétrer la nouvelle variable
Les paramètres à renseigner lors de la création d’une variable permettent de définir précisément son comportement et son intégration dans les scénario et modules distants.
Cliquer sur l'icône pinceau pour ouvrir la fenêtre de configuration et renseigner les éléments suivants :
- le nom
il est recommandé d'utiliser un nom explicite afin d’identifier clairement la variable dans les scénarios et la supervision. - la valeur par défaut
Valeur appliquée à la variable lors du démarrage du module ou après un redémarrage.
Ce paramètre permet de garantir un état de fonctionnement sûr au lancement. - l’unité et le type d’unité
Précise l’unité de mesure associée à la variable (par exemple : température et degrés celcius).
Important pour la cohérence des scénarios et l’affichage correct dans la supervision. - le type de variable Home Assistant
Ce paramètre est essentiel pour assurer la bonne communication et l’interopérabilité avec les plateformes domotiques - les droits d’accès
Ils permettent de définir comment la variable peut être utilisée :
- lecture seule : elle peut être consultée mais non modifiée
- écriture seule : elle peut être modifiée sans possibilité de lecture
- lecture et écriture : elle peut être à la fois consultée et modifiée
Ce paramétrage garantit un contrôle sécurisé de l’utilisation des variables dans les scénarios et les interfaces externes
- commentaire
Champ libre permettant de saisir tout type de remarque ou d'information complémentaire pour documenter l’usage spécifique ou les particularités de la variable - options d'exposition
Elles permettent de définir sur quelles interfaces et protocoles la variable est accessible. Elles facilitent l’intégration avec des systèmes tiers et le pilotage à distance - Scénario distant
Permet l’utilisation de la variable par des scénarios exécutés à distance (supervision ...) - Home Assistant
Expose la variable dans Home Assistant.
Exemple : récupération d’un état (alarme, disjoncteur) ou commande d’un équipement depuis Home Assistant. - ESP-NOW
Autorise l’échange direct avec des modules ModLink distants - Modbus
Expose la variable via le protocole Modbus, largement utilisé en automatisme, GTB - Site Web
Rend la variable accessible depuis l’interface Web locale ou distante du système - OPC UA
Permet l’intégration avec des superviseurs industriels (SCADA, GTB ...) - Non sécurisé
Permet un accès simplifié à la variable sans mécanisme de sécurité renforcé.
À utiliser uniquement dans des environnements maîtrisés
1.2- Configurer les valeurs de la variable
En cliquant sur le bouton vert (lien), une fenêtre de configuration s’ouvre et permet de définir les valeurs associées à une variable pour les rendre plus lisibles dans les scénarios.
Il est possible d’ajouter autant de lignes que nécessaire afin de détailler les différentes valeurs et leurs significations.
Chaque ligne doit comporter :
- un champ valeur
- un libellé associé
Cette configuration facilite la compréhension et l’interprétation des variables lors de la programmation des scénarios, en associant chaque valeur à une action ou un état clairement identifié.
Exemple :
- Valeur : 1 → Libellé : Allumage
- Valeur : 2 → Libellé : Extinction
2- Supprimer une variable
Seules les variables créées par un utilisateur peuvent être supprimées en utilisant le bouton rouge associé.
Les variables pré configurées ne peuvent pas être supprimées.