Yoctopuce Yocto-Thermocouple Mode D'emploi page 48

9. Utilisation du Yocto-Thermocouple en C++
YAPI::RegisterHub("usb",
[...]
// On récupère l'objet permettant d'intéragir avec le module
YTemperature *temperature;
temperature = YTemperature::FindTemperature("THRMCPL1-123456.temperature");
// Pour gérer le hot-plug, on vérifie que le module est là
if(temperature->isOnline())
{
// Utiliser temperature->get_currentValue()
[...]
}
Voyons maintenant en détail ce que font ces quelques lignes.
yocto_api.h et yocto_temperature.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 température, comme le Yocto-Thermocouple.
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.
YTemperature::FindTemperature
La fonction
YTemperature::FindTemperature
température 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-Thermocouple avec le numéros de série THRMCPL1-123456 que vous
auriez appelé "MonModule" et dont vous auriez nommé la fonction temperature "MaFonction", les
cinq appels suivants seront strictement équivalents (pour autant que MaFonction ne soit définie
qu'une fois, pour éviter toute ambiguïté):
YTemperature *temperature
YTemperature *temperature
YTemperature *temperature
YTemperature *temperature
YTemperature *temperature
YTemperature::FindTemperature
pour contrôler le capteur de température.
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 température actuelle mesurée par le capteur. La valeur de retour est un nombre flottant,
représentant directement le nombre de degrés Celsius.
Un exemple réel
Lancez votre environnement C++ et ouvrez le projet exemple correspondant, fourni dans le
répertoire Examples/Doc-GettingStarted-Yocto-Thermocouple 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
42
errmsg);
doit toujours être utilisé,
initialise l'API de Yoctopuce en indiquant où les modules
, et retournera via le paramètre
YAPI_SUCCESS
= YTemperature::FindTemperature("THRMCPL1-123456.temperature");
= YTemperature::FindTemperature("THRMCPL1-123456.MaFonction");
= YTemperature::FindTemperature("MonModule.temperature");
= YTemperature::FindTemperature("MonModule.MaFonction");
= YTemperature::FindTemperature("MaFonction");
renvoie un objet que vous pouvez ensuite utiliser à loisir
de l'objet renvoyé par
de l'objet renvoyé par
yocto_temperature.h
, elle permet de travailler avec les
"usb"
permet de retrouver un capteur de
YTemperature::FindTemperature
yFindTemperature
est nécessaire pour
un explication du
errmsg
permet
permet
, vous taperez
main.cpp
www.yoctopuce.com