NEW - Scénarios (automation)

1- Généralités

Le fonctionnement d'unUn scénario peutfonctionne s'apparenterselon àle laprincipe d’une feuilleboucle ded’exécution. route
À d'l’image d’un agent de sécurité ;effectuant àune chaque tour,ronde, il vavérifie surveilleren despermanence différents points précisde contrôle dans un ordre défini (c'est ce qu'on entend par "boucle") :

• Les entrées (voyants, ouvrants, environnement ...)
• Les sorties (interrupteur, vanne, alerte ...)
• Les variables (rapports des agents précédents)

Une fois l’ensemble des vérifications effectué, le cycle recommence automatiquement, assurant ainsi une surveillance continue du système.

Chaque module ModLink peut gérer jusqu'à 3 scénarios, exécutés de manière autonome et pouvant être activés ou désactivés indépendamment.

Le scénario, c'est la liste des consignes que l'agent suit à chaque tour

une variable, c'est comme une lampe témoin sur un tableau de bord

Lorsque plusieurs modules sont utilisés ensemble, ils peuvent échanger des informations grâce au partage de variables et de scénarios

Exemple de scénario

Cette section présente un exemple concret de scénario de fonctionnement.
Le visuel du scénario est accompagné d'une description des différents blocs de fonctions utilisés, afin de faciliter la compréhension de leur rôle et de leur interaction.

Commande conditionnelle de 2 relais

 

• Bloc 1 : "test entrée simple"
  détecter l'activation de l'entrée 1
  - sortie VRAI → va au bloc 2 « Test variable »
  - sortie FAUX → retour au début du scénario (boucle)
• Bloc 2 "test variables" égales
  comparer la valeur d'une variable
  - si la valeur est 1 (allumée) → va au bloc 4
  - si la valeur est 0 (éteinte) → va au bloc 3
• Bloc 3 "contact sortie" ON / OFF après temporisation
  commander le relais 2 pendant une durée déterminée
  - active la sortie 1
  - durée : 180 000 ms (3 minutes)
• Bloc 4 "contact sortie" ON / OFF après temporisation 
  commander le relais 2 pendant une durée déterminée
  - active le relais 2
  - durée : 600 000 ms (10 minutes)
• Blocs 5 et 6 "Saut" retour début
  revenir au début du scénario
  - une fois la temporisation terminée, le scénario retourne au point de départ (bloc 1), il est prêt à traiter un nouvel événement sur l'entrée 1

Ce scénario nécessite la création préalable d'une variable nommée « Lampe témoin X » pour orienter l'exécution vers l'un des deux relais. Avant de créer le scénario, il est donc nécessaire de créer et configurer cette variable dans le module.

1- Généralités

Chaque module peut gérer jusqu'à 3 scénarios, exécutés de manière autonome et pouvant être activés ou désactivés indépendamment.

1.1- Définition

2- Principe de fonctionnement

Le système fonctionne en boucle continue :

• les conditions sont analysées en permanence,
• les tests sont exécutés dans l'ordre défini,
• lorsqu'une condition est satisfaite, l'action correspondante est exécutée,
• dans le cas contraire, le scénario poursuit son exécution selon la logique configurée.

L’automatisation peut être basée sur :

• l’état d’une entrée,
• une variable,
• une temporisation,
• une commande utilisateur,
• un widget,
• un horaire,
• l’état d’une sortie.

Les scénarios permettent ainsi d’assurer un fonctionnement autonome du système sans intervention manuelle permanente.

A lire pour les néophytes

ModLink fonctionne comme un agent de sécurité qui fait ses rondes.
A chaque tour, il vérifie des points précis dans un ordre défini, c'est ce qu'on appelle une boucle.

Les éléments surveillés :

• Les entrées (voyants, ouvrants, environnement ...)
• Les sorties (interrupteur, vanne, alerte ...)
• Les variables (rapport de contrôle des agents précédents)

Le scénario  : sa feuille de route

Le scénario, c'est la liste des consignes que l'agent suit à chaque tour.

