Yoctopuce Yocto-GPS-V2 Mode D'emploi page 60

8. Utilisation du Yocto-GPS-V2 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
$latitude = YLatitude::FindLatitude("YGNSSMK2-123456.latitude");
// Pour gérer le hot-plug, on vérifie que le module est là
if($latitude->isOnline())
{
// Utiliser latitude->get_currentValue()
[...]
}
Voyons maintenant en détail ce que font ces quelques lignes.
yocto_api.php et yocto_latitude.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 de latitude, comme le Yocto-GPS-V2.
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.
YLatitude::FindLatitude
La fonction
YLatitude::FindLatitude
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-GPS-V2 avec le numéros de série YGNSSMK2-123456 que vous auriez appelé "MonModule"
et dont vous auriez nommé la fonction latitude "MaFonction", les cinq appels suivants seront
strictement équivalents (pour autant que MaFonction ne soit définie qu'une fois, pour éviter toute
ambiguïté):
$latitude = YLatitude::FindLatitude("YGNSSMK2-123456.latitude");
$latitude = YLatitude::FindLatitude("YGNSSMK2-123456.MaFonction");
$latitude = YLatitude::FindLatitude("MonModule.latitude");
$latitude = YLatitude::FindLatitude("MonModule.MaFonction");
$latitude = YLatitude::FindLatitude("MaFonction");
YLatitude::FindLatitude
contrôler le capteur de latitude.
isOnline
La méthode
isOnline()
si le module correspondant est présent et en état de marche.
get_latitude
La méthode
get_latitude()
actuelle mesurée par le Yocto-GPS-V2, sous forme de chaîne de caractères. Le format dépend de la
configuration du Yocto-GPS-V2. Pour obtenir une valeur en virgule flottante, quelle que soit la
configuration du Yocto-GPS-V2, utilisez plutôt la classe YLatitude.
54
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 de latitude en fonction
renvoie un objet que vous pouvez ensuite utiliser à loisir pour
de l'objet renvoyé par
de l'objet renvoyé par
yocto_latitude.php
YLatitude::FindLatitude
YFindGps
est nécessaire
(le port
4444
permet de savoir
permet d'obtenir la latitude
www.yoctopuce.com