ESP32 C3 Super Mini - Affichage OLED 128x64
Introduction
Voulez-vous afficher les lectures des capteurs, l'état du système ou des graphiques personnalisés dans vos projets ESP32 C3 Super Mini ? Ce tutoriel vous montre comment connecter et programmer un affichage OLED 128x64 avec votre ESP32 C3 Super Mini - parfait pour les débutants !
Dans ce tutoriel, vous apprendrez :
- Qu'est-ce qu'un affichage OLED et pourquoi c'est génial pour les projets ESP32 C3 Super Mini
- Comment câbler un affichage OLED 128x64 à l'ESP32 C3 Super Mini
- Comment installer la bibliothèque SSD1306 OLED pour votre ESP32 C3 Super Mini
- Comment afficher du texte et des nombres sur l'écran OLED
- Comment dessiner des formes et des graphiques avec votre ESP32 C3 Super Mini
- Comment afficher des images personnalisées sur l'affichage OLED
- Comment dépanner les problèmes courants d'affichage OLED

Matériel Requis
| 1 | × | ESP32 C3 Super Mini | |
| 1 | × | Câble Micro USB | |
| 1 | × | Affichage OLED I2C SSD1306 128x64 | |
| 1 | × | Fils Jumper |
Ou vous pouvez acheter les kits suivants:
| 1 | × | Kit de Capteurs DIYables (18 capteurs/écrans) |
À Propos des Affichages OLED
Un affichage OLED (Diode Électroluminescente Organique) est un écran où chaque pixel produit sa propre lumière.
Caractéristiques clés des affichages OLED :
- Noirs parfaits - les pixels s'éteignent complètement quand ils ne sont pas nécessaires
- Contraste élevé - visuels nets et clairs
- Larges angles de vision - lisible de n'importe quelle direction
- Aucun rétroéclairage requis - consommation d'énergie inférieure
- Fin et léger - design compact
Types OLED populaires pour l'ESP32 C3 Super Mini :
- OLED I2C SSD1306 128x64 - Taille la plus courante, idéale pour le texte et les graphiques simples
- OLED I2C SSD1306 128x32 - Version plus petite pour les projets compacts
- Interface I2C - Nécessite seulement deux fils pour la communication avec l'ESP32 C3 Super Mini

Brochage de l'Affichage OLED I2C
L'affichage OLED SSD1306 a généralement quatre broches pour une connexion facile à votre ESP32 C3 Super Mini :
- Broche GND : Connectez à la terre (GND) sur l'ESP32 C3 Super Mini
- Broche VCC : Alimentation électrique - connectez à 3.3V sur l'ESP32 C3 Super Mini (certains modules acceptent 5V)
- Broche SCL : Ligne d'Horloge Série pour la communication I2C avec l'ESP32 C3 Super Mini
- Broche SDA : Ligne de Données Série pour la communication I2C avec l'ESP32 C3 Super Mini

※ Note:
- Les étiquettes des broches peuvent varier selon le fabricant - vérifiez toujours les marquages sur votre module OLED spécifique
- Ce tutoriel utilise un affichage OLED I2C SSD1306 - testé avec le module OLED DIYables
Schéma de Câblage
Voici comment connecter votre affichage OLED 128x64 à l'ESP32 C3 Super Mini en utilisant l'interface I2C :
- Schéma de câblage entre l'ESP32 C3 Super Mini et l'affichage OLED utilisant la breadboard

Cette image a été créée avec Fritzing. Cliquez pour agrandir l'image.
- Schéma de câblage entre l'ESP32 C3 Super Mini et l'affichage OLED directement

Cette image a été créée avec Fritzing. Cliquez pour agrandir l'image.
Tableau de connexion pour l'ESP32 C3 Super Mini et l'affichage OLED :
| Module OLED | ESP32 C3 Super Mini |
|---|---|
| Vin | 3.3V |
| GND | GND |
| SDA | SDA (broche 11) |
| SCL | SCL (broche 12) |
Comment Utiliser l'OLED avec l'ESP32 C3 Super Mini
Installer la Bibliothèque SSD1306 OLED
Avant de programmer votre affichage OLED avec l'ESP32 C3 Super Mini, installez les bibliothèques requises :
- Ouvrez le Gestionnaire de Bibliothèques : Cliquez sur l'icône Bibliothèques dans la barre latérale gauche de l'Arduino IDE
- Recherchez SSD1306 : Tapez "SSD1306" dans la zone de recherche
- Installez Adafruit SSD1306 : Cliquez sur Installer à côté de la bibliothèque Adafruit SSD1306
- Installez les dépendances : Quand on vous le demande, cliquez sur "Installer Tous" pour ajouter la bibliothèque Adafruit GFX


