ESP32 gestionnaire de cartes : corriger l'erreur d'installation
ESP32 gestionnaire de cartes en erreur ? Bonne URL, Error downloading, délai dépassé, antivirus, proxy, anciens paquets et installation hors ligne.
Une erreur du gestionnaire de cartes ESP32 est le problème le plus courant quand on ajoute l'ESP32 à l'Arduino IDE : esp32 n'apparaît jamais dans le gestionnaire de cartes, l'installation s'arrête en plein milieu sur "Error downloading", ou elle échoue par dépassement de délai après plusieurs minutes d'attente. La cause est presque toujours l'une de ces cinq : une URL de gestionnaire de cartes fausse ou périmée, une connexion Internet lente ou filtrée, un antivirus qui verrouille des fichiers, d'anciens téléchargements restés à moitié et des restes d'anciens paquets sur le disque.
Dans ce guide, tu feras d'abord une installation propre étape par étape, puis tu trouveras la solution correspondant au message d'erreur affiché. Tu verras aussi comment installer hors ligne sur les réseaux filtrés des écoles et des entreprises, comment obtenir un affichage détaillé avec Arduino CLI et comment choisir entre les cores 2.x et 3.x. Pour finir, un petit programme de test confirmera que l'installation fonctionne vraiment.

Qu'est-ce que le paquet de cartes ESP32 et pourquoi est-il si lourd ?
À l'origine, l'Arduino IDE ne connaît que les cartes d'Arduino. Pour l'ESP32, il faut installer le paquet arduino-esp32 (core) d'Espressif. Ce n'est pas une poignée de fichiers : il contient les chaînes de compilation Xtensa et RISC-V, les bibliothèques ESP-IDF, l'outil de téléversement esptool et des outils de système de fichiers. Les versions 3.x actuelles téléchargent des centaines de mégaoctets et occupent plusieurs gigaoctets une fois décompressées. Plus le téléchargement est gros, plus il risque d'être interrompu, et c'est de là que viennent la plupart des erreurs.
Installation propre étape par étape
- Utilise la dernière version 2.x de l'Arduino IDE ; l'ancienne base Java de la 1.8.x n'arrive parfois pas à établir une connexion sécurisée avec certains serveurs.
- Ouvre Fichier > Préférences (sur macOS, Arduino IDE > Settings).
- Dans le champ URL de gestionnaire de cartes supplémentaires, colle cette adresse : https://espressif.github.io/arduino-esp32/package_esp32_index.json. Si d'autres URL y figurent déjà, mets chacune sur sa propre ligne.
- Clique sur OK et attends que l'IDE télécharge l'index des paquets en bas de la fenêtre.
- Ouvre le gestionnaire de cartes dans la barre latérale, tape esp32 et clique sur Installer pour esp32 by Espressif Systems. Le paquet "Arduino ESP32 Boards" d'Arduino ne sert qu'à la Nano ESP32, ne les confonds pas.
- Une fois terminé, choisis ESP32 Dev Module ou le modèle de ta carte dans Outils > Carte.
Tableau des solutions selon le message d'erreur
Quand l'installation échoue, le panneau Sortie en bas de l'IDE affiche un long message en anglais. Inutile de tout décortiquer : repère l'expression clé dans le tableau ci-dessous et applique la solution en face. Si tu en vois plusieurs, la dernière ligne est généralement la vraie cause.
| Le message contient | Signification | Solution |
|---|---|---|
| Error downloading ... package_esp32_index.json | L'index des paquets est inaccessible | Vérifie l'URL lettre par lettre et ouvre-la dans un navigateur ; si elle ne s'ouvre pas, c'est le réseau ou le proxy |
| context deadline exceeded, Client.Timeout exceeded, DEADLINE_EXCEEDED | Le téléchargement a dépassé le délai | Augmente le délai, essaie un câble réseau ou le partage de connexion du téléphone |
| TLS handshake timeout, x509: certificate signed by unknown authority | Impossible d'établir une connexion sécurisée | Corrige la date et l'heure de l'ordinateur ; sur un réseau d'entreprise, renseigne le proxy |
| checksum mismatch, archive hash differs, CRC doesn't match | Le fichier téléchargé est corrompu ou incomplet | Supprime les fichiers ESP32 du dossier staging et réinstalle |
| Access is denied, moving extracted archive, rename | Un antivirus ou un autre programme a verrouillé un fichier | Ajoute le dossier Arduino15 aux exclusions de l'antivirus et relance l'IDE |
| no space left on device | Le disque est plein | Libère au moins 5 Go et supprime les anciennes versions du core |
| 403 Forbidden, 404 Not Found (github.com) | GitHub est bloqué ou l'adresse est périmée | Essaie un autre réseau, mets à jour l'IDE et l'URL |
| esp32 n'apparaît pas dans le gestionnaire de cartes | URL absente ou index non actualisé | Ajoute l'URL et redémarre l'IDE |
Délai dépassé et connexion lente
Le cas le plus fréquent est une coupure pendant le téléchargement d'un des gros fichiers de la chaîne de compilation. L'Arduino IDE 2.x utilise Arduino CLI en arrière-plan, et son délai réseau par défaut peut être trop court pour une connexion lente. Commence par les solutions simples : un câble réseau ou le partage de connexion de ton téléphone à la place du Wi-Fi, couper ou activer un VPN, ou réessayer à un moment où le réseau est peu chargé. Si une installation a été interrompue, l'IDE ne retélécharge pas les fichiers déjà terminés au redémarrage ; quelques tentatives suffisent souvent.
Si le problème persiste, augmente le délai. IDE fermé, ouvre le fichier .arduinoIDE/arduino-cli.yaml de ton dossier utilisateur avec un éditeur de texte, ajoute une section network: puis, en dessous et en retrait, la ligne connection_timeout: 600s. L'attente passe alors à 10 minutes ; ce réglage fonctionne avec les versions récentes de l'IDE qui embarquent Arduino CLI 1.x, donc mets d'abord à jour un IDE ancien. Sur un réseau d'entreprise, saisis l'adresse du proxy dans Préférences > Réseau de l'IDE.
Antivirus, pare-feu et proxy
Sous Windows, une installation qui s'arrête presque à la fin sur "Access is denied" ou "moving extracted archive" vient le plus souvent de l'antivirus. La décompression du paquet crée des milliers de petits fichiers ; Windows Defender ou un autre logiciel de sécurité les verrouille pour les analyser, et l'IDE ne peut pas les déplacer à leur place. La solution consiste à ajouter le dossier Arduino15 aux exclusions de l'antivirus pendant l'installation ; exclure uniquement ce dossier est plus sûr que désactiver complètement la protection. Sur les réseaux des écoles et des entreprises, un pare-feu peut aussi bloquer les serveurs de téléchargement de GitHub. Si l'index des paquets s'ouvre dans le navigateur mais que l'installation échoue quand même, demande l'adresse du proxy à l'administrateur réseau, ou installe le paquet chez toi et transfère-le avec la méthode hors ligne décrite plus bas.
| Système d'exploitation | Dossier Arduino15 | Téléchargements partiels (staging) |
|---|---|---|
| Windows | %LOCALAPPDATA%\Arduino15 | %LOCALAPPDATA%\Arduino15\staging\packages |
| macOS | ~/Library/Arduino15 | ~/Library/Arduino15/staging/packages |
| Linux | ~/.arduino15 | ~/.arduino15/staging/packages |
Nettoyer les restes d'anciens paquets
Si tu as déjà installé l'ESP32 d'une autre façon (par exemple à la main depuis GitHub) ou ajouté une vieille version il y a des années, la nouvelle installation peut entrer en conflit avec d'anciens fichiers. Signes typiques : l'installation se termine sans erreur mais l'ESP32 apparaît deux fois dans la liste des cartes, la compilation affiche des avertissements "multiple libraries were found" ou l'IDE s'obstine à utiliser une ancienne version. Ces étapes te permettent de repartir de zéro.
- Ferme complètement l'Arduino IDE.
- Supprime le dossier packages/esp32 et le fichier package_esp32_index.json dans Arduino15.
- Supprime les fichiers ESP32 partiels dans staging/packages (ceux qui commencent par esp32-, xtensa-, riscv32- et esptool).
- Si ton dossier de croquis (souvent Documents/Arduino) contient un dossier hardware/espressif, retire-le aussi ; il vient d'une ancienne installation manuelle et entre en conflit avec celle du gestionnaire de cartes.
- Ouvre l'IDE, vérifie que seule l'URL ESP32 actuelle reste dans les Préférences et réinstalle le paquet.
Installation hors ligne et manuelle
Dans une salle informatique au réseau filtré ou avec une connexion très lente, la méthode la plus fiable consiste à installer le paquet sur un ordinateur bien connecté puis à le transférer. Cela fonctionne sans souci entre deux ordinateurs ayant le même système d'exploitation, car les compilateurs sont propres à chaque système : un paquet installé sous Windows ne fonctionne pas sous macOS.
- Sur l'ordinateur bien connecté, installe normalement l'Arduino IDE et le paquet ESP32.
- Copie sur une clé USB le dossier packages/esp32 et le fichier package_esp32_index.json du dossier Arduino15 de cet ordinateur.
- Sur l'ordinateur cible, ouvre puis ferme une fois l'Arduino IDE pour que le dossier Arduino15 soit créé.
- Colle ce que tu as copié aux mêmes emplacements dans le dossier Arduino15 de l'ordinateur cible et ajoute la même URL ESP32 dans les Préférences.
- Ouvre l'IDE : le gestionnaire de cartes affichera esp32 comme installé et les cartes ESP32 apparaîtront dans Outils > Carte.
Une deuxième méthode consiste à télécharger dans le navigateur les fichiers que l'IDE n'arrive pas à récupérer et à les placer dans le dossier staging/packages. Avant d'installer, l'IDE regarde dans ce dossier ; si le nom et la somme de contrôle du fichier correspondent exactement à l'index des paquets (package_esp32_index.json), il saute le téléchargement et décompresse directement le fichier. La ligne "Downloading" du panneau Sortie t'indique quel fichier il faut. Pour les développeurs, une troisième voie consiste à cloner le dépôt GitHub dans hardware/espressif de ton dossier de croquis, mais cette méthode ne doit pas être utilisée en même temps qu'une installation par le gestionnaire de cartes.
Installation détaillée avec Arduino CLI
L'IDE n'affiche qu'un court message d'erreur. Pour voir précisément sur quel fichier et à quelle étape ça bloque, tu peux faire la même opération en ligne de commande avec Arduino CLI. Comme l'IDE 2.x utilise déjà cet outil en arrière-plan, un paquet installé avec la CLI apparaît aussi dans l'IDE, tant que les deux utilisent le même dossier de données.
| Commande | Rôle |
|---|---|
| arduino-cli config init | Crée le fichier de configuration |
| arduino-cli config add board_manager.additional_urls https://espressif.github.io/arduino-esp32/package_esp32_index.json | Ajoute l'URL du paquet ESP32 |
| arduino-cli core update-index | Télécharge les index des paquets |
| arduino-cli core install esp32:esp32 -v | Installe le paquet ESP32 avec un affichage détaillé |
| arduino-cli core install esp32:[email protected] | Installe une version précise |
| arduino-cli core list | Liste les cores installés et leurs versions |
Choisir la bonne version du core
Le gestionnaire de cartes propose toujours la version la plus récente, mais elle n'est pas forcément la meilleure pour chaque projet. Avec la version 3.0, arduino-esp32 est passé à ESP-IDF 5 et certaines fonctions ont changé : pour le PWM, on utilise désormais ledcAttach au lieu de ledcSetup et ledcAttachPin, et pour les timers timerBegin(fréquence) au lieu de timerBegin(0, 80, true). C'est pourquoi une ancienne bibliothèque ou un tutoriel écrit pour la 2.x peut ne pas compiler en 3.x. Dans le gestionnaire de cartes, tu peux choisir n'importe quelle version dans la liste sous le paquet ; une seule version est installée à la fois.
| Version | Base ESP-IDF | Puces prises en charge | Quand la choisir ? |
|---|---|---|---|
| 1.0.6 | 3.3 | ESP32 uniquement | Seulement pour recompiler tel quel un très vieux projet |
| 2.0.17 | 4.4 | ESP32, S2, S3, C3 | Bibliothèques pas encore adaptées à la 3.x et anciens tutoriels |
| 3.x (actuelle) | 5.x | ESP32, S2, S3, C3, C6, H2 et plus récentes | Le choix par défaut pour les nouveaux projets et les nouvelles puces |
Si tu veux que ton propre code compile sur les deux versions, utilise la macro de version. L'exemple ci-dessous allume progressivement la LED intégrée ; si ESP_ARDUINO_VERSION_MAJOR vaut 3 ou plus, il compile les nouvelles fonctions PWM, sinon les anciennes. Tu peux utiliser la même astuce pour le code des timers et des broches tactiles.
1// Hem 2.x hem 3.x çekirdekte derlenen PWM örneği / PWM example that builds on both 2.x and 3.x cores
2const int LED_PIN = 2;
3const int PWM_FREQ = 5000; // 5 kHz
4const int PWM_RES = 8; // 8 bit: 0-255
5
6void setup() {
7#if ESP_ARDUINO_VERSION_MAJOR >= 3
8 ledcAttach(LED_PIN, PWM_FREQ, PWM_RES); // 3.x: pin tabanlı API / pin-based API
9#else
10 ledcSetup(0, PWM_FREQ, PWM_RES); // 2.x: önce kanal kurulur / set up the channel first
11 ledcAttachPin(LED_PIN, 0);
12#endif
13}
14
15void loop() {
16 for (int duty = 0; duty <= 255; duty++) {
17#if ESP_ARDUINO_VERSION_MAJOR >= 3
18 ledcWrite(LED_PIN, duty); // 3.x: pin numarası / pin number
19#else
20 ledcWrite(0, duty); // 2.x: kanal numarası / channel number
21#endif
22 delay(5);
23 }
24}Tester l'installation
Ne suppose pas que tout marche simplement parce que l'installation s'est terminée. Téléverse le programme ci-dessous et ouvre le moniteur série à 115200 bauds : tu verras la version du core installé, celle d'ESP-IDF, le modèle de la puce et la taille de la mémoire flash, et la LED intégrée clignotera. Si tu obtiens des erreurs à la compilation, le problème vient encore de l'installation ; si le téléversement se termine par "Failed to connect", le problème vient désormais de la carte, du câble ou du pilote.
1// ESP32 kart paketi kurulum testi / ESP32 board package install test
2// Seri Monitör: 115200 baud / Serial Monitor: 115200 baud
3
4const int LED_PIN = 2; // çoğu DevKit'te dahili LED / onboard LED on most DevKits
5
6void setup() {
7 Serial.begin(115200);
8 delay(1000);
9 Serial.printf("Arduino-ESP32 core: %d.%d.%d\n",
10 ESP_ARDUINO_VERSION_MAJOR, ESP_ARDUINO_VERSION_MINOR, ESP_ARDUINO_VERSION_PATCH);
11 Serial.printf("ESP-IDF: %s\n", ESP.getSdkVersion());
12 Serial.printf("Yonga / Chip: %s rev %d, %d cekirdek / cores\n",
13 ESP.getChipModel(), ESP.getChipRevision(), ESP.getChipCores());
14 Serial.printf("Flash: %u MB, CPU: %u MHz\n",
15 (unsigned)(ESP.getFlashChipSize() / (1024 * 1024)), (unsigned)ESP.getCpuFreqMHz());
16 pinMode(LED_PIN, OUTPUT);
17}
18
19void loop() {
20 digitalWrite(LED_PIN, !digitalRead(LED_PIN)); // LED yanıp söner / LED blinks
21 delay(500);
22}Ça ne s'installe toujours pas ? Dernière liste de contrôle
- La date et l'heure sont-elles justes ? Une horloge fausse rend les certificats des connexions sécurisées invalides, et tous les téléchargements échouent.
- Ton nom d'utilisateur contient-il des accents ou des espaces ? Certains outils échouent sur des chemins contenant é, è ou ç ; le réglage directories.data d'arduino-cli.yaml permet de déplacer le dossier des paquets vers un chemin court comme C:\Arduino15.
- Limite de longueur des chemins sous Windows : les chemins de plus de 260 caractères peuvent empêcher la décompression ; activer la prise en charge des chemins longs dans Windows ou garder des chemins courts aide.
- Espace disque : pendant l'installation, les archives téléchargées et les fichiers décompressés coexistent un moment, alors garde au moins 5 Go libres.
- Essaie un autre outil : si l'IDE échoue, essaie Arduino CLI, puis PlatformIO, qui télécharge ses paquets depuis ses propres serveurs.
- Teste ton code en attendant : tant que l'installation n'est pas réglée, tu peux faire tourner ton circuit et ton code dans le navigateur avec le simulateur Wokwi.
Une fois le paquet de cartes ESP32 correctement installé, passer aux projets Wi-Fi, Bluetooth et capteurs ne prend que quelques minutes. Si tu découvres l'ESP32, commence par Qu'est-ce que l'ESP32 ? ; ensuite, dans l'application BlueGrays, tu peux essayer pas à pas les projets allumer une LED avec l'ESP32, LED intégrée et connexion Wi-Fi, avec schéma de câblage et code prêt à l'emploi.
Questions fréquentes
Pourquoi le paquet ESP32 ne s'installe-t-il pas ?
Les causes les plus fréquentes sont une URL de gestionnaire de cartes fausse ou périmée, une connexion lente qui dépasse le délai, un antivirus qui verrouille des fichiers et d'anciens téléchargements incomplets. Vérifie d'abord que l'URL est https://espressif.github.io/arduino-esp32/package_esp32_index.json, puis applique la solution correspondant au message du panneau Sortie.
Quelle est la bonne URL du gestionnaire de cartes pour l'ESP32 ?
Pour la version stable actuelle, utilise https://espressif.github.io/arduino-esp32/package_esp32_index.json. L'ancienne adresse de dl.espressif.com n'affiche que de très vieilles versions ; si elle est encore dans ta liste, retire-la, car deux URL ESP32 en même temps peuvent poser problème.
Comment corriger "Error downloading" dans l'Arduino IDE ?
Essaie d'abord d'ouvrir l'URL du paquet dans un navigateur ; si elle ne s'ouvre pas, le problème vient du réseau, du proxy ou du pare-feu. Si elle s'ouvre, supprime les fichiers partiels du dossier staging, vérifie l'horloge de l'ordinateur et relance l'installation avec un câble réseau ou le partage de connexion du téléphone.
Faut-il installer le core ESP32 2.x ou 3.x ?
Choisis la 3.x pour les nouveaux projets et les puces récentes comme l'ESP32-C6. Si une bibliothèque ou un tutoriel dont tu as besoin a été écrit pour la 2.x et ne compile pas en 3.x, installe la 2.0.17, dernière version 2.x. Tu peux changer de version à tout moment dans la liste du gestionnaire de cartes.
Peut-on installer le paquet ESP32 sans Internet ?
Oui. Installe le paquet sur un ordinateur connecté qui a le même système d'exploitation, puis copie le dossier packages/esp32 et le fichier package_esp32_index.json de son dossier Arduino15 au même endroit sur l'ordinateur cible. À l'ouverture de l'IDE, le paquet apparaît comme installé.
Quelle place le paquet ESP32 prend-il sur le disque ?
Cela dépend de la version ; les versions 3.x actuelles occupent plusieurs gigaoctets avec leurs chaînes de compilation et leurs bibliothèques. Pendant l'installation, archives et fichiers décompressés coexistent, donc garder au moins 5 Go libres est une marge sûre.
Projets à réaliser après cet article
Voir tous les projets
Clignotement de la LED interne de l'ESP32
Faire clignoter la LED bleue intégrée à l'ESP32 DevKit V1. Aucun composant externe n'est nécessaire ! Le premier projet que vous devriez essayer lorsque vous achetez un ESP32. Le GPIO 2 est connecté à la LED interne.

