Zibase, XML et sonde virtuelle

Une question nous revient régulièrement : “Comment récupérer une information extérieure à la zibase  et l’intégrer dans un périphérique virtuel ?”
La zibase sait lire nativement du XML par une requête HTTP, ouvrant d’énorme source d’information sur le web (météo, inondation, trafic,..) mais aussi en interne (carte IPX, caméra IP).
Petite remarque, la zibase ne sait récupérer que des valeurs numériques (pas de texte).

Le XML est un fichier structuré hiérarchiquement avec des balises.

Un exemple vaut mieux qu’un long discours, je vais vous présenter dans cet article comment récupérer des informations météorologique (température, humidité, vent, visibilité..) depuis un site internet (en l’occurrence weather.com).
Nous allons le faire de 2 manières : soit à partir de scénario de la zibase soit  via un fichier php (si vous avez la chance de disposer d’un serveur Web chez vous). Chacune à ses avantages et inconvénients.

Mais avant cela, il faut trouver le code de la localité souhaité.
Dans cet article, nous prendrons Paris.
Il suffit d’aller sur le site weather.com, de rechercher votre ville

Puis de repérer le code FRXXXX correspondant dans l’URL de votre navigateur.

L’url pour obtenir les informations météo en XML sera : http://wxdata.weather.com/wxdata/weather/local/FRXX0076?cc=*&unit=m (remplacer le FRXX0076 par celui de votre localité)

En cliquant sur le lien, vous obtiendrez un fichier XML de ce style.

Il regorge d’information, température, humidité, pression atmosphérique, visibilité, vent (vitesse, direction),… j’indiquerai plus loin dans l’article comment récupérer ces différentes données.

Pour cet article nous allons rechercher la température et l’humidité extérieure.

1ère méthode : Par scénario dans la zibase

Commençons par créer le scénario « Temp et Hum Ext »

Il sera lancé toutes les 30 minutes (c’est l’intervale de mise à jour des données sur le site).
Dans « Stimuli », « Evenement temporel, Timer : 1800 s ( 30 min  x 60s)

Nous allons maintenant lire la température en l’action « Commander par HTTP », mais avant cela il faut indiquer à la Zibase où se trouve l’information dans le fichier XML.
La température se trouve dans la balise <tmp> dans la section <cc> (current condition)

Dans la partie action du scénario, « Calculer / Affecter une chaîne de caractères à une variable » (ici V0) en lui indiquant l’arbre de recherche : d’abord la balise cc, puis tmp.

On récupère maintenant la donnée température depuis internet.

Action : Fonctins spécciales / Commander par HTTP.

Utl :  (http://wxdata.weather.com/wxdata/weather/local/FRXX0076?cc=*&unit=m)

N’oubliez pas de cocher « Lire en retour une valeur balisée par » (ici V0).

Cette variable contient l’arbre de recherche et stockera après l’appel la température.

Maintenant que nous avons la température, faisons de même pour l’humidité.

« Affecter une chaîne de caractères à une variable » (ici V1 ) en lui indiquant l’arbre de recherche : d’abord la balise cc, puis hmid.

Reste à alimenter la sonde virtuelle en utilisant l’action « Fonctions spéciales / Alimenter un sonde virtuelle »

Choisir une sonde de type « Thermo-Hygro ».

Entrée (thermo/énergie) I0 : V0 (variable qui contient la température récupérée sur internet)

Coef de conversion sur IO : 10 ( Zibase doit recevoir des températures au dixième de degré. Le coefficient 10 multiplie la température récupérée pour la mettre au dixième de degré)

Canal de la sonde virtuelle : 24 (si vous utilisez plusieurs sondes virtuelles, il faut attribuer un canal à chaque sonde. Il y a 25 canaux disponibles)

Entrée (hygro/puissance) : I1 : V1 (variable qui contient l’humidité).

Il n’y a plus qu’à enregistrer le scénario.

Et de le tester en appuyant sur le bouton :

Puis dans le suivi d’activité.

vous devriez voir les lignes :

Noter la référence de la sonde (ici : OS3391881240)

Allons maintenant créer la sonde virtuelle dans les périphériques

Et mettre dans l’identifiant radio la référence de la sonde (ici : OS3391881240)

La sonde virtuelle est maintenant opérationnelle

Avantages :
Pas besoin d’un équipement supplémentaire (NAS, Serveur Web) pour aller chercher l’information.
Assez facile à mettre en place

Inconvénients :
Le nombre d’instruction possible par scénario, il faut pratiquement un scénario pour alimenter chaque sonde virtuelle.

2ème méthode : Via un fichier php héberger sur un serveur Web (Nas, PC, Raspberry,…)

En premier, il faut déclarer la sonde en mettant l’identifiant radio que vous souhaitez (ici OS65539)

Télécharger le sdk zibase (http://bgarel.free.fr/Zibase/)

Créer un fichier php (ici méteo.php) et copier/coller le code ci-dessous

<?php
require_once(« ./lib/ZiBase.php »);
$weather = simplexml_load_file(« http://wxdata.weather.com/wxdata/weather/local/FRXX0076?cc=*&unit=m« );  # URL pour récupérer la météo
$zibase = new ZiBase(« 192.168.x.x »); # 192.168.x.x : IP de votre zibase

// Temperature exterieure
$zibase->sendVirtualProbeValues(‘65539’,$weather->cc->tmp*10,$weather->cc->hmid); # 65539 : identifiant radio de la sonde sans OS devant, tmp*10 : il faut multiplier la température par 10 car la zibase attend l’information au dixième de degré

?>

Reste à planifier le lancement de ce php, soit via les tâches planifiés de votre serveur Web (cron, tâche planifiée), soit en appelant la page depuis la zibase dans un scénario qui se déclenchera toutes les 30 minutes par exemple

Avantages :
Facile à mettre en place.
Dans un même php, on peut récupérer plusieurs informations.

Inconvénients :
Nécessite un serveur allumé en permanence

Pour terminer, un petit tableau des informations météo disponible sur weather.com et la méthode pour les récupérer soit dans les scénarios soit en php ainsi que le type de périphérique à déclarer

Vent (Vitesse et direction)
– Type périphérique : WGR800
– Scénario
V0=/cc/wind/s ( Vitesse)
Coefficient de conversion = 0.28 (la vitesse est exprimée sur weather.com en m/s et sur zibase en km/h)
V1=/cc/wind/d (direction)
Coefficient de conversion = 0
– Php
$zibase->sendVirtualProbeValues(‘xxxx’’,$weather->cc->wind->s*0.28,$weather->cc->wind->d);

Indice UV
– Type périphérique : UVN800
– Scénario
V0=/cc/uv/i
Coefficient de conversion = 0
– Php
$zibase->sendVirtualProbeValues(‘xxx’,$weather->cc->uv->i);

Pression atmosphérique
– Type périphérique : Pas de préférence
– Scénario
V0=/cc/bar/r
Coefficient de conversion = 0
– Php
$zibase->sendVirtualProbeValues(‘xxx’,$weather->cc->bar->r);

Point de rosée
– Type périphérique : Pas de préférence
– Scénario
V0=/cc/dewp
Coefficient de conversion = 0
– Php
$zibase->sendVirtualProbeValues(‘xxx’,$weather->cc->dewp);

Visibilité
– Type périphérique : Pas de préférence
– Scénario
V0=/cc/vis
Coefficient de conversion = 0
– Php
$zibase->sendVirtualProbeValues(‘xxx’,$weather->cc->vis);

N’hésitez pas à nous faire part des informations que vous aller chercher sur internet et en faire profiter aux autres 🙂