8. Utilisation du Yocto-Demo en PHP
// On récupère l'objet représentant le module, à travers le VirtualHub local
yRegisterHub('http://127.0.0.1:4444/',$errmsg);
$led = yFindLed("YCTOPOC1-123456.led");
// Pour gérer le hot-plug, on vérifie que le module est là
if(led->isOnline())
{
// Utiliser led->set_power(), ...
}
Voyons maintenant en détail ce que font ces quelques lignes.
yocto_api.php et yocto_led.php
Ces deux includes PHP permettent d'avoir accès aux fonctions permettant de gérer les modules
Yoctopuce.
yocto_api.php
les modules contenant une led, comme le Yocto-Demo.
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.
yFindLed
La fonction
yFindLed
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-Demo avec le numéros de série
YCTOPOC1-123456 que vous auriez appelé "MonModule" et dont vous auriez nommé la fonction
led "MaFonction", les cinq appels suivants seront strictement équivalents (pour autant que
MaFonction ne soit définie qu'une fois, pour éviter toute ambiguïté):
$led = yFindLed("YCTOPOC1-123456.led");
$led = yFindLed("YCTOPOC1-123456.MaFonction");
$led = yFindLed("MonModule.led");
$led = yFindLed("MonModule.MaFonction");
$led = yFindLed("MaFonction");
renvoie un objet que vous pouvez ensuite utiliser à loisir pour contrôler la led.
yFindLed
isOnline
La méthode
isOnline()
correspondant est présent et en état de marche.
set_power
La fonction
set_power()
L'argument est Y_POWER_ON ou Y_POWER_OFF. Vous trouverez dans la référence de l'interface
de programmation d'autres méthodes permettant de contrôler précisément la luminosité et de faire
clignoter automatiquement la led.
Un exemple réel
Ouvrez votre éditeur de texte préféré
accessible par votre serveur web/PHP avec les fichiers de la librairie, et ouvrez-la page avec votre
browser favori. Vous trouverez aussi ce code dans le répertoire Examples/Doc-GettingStarted-
Yocto-Demo de la librairie Yoctopuce.
Vous reconnaîtrez dans cet exemple l'utilisation des fonctions expliquées ci-dessus, cette fois
utilisées avec le décorum nécessaire à en faire un petit programme d'exemple concret.
4
Si vous n'avez pas d'éditeur de texte, utilisez Notepad plutôt que Microsoft Word.
34
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 une led en fonction du numéro de série de son module
de l'objet renvoyé par
de l'objet renvoyé par
4
, recopiez le code ci dessous, sauvez-le dans un répertoire
yocto_led.php
permet de savoir si le module
yFindLed
permet d'allumer et d'éteindre la led.
yFindLed
est nécessaire pour gérer
(le port
4444
www.yoctopuce.com