Clignotement LED avec ESP32
Enseigne l'utilisation de base des sorties GPIO avec l'ESP32. Nous obtenons un effet de clignotement en allumant et éteignant une LED à partir de la broche numérique. Version ESP32 du projet blink classique sur Arduino UNO ; les commandes de base de blink dans l'environnement Arduino restent les mêmes, mais le brochage et les niveaux GPIO de 3,3 V de l'ESP32 diffèrent de ceux de l'Arduino UNO.

ESP32 Contrôle de LED avec bouton poussoir (Push)
La LED s'allume lorsque le bouton est enfoncé et s'éteint lorsqu'il est relâché. Montre comment la broche d'entrée numérique de l'ESP32 et la résistance pull-up interne sont utilisées. Grâce au mode INPUT_PULLUP, aucune résistance externe n'est nécessaire.

Feu de circulation ESP32
Simulation d'un vrai feu de circulation avec 3 LED rouge-jaune-vert. Les temps sont proches de la logique du trafic réel : rouge long, jaune court, vert long. Exemple classique de contrôle séquentiel GPIO.

Mesure de l'intensité lumineuse avec le module LDR ESP32
Suivi en temps réel sur le moniteur série de la valeur brute de l'ADC du module LDR et du pourcentage relatif de luminosité calculé à partir de références dans l'obscurité et à la lumière. Ce pourcentage n'est pas une mesure en lux. Permet de comprendre le principe de calibrage du module. Il est préférable de réaliser cet exercice avant le projet 10, car il sert à déterminer la valeur seuil.

