Un Exemple Réel - Yoctopuce Yocto-MaxiDisplay Mode D'emploi

17. Utilisation du Yocto-MaxiDisplay 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
$display = YDisplay::FindDisplay("YD128X64-123456.display");
// Pour gérer le hot-plug, on vérifie que le module est là
if($display->isOnline())
{
// Utiliser display->get_displayLayer()
[...]
}
Voyons maintenant en détail ce que font ces quelques lignes.
yocto_api.php et yocto_display.php
Ces deux includes PHP permettent d'avoir accès aux fonctions permettant de gérer les modules
Yoctopuce.
yocto_api.php
gérer les modules contenant un ecran, comme le Yocto-MaxiDisplay.
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.
YDisplay::FindDisplay
La fonction
YDisplay::FindDisplay
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-MaxiDisplay
avec le numéros de série YD128X64-123456 que vous auriez appelé "MonModule" et dont vous
auriez nommé la fonction display "MaFonction", les cinq appels suivants seront strictement
équivalents (pour autant que MaFonction ne soit définie qu'une fois, pour éviter toute ambiguïté):
$display = YDisplay::FindDisplay("YD128X64-123456.display");
$display = YDisplay::FindDisplay("YD128X64-123456.MaFonction");
$display = YDisplay::FindDisplay("MonModule.display");
$display = YDisplay::FindDisplay("MonModule.MaFonction");
$display = YDisplay::FindDisplay("MaFonction");
YDisplay::FindDisplay
contrôler l'ecran.
isOnline
La méthode
isOnline()
le module correspondant est présent et en état de marche.
get_displayLayer
La méthode
get_displayLayer()
objet correspondant à une des couches de l'écran. Cet objet implémente toutes les routines
graphiques.
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
4
Si vous n'avez pas d'éditeur de texte, utilisez Notepad plutôt que Microsoft Word.
128
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 ecran en fonction du numéro de
renvoie un objet que vous pouvez ensuite utiliser à loisir pour
de l'objet renvoyé par
de l'objet renvoyé par
4
, recopiez le code ci dessous, sauvez-le dans un répertoire
yocto_display.php
YDisplay::FindDisplay
YFindDisplay
est nécessaire pour
(le port
4444
permet de savoir si
permet récupérer un
www.yoctopuce.com