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~~supprimées, en utilisant le bouton rouge associé.
Les variables ~~pré configurées~~préconfigurées ne peuvent pas être ~~supprimées.~~supprimées, car elles sont nécessaires au fonctionnement du système.