Un Exemple Réel - Yoctopuce Yocto-GPS-V2 Mode D'emploi

14. Utilisation du Yocto-GPS-V2 en Delphi
var errmsg: string;
latitude: TYLatitude;
[...]
// 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
latitude = yFindLatitude("YGNSSMK2-123456.latitude")
// Pour gérer le hot-plug, on vérifie que le module est là
if latitude.isOnline() then
begin
// use latitude.get_currentValue()
[...]
end;
[...]
Voyons maintenant en détail ce que font ces quelques lignes.
yocto_api et yocto_latitude
Ces deux unités permettent d'avoir accès aux fonctions permettant de gérer les modules Yoctopuce.
doit toujours être utilisé,
yocto_api
contenant un capteur de latitude, comme le Yocto-GPS-V2.
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
yFindLatitude
La fonction
yFindLatitude
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-GPS-V2 avec
le numéros de série YGNSSMK2-123456 que vous auriez appelé "MonModule" et dont vous auriez
nommé la fonction latitude "MaFonction", les cinq appels suivants seront strictement équivalents
(pour autant que MaFonction ne soit définie qu'une fois, pour éviter toute ambiguïté):
latitude := yFindLatitude("YGNSSMK2-123456.latitude");
latitude := yFindLatitude("YGNSSMK2-123456.MaFonction");
latitude := yFindLatitude("MonModule.latitude");
latitude := yFindLatitude("MonModule.MaFonction");
latitude := yFindLatitude("MaFonction");
renvoie un objet que vous pouvez ensuite utiliser à loisir pour contrôler le capteur
yFindLatitude
de latitude.
isOnline
La méthode
isOnline()
correspondant est présent et en état de marche.
get_latitude
La méthode
get_latitude()
actuelle mesurée par le Yocto-GPS-V2, sous forme de chaîne de caractères. Le format dépend de la
configuration du Yocto-GPS-V2. Pour obtenir une valeur en virgule flottante, quelle que soit la
configuration du Yocto-GPS-V2, utilisez plutôt la classe YLatitude.
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.
102
yocto_latitude
initialise l'API de Yoctopuce en indiquant où les modules doivent être
, elle permet de travailler avec les modules connectés
'usb'
permet de retrouver un capteur de latitude en fonction du numéro de
de l'objet renvoyé par
de l'objet renvoyé par
est nécessaire pour gérer les modules
un explication du problème.
errmsg
permet de savoir si le module
yFindLatitude
permet d'obtenir la latitude
YFindGps
www.yoctopuce.com