Yoctopuce Yocto-Inclinometer Mode D'emploi page 52

9. Utilisation du Yocto-Inclinometer en C++
YAPI::RegisterHub("usb",
[...]
// On récupère l'objet permettant d'intéragir avec le module
YTilt *tilt;
tilt = YTilt::FindTilt("YCLINOM1-123456.tilt1");
// Pour gérer le hot-plug, on vérifie que le module est là
if(tilt->isOnline())
{
// Utiliser tilt->get_currentValue()
[...]
}
Voyons maintenant en détail ce que font ces quelques lignes.
yocto_api.h et yocto_tilt.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 inclinomètre, comme le Yocto-Inclinometer.
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.
YTilt::FindTilt
La fonction
YTilt::FindTilt
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-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é):
YTilt *tilt = YTilt::FindTilt("YCLINOM1-123456.tilt1");
YTilt *tilt = YTilt::FindTilt("YCLINOM1-123456.MaFonction");
YTilt *tilt = YTilt::FindTilt("MonModule.tilt1");
YTilt *tilt = YTilt::FindTilt("MonModule.MaFonction");
YTilt *tilt = YTilt::FindTilt("MaFonction");
YTilt::FindTilt
l'inclinomètre.
isOnline
La méthode
isOnline()
module correspondant est présent et en état de marche.
get_currentValue
La méthode
get_currentValue()
l'inclinaison actuelle mesurée par le capteur. La valeur de retour est un nombre flottant.
Un exemple réel
Lancez votre environnement C++ et ouvrez le projet exemple correspondant, fourni dans le
répertoire Examples/Doc-GettingStarted-Yocto-Inclinometer 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.
46
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 inclinomètre en fonction du numéro de
renvoie un objet que vous pouvez ensuite utiliser à loisir pour contrôler
de l'objet renvoyé par
des objets renvoyés par
est nécessaire pour gérer les
yocto_tilt.h
, elle permet de travailler avec les
"usb"
errmsg
YTilt::FindTilt
yFindTilt
main.cpp
un explication du
permet de savoir si le
permet d'obtenir
, vous taperez
www.yoctopuce.com