Yoctopuce Yocto-RangeFinder Mode D'emploi page 54

9. Utilisation du Yocto-RangeFinder en C++
YAPI::RegisterHub("usb",
[...]
// On récupère l'objet permettant d'intéragir avec le module
YRangeFinder *rangefinder;
rangefinder = YRangeFinder::FindRangeFinder("YRNGFND1-123456.rangeFinder");
// Pour gérer le hot-plug, on vérifie que le module est là
if(rangefinder->isOnline())
{
// Utiliser rangefinder->get_currentValue()
[...]
}
Voyons maintenant en détail ce que font ces quelques lignes.
yocto_api.h et yocto_rangefinder.h
Ces deux fichiers inclus permettent d'avoir accès aux fonctions permettant de gérer les modules
Yoctopuce.
yocto_api.h
gérer les modules contenant un capteur de distance, comme le Yocto-RangeFinder.
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.
YRangeFinder::FindRangeFinder
La fonction
YRangeFinder::FindRangeFinder
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-RangeFinder avec le numéros de série YRNGFND1-123456 que vous auriez appelé
"MonModule" et dont vous auriez nommé la fonction rangeFinder "MaFonction", les cinq appels
suivants seront strictement équivalents (pour autant que MaFonction ne soit définie qu'une fois, pour
éviter toute ambiguïté):
YRangeFinder *rangefinder
YRangeFinder *rangefinder
YRangeFinder *rangefinder
YRangeFinder *rangefinder
YRangeFinder *rangefinder
YRangeFinder::FindRangeFinder
pour contrôler le capteur de distance.
isOnline
La méthode
isOnline()
de savoir si le module correspondant est présent et en état de marche.
get_currentValue
La méthode
get_currentValue()
d'obtenir la distance en mm mesurée par le capteur.
Un exemple réel
Lancez votre environnement C++ et ouvrez le projet exemple correspondant, fourni dans le
répertoire Examples/Doc-GettingStarted-Yocto-RangeFinder de la librairie Yoctopuce. Si vous
préférez travailler avec votre éditeur de texte préféré, ouvrez le fichier
simplement dans le répertoire de l'exemple pour le compiler.
make
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.
48
errmsg);
doit toujours être utilisé,
initialise l'API de Yoctopuce en indiquant où les modules
, et retournera via le paramètre
YAPI_SUCCESS
= YRangeFinder::FindRangeFinder("YRNGFND1-123456.rangeFinder");
= YRangeFinder::FindRangeFinder("YRNGFND1-123456.MaFonction");
= YRangeFinder::FindRangeFinder("MonModule.rangeFinder");
= YRangeFinder::FindRangeFinder("MonModule.MaFonction");
= YRangeFinder::FindRangeFinder("MaFonction");
renvoie un objet que vous pouvez ensuite utiliser à loisir
de l'objet renvoyé par
de l'objet renvoyé par
yocto_rangefinder.h
, elle permet de travailler avec les
"usb"
permet de retrouver un capteur de distance en
YRangeFinder::FindRangeFinder
yFindRangeFinder
est nécessaire pour
un explication du
errmsg
permet
permet
, vous taperez
main.cpp
www.yoctopuce.com