lundi 14 juin 2021

Utilisation d'un écran tactile TFT SPI 240 X 320 (ILI9341) avec le Raspberry Pi Pico

Nous allons maintenant brancher un Raspberry Pi Pico à un écran tactile SPI 240 X 320 muni d'un contrôleur ILI9341 (pour l'affichage) et d'un contrôleur XPT2046 (capteur tactile). Le Raspberry Pi Pico sera programmé en MicroPython.


Connexions de l'écran au Raspberry Pi Pico

Le module comporte un total de 18 broches:

  • 2 broches pour l'alimentation (VCC et GND)
  • 7 broches pour l'affichage
  • 5 broches pour le capteur tactile (celles dont le nom débute par "T_")
  • De l'autre côté de la carte, 4 broches pour le lecteur de carte SD (que je n'ai pas utilisé)

Il serait tout à fait acceptable de brancher l'afficheur et le capteur tactile (XPT2046) sur le même bus SPI. Toutefois, l'auteur de la bibliothèque que nous allons utiliser fait remarquer que l'affichage supporte une vitesse de communication beaucoup plus rapide que le capteur tactile. Pour cette raison, il suggère de brancher l'afficheur et le capteur tactile sur deux bus SPI différents, et c'est ce que j'ai fait (affichage sur le bus SPI0 et détection du touché sur le bus SPI1).

Ça représente beaucoup de fils à connecter... De gauche à droite sur l'écran du schéma ci-dessous:

  • Broche T_IRQ de l'écran : Broche GP2 du RP Pico
  • Broche T_DO de l'écran: Broche GP8 du RP Pico
  • Broche T_DIN de l'écran: Broche GP11 du RP Pico
  • Broche T_CS de l'écran: Broche GP12 du RP Pico
  • Broche T_CLK de l'écran: Broche GP10 du RP Pico
  • Broche SDO (MISO) de l'écran: Broche GP4 du RP Pico (probablement pas nécessaire)
  • Broche LED de l'écran: Sortie 3,3 V du RP Pico
  • Broche SCK de l'écran: Broche GP6 du RP Pico
  • Broche SDI (MOSI) de l'écran: Broche GP7 du RP Pico
  • Broche DC de l'écran: Broche GP13 du RP Pico
  • Broche RESET de l'écran: Broche GP14 du RP Pico
  • Broche CS de l'écran: Broche GP15 du RP Pico
  • Broche GND de l'écran: Broche GND du RP Pico
  • Broche VCC de l'écran: Sortie 3,3 V du RP Pico

Installation des bibliothèques

J'ai utilisé les bibliothèques MicroPython offertes par rdagger.

Pour que les scripts que je présente plus loin dans cet article fonctionnent correctement, tous les fichiers suivants doivent être copiés dans le Raspberry Pi Pico:

  • ili9341.py (gestion de l'affichage)
  • xpt2046.py (gestion du capteur tactile)
  • xglcd_font.py (pour affichage de texte)
  • Unispace12x24.c, à l'intérieur du répertoire "fonts"


Le dépôt github présente une bonne quantité de scripts en MicroPython qui montrent comment afficher du texte, des formes géométriques, des images et des animations sur l'écran (il s'agit des 11 fichiers dont le titre débute par "demo").  Mais puisqu'il n'y a aucun exemple simple montrant comment utiliser la bibliothèque xpt2046.py, c'est sur cet aspect que je vais insister.

Routine de calibration

Lorsqu'on touche l'écran, le capteur tactile envoie au Raspberry Pi Pico deux valeurs qui sont proportionnelles à la position (horizontale et verticale) qui a été touchée.  Ces valeurs brutes doivent toutefois être transformées si on désire qu'elles correspondent aux coordonnées des pixels sur l'écran.

Pour compliquer les choses, les valeurs générées ne sont pas identiques d'un écran à l'autre. Pour cette raison, il est utile d'exécuter une routine comme celle qui est présentée ci-dessous, afin de connaître les valeurs propres à l'écran que nous utilisons.

Le script ci-dessous invite l'utilisateur à toucher tour à tour chacun des 4 coins de l'écran.


Lorsque c'est terminé, les valeurs extrêmes sont affichées:
  • x_min (coordonnée x lorsqu'on touche le bord gauche de l'écran)
  • x_max (coordonnée x lorsqu'on touche le bord droit de l'écran)
  • y_min (coordonnée y lorsqu'on touche le haut de l'écran)
  • y_max (coordonnée y lorsqu'on touche le bas de l'écran)



Ces informations peuvent être entrées dans nos scripts afin que les coordonnées de la position touchée correspondent aux coordonnées du pixel correspondant sur l'écran.

-
-

Vérification de la calibration

Voici maintenant un script minimaliste qui permet de vérifier rapidement la qualité de la calibration: avant de l'utiliser, c'est important de modifier le contenu de la ligne 29 pour qu'il corresponde aux valeurs trouvées au moyen du script de calibration.

Lorsque vous exécutez ce script, un point blanc est tracé chaque fois que vous touchez l'écran. Si la calibration est correcte, le point devrait se tracer à la position touchée.


-

-

Script: un exemple avec des boutons

Voici finalement un exemple dans lequel deux boutons apparaissent à l'écran. Lorsqu'on touche le bouton de gauche, un cercle vert est affichée, alors que c'est un rectangle rouge qui s'affiche lorsqu'on clique sur le bouton de droite. Encore une fois, pour que ça fonctionne bien, c'est important d'écrire vos paramètres de calibration à la ligne 68 du script.


-
-

À lire également

Le même écran tactile peut être utilisé avec un ESP32, un ESP8266 ou une STM32 Blue Pill (toutes ces cartes ont été programmées avec l'IDE Arduino).

D'autre part, nous avons déjà exploré l'utilisation d'autres afficheurs avec le Raspberry Pi Pico programmé en MicroPython: 


Yves Pelletier (TwitterFacebook)

1 commentaire:

  1. Bonsoir!! Merci pour ce super post, ça m'a beaucoup aidé !! Mais j'ai un problème que je n'arrive pas à résoudre : l'axe Y de l'affichage est inversé. lorsque je lance le programme pour vérifier l'étalonnage en cliquant sur le haut, le cercle apparaît en bas. En haut à gauche (x, y) = 147, 1854 --- En haut à droite = 1903, 1839 --- En bas à gauche = 123, 70 --- En bas à droite = 1903, 93. Qu'est-ce qui pourrait faire cela et comment le résoudre ? Merci beaucoup d'avance!!

    RépondreSupprimer