Les variables de ZiBASE

Configurateur>>Scénarios>>Actions>>Liste 1ière Partie/2ième Partie/3ième Partie/4ième Partie>>Variables


CETTE PAGE FAIT PARTIE D'UNE DOCUMENTATION.

ELLE EVOLUE EN PERMANENCE ET NE DOIT PAS ETRE DUPLIQUEE. FAITES Y PLUTOT REFERENCE !



Pour l'utilisateur, les variables constituent un moyen puissant pour réaliser des calculs particuliers nécessaires au fonctionnement de son installation.

Les variables accroissent considérablement les possibilités offertes par l'équipement car elles ouvrent la voie du traitement des "cas spécifiques". Conjointement utilisées avec le calculateur ou le filtrage par critères, elles constituent la véritable boite à outils de l'utilisateur pour concrétiser des idées sortant des sentiers battus. 


Les variables peuvent être utilisées :

- dans un calcul invoqué par une action de scénario. Les opérations possibles sont multiples. Voir l'ensemble de ces opérations sur la page "Calculer".

- Pour discriminer si un scénario particulier doit lancé lors de l'arrivée de son stimulus (voir "Les Critères")


Les variables (de 16 bits signés) sont de 3 natures :

- V : Globale,

- I : Issue de capteur ou sonde,

- S : Système.


Les Variables Globales (V)

60 variables globales numérotées  "V0" à "V59" sont mises à disposition de l'utilisateur pour ses calculs.

La moitié de ses variables est sauvegardée (V15 à V44) : Si ZiBASE est mise hors tension et éteinte, le contenu numérique de ces variables est préservé. Le contenu des autres variables (V0 à V14 et V45 à V59) est initialisé à 0 lors du démarrage de ZIBASE ou redémarrage du moteur domotique de ZIBASE (après une opération "Sauvegarder")  afin d'avoir un comportement le plus déterministe possible.

En cours de mise au point, l'action "AFFICHER LES VARIABLES GLOBALES" permet de voir leur contenu. Néanmoins préférez lire plus rapidement le contenu des variables à http://<zibase_ip>//sensors.xml.


Visibilité

Les Variables V0 à V31 sont publiques tandis que les variables V32 à V59 sont privées.

Publiques : Visibles en interne de l'équipement (calculateur, critères),  et visibles de l'extérieur de l'équipement par l'API Zapi et  dans le fichier http://<zibase_ip>/sensors.xml

Privées : Visibles en interne seulement (calculateur, critères) mais non visibles de l'extérieur.

PS:

- Les  thermostats (voir METTRE EN PLACE UN THERMOSTAT) utilisent Zapi et sont donc limités à V0...V31.

- Il est attendu que les variables privées deviennent à l'avenir également publiques.


Les variables globales peuvent être de nature "numérique" ou "chaine de caractères",  et cela simultanément en fonction du contexte.

Ainsi l'opération d'affectation de chaîne de caractères,  V4 = "Bonjour, la valeur recherchée est:  V4" donnera par exemple après exécution :

Sous sa nature numérique : V4=123

Sous sa nature chaine de caractères : V4= Bonjour,  la valeur recherchée est 123


PS:

- Une erreur commune consiste à vouloir envoyer directement une valeur numérique dans un email, un SMS ou une notification PUSH , alors qu'il est nécessaire de fournir une "chaine de caractères".

- Les chaines de caractères contenues dans les variables ne sont pas sauvegardées lors de l'extinction de ZIBASE et sont toujours privées.


Les Variables de Sonde (I)

Les sondes ou les détecteurs émettent des trames d'informations, lesquelles sont reçues par ZiBASE si le protocole radio est compatible (Le suivi d'activité indique alors "Received Radio ID....")

Les Variables I contiennent les informations de la trame de sonde uniquement si cette trame a été l'initiatrice du déclenchement du scénario qui lit ces variables I. En d'autres termes, Les variables I sont relatives à la sonde ou au détecteur qui déclenche le scénario qui les sollicitent. Dans le cas contraire, les variables I sont positionnées à 0.

--> il est anomal de lire des variables I dans un scénario déclenché par autre chose qu'un capteur ou détecteur.

Les variables I sont à lecture seule.

Les variables I0, éventuellement I1 et I2, contiennent des valeurs les plus utiles de de la trame. Cependant, nombre de protocoles fournissent d'autres informations annexes. Il est alors possible de trouver ces informations dans les variables I3 à I16 qui contiennent la trame sous un "format brut".

Etant donné la multiplicité des protocoles et des formats de trames pour un même protocole, il n'est pas possible d'établir une table des "formats bruts". Cependant, pour un ID de sonde ou détecteur donné, le format de trame demeure le même. En cours de mise au point, l'action "AFFICHER LES VARIABLES DE SONDE" est  utile pour afficher le contenu  de la  trame reçue.


Contenu des variables I0/I1:

