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

15. Utilisation du Yocto-GPS-V2 en Python
Il suffit de quelques lignes de code pour piloter un Yocto-GPS-V2. Voici le squelette d'un fragment de
code Python qui utilise la fonction Latitude.
[...]
# On active la détection des modules sur USB
errmsg=YRefParam()
YAPI.RegisterHub("usb",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():
# use latitude.get_currentValue()
[...]
[...]
Voyons maintenant en détail ce que font ces quelques lignes.
YAPI.RegisterHub
La fonction
YAPI.RegisterHub
être recherchés. Utilisée avec le paramètre
connectés localement à la machine. Si l'initialisation se passe mal, cette fonction renverra une valeur
différente de
YAPI.SUCCESS
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.
Un exemple réel
Lancez votre interpréteur Python et ouvrez le script correspondant, fourni dans le répertoire
Examples/Doc-GettingStarted-Yocto-GPS-V2 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.
110
initialise l'API de Yoctopuce en indiquant où les modules doivent
"usb"
, et retournera via l'objet
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
, elle permet de travailler avec les modules
une explication du problème.
errmsg
YLatitude.FindLatitude
YGps.FindGps
permet de savoir
permet d'obtenir la latitude
www.yoctopuce.com