Ce que font ces bibliothèques :
- Adafruit_SSD1306 - Contrôle le matériel de l'affichage OLED sur l'ESP32 C3 Super Mini
- Adafruit_GFX - Fournit les fonctions graphiques pour dessiner sur l'OLED
Programmation de votre Affichage OLED ESP32 C3 Super Mini
Voici la structure de code basique pour utiliser un affichage OLED avec l'ESP32 C3 Super Mini :
Incluez les bibliothèques :
Définissez les dimensions OLED :
Créez un objet OLED :
Initialisez l'OLED dans setup() :
Ce que cela fait :
- SSD1306_SWITCHCAPVCC - Utilise la génération de tension interne
- 0x3C - Adresse I2C par défaut pour la plupart des affichages OLED (certains utilisent 0x3D)
- La gestion des erreurs arrête le programme si l'initialisation OLED échoue
Code ESP32 C3 Super Mini - Afficher du Texte sur l'OLED
Cet exemple montre comment afficher du texte sur votre écran OLED en utilisant l'ESP32 C3 Super Mini :
Fonctions Essentielles de Texte OLED
Fonctions clés pour afficher du texte sur l'OLED avec l'ESP32 C3 Super Mini :
- oled.clearDisplay() - Efface tous les pixels de l'écran OLED
- oled.drawPixel(x, y, color) - Dessine un seul pixel aux coordonnées x, y
- oled.setTextSize(n) - Définit la taille du texte (1-8, où 1 est le plus petit)
- oled.setCursor(x, y) - Définit la position de départ pour le texte
- oled.setTextColor(WHITE) - Définit la couleur du texte en blanc
- oled.setTextColor(BLACK, WHITE) - Définit la couleur du texte en noir avec fond blanc
- oled.println("message") - Imprime le message texte sur l'OLED
- oled.println(number) - Imprime un nombre sur l'OLED
- oled.println(number, HEX) - Imprime un nombre au format hexadécimal
- oled.display() - Met à jour l'écran OLED avec les modifications
- oled.startscrollright(start, stop) - Défile le texte de gauche à droite
- oled.startscrollleft(start, stop) - Défile le texte de droite à gauche
- oled.startscrolldiagright(start, stop) - Défile en diagonale bas-gauche vers haut-droit
- oled.startscrolldiagleft(start, stop) - Défile en diagonale bas-droit vers haut-gauche
- oled.stopscroll() - Arrête l'animation de défilement
Centrer le Texte sur votre Affichage OLED
Voulez-vous centrer le texte sur votre affichage OLED 128x64 ? Cela nécessite de calculer les dimensions du texte.
Pour des instructions détaillées sur le centrage du texte (horizontal et vertical) :
- Visitez notre guide complet : Comment centrer verticalement/horizontalement sur l'OLED
Méthode de centrage rapide :
- Utilisez getTextBounds() pour calculer la largeur et la hauteur du texte
- Centre horizontal : x = (OLED_WIDTH - textWidth) / 2
- Centre vertical : y = (OLED_HEIGHT - textHeight) / 2
Code ESP32 C3 Super Mini - Dessiner des Formes sur l'OLED
Créez des lignes, des cercles, des rectangles et d'autres formes sur votre affichage OLED avec l'ESP32 C3 Super Mini :
Fonctions de dessin courantes pour l'OLED ESP32 C3 Super Mini :
- drawLine(x1, y1, x2, y2, color) - Dessine une ligne entre deux points
- drawRect(x, y, width, height, color) - Dessine le contour d'un rectangle
- fillRect(x, y, width, height, color) - Dessine un rectangle rempli
- drawCircle(x, y, radius, color) - Dessine le contour d'un cercle
- fillCircle(x, y, radius, color) - Dessine un cercle rempli
- drawTriangle(x1, y1, x2, y2, x3, y3, color) - Dessine le contour d'un triangle
- fillTriangle(x1, y1, x2, y2, x3, y3, color) - Dessine un triangle rempli
- drawRoundRect(x, y, width, height, radius, color) - Dessine un rectangle arrondi
Code ESP32 C3 Super Mini - Afficher les Images sur l'OLED
Affichage des images personnalisées, des logos ou des icônes sur votre OLED en les convertissant en tableaux de bitmap.
Conversion d'Images en Tableaux de Bitmap
Étapes pour convertir les images pour l'OLED ESP32 C3 Super Mini :
- Choisissez votre fichier image (JPG, PNG, GIF, etc.)
- Ouvrez le convertisseur en ligne : image2cpp
- Définissez la taille du canevas à 128x64 (correspondant à la résolution de votre OLED)
- Sélectionnez "Code Arduino" comme format de sortie
- Choisissez "Vertical - 1 bit par pixel" pour le mode de dessin
- Cliquez sur générer et copiez le tableau de bitmap
Processus de conversion d'exemple :

Utilisation du Bitmap dans le Code ESP32 C3 Super Mini
Remplacez le tableau ArduinoIcon dans ce code par votre bitmap généré :
Conseils pour les meilleurs résultats d'image sur l'OLED :
- Utilisez des images noir et blanc à contraste élevé
- Redimensionnez les images à 128x64 avant la conversion
- Les graphiques simples fonctionnent mieux que les photos complexes
- Les images plus petites utilisent moins de mémoire ESP32 C3 Super Mini
- Testez différents paramètres de tramage pour la qualité des photos