The Ultimate Guide to ESP32 Dev Module Pins

Le guide complet des broches de l'ESP32 Dev Module

Mis à jour le

L'ESP32 a beaucoup de broches, et elles ne se valent pas toutes.

Certaines conviennent à tout. Certaines sont lues au démarrage et peuvent empêcher votre carte de démarrer. Certaines ne font qu'entrée. D'autres sont reliées à la puce flash et ne doivent jamais être touchées. Choisissez la mauvaise et vous obtenez une carte qui ne démarre pas, refuse le téléversement ou plante au hasard.

Ce guide classe chaque broche de l'ESP32 Dev Module en quatre catégories simples, puis couvre les fonctions spéciales (tactile, analogique, I2C, SPI, série) et le choix des broches pour les vêtements connectés et les projets en tissu. Il accompagne l'épisode 6 de la série Foundations, Reading a Pinout Diagram (vidéo en anglais).

La carte utilisée tout au long du guide est notre carte de développement ESP32 30 broches (USB-C), un module de développement ESP32-WROOM-32. Les catégories s'appliquent à tous les ESP32 Dev Module, y compris la version 38 broches. La seule différence est le nombre de broches accessibles sur les connecteurs.

Référence rapide : l'aide-mémoire des broches

Si vous ne retenez qu'une chose, retenez ce tableau. Commencez chaque projet avec les broches sûres et ne passez aux autres que si vous savez pourquoi.

CatégorieGPIOUsage
Sûres13, 14, 16, 17, 18, 19, 21, 22, 23, 25, 26, 27, 32, 33Tout : LED, boutons, capteurs, connexions en tissu
Démarrage (avec prudence)0, 2, 5, 12, 15À éviter en prototype. Sinon, débranchez la charge pendant le téléversement
Entrée uniquement34, 35, 36 (VP), 39 (VN)Capteurs et entrées analogiques. Pas de sortie, pas de résistance de rappel interne
Réservées (flash)6, 7, 8, 9, 10, 11Ne jamais utiliser
Série USB1 (TX0), 3 (RX0)À garder pour le téléversement et le moniteur série
Tactiles, sûres pour vêtements4, 13, 14, 27, 32, 33Zones tactiles en tissu conducteur
Analogiques avec WiFi (ADC1)32, 33, 34, 35, 36, 39Capteurs analogiques dans les projets WiFi

Catégorie 1 : les broches sûres

GPIO 13, 14, 16, 17, 18, 19, 21, 22, 23, 25, 26, 27, 32 et 33.

Pas de rôle au démarrage, pas de lien avec la flash, pas de restriction d'entrée. Ces broches peuvent servir d'entrée ou de sortie, acceptent les résistances de rappel internes et se comportent comme prévu. Branchez-y d'abord LED, boutons, capteurs et connexions en tissu.

Plusieurs ont aussi une fonction par défaut, utile à connaître avant de planifier un montage :

  • I2C : SDA sur 21, SCL sur 22
  • SPI (VSPI) : MOSI sur 23, MISO sur 19, CLK sur 18
  • Série 2 : RX sur 16, TX sur 17
  • DAC (vraie sortie analogique) : 25 et 26

Ces fonctions peuvent être réattribuées par logiciel pour la plupart des périphériques, mais garder les valeurs par défaut permet aux bibliothèques et aux exemples de fonctionner sans modification.

Broches GPIO sûres de l'ESP32 surlignées sur le schéma de brochage

Catégorie 2 : les broches de démarrage

GPIO 0, 2, 5, 12 et 15. À utiliser avec prudence.

À la mise sous tension, l'ESP32 lit l'état de ces broches pour décider comment démarrer. Si un élément branché sur l'une d'elles la tire dans le mauvais sens à ce moment-là, la carte ne démarre pas ou refuse le téléversement. Une fois la carte lancée, elles se comportent comme des broches normales, d'où la confusion : le projet fonctionne, puis échoue après une réinitialisation.

  • GPIO 0 sélectionne le mode de téléversement. Il est relié au bouton BOOT et, sur la plupart des cartes 30 broches, il n'est même pas sur le connecteur.
  • GPIO 2 est souvent relié à la LED intégrée.
  • GPIO 12 règle la tension de la flash. Une charge qui le maintient haut au démarrage peut empêcher certains modules de démarrer.
  • GPIO 5 et 15 influencent les messages et le minutage du démarrage.

La règle simple : évitez-les en prototype. Si vous devez en utiliser une, débranchez la charge pendant le téléversement et testez un cycle complet d'alimentation.

Broches de démarrage de l'ESP32 surlignées sur le schéma de brochage

Catégorie 3 : les broches d'entrée uniquement

GPIO 34, 35, 36 (VP) et 39 (VN). Capteurs seulement.

Ces broches ne peuvent rien émettre. Elles n'ont pas non plus de résistance de rappel interne : un bouton aura besoin d'une résistance externe. Elles sont idéales pour lire des capteurs analogiques, c'est d'ailleurs ce qu'elles font le mieux. N'essayez jamais d'y alimenter une LED : le code s'exécutera, et rien ne se passera.

Broches d'entrée uniquement de l'ESP32 surlignées sur le schéma de brochage

Catégorie 4 : les broches réservées

GPIO 6, 7, 8, 9, 10 et 11. Ne jamais toucher.

