Yoctopuce Yocto-Inclinometer Mode D'emploi page 46

8. Utilisation du Yocto-Inclinometer en Python
Il suffit de quelques lignes de code pour piloter un Yocto-Inclinometer. 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("YCLINOM1-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-Inclinometer avec le
numéros de série YCLINOM1-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("YCLINOM1-123456.tilt1")
tilt = YTilt.FindTilt("YCLINOM1-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()
d'obtenir l'inclinaison actuelle mesurée par le capteur. La valeur de retour est un nombre flottant.
Un exemple réel
Lancez votre interpréteur Python et ouvrez le script correspondant, fourni dans le répertoire
Examples/Doc-GettingStarted-Yocto-Inclinometer 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.
#!/usr/bin/python
# -*- coding: utf-8 -*-
import os, sys
40
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
des l'objets renvoyés par
, elle permet de travailler avec les modules
"usb"
une explication du problème.
errmsg
YTilt.FindTilt
permet de savoir si le module
YTilt.FindTilt
www.yoctopuce.com
permet