Yoctopuce Yocto-milliVolt-Rx-BNC Mode D'emploi page 156

19. Utilisation du Yocto-milliVolt-Rx-BNC en Objective-C
// On récupère l'objet représentant le module (ici connecté en local sur USB)
genericsensor = [YGenericSensor
// Pour gérer le hot-plug, on vérifie que le module est là
if([genericsensor
{
// 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 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 un capteur générique, comme le Yocto-milliVolt-Rx-BNC.
[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.
[GenericSensor FindGenericSensor]
La fonction
[GenericSensor
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-milliVolt-Rx-BNC avec le numéros de série RXMVOLT2-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
FindGenericSensor:@"RXMVOLT2-123456.genericSensor1"];
YGenericSensor *genericsensor
FindGenericSensor:@"RXMVOLT2-123456.MaFonction"];
YGenericSensor *genericsensor
FindGenericSensor:@"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
YGenericSensor.FindGenericSensor
Yocto-milliVolt-Rx-BNC. La valeur de retour est un nombre flottant, converti dans la grandeur
physique mesurée par le dispositif connecté au Yocto-milliVolt-Rx-BNC.
Un exemple réel
Lancez Xcode 4.2 et ouvrez le projet exemple correspondant, fourni dans le répertoire Examples/
Doc-GettingStarted-Yocto-milliVolt-Rx-BNC de la librairie Yoctopuce.
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.
150
FindGenericSensor:@"RXMVOLT2-123456.genericSensor1"];
isOnline])
doit toujours être utilisé,
initialise l'API de Yoctopuce en indiquant où les modules
, et retournera via le paramètre
YAPI_SUCCESS
FindGenericSensor]
= [YGenericSensor
= [YGenericSensor
= [YGenericSensor
= [YGenericSensor
= [YGenericSensor
de l'objet renvoyé par
get_currentValue()
yocto_genericsensor.h
, elle permet de travailler avec les
@"usb"
, permet de retrouver un capteur
FindGenericSensor:@"MonModule.MaFonction"];
FindGenericSensor:@"MaFonction"];
renvoie un objet que vous pouvez ensuite utiliser à
[YGenericSensor FindGenericSensor]
de l'objet
permet d'obtenir la valeur actuelle mesurée par le
est nécessaire
un explication du
errmsg
renvoyé
www.yoctopuce.com
par