Elles sont reliées à la puce flash qui stocke votre programme. Branchez-y quoi que ce soit et la carte plante. Beaucoup de cartes 30 broches ne les exposent pas du tout, ce qui est le plus sûr. Si votre carte les expose, faites comme si elles n'existaient pas.

Broches flash réservées de l'ESP32 surlignées sur le schéma de brochage

Broches tactiles : branchez le tissu directement

C'est la fonction qui fait de l'ESP32 une si bonne carte pour les vêtements connectés et les e-textiles. Dix broches (T0 à T9) détectent directement la capacité : un morceau de tissu, de fil ou de feuille conductrice relié à la broche devient un capteur tactile sans aucun composant supplémentaire.

Broches tactiles capacitives de l'ESP32 surlignées sur le schéma de brochage

Quatre de ces canaux sont sur des broches de démarrage (0, 2, 12 et 15). Pour les vêtements, utilisez 4, 13, 14, 27, 32 et 33. Vous obtenez six entrées tactiles fiables sans risquer le démarrage.

Un exemple PlatformIO minimal qui lit une zone tactile en tissu sur le GPIO 14 :

// platformio.ini
[env:esp32dev]
platform = espressif32
board = esp32dev
framework = arduino
monitor_speed = 115200

// src/main.cpp
#include <Arduino.h>

const int TOUCH_PIN = 14;   // T6
const int THRESHOLD = 30;   // a ajuster selon votre tissu

void setup() {
  Serial.begin(115200);
}

void loop() {
  int value = touchRead(TOUCH_PIN);
  Serial.println(value);
  if (value < THRESHOLD) {
    Serial.println("Touched");
  }
  delay(100);
}

Sur l'ESP32 classique, la valeur baisse quand vous touchez la zone. Ouvrez le moniteur série, notez la valeur sans contact et avec contact, puis réglez le seuil entre les deux. Tissus, tailles et longueurs de fil différents donnent des valeurs différentes : calibrez toujours pour votre propre montage. Nos tissus conducteurs sont parfaits pour expérimenter.

Entrées analogiques : ADC1 ou ADC2

L'ESP32 possède deux convertisseurs analogique-numérique, et cela piège beaucoup de monde.

  • ADC1 (GPIO 32 à 39) fonctionne en tout temps.
  • ADC2 (GPIO 0, 2, 4, 12 à 15, 25 à 27) est inutilisable quand le WiFi est actif.

Si votre projet utilise le WiFi, lisez vos capteurs analogiques sur les broches ADC1. Encore une bonne raison de réserver 34, 35, 36 et 39 aux capteurs.

Broches à laisser tranquilles : GPIO 1 et 3

GPIO 1 (TX0) et GPIO 3 (RX0) forment la connexion série USB. Elles servent au téléversement et au moniteur série. Vous pouvez les utiliser, mais votre sortie série entrera en conflit avec ce que vous y branchez. Pour débuter, considérez-les comme réservées.

Alimentation et tension : trois choses à savoir

  • Logique 3,3 V. Les broches ne tolèrent pas le 5 V. Un signal de 5 V branché directement peut endommager la puce.
  • Courant faible. Pilotez directement de petites charges, comme une LED avec résistance. Utilisez un transistor ou un pilote pour tout ce qui est plus gros, comme des moteurs ou de longs rubans de LED.
  • 3V3 et VIN. La broche 3V3 fournit une alimentation régulée pour les petits capteurs. VIN donne le 5 V de l'USB pour ce qui en a besoin.

Cartes 30 broches ou 38 broches

Les deux cartes utilisent la même puce ESP32, et toutes les catégories ci-dessus s'appliquent aux deux. La carte 38 broches expose quelques broches de plus, dont le GPIO 0 et les broches flash réservées, d'où leur présence dans l'aide-mémoire. Sur une carte 30 broches, elles sont cachées, ce qui rend les erreurs un peu plus difficiles. Vérifiez toujours la sérigraphie de votre carte, car la disposition varie légèrement d'un fabricant à l'autre.

Choisir une broche en 10 secondes

  1. Besoin d'une sortie ou d'un capteur général ? Choisissez parmi les broches sûres.
  2. Besoin d'un capteur tactile en tissu ? Utilisez 4, 13, 14, 27, 32 ou 33.
  3. Lecture d'un capteur analogique avec le WiFi actif ? Utilisez 32 à 39.
  4. Lecture d'un capteur seulement ? Les broches d'entrée uniquement conviennent.
  5. Broche de démarrage ? Débranchez-la avant le téléversement et testez un cycle d'alimentation.
  6. Ne touchez jamais 6 à 11.

Regardez l'épisode complet

L'épisode 6 de Foundations, Reading a Pinout Diagram, parcourt le schéma pas à pas pour que vous puissiez lire n'importe quel brochage et savoir ce qui est sûr.

Regardez Foundations EP.06 sur YouTube, et consultez le guide des broches et broches tactiles ESP32 pour toutes nos cartes pour les cartes S3 et C3.

Procurez-vous la carte

Prêt à essayer ? Prenez la carte de développement ESP32 30 broches (USB-C), ou la version 38 broches avec USB-C. Besoin d'un câble ? Nous avons aussi un câble de données USB-C.

Retour au blog

Laisser un commentaire