Principe de fonctionnement de l’IPX800V5 - Historique des versions

Grocrabe le 28 mars 2024 à 10:13

2024-03-28T10:13:54Z

← Version précédente		Version du 28 mars 2024 à 10:13
Ligne 3 :		Ligne 3 :

	{{Infobox IPX800		{{Infobox IPX800
	\| titre = ~~V5 : aller plus loin, mode expert~~		\| titre = Utilisation de IPX Browser
	\| image = ~~LogiqueV5~~.png		\| image = IPX Browser.png
	\| famille = IPX800 V5		\| famille = IPX800 V5
	\| date-create = 01/04/~~2023~~		\| date-create = 01/04/2024
	\| date-update =01/04/~~2023~~		\| date-update =01/04/2024
	\| auteur = @Michel94		\| auteur = @Michel94
	}}		}}

	== Introduction ==		== Introduction ==
	Avant de consulter ce wiki ~~<!-- test -->~~, veuillez lire le [[IPX800 V5\|wiki]] consacré à l’IPX800V5.		Avant de consulter ce [[wiki]], veuillez lire le [[IPX800 V5\|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.		Le fonctionnement de l’IPX800V5 repose sur 4 types d’éléments : les ressources, les variables, les Liens, les Règles.

Grocrabe : /* Introduction */

2024-03-28T07:31:10Z

Introduction

← Version précédente		Version du 28 mars 2024 à 07:31
Ligne 12 :		Ligne 12 :

	== Introduction ==		== Introduction ==
	Avant de consulter ce <!-- test ~~de commentaire~~ -->, veuillez lire le [[IPX800 V5\|wiki]] consacré à l’IPX800V5.		Avant de consulter ce wiki <!-- test -->, veuillez lire le [[IPX800 V5\|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.		Le fonctionnement de l’IPX800V5 repose sur 4 types d’éléments : les ressources, les variables, les Liens, les Règles.

Grocrabe : /* Les ressources */

2024-03-28T07:30:06Z

Les ressources

← Version précédente		Version du 28 mars 2024 à 07:30
Ligne 12 :		Ligne 12 :

	== Introduction ==		== Introduction ==
	Avant de consulter ce ~~wiki~~, veuillez lire le [[IPX800 V5\|wiki]] consacré à l’IPX800V5.		Avant de consulter ce <!-- test de commentaire -->, veuillez lire le [[IPX800 V5\|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.		Le fonctionnement de l’IPX800V5 repose sur 4 types d’éléments : les ressources, les variables, les Liens, les Règles.

Grocrabe le 8 avril 2023 à 10:32

2023-04-08T10:32:17Z

← Version précédente		Version du 8 avril 2023 à 10:32
Ligne 3 :		Ligne 3 :

	{{Infobox IPX800		{{Infobox IPX800
	\| titre = V5 : ~~principe de fonctionnement~~		\| titre = V5 : aller plus loin, mode expert
	\| image = LogiqueV5.png		\| image = LogiqueV5.png
	\| famille = IPX800 V5		\| famille = IPX800 V5
	\| date-create = 29/12/~~2022~~		\| date-create = 01/04/2023
	\| date-update =29/12/~~2022~~		\| date-update =01/04/2023
	\| auteur = @Michel94		\| auteur = @Michel94
	}}		}}

Grocrabe : /* Liens, Règles, Scènes */

2023-01-06T08:01:54Z

Liens, Règles, Scènes

← Version précédente		Version du 6 janvier 2023 à 08:01
Ligne 81 :		Ligne 81 :

	== Liens, Règles, Scènes ==		== Liens, Règles, Scènes ==
			Les Liens permettent de programmer des actions simples pré-formatées, les Règles (qui peuvent être regroupées dans une Scène) des actions plus complexes.

	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.

Grocrabe : /* Variable externe à la ressource */

2023-01-06T07:53:06Z

Variable externe à la ressource

← Version précédente		Version du 6 janvier 2023 à 07:53
Ligne 96 :		Ligne 96 :

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

			=== Etiquettes ===
			Dans une chaine de caractères, il est possible d’insérer une étiquette représentant le contenu d’une variable. Une étiquette est constituée de l’identifiant de la variable entourées de deux caractères « $ ». A titre d’exemple, l’étiquette « $327687$ » affiche, après décodage, la valeur de la variable dont l’identifiant est 327687.

			Pour exploiter une étiquette, la ressource doit pouvoir la décoder. Actuellement, seules quelques ressources peuvent décoder une étiquette : Mail, Push, Function... Avant que le décodage de l’étiquette ne soit réalisé, l’étiquette reste une simple succession de caractères représentant l’adresse de la variable qui ne varie pas. Pour cette raison, une variable représentée par son étiquette ne peut déclencher une ressource. Une modification a été apportée depuis la version 5.4.3 pour que, dans la ressource « Function », les étiquettes soient décodées régulièrement (si l’entrée x n’est pas utilisée) et puissent déclencher cette ressource.

			Les étiquettes peuvent être utilisées dans les variables string (strMailOn ou strMailOff des ressources Mail par exemple).

Grocrabe : /* Le partage de variable */

2023-01-03T17:29:30Z

Le partage de variable

← Version précédente		Version du 3 janvier 2023 à 17:29
Ligne 84 :		Ligne 84 :

	== Le partage de variable ==		== Le partage de variable ==
	Il existe une autre possibilité pour lier des ressources entres elles : le partage de variable.		En plus des liens et des scènes, 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.		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.		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.
Ligne 91 :		Ligne 91 :
	L'objet ''Parser JSON'' analyse une chaine de caractères dont il extrait des données correspondant à des clés identifiées, données qu'il stocke dans une ou des variables adaptées.		L'objet ''Parser JSON'' analyse une chaine de caractères dont il extrait des données correspondant à des clés identifiées, données qu'il stocke dans une ou des variables adaptées.

	Ici, par exemple, la variable ''[Shelly Lampe Sal]Response'' d'un Push est utilisée comme variable d’entrée par le Parser JSON Test qui extrait de la clé ''ison'' ~~dans~~ une variable de type ''IO'' et la clé ''timer_remaining'' ~~dans~~ une variable Analog<sup>32</sup>		Ici, par exemple, la variable ''[Shelly Lampe Sal]Response'' d'un Push est utilisée comme variable d’entrée par le Parser JSON Test qui extrait de la clé ''ison'' une variable de type ''IO'' et la clé ''timer_remaining'' une variable Analog<sup>32</sup>

	[[Fichier:ParsonJSON.png\|sans_cadre]]		[[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.		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.

Grocrabe : /* Variable externe à la ressource */

2023-01-03T14:56:42Z

Variable externe à la ressource

← Version précédente		Version du 3 janvier 2023 à 14:56
Ligne 89 :		Ligne 89 :

	=== Variable externe à la ressource ===		=== 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.~~		L'objet ''Parser JSON'' analyse une chaine de caractères dont il extrait des données correspondant à des clés identifiées, données qu'il stocke dans une ou des variables adaptées.

			Ici, par exemple, la variable ''[Shelly Lampe Sal]Response'' d'un Push est utilisée comme variable d’entrée par le Parser JSON Test qui extrait de la clé ''ison'' dans une variable de type ''IO'' et la clé ''timer_remaining'' dans une variable Analog<sup>32</sup>

	[[Fichier:ParsonJSON.png\|sans_cadre]]		[[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.		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.~~

Grocrabe : /* Liens, Règles, Scènes */

2023-01-03T08:01:36Z

Liens, Règles, Scènes

← Version précédente		Version du 3 janvier 2023 à 08:01
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.

Grocrabe : /* Précaution lors de l’utilisation de la variable Enable */

2023-01-01T10:08:53Z

Précaution lors de l’utilisation de la variable Enable

← Version précédente		Version du 1 janvier 2023 à 10:08
Ligne 80 :		Ligne 80 :
	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.		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.

	== ~~Les~~ Liens ==		== Liens, Règles, Scènes ==
	~~[[Fichier:Objet.png\|gauche\|sans_cadre\|300x300px]]~~		Pour ces 3 éléments, reportez-vous au [[IPX800 V5\|wiki]] consacré à l'IPX V5
	~~Un lien assure la mise en relation entre une variable de sortie d’une ressource ou d’une règle et une variable d’entrée d’une ressource, d’une scène ou d’une règle.~~

	~~Il existe deux types de lien : les liens ''I0'' réservés exclusivement aux variables ''I0'' et les liens ''Analog'' réservés exclusivement aux variables ''Analog.'' Il n’existe pas de lien S.~~

	~~Pour éviter la confusion entre les entrées et sorties des variables et les entrées et sorties des liens~~, ~~dans ce document on nommera ''source'' (src)~~, ~~la partie du lien prenant en charge l’information et ''destination'' (dst), la partie du lien restituant l’information.~~
	~~La mise en relation de deux variables par le lien est conditionnée à une variation d’état détectée sur la ou les sources du lien.~~

	~~=== Liens I0 =~~==
	~~Un lien ''I0'' est associé à une action choisie parmi les deux suivantes :~~

	~~[[Fichier:Link.png\|sans_cadre\|55x55px]] Action Link~~

	* Si la source détecte un événement ON, le lien restitue à sa destination, un événement ON.
	* Si la source détecte un événement OFF, le lien restitue à sa destination, ~~un événement OFF.~~

	~~[[Fichier:Not.png\|sans_cadre\|55x55px]] Action Not~~

	* Si la source détecte un événement ON, le lien restitue à sa destination, un événement OFF.
	* Si la source détecte un événement OFF, le lien restitue à sa destination, un événement ON.

	~~=== Liens Analog ===~~
	~~Un lien ''Analog'' est associé à une action [[Fichier:Setval.png\|sans_cadre\|55x55px]] SetVal : à chaque variation de la source du lien (événement), la valeur de celle~~-~~ci est reproduite à la destination du lien.~~

	~~=== Particularités et contraintes : ===~~
	~~[[Fichier:Connecteurs.png\|sans_cadre\|463x463px]]~~
	* Chaque lien est contenu dans un connecteur.
	* Une extrémité source d’un lien ne peut être connectée qu’à une variable de sortie.
	* Une extrémité destination d’un lien ne peut être connectée qu’à une variable d’entrée.
	* Un connecteur peut contenir jusqu’à 8 liens dans une des deux configurations suivantes :

	[[Fichier:1N.png\|sans_cadre\|40x40px]] Une seule source et une ou plusieurs destinations (configuration 1 vers n). Pour les liens I0, chaque destination peut être associée à une action particulière.

	~~[[Fichier:N1.png\|sans_cadre\|40x40px]] Plusieurs sources et une seule destination (configuration n vers1). Pour les liens I0, chaque source est associée à une action particulière.~~


	~~Il est possible de désactiver une branche en lui affectant une action 0~~ [[~~Fichier:NoAction.png\|sans_cadre~~\|~~55x55px~~]]
	Une entrée ou sortie de ressource, de scène ou de règle ne peut appartenir qu’à un seul connecteur. Une variable virtuelle étant à la fois une variable d’entrée et une variable de sortie, elle peut appartenir à 2 connecteurs différents.
	Du fait du fonctionnement événementiel des liens, dans le cas d’une configuration n vers 1, la valeur présente sur la destination du lien est dépendante uniquement de la source ayant eu la variation la plus récente. A noter que, pour les variables ''I0'' de type ''Start'' ou ''Réinit'', celles-ci reprennent, après leurs activations, un état différent des variables sources qui les ont activées. Il est donc normal que, dans certains cas, les extrémités sources et destinations d’un lien aient des valeurs différentes.

	~~== Les règles ==~~
	~~Comme les liens, les règles permettent la mise en relation des variables ''I0'' et ''Analog'' des ressources.~~

	~~Le traitement d’une règle est composé de deux parties :~~

	~~=== L'interpréteur d’événements ===~~
	~~C'est la partie qui analyse les événements qui lui sont soumis et attribue une valeur « Vraie/Faux »~~ à la sortie ''Result'' de la règle. Cet interpréteur peut accepter indifféremment des variables d’entrée ou des variables de sortie, mais il a un fonctionnement totalement différent suivant que les variables sont ''I0'' ou ''Analog''. De ce fait, le mélange de variables ''I0'' et ''Analog'' n’est pas possible. Il peut accepter jusqu’à 8 variables booléennes ''I0'' ou deux variables ''Analog''.

	~~==== Evénements booléens ====~~
	Lorsque l’interpréteur est utilisé en mode booléen si une seule variable est déclarée, le résultat sera dépendant de la valeur de cette variable ou de la valeur inverse si un opérateur NON a été placé avant cette variable. Si plusieurs variables ''I0'' sont utilisées, celles-ci doivent être combinées avec des opérateurs logiques OU ou ET, dans une équation logique. Si une variable ''I0'' doit être inversée, l’opérateur NON doit être placé juste avant cette variable. Ex : <io1>, ET,<io2>,OU,NON,<io3>. L’interprétation de l’équation logique est réalisée séquentiellement de la gauche vers la droite.

	~~==== Evénements analogiques ====~~
	Le fonctionnement de l’interpréteur d’événements analogiques est identique à celui de la ressource objet comparateur qui donne le résultat de la comparaison entre deux variables en fonction d’un opérateur de comparaison. Les opérateurs comparatifs disponibles sont : > (strictement supérieur à), >= (supérieur ou égal à), < (strictement inférieur à), >= (inférieur ou égal à), == (égal à) et != (différent de ).

	~~==== Interprétation ====~~
	Lorsqu’une variable déclarée dans l’interpréteur d’événements change de valeur, l’interpréteur d’événements détermine un nouveau résultat. Si ce résultat est différent du résultat existant, l’interpréteur délivre, suivant le cas, un événement ON ou un événement OFF à la sortie « Result ». Un événement ON sera délivré lorsque l’équation logique IO ou la comparaison analogique, jusqu’alors « fausse », devient « vraie ». ». Un événement OFF sera délivré lorsque l’équation logique IO ou la comparaison analogique, jusqu’alors « vraie », devient « fausse ».

	~~==== Variable Result ====~~
	Le résultat logique calculé par l’interpréteur d’événement est disponible sur la sortie Result de la règle, quel que soit l’état présent sur l’entrée Enable de la règle. Cette sortie peut être utilisée pour chainer des règles. Elle permet également de structurer une logique de déclenchement et compenser ainsi, l’absence de parenthèse dans l’interprétation des règles. Pour cela, les variables Result des règles de premier niveau doivent être déclarées comme événements dans la règle assurant leur agrégation.

	~~==== Activation/désactivation de la règle ====~~
	L’interpréteur d’événements étant toujours actif, quel que soit l’état de sa variable Enable, le résultat obtenu avant lest donc toujours disponible sur la variable Result. Lorsque la variable Enable est à l’état off, le générateur d’actions est simplement déconnecté de l’interpréteur d’événements. La réactivation de la variable Enable ne génère aucun message vers le générateur d’action. Elle réactive seulement la transmission entre les deux parties de la règle.

	~~==== Précaution lors de l’utilisation de la variable Enable ====~~
	~~Une mauvaise maitrise de la variable Enable peut être la source de dysfonctionnement ou donner des valeurs semblant incohérentes.~~

	~~Imaginons que nous voulions générer une alarme lors de l’ouverture d’une porte seulement la nuit. Pour cela nous utilisons deux variables io :~~

	* ioPorte : Off=fermée, On=ouverte.

	* ioNuit : On=nuit, Off=Jour.

	~~Il est possible de créer une règle <ioPorte> ET <ioNuit> qui fonctionne parfaitement et déclenche l'alarme lorsque la porte est ouverte la nuit.~~

	Intuitivement, surtout si nous avons plusieurs portes à surveiller, nous pouvons tester la désactivation de la règle durant le jour en créant un lien entre la variable <ioNuit> et la variable enable de la règle. La règle est simplifiée : <ioPorte>. De ce fait, la porte ne sera surveillée que la nuit.

	~~Le dispositif fonctionne sauf si, durant la journée, la porte est ouverte et le reste jusqu’à l’activation de la règle par ioNuit. Dans ce cas, l'alarme ne se déclenche pas puisque~~ l'~~état de la porte ne change pas alors que dans la solution précédente, une alarme est générée lors du passage en période Nuit, puisque la variable nuit change d'état.~~