8. Utilisation du Yocto-MaxiDisplay 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.
8.3. Contrôle de la fonction Display
Pour contrôler la fonction Display de votre Yocto-MaxiDisplay, vous avez besoin de l'exécutable
YDisplay.
Vous pouvez par exemple lancer:
C:\>YDisplay
any
-layer 0 drawText 64 16 CENTER
Cet exemple utilise la cible "any" pour signifier que l'on désire travailler sur la première fonction
Display 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-MaxiDisplay avec le numéros de série YD128X64-123456
que vous auriez appelé "MonModule" et dont vous auriez nommé la fonction display "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:\>YDisplay YD128X64-123456.display describe
C:\>YDisplay YD128X64-123456.MaFonction describe
C:\>YDisplay MonModule.display describe
C:\>YDisplay MonModule.MaFonction describe
C:\>YDisplay MaFonction describe
Pour travailler sur toutes les fonctions Display à la fois, utilisez la cible "all".
C:\>YDisplay
all
describe
Pour plus de détails sur les possibilités de l'exécutable
C:\>YDisplay
/help
42
sont, assez logiquement, les paramètres dont la commande a besoin.
/help
"Hello world!"
, utilisez:
YDisplay
www.yoctopuce.com