18. Utilisation du Yocto-Temperature-IR en Delphi
var
errmsg: string;
temperature: TYTemperature;
[...]
// On active la détection des modules sur USB
yRegisterHub('usb',errmsg)
[...]
// On récupère l'objet permettant d'intéragir avec le module
temperature =
yFindTemperature("YTEMPIR1-123456.temperature")
// Pour gérer le hot-plug, on vérifie que le module est là
if temperature.isOnline() then
begin
// use temperature.get_currentValue()
[...]
end;
[...]
Voyons maintenant en détail ce que font ces quelques lignes.
yocto_api et yocto_temperature
Ces deux unités permettent d'avoir accès aux fonctions permettant de gérer les modules Yoctopuce.
doit toujours être utilisé,
yocto_api
modules contenant un capteur de température, comme le Yocto-Temperature-IR.
yRegisterHub
La fonction
yRegisterHub
recherchés. Utilisée avec le paramètre
localement à la machine. Si l'initialisation se passe mal, cette fonction renverra une valeur différente
de
, et retournera via le paramètre
YAPI_SUCCESS
yFindTemperature
La fonction
yFindTemperature
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é):
temperature := yFindTemperature("YTEMPIR1-123456.temperature");
temperature := yFindTemperature("YTEMPIR1-123456.MaFonction");
temperature := yFindTemperature("MonModule.temperature");
temperature := yFindTemperature("MonModule.MaFonction");
temperature := yFindTemperature("MaFonction");
yFindTemperature
capteur de température.
isOnline
La méthode
isOnline()
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 Delphi, copiez la DLL yapi.dll dans un répertoire et créez une nouvelle
application console dans ce même répertoire, et copiez-coller le code ci dessous.
136
yocto_temperature
initialise l'API de Yoctopuce en indiquant où les modules doivent être
'usb'
permet de retrouver un capteur de température en fonction du
renvoie un objet que vous pouvez ensuite utiliser à loisir pour contrôler le
de l'objet renvoyé par
de l'objet renvoyé par
est nécessaire pour gérer les
, elle permet de travailler avec les modules connectés
un explication du problème.
errmsg
yFindTemperature
permet de savoir si le
yFindTemperature
www.yoctopuce.com
permet