8. Utilisation du Yocto-Serial en ligne de commande
Les
gèrent le fonctionnement global des commandes , elles permettent par exemple de
[options]
piloter des modules à distance à travers le réseau, ou encore elles peuvent forcer les modules à
sauver leur configuration après l'exécution de la commande.
La
est le nom du module ou de la fonction auquel la commande va s'appliquer. Certaines
[cible]
commandes très génériques n'ont pas besoin de cible. Vous pouvez aussi utiliser les alias "any" ou
"all", ou encore une liste de noms, séparés par des virgules, sans espace.
La
est la commande que l'on souhaite exécuter. La quasi-totalité des fonctions
commande
disponibles dans les API de programmation classiques sont disponibles sous forme de commandes.
Vous n'êtes pas obligé des respecter les minuscules/majuscules et les caractères soulignés dans le
nom de la commande.
Les
[paramètres]
A tout moment les exécutables de l'API en ligne de commande sont capables de fournir une aide
assez détaillée: Utilisez par exemple
C:\>executable
/help
pour connaître la liste de commandes disponibles pour un exécutable particulier de l'API en ligne de
commande, ou encore:
C:\>executable commande
Pour obtenir une description détaillée des paramètres d'une commande.
8.3. Contrôle de la fonction SerialPort
Pour contrôler la fonction SerialPort de votre Yocto-Serial, vous avez besoin de l'exécutable
YSerialPort.
Vous pouvez par exemple lancer:
C:\>YSerialPort
any
C:\>YSerialPort
any
C:\>YSerialPort
any
C:\>YSerialPort
any
C:\>YSerialPort
any
C:\>YSerialPort
any
Cet exemple utilise la cible "any" pour signifier que l'on désire travailler sur la première fonction
SerialPort trouvée parmi toutes celles disponibles sur les modules Yoctopuce accessibles au
moment de l'exécution. Cela vous évite d'avoir à connaître le nom exact de votre fonction et celui de
votre module.
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é).
C:\>YSerialPort YSERIAL1-123456.serialPort describe
C:\>YSerialPort YSERIAL1-123456.MaFonction describe
C:\>YSerialPort MonModule.serialPort describe
C:\>YSerialPort MonModule.MaFonction describe
C:\>YSerialPort MaFonction describe
Pour travailler sur toutes les fonctions SerialPort à la fois, utilisez la cible "all".
50
sont, assez logiquement, les paramètres dont la commande a besoin.
/help
set_serialMode
"9600,8N1"
set_protocol
"Line"
reset
writeLine
"my line of data"
readLine
reset
www.yoctopuce.com