Table des Matières
Publicité
18. Utilisation du Yocto-RangeFinder en Delphi
var
errmsg: string;
rangefinder: TYRangeFinder;
[...]
// 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
rangefinder =
yFindRangeFinder("YRNGFND1-123456.rangeFinder")
// Pour gérer le hot-plug, on vérifie que le module est là
if rangefinder.isOnline() then
begin
// use rangefinder.get_currentValue()
[...]
end;
[...]
Voyons maintenant en détail ce que font ces quelques lignes.
yocto_api et yocto_rangefinder
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 distance, comme le Yocto-RangeFinder.
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
yFindRangeFinder
La fonction
yFindRangeFinder
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-
RangeFinder avec le numéros de série YRNGFND1-123456 que vous auriez appelé "MonModule" et
dont vous auriez nommé la fonction rangeFinder "MaFonction", les cinq appels suivants seront
strictement équivalents (pour autant que MaFonction ne soit définie qu'une fois, pour éviter toute
ambiguïté):
rangefinder := yFindRangeFinder("YRNGFND1-123456.rangeFinder");
rangefinder := yFindRangeFinder("YRNGFND1-123456.MaFonction");
rangefinder := yFindRangeFinder("MonModule.rangeFinder");
rangefinder := yFindRangeFinder("MonModule.MaFonction");
rangefinder := yFindRangeFinder("MaFonction");
yFindRangeFinder
capteur de distance.
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 distance en mm mesurée par le capteur.
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.
140
yocto_rangefinder
initialise l'API de Yoctopuce en indiquant où les modules doivent être
'usb'
permet de retrouver un capteur de distance 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
yFindRangeFinder
permet de savoir si le
yFindRangeFinder
www.yoctopuce.com
permet
Publicité
Table des Matières
