Afficheur ESP32-2432S028R (CYD) : caractéristiques, révisions du pilote et configuration
Le Cheap Yellow Display : un TFT SPI 2,8 pouces 240×320 sur une carte ESP32. Selon les lots, il est livré avec un contrôleur d’affichage ILI9341 ou ST7789 : le même sketch peut donc fonctionner sur une carte et afficher un écran blanc sur une autre.
Caractéristiques de l’afficheur ESP32-2432S028R (CYD)
| MCU | ESP32 (ESP32-WROOM-32) |
|---|---|
| Afficheur | 2.8″ · 240×320 |
| Bus d’affichage | SPI (HSPI) |
| Circuit pilote | ILI9341 ou ST7789 |
| Tactile | XPT2046 résistif (broches SPI séparées) |
Quelle révision du ESP32-2432S028R (CYD) avez-vous ?
Des cartes vendues sous le même nom sont livrées avec des circuits pilotes d’affichage différents. Un code écrit pour une révision affiche un écran blanc, de mauvaises couleurs ou rien du tout sur l’autre : identifiez d’abord la vôtre.
| Révision | Circuit pilote | Comment identifier | Réglages de la bibliothèque |
|---|---|---|---|
| Version d’origine (micro-USB) | ILI9341 | Fonctionne avec le User_Setup.h communautaire sans modification | TFT_eSPI : ILI9341_2_DRIVER, sans inversion |
| Lots ultérieurs (certains avec deux ports USB) | ST7789 | Écran blanc, couleurs délavées ou inversées avec la configuration ILI9341 | TFT_eSPI : ST7789_DRIVER ; essayer TFT_INVERSION_ON/OFF et TFT_RGB_ORDER TFT_BGR un par un ; rétroéclairage toujours sur la GPIO 21 |
Broches afficheur et tactile du ESP32-2432S028R (CYD)
| Signal | GPIO | Remarques |
|---|---|---|
| TFT MOSI | 13 | HSPI |
| TFT MISO | 12 | HSPI |
| TFT SCLK | 14 | HSPI |
| TFT CS | 15 | |
| TFT DC | 2 | |
| TFT RST | -1 | Non connecté à une GPIO |
| Backlight | 21 | Actif à l’état haut ; ne pas réutiliser |
| Touch CLK | 25 | XPT2046 |
| Touch CS | 33 | XPT2046 |
| Touch DIN (MOSI) | 32 | XPT2046 |
| Touch DO (MISO) | 39 | XPT2046 |
| Touch IRQ | 36 | XPT2046 |
Même spécification d’afficheur pour la production en série
Prototype réalisé sur le ESP32-2432S028R (CYD) ? Ces modules de nos usines directes reprennent la taille et la résolution de dalle, sont livrés avec une fiche technique et un circuit pilote fixe par lot de production, et sont disponibles en échantillons dès 1 pce. MOQ et délai définis par projet.
De l’ESP32-2432S028R (CYD) prototype à la production
Les cartes de développement sont idéales pour valider une interface, mais leurs dalles sont achetées sur le marché libre : le contrôleur peut changer d’un lot à l’autre (comme c’est déjà arrivé sur cette carte), il y a rarement une fiche technique et la durée de vie n’est pas garantie. Pour un produit, spécifiez un module avec un circuit pilote fixe par lot de production, une fiche technique et un engagement de cycle de vie.
Nos usines directes fabriquent des modules au même format 2,8″ 240×320. Échantillons dès 1 pce ; MOQ et délai définis par projet avec notre équipe commerciale.
Avant de déboguer le code
- Identifiez votre révision (tableau ci-dessus) : un changement de circuit pilote est la cause la plus fréquente d’un écran blanc.
- Vérifiez que la broche de rétroéclairage n’est pas réutilisée dans votre sketch.
- Changez un réglage à la fois (pilote, inversion, ordre des couleurs) et gardez un exemple fonctionnel pour comparer.
Exemples de configuration
#define ILI9341_2_DRIVER
#define TFT_WIDTH 240
#define TFT_HEIGHT 320
#define TFT_BL 21
#define TFT_BACKLIGHT_ON HIGH
#define TFT_MISO 12
#define TFT_MOSI 13
#define TFT_SCLK 14
#define TFT_CS 15
#define TFT_DC 2
#define TFT_RST -1
#define SPI_FREQUENCY 55000000
#define SPI_READ_FREQUENCY 20000000
#define SPI_TOUCH_FREQUENCY 2500000
#define USE_HSPI_PORT// replace the ILI9341_2_DRIVER line with:
#define ST7789_DRIVER
#define TFT_WIDTH 240
#define TFT_HEIGHT 320
// if colours are inverted, toggle ONE of these:
#define TFT_INVERSION_ON
// #define TFT_INVERSION_OFF
// if red and blue are swapped:
// #define TFT_RGB_ORDER TFT_BGR
// pins and SPI settings stay the same as the ILI9341 setupQuestions fréquentes
Pourquoi mon CYD affiche-t-il un écran blanc avec un code qui marche chez d’autres ?
Votre carte a probablement le contrôleur d’affichage ST7789 au lieu de l’ILI9341. Passez le pilote TFT_eSPI à ST7789_DRIVER et ajustez l’inversion et l’ordre des couleurs ; les broches restent les mêmes.
Quelle GPIO commande le rétroéclairage du CYD ?
GPIO 21, active à l’état haut. Réutiliser la GPIO 21 dans votre sketch éteint l’écran.
Pourquoi le tactile ne fonctionne-t-il pas avec TFT_eSPI sur le CYD ?
Le contrôleur tactile XPT2046 a ses propres broches (CLK 25, CS 33, DIN 32, DO 39, IRQ 36), pas sur le bus SPI de l’afficheur : utilisez une instance distincte de la bibliothèque XPT2046 sur ces broches.
Sources
Vous ne savez pas quel afficheur convient à votre conception ?
Envoyez-nous votre taille, interface et processeur hôte. Un ingénieur afficheur répond sous 12 heures avec 2 à 3 options, fiches techniques et code d’initialisation. Échantillons dès 1 pce.