6. Utilisation du Yocto-VOC-V3 en ligne de 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.
6.3. Contrôle de la fonction Voc
Pour contrôler la fonction Voc de votre Yocto-VOC-V3, vous avez besoin de l'exécutable YVoc.
Vous pouvez par exemple lancer:
C:\>YVoc
any
get_currentValue
Cet exemple utilise la cible "any" pour signifier que l'on désire travailler sur la première fonction Voc
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-VOC-V3 avec le numéros de série YVOCMK03-123456 que
vous auriez appelé "MonModule" et dont vous auriez nommé la fonction voc "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:\>YVoc YVOCMK03-123456.voc describe
C:\>YVoc YVOCMK03-123456.MaFonction describe
C:\>YVoc MonModule.voc describe
C:\>YVoc MonModule.MaFonction describe
C:\>YVoc MaFonction describe
Pour travailler sur toutes les fonctions Voc à la fois, utilisez la cible "all".
C:\>YVoc
all
describe
Pour plus de détails sur les possibilités de l'exécutable
C:\>YVoc
/help
34
sont, assez logiquement, les paramètres dont la commande a besoin.
/help
, utilisez:
YVoc
www.yoctopuce.com