16. Utilisation du Yocto-Serial en Delphi
var
errmsg: string;
serialport: TYSerialPort;
[...]
// 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
serialport =
yFindSerialPort("YSERIAL1-123456.serialPort")
// Pour gérer le hot-plug, on vérifie que le module est là
if serialport.isOnline() then
begin
// use serialport.get_serialMode()
[...]
end;
[...]
Voyons maintenant en détail ce que font ces quelques lignes.
yocto_api et yocto_serialport
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 port série, comme le Yocto-Serial.
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
yFindSerialPort
La fonction
yFindSerialPort
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-Serial avec le
numéros de série YSERIAL1-123456 que vous auriez appelé "MonModule" et dont vous auriez
nommé la fonction serialPort "MaFonction", les cinq appels suivants seront strictement équivalents
(pour autant que MaFonction ne soit définie qu'une fois, pour éviter toute ambiguïté):
serialport := yFindSerialPort("YSERIAL1-123456.serialPort");
serialport := yFindSerialPort("YSERIAL1-123456.MaFonction");
serialport := yFindSerialPort("MonModule.serialPort");
serialport := yFindSerialPort("MonModule.MaFonction");
serialport := yFindSerialPort("MaFonction");
yFindSerialPort
série.
isOnline
La méthode
isOnline()
module correspondant est présent et en état de marche.
reset
La méthode
reset()
série.
readLine
La méthode
readLine()
prochain saut de ligne. La fonction est non-bloquante: si aucune ligne n'est disponible, elle retourne
une chaîne vide.
114
yocto_serialport
initialise l'API de Yoctopuce en indiquant où les modules doivent être
'usb'
permet de retrouver un port série en fonction du numéro de série
renvoie un objet que vous pouvez ensuite utiliser à loisir pour contrôler le port
de l'objet renvoyé par
de l'objet returné par
retourne la prochaine ligne de texte reçue sur le port série, jusqu'au
est nécessaire pour gérer les modules
, elle permet de travailler avec les modules connectés
un explication du problème.
errmsg
yFindSerialPort
yFindSerialPort
permet de savoir si le
vide tous les tampons du port
www.yoctopuce.com