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

10. Utilisation du Yocto-0-10V-Tx en Objective-C
// Pour gérer le hot-plug, on vérifie que le module est là
if([voltageoutput
{
// 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 importés 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.
[VoltageOutput FindVoltageOutput]
La fonction
[VoltageOutput 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
FindVoltageOutput:@"TX010V01-123456.voltageOutput1"];
YVoltageOutput *voltageoutput
FindVoltageOutput:@"TX010V01-123456.MaFonction"];
YVoltageOutput *voltageoutput
FindVoltageOutput:@"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()
VoltageOutput.FindVoltageOutput
sur le bornier de 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.
Un exemple réel
Lancez Xcode 4.2 et ouvrez le projet exemple correspondant, fourni dans le répertoire Examples/
Doc-GettingStarted-Yocto-0-10V-Tx de la librairie Yoctopuce.
60
isOnline])
doit toujours être utilisé,
initialise l'API de Yoctopuce en indiquant où les modules
, et retournera via le paramètre
YAPI_SUCCESS
= [YVoltageOutput
= [YVoltageOutput
= [YVoltageOutput
= [YVoltageOutput
= [YVoltageOutput
de l'objet renvoyé par
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
FindVoltageOutput:@"MonModule.MaFonction"];
FindVoltageOutput:@"MaFonction"];
renvoie un objet que vous pouvez ensuite utiliser à
[YVoltageOutput FindVoltageOutput]
de l'objet
permet de changer instantanément la tension produite
est nécessaire
un explication du
errmsg
retourné par la
www.yoctopuce.com
fonction