20. Utilisation du Yocto-Temperature-IR en Objective-C
// On récupère l'objet représentant le module (ici connecté en local sur USB)
temperature
=
[YTemperature
// 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 importés 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-Temperature-IR.
[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.
[Temperature FindTemperature]
La fonction
[Temperature
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-Temperature-IR avec le numéros de série YTEMPIR1-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
YTemperature.FindTemperature
capteur. La valeur de retour est un nombre flottant, représentant directement le nombre de degrés
Celsius.
Un exemple réel
Lancez Xcode 4.2 et ouvrez le projet exemple correspondant, fourni dans le répertoire Examples/
Doc-GettingStarted-Yocto-Temperature-IR 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.
152
FindTemperature:@"YTEMPIR1-123456.temperature"];
doit toujours être utilisé,
initialise l'API de Yoctopuce en indiquant où les modules
, et retournera via le paramètre
YAPI_SUCCESS
FindTemperature]
=
[YTemperature
FindTemperature:@"YTEMPIR1-123456.temperature"];
=
[YTemperature
FindTemperature:@"YTEMPIR1-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
get_currentValue()
permet d'obtenir la température actuelle mesurée par le
yocto_temperature.h
, elle permet de travailler avec les
@"usb"
, permet de retrouver un capteur de
[YTemperature FindTemperature]
de
l'objet
est nécessaire pour
un explication du
errmsg
permet
renvoyé
www.yoctopuce.com
par