Guides · 10 min de lecture

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.

Carte de développement ESP32 DevKit
ESP32 DevKit : pour la programmer dans l'Arduino IDE, il faut d'abord installer le paquet de cartes d'Espressif.

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

  1. 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.
  2. Ouvre Fichier > Préférences (sur macOS, Arduino IDE > Settings).
  3. 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.
  4. Clique sur OK et attends que l'IDE télécharge l'index des paquets en bas de la fenêtre.
  5. 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.
  6. Une fois terminé, choisis ESP32 Dev Module ou le modèle de ta carte dans Outils > Carte.
L'adresse https://dl.espressif.com/dl/package_esp32_index.json citée dans d'anciens tutoriels n'est plus mise à jour et n'affiche que de très vieilles versions. Si elle est encore dans ta liste, supprime-la : deux URL ESP32 différentes en même temps mélangent la liste des versions et peuvent faire échouer les téléchargements.

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 contientSignificationSolution
Error downloading ... package_esp32_index.jsonL'index des paquets est inaccessibleVé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_EXCEEDEDLe téléchargement a dépassé le délaiAugmente 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 authorityImpossible d'établir une connexion sécuriséeCorrige 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 matchLe fichier téléchargé est corrompu ou incompletSupprime les fichiers ESP32 du dossier staging et réinstalle
Access is denied, moving extracted archive, renameUn antivirus ou un autre programme a verrouillé un fichierAjoute le dossier Arduino15 aux exclusions de l'antivirus et relance l'IDE
no space left on deviceLe disque est pleinLibè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éeEssaie un autre réseau, mets à jour l'IDE et l'URL
esp32 n'apparaît pas dans le gestionnaire de cartesURL 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'exploitationDossier Arduino15Té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.

  1. Ferme complètement l'Arduino IDE.
  2. Supprime le dossier packages/esp32 et le fichier package_esp32_index.json dans Arduino15.
  3. Supprime les fichiers ESP32 partiels dans staging/packages (ceux qui commencent par esp32-, xtensa-, riscv32- et esptool).
  4. 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.
  5. Ouvre l'IDE, vérifie que seule l'URL ESP32 actuelle reste dans les Préférences et réinstalle le paquet.
Dans la plupart des cas, il suffit de cliquer une fois sur Supprimer pour le paquet esp32 dans le gestionnaire de cartes puis de le réinstaller ; ne supprime les dossiers à la main que si cela ne marche pas. Pour faire une sauvegarde avant, copier le dossier packages d'Arduino15 suffit.

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.

  1. Sur l'ordinateur bien connecté, installe normalement l'Arduino IDE et le paquet ESP32.
  2. Copie sur une clé USB le dossier packages/esp32 et le fichier package_esp32_index.json du dossier Arduino15 de cet ordinateur.
  3. Sur l'ordinateur cible, ouvre puis ferme une fois l'Arduino IDE pour que le dossier Arduino15 soit créé.
  4. 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.
  5. 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.

CommandeRôle
arduino-cli config initCrée le fichier de configuration
arduino-cli config add board_manager.additional_urls https://espressif.github.io/arduino-esp32/package_esp32_index.jsonAjoute l'URL du paquet ESP32
arduino-cli core update-indexTélécharge les index des paquets
arduino-cli core install esp32:esp32 -vInstalle le paquet ESP32 avec un affichage détaillé
arduino-cli core install esp32:[email protected]Installe une version précise
arduino-cli core listListe 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.

VersionBase ESP-IDFPuces prises en chargeQuand la choisir ?
1.0.63.3ESP32 uniquementSeulement pour recompiler tel quel un très vieux projet
2.0.174.4ESP32, S2, S3, C3Bibliothèques pas encore adaptées à la 3.x et anciens tutoriels
3.x (actuelle)5.xESP32, S2, S3, C3, C6, H2 et plus récentesLe 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.

C++ (Arduino IDE)
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.

C++ (Arduino IDE)
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}
Si l'ESP32 n'apparaît pas du tout dans la liste des ports, ce qui manque n'est pas le paquet de cartes mais le pilote USB ; consulte le guide installation du pilote CH340. Si le code compile mais que le téléversement finit par "Failed to connect", la méthode du bouton BOOT du guide ESP32 Failed to connect règle le problème.

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

Voir tous les projets
Clignotement de la LED interne de l'ESP32
ES-4Débutant

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.

4.8(29)
54
Clignotement LED avec ESP32
ES-1Débutant

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.

4.7(37)
108
ESP32 Contrôle de LED avec bouton poussoir (Push)
ES-2Débutant

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.

4.6(36)
57
Feu de circulation ESP32
ES-5Débutant

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.

4.4(22)
45
Mesure de l'intensité lumineuse avec le module LDR ESP32
ES-11Débutant

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.

4.6(36)
55
ESP32 LED Fade avec PWM
ES-8Débutant

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.

4.8(36)
55
Connexion Wi-Fi STA ESP32 (avec écran LCD)
ES-25Avancé

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.

4.4(21)
38
Serveur Web asynchrone ESP32 (avec affichage de l'adresse IP sur l'écran LCD)
ES-27Avancé

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

4.8(16)
26