Yoctopuce Yocto-Thermocouple Mode D'emploi page 122

16. Utilisation du Yocto-Thermocouple en PHP
[...]
// On active l'accès aux modules locaux à travers le VirtualHub
YAPI::RegisterHub('http://127.0.0.1:4444/',$errmsg);
[...]
// On récupère l'objet permettant d'intéragir avec le module
$temperature = YTemperature::FindTemperature("THRMCPL1-123456.temperature");
// Pour gérer le hot-plug, on vérifie que le module est là
if($temperature->isOnline())
{
// Utiliser temperature->get_currentValue()
[...]
}
Voyons maintenant en détail ce que font ces quelques lignes.
yocto_api.php et yocto_temperature.php
Ces deux includes PHP permettent d'avoir accès aux fonctions permettant de gérer les modules
Yoctopuce.
yocto_api.php
nécessaire pour gérer les modules contenant un capteur de température, comme le Yocto-
Thermocouple.
YAPI::RegisterHub
La fonction
YAPI::RegisterHub
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.
YTemperature::FindTemperature
La fonction
YTemperature::FindTemperature
température en fonction du numéro de 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-Thermocouple avec le numéros de série THRMCPL1-123456 que vous
auriez appelé "MonModule" et dont vous auriez nommé la fonction temperature "MaFonction", les
cinq appels suivants seront strictement équivalents (pour autant que MaFonction ne soit définie
qu'une fois, pour éviter toute ambiguïté):
$temperature = YTemperature::FindTemperature("THRMCPL1-123456.temperature");
$temperature = YTemperature::FindTemperature("THRMCPL1-123456.MaFonction");
$temperature = YTemperature::FindTemperature("MonModule.temperature");
$temperature = YTemperature::FindTemperature("MonModule.MaFonction");
$temperature = YTemperature::FindTemperature("MaFonction");
YTemperature::FindTemperature
pour contrôler le capteur de température.
isOnline
La méthode
isOnline()
de savoir si le module correspondant est présent et en état de marche.
get_currentValue
La méthode
get_currentValue()
d'obtenir la température actuelle mesurée par le capteur. La valeur de retour est un nombre flottant,
représentant directement le nombre de degrés Celsius.
116
doit toujours être inclus,
permet d'indiquer sur quelle machine se trouve les modules
indique la machine locale, en utilisant le port
renvoie un objet que vous pouvez ensuite utiliser à loisir
de l'objet renvoyé par
de l'objet renvoyé par
yocto_temperature.php
permet de retrouver un capteur de
YTemperature::FindTemperature
yFindTemperature
est
(le port
4444
permet
permet
www.yoctopuce.com