Yoctopuce Yocto-Meteo Mode D'emploi page 56

8. Utilisation du Yocto-Meteo en PHP
// On récupère l'objet représentant le module, à travers le VirtualHub local
yRegisterHub('http://127.0.0.1:4444/',$errmsg);
$humidity = yFindHumidity("METEOMK1-123456.humidity");
// Pour gérer le hot-plug, on vérifie que le module est là
if(humidity->isOnline())
{
// Utiliser humidity->get_currentValue(), ...
}
Voyons maintenant en détail ce que font ces quelques lignes.
yocto_api.php et yocto_humidity.php
Ces deux includes PHP permettent d'avoir accès aux fonctions permettant de gérer les modules
Yoctopuce.
yocto_api.php
pour gérer les modules contenant un capteur d'humidité, comme le Yocto-Meteo.
yRegisterHub
La fonction
yRegisterHub
Yoctopuce, ou plus exactemenent sur quelle machine tourne le programme VirtualHub. Dans notre
cas l'adresse
127.0.0.1:4444
standard utilisé par Yoctopuce). Vous pouvez parfaitement changer cette adresse, et mettre
l'adresse d'une autre machine sur laquelle tournerait un autre VirtualHub.
yFindHumidity
La fonction
yFindHumidity
série de son module hôte et de son nom de fonction. Mais vous pouvez tout aussi bien utiliser des
noms logiques que vous auriez préalablement configurés. Imaginons un module Yocto-Meteo avec
le numéros de série METEOMK1-123456 que vous auriez appelé "MonModule" et dont vous auriez
nommé la fonction humidity "MaFonction", les cinq appels suivants seront strictement équivalents
(pour autant que MaFonction ne soit définie qu'une fois, pour éviter toute ambiguïté):
$humidity = yFindHumidity("METEOMK1-123456.humidity");
$humidity = yFindHumidity("METEOMK1-123456.MaFonction");
$humidity = yFindHumidity("MonModule.humidity");
$humidity = yFindHumidity("MonModule.MaFonction");
$humidity = yFindHumidity("MaFonction");
renvoie un objet que vous pouvez ensuite utiliser à loisir pour contrôler le capteur
yFindHumidity
d'humidité.
isOnline
La méthode
isOnline()
correspondant est présent et en état de marche.
get_currentValue
La méthode
get_currentValue()
l'humidité relative actuelle mesurée par le capteur. La valeur de retour est un nombre flottant,
représentant directement le nombre de %RH.
yFindTemperature et yFindPressure
Les fonctions
yFindTemperature
avec les mesures de temperature et de pression, et se manipulent exactement comme
.
yFindHumidity
50
doit toujours être inclus,
permet d'indiquer sur quelle machine se trouve les modules
indique la machine locale, en utilisant le port
, permet de retrouver un capteur d'humidité en fonction du numéro de
de l'objet renvoyé par
de l'objet renvoyé par
et
yFindPressure
yocto_humidity.php
permet de savoir si le module
yFindHumidity
yFindHumidity
permettent de travailler respectivement
est nécessaire
(le port
4444
permet d'obtenir
www.yoctopuce.com