Publicité
7. Utilisation du Yocto-MaxiMicroVolt-Rx en Python
Il suffit de quelques lignes de code pour piloter un Yocto-MaxiMicroVolt-Rx. Voici le squelette d'un
fragment de code Python qui utilise la fonction GenericSensor.
[...]
# 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
genericsensor
= YGenericSensor.FindGenericSensor("RXUVOLT1-123456.genericSensor1")
# Pour gérer le hot-plug, on vérifie que le module est là
if
genericsensor.isOnline():
# use genericsensor.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
YGenericSensor.FindGenericSensor
La fonction
YGenericSensor.FindGenericSensor
en fonction 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-MaxiMicroVolt-Rx avec le numéros de série RXUVOLT1-123456 que vous auriez
appelé "MonModule" et dont vous auriez nommé la fonction genericSensor1 "MaFonction", les cinq
appels suivants seront strictement équivalents (pour autant que MaFonction ne soit définie qu'une
fois, pour éviter toute ambiguïté):
genericsensor
= YGenericSensor.FindGenericSensor("RXUVOLT1-123456.genericSensor1")
genericsensor
= YGenericSensor.FindGenericSensor("RXUVOLT1-123456.MaFonction")
genericsensor
= YGenericSensor.FindGenericSensor("MonModule.genericSensor1")
genericsensor
= YGenericSensor.FindGenericSensor("MonModule.MaFonction")
genericsensor
= YGenericSensor.FindGenericSensor("MaFonction")
YGenericSensor.FindGenericSensor
loisir pour contrôler le capteur générique.
isOnline
La méthode
isOnline()
permet de savoir si le module correspondant est présent et en état de marche.
get_currentValue
La
méthode
YGenericSensor.FindGenericSensor
Yocto-MaxiMicroVolt-Rx. La valeur de retour est un nombre flottant, correspondant généralement à
la mesure différentielle de tension mesurée en mV, sauf si le
effectuer une correspondance linéaire vers une autre grandeur physique.
Un exemple réel
Lancez votre interpréteur Python et ouvrez le script correspondant, fourni dans le répertoire
Examples/Doc-GettingStarted-Yocto-MaxiMicroVolt-Rx 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.
42
initialise l'API de Yoctopuce en indiquant où les modules doivent
"usb"
, et retournera via l'objet
renvoie un objet que vous pouvez ensuite utiliser à
de l'objet renvoyé par
get_currentValue()
permet d'obtenir la valeur actuelle mesurée par le
, elle permet de travailler avec les modules
une explication du problème.
errmsg
permet de retrouver un capteur générique
YGenericSensor.FindGenericSensor
de
l'objet
genericSensor
renvoyé
par
a été configuré pour
www.yoctopuce.com
Publicité
Chapitres
