Connexion Écran TFT SPI

Interfacer un écran TFT 2.4" ST7789 avec Raspberry Pi Pico W

À propos de cette connexion

L'écran TFT SPI 240x320 ST7789 est un composant essentiel pour notre console de rétro gaming. Ce guide détaille comment connecter correctement l'écran au Raspberry Pi Pico W, les configurations logicielles nécessaires et les premiers tests.

📦 Composants nécessaires

Microcontrôleur

1x Raspberry Pi Pico W (WiFi intégré)

Écran

1x Écran TFT 2.4" 240x320 ST7789 (interface SPI)

Câblage

Fils de connexion (minimum 8 fils pour le SPI)

Alimentation

Câble USB pour alimentation du Pico (ou batterie externe)

📺 Aperçu de l'écran TFT ST7789

Vue de l'arrière

Écran TFT ST7789 - Vue de l'arrière

Survolez l'image pour zoomer • Cliquez pour ouvrir en grand

× Écran TFT ST7789 - Vue de l'arrière agrandie

🔌 Schéma de connexion

Le protocole SPI (Serial Peripheral Interface) utilise 4 lignes principales (MOSI, MISO, CLK, CS) plus plusieurs signaux de contrôle pour l'écran TFT.

Pinout du Raspberry Pi Pico W

Pinout Raspberry Pi Pico W

Survolez l'image pour zoomer • Cliquez pour ouvrir en grand

× Pinout Raspberry Pi Pico W - Vue agrandie
Broche Écran TFT Code Pico Description Notes
GND GND Masse / Ground 🔴 Essentiel - Commun GND
VCC (3.3V) 3V3 Alimentation ⚠️ Vérifier la tension de l'écran
CS GP17 Sélection de l'esclave Sortie du Pico vers écran
RESET GP20 Réinitialisation Sortie du Pico vers écran
A0 GP21 Sélection Données/Commande Sortie du Pico vers écran
SDA GP19 Données SPI (MOSI) Sortie du Pico vers écran
SCK GP18 Horloge SPI (CLK) Sortie du Pico vers écran
LED GP16 Rétroéclairage (Backlight) Sortie du Pico vers écran

ℹ️ À propos du protocole SPI

SPI (Serial Peripheral Interface) est un protocole de communication sériel synchrone. Le Pico peut avoir deux instances SPI:

  • SPI0: Utilise par défaut les GP16 (CLK), GP19 (MOSI), GP20 (RX - non utilisé ici)
  • SPI1: Utilise par défaut les GP10 (CLK), GP11 (MOSI), GP8 (RX - non utilisé ici)

Dans notre cas, nous utilisons SPI0 avec les broches réaffectées pour plus de flexibilité.

⚠️ Attention - Tensions électriques

  • Le Pico est un appareil 3.3V
  • Certains écrans TFT fonctionnent en 5V - vérifier les spécifications
  • Connecter directement une broche 5V au Pico peut l'endommager
  • Si nécessaire, utiliser un convertisseur de niveau logique (level shifter)

🔧 Guide d'assemblage étape par étape

  1. Préparation : Rassembler tous les composants et les fils de connexion
  2. Câblage GND : Commencer par connecter GND de l'écran à GND du Pico
  3. Câblage VCC : Connecter VCC de l'écran à 3V3 du Pico
  4. Câblage SPI : Connecter CLK et MOSI selon le tableau
  5. Signaux de contrôle : Connecter DC, CS et RST
  6. Rétroéclairage : Connecter BL (optionnellement avec PWM)
  7. Vérification : Vérifier visuellement tous les branchements avant alimentation
  8. Test : Brancher le Pico en USB et tester avec le code
📄 Voir le schéma complet (PDF)

💻 Configuration logicielle

Vous aurez besoin d'une bibliothèque MicroPython pour contrôler l'écran. La bibliothèque st7789 est recommandée.

📂 Fichiers Python pour le projet

