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

8. Utilisation du Yocto-3D-V2 en Python
Il suffit de quelques lignes de code pour piloter un Yocto-3D-V2. Voici le squelette d'un fragment de
code Python qui utilise la fonction Tilt.
[...]
# 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
tilt = YTilt.FindTilt("Y3DMK002-123456.tilt1")
# Pour gérer le hot-plug, on vérifie que le module est là
if tilt.isOnline():
# use tilt.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
YTilt.FindTilt
La fonction
YTilt.FindTilt
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-3D-V2 avec le
numéros de série Y3DMK002-123456 que vous auriez appelé "MonModule" et dont vous auriez
nommé la fonction tilt1 "MaFonction", les cinq appels suivants seront strictement équivalents (pour
autant que MaFonction ne soit définie qu'une fois, pour éviter toute ambiguïté):
tilt = YTilt.FindTilt("Y3DMK002-123456.tilt1")
tilt = YTilt.FindTilt("Y3DMK002-123456.MaFonction")
tilt = YTilt.FindTilt("MonModule.tilt1")
tilt = YTilt.FindTilt("MonModule.MaFonction")
tilt = YTilt.FindTilt("MaFonction")
YTilt.FindTilt
l'inclinomètre.
isOnline
La méthode
isOnline()
correspondant est présent et en état de marche.
get_currentValue
La méthode
get_currentValue()
l'inclinaison actuelle mesurée par le capteur. La valeur de retour est un nombre flottant.
YCompass.FindCompass, YGyro.FindGyro...
Les fonctions
YGyro.FindGyro
respectivement avec les mesures de renvoyées par le compas, le magnétomètre, le gyroscope et
l'accéléromètre, exactement de la même manière qu'avec
Un exemple réel
Lancez votre interpréteur Python et ouvrez le script correspondant, fourni dans le répertoire
Examples/Doc-GettingStarted-Yocto-3D-V2 de la librairie Yoctopuce.
46
initialise l'API de Yoctopuce en indiquant où les modules doivent
, et retournera via l'objet
permet de retrouver un inclinomètre en fonction du numéro de série
renvoie un objet que vous pouvez ensuite utiliser à loisir pour contrôler
de l'objet renvoyé par
de l'objet renvoyé par
YCompass.FindCompass
et
YAccelerometer.FindAccelerometer
, elle permet de travailler avec les modules
"usb"
une explication du problème.
errmsg
YTilt.FindTilt
YTilt.FindTilt
,
YMagnetometer.FindMagnetometer
YTilt.FindTilt
permet de savoir si le module
permet d'obtenir
permettent de travailler
.
www.yoctopuce.com
,