ESP32 LED Fade avec PWM
Modifiez la luminosité de la LED en douceur de 0 à max, de max à 0. Nous contrôlons le PWM avec analogWrite() comme dans Arduino - la même syntaxe avec ESP32 Arduino Core 3.0+ fonctionne sans problème. La définition du pin + pinMode + analogWrite est suffisante.

Connexion Wi-Fi STA ESP32 (avec écran LCD)
Dans ce projet, nous connectons l'ESP32 au réseau Wi-Fi domestique en mode Station (STA) de manière sécurisée et tolérante aux pannes. Nous isolons SSID/mot de passe dans un fichier secrets.h pour empêcher leur fuite sur Git, mettons en place une reconnexion automatique, et affichons le niveau RSSI et l'adresse IP sur un écran LCD I2C. La LED intégrée sert d'indicateur d'état.

Serveur Web asynchrone ESP32 (avec affichage de l'adresse IP sur l'écran LCD)
On transforme l'ESP32 en serveur web asynchrone que tu pilotes depuis ton téléphone ou ton ordinateur sur le même réseau Wi-Fi. Grâce à la bibliothèque ESPAsyncWebServer, le serveur traite plusieurs requêtes à la fois (il ne bloque pas sur une seule requête comme le WebServer.h classique). Ouvre l'adresse IP de l'ESP32 dans le navigateur et allume ou éteins la LED sur GPIO 5 avec les boutons ON/OFF (adresses /on et /off).
Autres articles
Application BlueGrays
Réalise ce montage pas à pas sur ton téléphone
Schéma, code et liste des composants sur un seul écran. Plus de 500 projets Arduino, ESP32 et Pico à réaliser.
Scanne avec ton téléphone
Pointe l’appareil photo vers le code : la boutique d’applications de ton téléphone s’ouvre.
ou ouvre la boutique