🐍
boot.py
Démarrage du système
📄
ST7735.py
Pilote de l'écran
🔡
sysfont.py
Police de caractères
🖼️
tftbmp.py
Affichage d'images BMP
⚡
offscreen-buffer.py
Optimisation graphique

Installation de la bibliothèque

# Avec thonny: Tools > Manage Packages # Rechercher "st7789" et installer # Ou manuellement, copier le fichier st7789.py # sur l'espace de stockage du Pico

Code de base pour initialiser l'écran

from machine import Pin, SPI import st7789 # Initialiser SPI spi = SPI(0, baudrate=40000000, polarity=0, phase=0, sck=Pin(16), mosi=Pin(19), miso=Pin(20)) # Créer l'instance de l'écran tft = st7789.ST7789( spi, 240, # Largeur en pixels 320, # Hauteur en pixels reset=Pin(20), # Broche RST dc=Pin(21), # Broche DC cs=Pin(17), # Broche CS backlight=Pin(13) # Broche BL (optionnel) ) # Initialiser l'écran tft.init() # Remplir l'écran avec une couleur # Format RGB565 tft.fill(0x0000) # Noir # Afficher un texte tft.text("Bonjour!", 10, 10, 0xFFFF) # Blanc

Codes de couleur (RGB565)

⬛ Noir: 0x0000
⬜ Blanc: 0xFFFF
🟥 Rouge: 0xF800
🟩 Vert: 0x07E0
🟦 Bleu: 0x001F
🟨 Jaune: 0xFFE0

📝 Exemple complet : Affichage animé

from machine import Pin, SPI, PWM import st7789 import time # Initialiser l'écran spi = SPI(0, baudrate=40000000, polarity=0, phase=0, sck=Pin(16), mosi=Pin(19), miso=None) tft = st7789.ST7789( spi, 240, 320, reset=Pin(20), dc=Pin(21), cs=Pin(17), backlight=Pin(13) ) # Initialiser le rétroéclairage (PWM optionnel) backlight_pwm = PWM(Pin(13)) backlight_pwm.freq(1000) backlight_pwm.duty_u16(65535) # Luminosité max (0-65535) tft.init() # Animation simple colors = [0xF800, 0x07E0, 0x001F, 0xFFE0] # R, G, B, Y x = 50 for i in range(100): tft.fill(0x0000) # Effacer l'écran tft.rect(x + i, 100, 50, 50, colors[i % 4]) # Dessiner un carré time.sleep(0.05) tft.text("Animation terminee!", 20, 150, 0xFFFF)

⚙️ Configuration de Thonny et des ports

Thonny est un IDE MicroPython simple et intuitif pour programmer le Raspberry Pi Pico. Voici comment le configurer correctement.

📥 Installation de Thonny

  1. Télécharger Thonny depuis thonny.org
  2. Installer Thonny selon votre système d'exploitation
  3. Lancer Thonny pour la première fois
  4. Aller à Tools → Options → Interpreter

🔌 Configuration du port et de l'interpréteur

Étapes de configuration

  1. Connecter le Pico: Brancher le Raspberry Pi Pico W en USB à votre ordinateur
  2. Ouvrir Options: Menu "Tools" → "Options..."
  3. Onglet Interpreter: Sélectionner l'onglet "Interpreter"
  4. Choisir l'interpréteur: Sélectionner "MicroPython (Raspberry Pi Pico)" dans la liste déroulante
  5. Sélectionner le port: Choisir le port COM correct (généralement COM3, COM4, COM5, etc.)
  6. Appliquer: Cliquer sur "OK" pour valider

📍 Identifier le bon port COM

Sous Windows:

  • Ouvrir le "Gestionnaire de périphériques" (appuyer sur Win + X, choisir "Gestionnaire de périphériques")
  • Expandir "Ports (COM et LPT)"
  • Chercher "USB Serial Device" ou "Raspberry Pi Pico"
  • Noter le port COM (ex: COM3, COM4)
  • Si vous ne voyez pas le Pico, essayer de réinstaller les drivers ou utiliser un autre câble USB

