Différences entre les versions de « Principe de fonctionnement de l’IPX800V5 »

De GCE Electronics
Aller à la navigation Aller à la recherche
Ligne 81 : Ligne 81 :


== Liens, Règles, Scènes ==
== Liens, Règles, Scènes ==
Pour ces 3 éléments, reportez-vous au [[IPX800 V5|wiki]] consacré à l'IPX V5
Pour ces 3 éléments, reportez-vous au [[IPX800 V5|wiki]] consacré à l'IPX V5.
 
== Le partage de variable ==
Il existe une autre possibilité pour lier des ressources entres elles : le partage de variable.
Rappel : Une variable appartient obligatoirement à une ressource, à une scène ou à une règle. Dans le cas d’une variable virtuelle, la variable est considérée comme étant sa propre ressource.
Certaines ressources autorisent la prise en compte du contenu de variable appartenant à d’autres ressources par le biais de deux méthodes : sélection d’une variable externe à la ressource lors du paramétrage de celle-ci ou utilisation d’une étiquette.
 
=== Variable externe à la ressource ===
L'objet ''Parser JSON'' analyse une chaine de caractère (ici ''[Shelly'' ''Lampe Sal]Response'' qui est le retour d'un objet Push) dont il extrait des données correspondant à des clés identifiées (ici ''ison'' qui indique si la lampe est On ou Off) qu'il stocke dans une variable adaptée.
 
[[Fichier:ParsonJSON.png|sans_cadre]]
 
La relation entre les deux ressources est équivalente à un lien : la ressource propriétaire de la variable est la source, la ressource ayant intégrée la variable est la destination. Dans cette ressource destination, la variable externe est considérée comme une variable d’entrée, quel que soit son rôle dans la ressource propriétaire.
 
Dans notre exemple, la variable ''Response'' du Push est utilisée comme variable d’entrée par le Parser JSON.

Version du 3 janvier 2023 à 09:01


V5 : principe de fonctionnement

LogiqueV5.png
Nom V5 : principe de fonctionnement
Famille IPX800 V5
Wiki créé le 29/12/2022
Wiki mis à jour le 29/12/2022
Auteur @Michel94

Introduction

Avant de consulter ce wiki, veuillez lire le wiki consacré à l’IPX800V5.

Le fonctionnement de l’IPX800V5 repose sur 4 types d’éléments : les ressources, les variables, les Liens, les Règles.

Les ressources

Ce sont des process indépendants qui assurent l’acquisition, le traitement ou la restitution de l’information. Elles sont accessibles par l’interface utilisateur Web IPX-800-V5 à la rubrique Links où elles sont classées en 5 catégories :

IPX800

Onglet IPX.png

interfaces d’entrées et de sorties natives de l’ipx800, commande de reboot, détection de présence secteur, fourniture de l’heure système de l’ipx800, informations sur le fonctionnement de l’Ipx800.

Extensions

Onglet extensions.png

interfaces d’entrées et de sorties des extensions de l’ipx800.

Objets

Onglet objets.png

ressources assurant un traitement de l’information (fonction, délai, compteur, tempo, comparateur...), un déclenchement d’actions (clignotant, calendrier, planning...), l’envoi de messages (push, mail), l’envoi et la réception de commandes via les protocoles ModBus ou MQTT...

Variables virtuelles

Onglet variables.png

elles sont décrites en détail à la rubrique variables.

Modules

Onglet modules.png

ressources de type plugin : météo, ipx800v4, Hue Light.

Une ressource communique au sein de l’IPX800V5 au moyen de variables. 
Des paramètres sont également disponibles pour préciser le mode de fonctionnement de la ressource.

Les variables

Les variables de l’IPX800V5 sont des espaces de stockage auxquels sont associés un identifiant, une capacité et une convention d’interprétation.

Les variables I0

Elles ont une capacité de 1 bit (booléen) dont la valeur indique 0 ou 1, vrai ou faux, on ou off.

Les variables Analog

Elles ont une capacité de 1 octet (ana8), 2 octets (ana16) ou 4 octets (ana32).

Elles peuvent être interprétées en mode RAW représentant un entier positif, ou en mode REAL représentant un nombre réel (positif ou négatif), entier ou décimal. Dans ce cas, le nombre de décimales peut être paramétré.

