Yoctopuce Yocto-0-10V-Tx Mode D'emploi page 58

9. Utilisation du Yocto-0-10V-Tx en C++
YAPI::RegisterHub("usb",
[...]
// On récupère l'objet permettant d'intéragir avec le module
YVoltageOutput *voltageoutput;
voltageoutput = YVoltageOutput::FindVoltageOutput("TX010V01-123456.voltageOutput1");
// Pour gérer le hot-plug, on vérifie que le module est là
if(voltageoutput->isOnline())
{
// Utiliser voltageoutput->set_currentVoltage()
[...]
}
Voyons maintenant en détail ce que font ces quelques lignes.
yocto_api.h et yocto_voltageoutput.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 une sortie de tension, comme le Yocto-0-10V-Tx.
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.
YVoltageOutput::FindVoltageOutput
La fonction
YVoltageOutput::FindVoltageOutput
tension 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-0-10V-Tx avec le numéros de série TX010V01-123456 que vous auriez
appelé "MonModule" et dont vous auriez nommé la fonction voltageOutput1 "MaFonction", les cinq
appels suivants seront strictement équivalents (pour autant que MaFonction ne soit définie qu'une
fois, pour éviter toute ambiguïté):
YVoltageOutput *voltageoutput
("TX010V01-123456.voltageOutput1");
YVoltageOutput *voltageoutput
("TX010V01-123456.MaFonction");
YVoltageOutput *voltageoutput
("MonModule.voltageOutput1");
YVoltageOutput *voltageoutput
YVoltageOutput *voltageoutput
YVoltageOutput::FindVoltageOutput
loisir pour contrôler la sortie de tension.
isOnline
La méthode
isOnline()
permet de savoir si le module correspondant est présent et en état de marche.
set_currentVoltage
La méthode
set_currentVoltage()
yFindVoltageOutput
sortie. La paramètre est la tension, exprimée en volts.
voltageMove
La méthode
voltageMove()
la valeur choisie. Le deuxième paramètre est la durée de la transition, en millisecondes.
52
errmsg);
doit toujours être utilisé,
initialise l'API de Yoctopuce en indiquant où les modules
, et retournera via le paramètre
YAPI_SUCCESS
= YVoltageOutput::FindVoltageOutput
= YVoltageOutput::FindVoltageOutput
= YVoltageOutput::FindVoltageOutput
= YVoltageOutput::FindVoltageOutput("MonModule.MaFonction");
= YVoltageOutput::FindVoltageOutput("MaFonction");
de l'objet renvoyé par
permet de changer instantanément la tension produite sur le bornier de
permet de d'ajuster progressivement la tension (transition linéaire) à
yocto_voltageoutput.h
, elle permet de travailler avec les
"usb"
permet de retrouver une sortie de
renvoie un objet que vous pouvez ensuite utiliser à
YVoltageOutput::FindVoltageOutput
de l'objet retourné
est nécessaire
un explication du
errmsg
par la fonction
www.yoctopuce.com