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égorie | GPIO | Usage |
|---|---|---|
| Sûres | 13, 14, 16, 17, 18, 19, 21, 22, 23, 25, 26, 27, 32, 33 | Tout : 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 uniquement | 34, 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, 11 | Ne jamais utiliser |
| Série USB | 1 (TX0), 3 (RX0) | À garder pour le téléversement et le moniteur série |
| Tactiles, sûres pour vêtements | 4, 13, 14, 27, 32, 33 | Zones tactiles en tissu conducteur |
| Analogiques avec WiFi (ADC1) | 32, 33, 34, 35, 36, 39 | Capteurs 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.

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.

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.

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 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.

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
- Besoin d'une sortie ou d'un capteur général ? Choisissez parmi les broches sûres.
- Besoin d'un capteur tactile en tissu ? Utilisez 4, 13, 14, 27, 32 ou 33.
- Lecture d'un capteur analogique avec le WiFi actif ? Utilisez 32 à 39.
- Lecture d'un capteur seulement ? Les broches d'entrée uniquement conviennent.
- Broche de démarrage ? Débranchez-la avant le téléversement et testez un cycle d'alimentation.
- 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.