Les variables String

Elles peuvent contenir une chaine de caractères (string). Elles ont une capacité de 32 caractères (str32), 64 caractères (str64), 128 caractères (str128), 256 caractères (str256) ou 512 caractères (str512).

Une variable est accessible en mode écriture (écriture d’une information dans la variable) et en mode lecture (lecture de l’information stockée dans la variable).

Pour chaque type de variable, il y a deux catégories : les variables systèmes créées automatiquement par la V5 et les variables virtuelles créées par l'utilisateur.

  • Une variable système est associée à un élément parent qui peut être une ressource, une scène ou une règle. Elle permet à cet élément parent de communiquer avec l’environnement interne de l’IPX800V5. Une variable d’entrée permet à son élément parent d’acquérir de l’information. Cette information est lue par l’élément parent. Après traitement, l’élément parent restitue des informations en écrivant dans des variables de sortie.
  • Une variable virtuelle est une variable qui n’est liée à aucun élément parent. En fait elle est une ressource de stockage de l’information. Elle joue également le rôle de variable d’entrée et de variable de sortie.

Mode événementiel

Il est primordial d’avoir toujours à l’esprit le mode de fonctionnement événementiel lors de l’analyse du comportement de l’IPX-800-V5.

Ceci signifie que les process de l’IPX-800-v5 ne sont activés que lorsqu’une variation d’état, nommée événement survient sur les entités qu’ils surveillent. En absence de variation, ces process ne réagissent pas.

De ce fait, si aucun événement n'est appliqué sur les variables d’entrée d’une ressource, celle-ci n’assure aucun traitement. Il en est de même pour les interfaces d’entrées : si le signal d’entrée extérieur ne varie pas, aucun traitement n’est réalisé.

De la même manière, si, suite à un traitement interne, le process d’une ressource détermine que le résultat à écrire sur une variable de sortie n’a pas varié, aucune nouvelle inscription ne sera réalisée sur celle-ci.

Pour variables booléennes (variables I0), on nomme :

  • Événement ON : variation de l’état 0 (off) à l’état 1 (on).
  • Événement OFF : variation de l’état 1 (on) à l’état 0 (off).

Pour les variables Analog et String, un événement est généré à chaque détection d’une variation du contenu de la variable. Ce mode de fonctionnement événementiel peut parfois générer des résultats semblant incohérents. A titre d’exemple, lorsque l’on créé une ressource objet comparateur, par défaut, les entrées InA et InB sont égales à 0. La formule de comparaison par défaut est inA == inB. Il serait logique que le résultat en sortie soit On puisque InA est égale à InB alors que le résultat affiché est Off. En fait le comparateur n’a pas été déclenché, n’ayant pas reçu d’événement puisque les valeurs entrées n’ont pas varié. Le résultat de la sortie reste donc à l’état Off.

Liens, Règles, Scènes

Pour ces 3 éléments, reportez-vous au wiki consacré à l'IPX V5.

Le partage de variable

Il existe une autre possibilité pour lier des ressources entres elles : le partage de variable.

Rappel : Une variable appartient obligatoirement à une ressource, à une scène ou à une règle. Dans le cas d’une variable virtuelle, la variable est considérée comme étant sa propre ressource.

Certaines ressources autorisent la prise en compte du contenu de variable appartenant à d’autres ressources par le biais de deux méthodes : sélection d’une variable externe à la ressource lors du paramétrage de celle-ci ou utilisation d’une étiquette.

Variable externe à la ressource

L'objet Parser JSON analyse une chaine de caractère (ici [Shelly Lampe Sal]Response qui est le retour d'un objet Push) dont il extrait des données correspondant à des clés identifiées (ici ison qui indique si la lampe est On ou Off) qu'il stocke dans une variable adaptée.

ParsonJSON.png

La relation entre les deux ressources est équivalente à un lien : la ressource propriétaire de la variable est la source, la ressource ayant intégrée la variable est la destination. Dans cette ressource destination, la variable externe est considérée comme une variable d’entrée, quel que soit son rôle dans la ressource propriétaire.

Dans notre exemple, la variable Response du Push est utilisée comme variable d’entrée par le Parser JSON.