NEW - Scénarios (automation)

Le fonctionnement d'un scénario peut s'~~apparente~~apparenter à la feuille de route d'un agent de sécurité ; où à chaque tour, il va surveiller des points précis 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)

Le scénario, c'est la liste des consignes que l'agent suit à chaque ~~tour.~~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.

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

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 :

Entrée dans une boucle
Tests (servant de déclencheurs)
Tests de conditions
Actions
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