Sous Linux/Mac:

  • Ouvrir un terminal
  • Taper /dev/tty.* pour voir les ports disponibles
  • Le Pico apparaîtra comme /dev/ttyUSB0 ou /dev/ttyACM0

📦 Installation de MicroPython sur le Pico

Si c'est la première fois, vous devez charger MicroPython sur le Pico.

Méthode 1 : Avec Thonny (Recommandé) ════════════════════════════════════ 1. Brancher le Pico en USB 2. Dans Thonny, aller à "Tools → Options → Interpreter" 3. Si demandé, Thonny proposera d'installer MicroPython automatiquement 4. Laisser Thonny installer la version la plus récente Méthode 2 : Manuellement ═════════════════════════ 1. Télécharger le firmware UF2 depuis: https://micropython.org/download/rp2-pico-w/ 2. Brancher le Pico en USB (tout en appuyant sur BOOTSEL) 3. Il apparaîtra comme un lecteur USB (RPI-RP2) 4. Copier le fichier .uf2 dans ce lecteur 5. Le Pico redémarrera automatiquement

✅ Test de connexion

Une fois configuré, testez la connexion :

# Taper dans la console Thonny (en bas) # ou créer un nouveau fichier et exécuter print("Hello from Pico!") # Si vous voyez "Hello from Pico!" en bas, c'est bon ! # Vous pouvez maintenant charger le code pour l'écran.

💾 Charger du code sur le Pico

  1. Créer un nouveau fichier : "File → New" ou Ctrl+N
  2. Écrire le code : Copier le code MicroPython dans l'éditeur
  3. Enregistrer sur le Pico : "File → Save As..." → choisir "Raspberry Pi Pico"
  4. Donner un nom : Pour la boucle principale, appeler le fichier main.py
  5. Exécuter : Cliquer sur le bouton Play (▶) ou appuyer sur F5

Note: Les fichiers sauvegardés comme main.py s'exécutent automatiquement au démarrage du Pico.

🎯 Installer les bibliothèques (st7789)

Méthode 1 : Avec Thonny (Recommandé) ════════════════════════════════════ 1. Menu "Tools → Manage Packages..." 2. Rechercher "st7789" 3. Cliquer sur le premier résultat 4. Attendre que l'installation se termine 5. Redémarrer Thonny Méthode 2 : Télécharger manuellement ═════════════════════════════════════ 1. Télécharger le fichier st7789.py depuis: https://github.com/russhughes/st7789_mpy/blob/master/st7789.py 2. Sauvegarder le fichier sur le Pico en tant que "st7789.py" 3. Utiliser dans votre code : import st7789

🐛 Dépannage Thonny

Port COM non détecté

Vérifier les drivers USB, essayer un autre câble USB ou redémarrer l'ordinateur.

Erreur de connexion

Fermer tout autre logiciel utilisant le port (Arduino IDE, Terminal, etc.)

MicroPython non détecté

Cliquer sur "Install MicroPython" dans Thonny quand demandé.

Erreur d'importation st7789

Utiliser "Tools → Manage Packages" pour installer st7789 correctement.

🔍 Tests et dépannage

✓ Écran qui s'allume

Excellent ! Passez à l'étape suivante de programmation.

✗ Écran noir

Vérifier les tensions et les connexions GND/VCC en priorité.

✗ Erreur SPI

Vérifier les broches en accord avec le tableau et le baudrate SPI.

✗ Affichage bizarre

Problème de timing - réduire le baudrate SPI ou vérifier les pinouts.

📚 Ressources et documentation

🚀 Prochaines étapes

  1. Mettre en place la connexion physique selon le schéma
  2. Installer la bibliothèque st7789
  3. Tester l'affichage basique avec le code d'initialisation
  4. Explorer les fonctions de dessin (rect, circle, line, etc.)
  5. Intégrer l'écran dans le projet de console de jeux
  6. Optimiser le code pour les performances
← Retour au projet Console