Thermomètre-Hygro (cas général) : I0= T°C*10 (Unité 0,1°C), I1= Taux (%) humidité
DIGIMAX TS10: I0= T°C*10 (Unité 0,1°C), I1= T°C de consigne (Unité 1°C)
Thermomètre: I0= T°C*10 (Unité 0,1°C)
Compteur d'Energie (WSxxxx) : I0= accumulateur d'énergie kWh*10 (Unité 0,1KWh), I1= puissance instantanée kWh*10 (Unité 100W*)
Compteur d'Energie (PZxx) : I0= accumulateur d'énergie kWh*10 (Unité 0,1KWh), I1= puissance instantanée kWh*100 (Unité 10W*)
Anémomètre: I0= vitesse pondérée m/s*10 (Unité 0,1m/s), I1= direction 0-360°/3
Pluviomètre: I0= accumulateur en mm de pluie, I1= force instantanée (Unité: 2mm/h)
LUXmètre: I0= indice de luminosité*10,  valeur en Lux

* La puissance instantanée est susceptible de changer d'unité avec l'évolution du firmware de ZiBASE (Future Unité : 1W)

Les variables I ont une durée de vie éphémère puisque devant être lues instantanément dans un ou plusieurs scénarios. Cependant, la variable I0 est mémorisée dans http://<ip_zibase>/sensors.xml dans la variable v1 du descripteur de sonde associé. La variable I1 est mémorisée dans http://<ip_zibase>/sensors.xml dans la variable v2 du descripteur de sonde associé.


Les Variables Système  (S)


Les variables Système S contiennent des informations diverses et hétérogènes relatives à l'environnement et état de ZiBASE.

Les variables S sont à lecture seule.

En cours de mise au point, l'action "AFFICHER LES VARIABLES SYSTEME" permet de voir leur contenu.


variable Signification
S0 Compteur simple de secondes 0...32767
S1 Date courante : Compteur de secondes 0...59
S2 Date courante : Compteur de minutes 0...59
S3 Date courante : Compteur d'heures 0...23
S4 Date courante : Jour 1...31
S5 Date courante : Mois 1...12
S6 Date courante : Année 2xxx
S7 Date courante : Jour de la semaine 1 (lundi)...7 (dimanche)
S8 Heure de lever du soleil en minutes depuis minuit (Heure = S8/60, Minutes = S8 modulo 60)
S9 Heure de coucher du soleil en minutes depuis minuit (Heure =S9/60, Minutes = S9 modulo 60)
S10 Etat jour = 1 ou nuit = 0
S11 Nombre aléatoire
S12 Dernière valeur de DIM (Dimmer: 0...100%) spécifiée sur l'interface ZAPI  (utilisé par les smartphones/tablettes)
S13 Etat du système d'alarme d'instance 0 (0:OFF, <>0: armé ou pré-armé)*
S14 Etat du système d'alarme d'instance 1 (0:OFF, <>0: armé ou pré-armé)
S15 Etat du système d'alarme d'instance 2 (0:OFF, <>0: armé ou pré-armé)
S16 Etat du système d'alarme d'instance 3 (0:OFF, <>0: armé ou pré-armé)
S17 Etat du système d'alarme d'instance 4 (0:OFF, <>0: armé ou pré-armé)
S18 Etat du système d'alarme d'instance 5 (0:OFF, <>0: armé ou pré-armé)
S19 Etat du système d'alarme d'instance 6 (0:OFF, <>0: armé ou pré-armé)
S20 Etat du système d'alarme d'instance 7 (0:OFF, <>0: armé ou pré-armé)
S21 Etat du système d'alarme d'instance 8 (0:OFF, <>0: armé ou pré-armé)
S22 Etat du système d'alarme d'instance 9 (0:OFF, <>0: armé ou pré-armé)
- -
S30 ZiBASE Mini : Code Errno retourné par "COMMANDER PAR SHELL"
S31 ZiBASE Mini : 1er paramètre numérique retourné par "COMMANDER PAR SHELL"
S32 ZiBASE Mini : 2ième paramètre numérique retourné par "COMMANDER PAR SHELL"
S33 ZiBASE Mini : 3ième paramètre numérique retourné par "COMMANDER PAR SHELL"
S34 ZiBASE Mini : 4ième paramètre numérique retourné par "COMMANDER PAR SHELL"
S35 ZiBASE Mini : 5ième paramètre numérique retourné par "COMMANDER PAR SHELL"
S36 ZiBASE Mini : 6ième paramètre numérique retourné par "COMMANDER PAR SHELL"
S37 ZiBASE Mini : 7ième paramètre numérique retourné par "COMMANDER PAR SHELL"
S38 ZiBASE Mini : 8ième paramètre numérique retourné par "COMMANDER PAR SHELL"
S39 ZiBASE Mini : 9ième paramètre numérique retourné par "COMMANDER PAR SHELL"

* Voir comment mettre en place un système d'alarme.