Les variables  : une signalisation qui informe et garde la mémoire

une variable, c'est comme une lampe témoin sur un tableau de bord

L'agent peut :
- l'allumer (mettre la valeur à 1)
- l'éteindre (mettre la valeur à 2)
- tester son état (tester son état)
Sans variable, l'agent ne se souviendrait de rien d'un tour à un autre

Communication entre modules : les drapeaux partagés

Imaginez deux agents indépendants qui font leur ronde chacun dans leur coin. Ils ne se parlent pas directement mais ils peuvent voir les mêmes lampes témoin sur leur tableau de bord respectif.

Lorsque plusieurs modules sont utilisés ensemble, ils peuvent échanger des informations grâce au partage de variables et de scénarios

C'est comme un fil électrique invisible entre deux modules. Lorsqu'un scénario sur le premier module « lève un drapeau » en modifiant une variable partagée, le second module voit ce changement et peut immédiatement exécuter les actions prévues dans son propre scénario. Les variables partagées servent ainsi de moyen de communication entre les modules.

Cette section présente un exemple concret de scénario de fonctionnement.
Le visuel du scénario est accompagné d'une description des différents blocs de fonctions utilisés, afin de faciliter la compréhension de leur rôle et de leur interaction.

Commande conditionnelle de 2 relais

• Bloc 1 : "test entrée simple"
  détecter l'activation de l'entrée 1
  - sortie VRAI → va au bloc 2 « Test variable »
  - sortie FAUX → retour au début du scénario (boucle)
• Bloc 2 "test variables" égales
  comparer la valeur d'une variable
  - si la valeur est 1 (allumée) → va au bloc 4
  - si la valeur est 0 (éteinte) → va au bloc 3
• Bloc 3 "contact sortie" ON / OFF après temporisation
  commander le relais 2 pendant une durée déterminée
  - active la sortie 1
  - durée : 180 000 ms (3 minutes)
• Bloc 4 "contact sortie" ON / OFF après temporisation 
  commander le relais 2 pendant une durée déterminée
  - active le relais 2
  - durée : 600 000 ms (10 minutes)
• Blocs 5 et 6 "Saut" retour début
  revenir au début du scénario
  - une fois la temporisation terminée, le scénario retourne au point de départ (bloc 1), il est prêt à traiter un nouvel événement sur l'entrée 1

Ce scénario nécessite la création préalable d'une variable nommée « Lampe témoin X » pour orienter l'exécution vers l'un des deux relais. Avant de créer le scénario, il est donc nécessaire de créer et configurer cette variable dans le module.

3- Gestion des scénarios

