Table des Matières
Publicité
9. Utilisation du Yocto-MaxiDisplay en Python
Il suffit de quelques lignes de code pour piloter un Yocto-MaxiDisplay. Voici le squelette d'un
fragment de code Python qui utilise la fonction Display.
[...]
# On active la détection des modules sur USB
errmsg=YRefParam()
YAPI.RegisterHub("usb",errmsg)
[...]
# On récupère l'objet permettant d'intéragir avec le module
display
= YDisplay.FindDisplay("YD128X64-123456.display")
# Pour gérer le hot-plug, on vérifie que le module est là
if
display.isOnline():
# use display.get_displayLayer()
[...]
[...]
Voyons maintenant en détail ce que font ces quelques lignes.
YAPI.RegisterHub
La fonction
YAPI.RegisterHub
être recherchés. Utilisée avec le paramètre
connectés localement à la machine. Si l'initialisation se passe mal, cette fonction renverra une valeur
différente de
YAPI.SUCCESS
YDisplay.FindDisplay
La fonction
YDisplay.FindDisplay
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-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é):
display
= YDisplay.FindDisplay("YD128X64-123456.display")
display
= YDisplay.FindDisplay("YD128X64-123456.MaFonction")
display
= YDisplay.FindDisplay("MonModule.display")
display
= YDisplay.FindDisplay("MonModule.MaFonction")
display
= YDisplay.FindDisplay("MaFonction")
YDisplay.FindDisplay
l'ecran.
isOnline
La méthode
isOnline()
module correspondant est présent et en état de marche.
get_displayLayer
La méthode
get_displayLayer()
récupérer un objet correspondant à une des couches de l'écran. Cet objet fourni toutes les routines
graphiques.
Un exemple réel
Lancez votre interpréteur Python et ouvrez le script correspondant, fourni dans le répertoire
Examples/Doc-GettingStarted-Yocto-MaxiDisplay de la librairie Yoctopuce.
Vous reconnaîtrez dans cet exemple l'utilisation des fonctions expliquées ci-dessus, cette fois
utilisées avec le décorum nécessaire à en faire un petit programme d'exemple concret.
#!/usr/bin/python
# -*- coding: utf-8 -*-
46
initialise l'API de Yoctopuce en indiquant où les modules doivent
"usb"
, et retournera via l'objet
permet de retrouver un ecran en fonction du numéro de
renvoie un objet que vous pouvez ensuite utiliser à loisir pour contrôler
de l'objet renvoyé par
YDisplay.FindDisplay
de l'objet renvoyé par
, elle permet de travailler avec les modules
une explication du problème.
errmsg
YDisplay.FindDisplay
permet de savoir si le
permet
www.yoctopuce.com
Publicité
Table des Matières
