Yoctopuce Yocto-MaxiMicroVolt-Rx Mode D'emploi page 54

8. Utilisation du Yocto-MaxiMicroVolt-Rx en C++
YAPI::RegisterHub("usb",
[...]
// On récupère l'objet permettant d'intéragir avec le module
YGenericSensor *genericsensor;
genericsensor = YGenericSensor::FindGenericSensor("RXUVOLT1-123456.genericSensor1");
// Pour gérer le hot-plug, on vérifie que le module est là
if(genericsensor->isOnline())
{
// Utiliser genericsensor->get_currentValue()
[...]
}
Voyons maintenant en détail ce que font ces quelques lignes.
yocto_api.h et yocto_genericsensor.h
Ces deux fichiers inclus permettent d'avoir accès aux fonctions permettant de gérer les modules
Yoctopuce.
yocto_api.h
pour gérer les modules contenant un capteur générique, comme le Yocto-MaxiMicroVolt-Rx.
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.
YGenericSensor::FindGenericSensor
La fonction
YGenericSensor::FindGenericSensor
générique 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é):
YGenericSensor *genericsensor
("RXUVOLT1-123456.genericSensor1");
YGenericSensor *genericsensor
("RXUVOLT1-123456.MaFonction");
YGenericSensor *genericsensor
("MonModule.genericSensor1");
YGenericSensor *genericsensor
YGenericSensor *genericsensor
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
get_currentValue()
d'obtenir la valeur actuelle mesurée par le 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
genericSensor
autre grandeur physique.
48
errmsg);
doit toujours être utilisé,
initialise l'API de Yoctopuce en indiquant où les modules
, et retournera via le paramètre
YAPI_SUCCESS
= YGenericSensor::FindGenericSensor
= YGenericSensor::FindGenericSensor
= YGenericSensor::FindGenericSensor
= YGenericSensor::FindGenericSensor("MonModule.MaFonction");
= YGenericSensor::FindGenericSensor("MaFonction");
de l'objet renvoyé par
de l'objet renvoyé par
a été configuré pour effectuer une correspondance linéaire vers une
yocto_genericsensor.h
, elle permet de travailler avec les
"usb"
permet de retrouver un capteur
renvoie un objet que vous pouvez ensuite utiliser à
YGenericSensor::FindGenericSensor
yFindGenericSensor
est nécessaire
un explication du
errmsg
permet
www.yoctopuce.com