Choisir "Scénario" dans la barre de menu (vous devez disposer des droits d'accès) pour activer, désactiver, modifier, créer, importer et télécharger un scénario.

Droits d'accès

L’utilisateur dispose de trois options pour utiliser un scénario :

1.1- Scénario chargé par défaut

• Le scénario est prêt à l’emploi et activé

• Idéal pour se familiariser avec l'univers ModLink

• Les variables et widgets sont déjà créés

1.2- Modifier un scénario existant

• Permet d’ajuster un scénario pour un cas particulier sans repartir de zéro (télécharger un modèle depuis le serveur distant ou local) 

• L’utilisateur doit vérifier que toutes les variables sont valides et que les entrées et les sorties sont bien configurées

1.3- Créer un scénario personnalisé

• L’utilisateur définit toutes les variables, blocs et connexions.

• Nécessite de :

  • Définir les variables 

  • Insérer et connecter les blocs fonctionnels (tests, compteurs, régulation, utilitaires, sorties)

  • Vérifier que le scénario forme une boucle complète pour garantir son fonctionnement
    

1.4- Importer / exporter un scénario

• depuis un serveur distant
  Bibliothèque de scénarios disponible depuis le serveur de ModLink.
  Il faudra adapter et personnaliser les paramètres à la configuration de l'installation.
• en local 
  Possibilité d'importer un scénario enregistrés sur l'ordinateur utilisé 

Pour créer ou modifier des scénarios, il est recommandé d’utiliser un ordinateur.
L’édition sur téléphone peut entraîner des problèmes d’affichage ou une visibilité limitée des paramètres avancés

2. Principe de création d'un scénario

Avant la création du scénario, les variables d’état et les variables de commande doivent être définies (menu "objet")
Les blocs du scénario viennent ensuite exploiter ces variables pour construire la logique de contrôle

2.1- Variables

Deux types de variables :

• Variables d’état
  Variables en lecture, reflétant l’état courant d’un équipement, d’une fonction ou d’un processus

• Variables de commande
  Variables en écriture, utilisées pour piloter un équipement ou modifier un état

2.2- Blocs fonctionnels

Les scénarios sont construits à partir de blocs fonctionnels interconnectés.
Chaque bloc remplit une fonction logique précise dans le traitement des entrées, des variables et des sorties.

• Blocs de test sur les entrées

  Ces blocs permettent d’évaluer l’état d’une entrée (physique ou logique)

  • Test d’état (actif / inactif)

  • Test impulsion (simple / double / triple)

  • Comparaison de valeur (<=>, seuil ...)

  ➡ Utilisés comme conditions de déclenchement du scénario
  
  

• Blocs de test sur les variables
  

  Ces blocs permettent d’évaluer les variables d’état internes

  • Test de valeur

  • Comparaison (égal, supérieur, inférieur, seuil)

  • Condition logique sur variable

  ➡ Utilisés pour orienter la logique du scénario en fonction de l’état du système
  
  

• Blocs contacts de sortie

  Ces blocs représentent les sorties logiques du scénario

  • Activation / désactivation de sortie

  • Impulsion

  • Maintien d’état

  ➡ Agissent directement sur les variables de commande
  
  

• Blocs d’action sur variables

  Ces blocs permettent d’agir directement sur les variables

  • Affectation de valeur

  • Modification d’état

  • Forçage / réinitialisation

  ➡ Assurent la liaison entre la logique du scénario et l’état interne du système
  
  

• Blocs de régulation

  Ces blocs permettent de gérer une régulation automatique

  • Régulation simple (tout ou rien)

  • Régulation avec seuils ou hystérésis

  • Boucle de régulation basée sur une variable d’état

  ➡ Utilisés pour maintenir une valeur cible (température, niveau, etc.)
  
  

• Blocs compteur

  Ces blocs permettent de compter des événements ou des occurrences

  • Incrément / décrément

  • Remise à zéro

  • Seuil de comptage

  ➡ Exploitent des événements issus des entrées ou des variables
  
  

• Blocs utilitaires

  Les blocs utilitaires offrent des fonctions avancées de planification et communication :

  • Test date / calendrier : déclenchement selon jour, date ou plage horaire

  • Test lever / coucher du soleil : déclenchement automatique basé sur les heures de lever/coucher

  • Envoi de SMS ou email : notification externe directement depuis le scénario

  ➡ Utilisés pour automatiser des actions selon le temps ou pour alerter des utilisateurs

2.3- Programmation par boucles

Chaque scénario doit former une boucle fonctionnelle complète :
entrée → test / logique → sortie / action → mise à jour variable d’état

Il est impératif de refermer la boucle fonctionnelle : toute commande générée par un bloc de sortie doit avoir un impact sur un état ou une variable réutilisable par un bloc d’entrée, garantissant ainsi un fonctionnement cohérent du scénario.
Un scénario est structuré sous forme de boucles logiques :

1. Entrée dans une boucle
2. Tests (servant de déclencheurs)
3. Tests de conditions
4. Actions
5. Retour
   - dans la même boucle
   - dans une autre boucle

2.4- Tests

Les tests remplacent la notion de "trigger" événementiel.
Les tests peuvent porter sur :

• variables locales,
• variables distantes (autres modules),
• états d’entrées
• états de sorties

2.5- Actions

Les actions possibles incluent notamment :

• l'écriture de variables
• la commande de sorties
• la modification d’états utilisateurs
• l'envoi d’email
• l'envoi de SMS

: