Un Exemple Réel - Yoctopuce Yocto-VOC-V3 Mode D'emploi

7. Utilisation du Yocto-VOC-V3 en Python
Il suffit de quelques lignes de code pour piloter un Yocto-VOC-V3. Voici le squelette d'un fragment
de code Python qui utilise la fonction Voc.
[...]
# 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
voc = YVoc.FindVoc("YVOCMK03-123456.voc")
# Pour gérer le hot-plug, on vérifie que le module est là
if voc.isOnline():
# use voc.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
YVoc.FindVoc
La fonction
YVoc.FindVoc
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-VOC-V3 avec le numéros de série YVOCMK03-123456 que vous auriez appelé
"MonModule" et dont vous auriez nommé la fonction voc "MaFonction", les cinq appels suivants
seront strictement équivalents (pour autant que MaFonction ne soit définie qu'une fois, pour éviter
toute ambiguïté):
voc = YVoc.FindVoc("YVOCMK03-123456.voc")
voc = YVoc.FindVoc("YVOCMK03-123456.MaFonction")
voc = YVoc.FindVoc("MonModule.voc")
voc = YVoc.FindVoc("MonModule.MaFonction")
voc = YVoc.FindVoc("MaFonction")
renvoie un objet que vous pouvez ensuite utiliser à loisir pour contrôler le capteur
YVoc.FindVoc
de Composés Organiques Volatils.
isOnline
La méthode
isOnline()
correspondant est présent et en état de marche.
get_currentValue
La méthode
get_currentValue()
niveau de Composés Organiques volatils actuel mesuré par le capteur. La valeur de retour est un
nombre flottant, représentant directement le taux de VOC en parties par million équivalent CO2.
Un exemple réel
Lancez votre interpréteur Python et ouvrez le script correspondant, fourni dans le répertoire
Examples/Doc-GettingStarted-Yocto-VOC-V3 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.
38
initialise l'API de Yoctopuce en indiquant où les modules doivent
"usb"
, et retournera via l'objet
permet de retrouver un capteur de Composés Organiques Volatils en
de l'objet renvoyé par
de l'objet renvoyé par
, elle permet de travailler avec les modules
une explication du problème.
errmsg
permet de savoir si le module
YVoc.FindVoc
YVoc.FindVoc
permet d'obtenir le
www.yoctopuce.com