Scénarios (automation)

1- Définition

Un scénario est un ensemble de règles qui détermine le comportement d'un module.

Le scénario, c'est la liste des consignes que le module exécute à chaque cycle de fonctionnement

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.

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

2- Principe de fonctionnement

Un scénario fonctionne selon le principe d’une boucle d’exécution 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

Tel un agent de sécurité qui effectue des rondes, il surveille en permanence différents points de contrôle dans un ordre défini :
- 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

Comprendre le principe de fonctionnement desd'un scénariosscé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 d'une pompe de relevage

• 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.module

3- Gestion des scénarios

Depuis le menu "Scénario", vous pouvez activer, désactiver, modifier, créer, importer ou télécharger un scénario.

Accès réservé : 
seuls les utilisateurs ayant le rôle Super administrateur ou Administrateur peuvent accéder à la gestion des scénarios

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.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

: