RASP-PiTFT-PLUS-Touch

De MCHobby - Wiki
Sauter à la navigation Sauter à la recherche


MCHobby investit du temps et de l'argent dans la réalisation de traduction et/ou documentation. C'est un travail long et fastidieux réalisé dans l'esprit Open-Source... donc gratuit et librement accessible.
SI vous aimez nos traductions et documentations ALORS aidez nous à en produire plus en achetant vos produits chez MCHobby.

Introduction

RASP-PiTFT-PLUS-Touch-01.jpg
Crédit: AdaFruit Industries www.adafruit.com

Configurer l'écran tactile

Maintenant que l'écran fonctionne correctement, nous allons nous attarder sur la partie tactile. Il y a juste un peut de calibration à faire mais cela n'est pas bien compliqué.

Avant de commencer, nous allons faire une règle udev pour l'écran tactile. C'est parce que le nom eventX du périphérique va être beaucoup modifié (recevoir beaucoup d'information) et qu'il sera difficile de se faire une idée sur ce qui sera appelé si vous avez une souris ou un clavier.

Exécutez la commande:

sudo nano /etc/udev/rules.d/95-stmpe.rules

pour créer une nouveau fichier udev et y copier/coller les lignes suivantes:

SUBSYSTEM=="input", ATTRS{name}=="stmpe-ts", ENV{DEVNAME}=="*event*", SYMLINK+="input/touchscreen"

RASP-PiTFT-PLUS-Touch-10.png
Crédit: AdaFruit Industries www.adafruit.com

Retirer et réinstaller l'écran tactile avec les commandes suivantes

sudo rmmod stmpe_ts; sudo modprobe stmpe_ts

Saisissez ensuite ls -l /dev/input/touchscreen

qui devrait pointer vers eventX où X représente une valeur numérique. Cette valeur numérique est différente pour chanque installation puisque les autres périphériques clavier/souris/USB occuperons également un event slot.

RASP-PiTFT-PLUS-Touch-11.png
Crédit: AdaFruit Industries www.adafruit.com

Il existes quelques outils que nous pouvons utiliser pour calibrer et et déboguer l'écran tacticle. Installez les paquet de test d'événement (event test) et bibliothèque tactile (touchscreen library) avec la commande

sudo apt-get install evtest tslib libts-bin 

RASP-PiTFT-PLUS-Touch-12.png
Crédit: AdaFruit Industries www.adafruit.com

Maintenant, vous pouvez utiliser des outils tels que sudo evtest /dev/input/touchscreen qui affiche, en temps réel, les événements reportée par l'écran tactile. Pressez sur l'écran tactile pour voie ces différents événements.

RASP-PiTFT-PLUS-Touch-13.png
Crédit: AdaFruit Industries www.adafruit.com

RASP-PiTFT-PLUS-Touch-14.png
Crédit: AdaFruit Industries www.adafruit.com

Script de calibration automatique

Si vous faire une rotation de l'écran, vous aurez besoin de recalibrer la partie tactile pour qu'elle fonctionne avec la nouvelle orientation. Vous pouvez exécuter manuellement le processus de calibration (voir section suivante) ou vous pouvez exécuter un petit script python qui initialise automatiquement les paramètres de calibration en fonction de l'orientation de l'écran.

Petit script d'aide (dit helper) qui est automatiquement installé mais dont voici la source sur GitHub

Executez la ligne de commande sudo adafruit-pitft-touch-cal

Le script essaye de détecter l'écran installé et l'état du paramètre de rotation

RASP-PiTFT-PLUS-Touch-20.png
Crédit: AdaFruit Industries www.adafruit.com

Par défaut, le script essaye d'obtenir l'orientation de l'écran en examinant la configuration du module PiTFT avec modprobe. Si le script peut lire l'orientation alors il l'affichera à l'écran, ainsi que les valeurs de calibration actuelles et les nouvelles valeurs de calibration basée sur l'orientation effective de l'écran. Pressez "y" (oui) et le retour-claver (enter) pour confirmer.

RASP-PiTFT-PLUS-Touch-21.png
Crédit: AdaFruit Industries www.adafruit.com

Essayez d'utiliser le script de calibration par défaut pour facilement calibrer votre afficheur tactile. Notez que les valeurs de calibration pourraient ne pas être les valeurs correspondant exactement à votre écran (tous les écrans sont sensiblement différents) mais elles devraient être suffisamment proche pour répondre à la plupart des besoins courants. Si vous avez besoin d'une calibration tactile plus précise, suivez les étapes de la prochaine section afin de calibrer manuellement votre écran tactile.

Calibration Manuelle

Si vous avez appliqué une rotation à votre écran et que nous devez disposer d'une calibration précise de celui-ci... alors vous devez procéder à une calibration manuelle.

Vous n'aurez besoin de calibrer l'écran qu'une seule fois mais vous êtes libre de recalibrer l'écran autant de fois qu'il vous plaira. Nous commençons la calibration en exécutant le ligne de commande suivante:

sudo TSLIB_FBDEVICE=/dev/fb1 TSLIB_TSDEVICE=/dev/input/touchscreen ts_calibrate

Suivez les instructions visibles à l'écran, touchez chaque point comme demandé. Utilisez un "Stylus" si vous avez besoin d'un positionnement précis. N'utilisez rien de métallique, uniquement du plastique!

{{{2}}}
Crédit: AdaFruit Industries www.adafruit.com

RASP-PiTFT-PLUS-Touch-31.png
Crédit: AdaFruit Industries www.adafruit.com

Ensuite, vous pouvez exécuter sudo TSLIB_FBDEVICE=/dev/fb1 TSLIB_TSDEVICE=/dev/input/touchscreen ts_test qui vous permet de tester la calibration tactile de l'écran en réalisant un dessin. Recommencez la calibration (éventuellement avec un stylus) si vous trouvez que l'écran n'est pas assez précis!

{{{2}}}
Crédit: AdaFruit Industries www.adafruit.com

Calibration X

Vous pouvez également calibrer le système d'entrée X (X input system) mais cela nécessite l'utilisation d'un autre programme appelé xinput_calibrator.

Vous pouvez utiliser ce logiciel si vous trouvez que la calibration de l'écran ne convient pas à vos attentes ou à chaque fois que vous modifiez le paramètre rotate=XX du module. Etant donné que l'écran et la partie tactile sont des pilotes totalement distincts (et séparer), la partie tactile ne fait pas d'auto-rotation lorsque vous faite une rotation de l'affichage.

En temps normale, vous devriez compiler le programme "xinput_calibrator" mais Adafruit propose un paquet pré-compilé afin de nous simplifier la vie. Vous pouvez installer le paquet à l'aide de la commande suivante:

wget http://adafruit-download.s3.amazonaws.com/xinput-calibrator_0.7.5-1_armhf.deb
sudo dpkg -i -B xinput-calibrator_0.7.5-1_armhf.deb

Il est nécessaire d'effacer les anciennes données de calibration avant de démarrer une calibration à l'aide de xinput_calibrator.

sudo rm /etc/X11/xorg.conf.d/99-calibration.conf

C'est une tâche essentiel avant d'exécuter startx et le calibrateur - sinon le programme de calibration devient vraiment confus! Maintenant, nous allons exécuter xcalibrator pendant que X fonctionne. Vous pouvez réaliser cela en faisant un startx puis ouvrir une session terminal et exécuter la commande xinput_calibrator (c'est un vrai challenge sur un écran aussi petit).

L'autre option est de démarrer X depuis une sessions SSH puis d'exécuter xinput_calibrator depuis le même terminal, cela est possible à l'aide des commandes suivantes:

FRAMEBUFFER=/dev/fb1 startx &
DISPLAY=:0.0 xinput_calibrator

Suivez les instructions à l'écran:

{{{2}}}
Crédit: AdaFruit Industries www.adafruit.com

Une fois complété, vous obtenez quelque-chose comme:

{{{2}}}
Crédit: AdaFruit Industries www.adafruit.com


Executez sudo nano /etc/X11/xorg.conf.d/99-calibration.conf et copiez le résultat

Section "InputClass"
        Identifier      "calibration"
        MatchProduct    "stmpe-ts"
        Option  "Calibration"   "119 3736 3850 174"
#        Option  "SwapAxes"      "1"
EndSection

(ou information obtenu) dans cette section. Vous pouvez quitter X en saisissant la commande fg (ce qui ramène la commande d'arrière plan en premier plan) puis en pressant Control-C pour quitter.

En fonction de la 'rotation' de l'écran pendant la calibration, vous pourriez avoir besoin de mettre la ligne 'SwapAxes' en commentaire avec un # et/ou intervertir les valeurs de calibration pour quelles passent de:

Option "Calibration" "119 3736 3850 174"

à cela

Option "Calibration" "3736 119 174 3850"

Voila, vous avez maintenant un écran tactile super calibré!


Source: Adafruit PiTFT 3.5" Touch Screen for Raspberry Pi
Créé par LadyAda pour AdaFruit Industries.

Traduction réalisée par Meurisse D pour MCHobby.be.

Toute référence, mention ou extrait de cette traduction doit être explicitement accompagné du texte suivant : «  Traduction par MCHobby (www.MCHobby.be) - Vente de kit et composants » avec un lien vers la source (donc cette page) et ce quelque soit le média utilisé.

L'utilisation commercial de la traduction (texte) et/ou réalisation, même partielle, pourrait être soumis à redevance. Dans tous les cas de figures, vous devez également obtenir l'accord du(des) détenteur initial des droits. Celui de MC Hobby s'arrêtant au travail de traduction proprement dit.

Traduit avec l'autorisation d'AdaFruit Industries - Translated with the permission from Adafruit Industries - www.adafruit.com