Yoctopuce Yocto-VOC-V3 Mode D'emploi page 50

8. Utilisation du Yocto-VOC-V3 en C++
YAPI::RegisterHub("usb",
[...]
// On récupère l'objet permettant d'intéragir avec le module
YVoc *voc;
voc = YVoc::FindVoc("YVOCMK03-123456.voc");
// Pour gérer le hot-plug, on vérifie que le module est là
if(voc->isOnline())
{
// Utiliser voc->get_currentValue()
[...]
}
Voyons maintenant en détail ce que font ces quelques lignes.
yocto_api.h et yocto_voc.h
Ces deux fichiers inclus permettent d'avoir accès aux fonctions permettant de gérer les modules
Yoctopuce.
yocto_api.h
modules contenant un capteur de Composés Organiques Volatils, comme le Yocto-VOC-V3.
YAPI::RegisterHub
La fonction
YAPI::RegisterHub
doivent être recherchés. Utilisée avec le paramètre
modules connectés localement à la machine. Si l'initialisation se passe mal, cette fonction renverra
une valeur différente de
problème.
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é):
YVoc *voc = YVoc::FindVoc("YVOCMK03-123456.voc");
YVoc *voc = YVoc::FindVoc("YVOCMK03-123456.MaFonction");
YVoc *voc = YVoc::FindVoc("MonModule.voc");
YVoc *voc = YVoc::FindVoc("MonModule.MaFonction");
YVoc *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()
Composé Organique Volatil mesuré par le capteur. La valeur de retour est un nombre flottant
representant directement le taux de VOC en parties par million équivalent CO2.
Un exemple réel
Lancez votre environnement C++ et ouvrez le projet exemple correspondant, fourni dans le
répertoire Examples/Doc-GettingStarted-Yocto-VOC-V3 de la librairie Yoctopuce. Si vous préférez
travailler avec votre éditeur de texte préféré, ouvrez le fichier
dans le répertoire de l'exemple pour le compiler.
make
44
errmsg);
doit toujours être utilisé,
initialise l'API de Yoctopuce en indiquant où les modules
, et retournera via le paramètre
YAPI_SUCCESS
permet de retrouver un capteur de Composés Organiques Volatils en
de l'objet renvoyé par
de l'objet renvoyé par
est nécessaire pour gérer les
yocto_voc.h
, elle permet de travailler avec les
"usb"
permet de savoir si le module
YVoc::FindVoc
yFindVoc
main.cpp
un explication du
errmsg
permet d'obtenir le taux de
, vous taperez simplement
www.yoctopuce.com