Yoctopuce Yocto-Serial Mode D'emploi page 90

12. Utilisation du Yocto-Serial en Objective-C
// Pour gérer le hot-plug, on vérifie que le module est là
if([serialport isOnline])
{
// Utiliser [serialport get_serialMode]
...
}
Voyons maintenant en détail ce que font ces quelques lignes.
yocto_api.h et yocto_serialport.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 port série, comme le Yocto-Serial.
[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.
[SerialPort FindSerialPort]
La fonction
[SerialPort FindSerialPort]
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-
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é):
YSerialPort *serialport
YSerialPort *serialport
YSerialPort *serialport
YSerialPort *serialport
YSerialPort *serialport
[YSerialPort FindSerialPort]
pour contrôler le port série.
isOnline
La méthode
isOnline
savoir si le module correspondant est présent et en état de marche.
reset
La méthode
reset()
tampons du port 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.
writeLine
La méthode
writeLine()
(CR/LF).
Un exemple réel
Lancez Xcode 4.2 et ouvrez le projet exemple correspondant, fourni dans le répertoire Examples/
Doc-GettingStarted-Yocto-Serial de la librairie Yoctopuce.
84
doit toujours être utilisé,
initialise l'API de Yoctopuce en indiquant où les modules
, et retournera via le paramètre
YAPI_SUCCESS
= [YSerialPort FindSerialPort:@"YSERIAL1-123456.serialPort"];
= [YSerialPort FindSerialPort:@"YSERIAL1-123456.MaFonction"];
= [YSerialPort FindSerialPort:@"MonModule.serialPort"];
= [YSerialPort FindSerialPort:@"MonModule.MaFonction"];
= [YSerialPort FindSerialPort:@"MaFonction"];
renvoie un objet que vous pouvez ensuite utiliser à loisir
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
transmet la chaîne spécifiée sur le port série, suivie par un saut de ligne
yocto_serialport.h
, elle permet de travailler avec les
@"usb"
, permet de retrouver un port série en fonction du
[YSerialPort FindSerialPort]
YSerialPort.FindSerialPort
est nécessaire pour
un explication du
errmsg
permet de
vide tous les
www.yoctopuce.com