ESP32 dev board with USB-C cable for installing USB drivers

Comment installer les pilotes USB CP210x pour ESP32 et ESP8266

Mis à jour le

Mis à jour en octobre 2026 : ajout des pilotes CH340, des cartes à USB intégré et des vérifications sous Linux et Mac.

Si votre ordinateur ne détecte pas votre carte ESP32 ou ESP8266 quand vous la branchez, la cause habituelle est un pilote USB-série manquant. Sans lui, votre ordinateur n'attribue pas de port COM (ou port série) à la carte, et l'IDE Arduino ou PlatformIO dans VS Code ne peut pas communiquer avec elle ni téléverser votre code.

La plupart des cartes ESP32 et ESP8266 classiques utilisent l'une de deux puces USB-série : la CP210x de Silicon Labs (généralement la CP2102) ou la CH340 de WCH. Ce guide couvre les deux.

Avant de commencer : deux vérifications rapides

  • Utilisez un câble de données. Beaucoup de câbles USB, surtout ceux fournis avec des chargeurs et des gadgets, ne transportent que l'alimentation. Si la carte s'allume mais que rien n'apparaît sur votre ordinateur, essayez un autre câble avant toute chose. En cas de doute, notre câble de données USB-C est testé pour la programmation.
  • Vérifiez la puce de votre carte. Regardez la petite puce à côté du port USB. Elle porte la mention CP2102 (ou CP2104), CH340 (ou CH343), ou il n'y a peut-être aucune puce supplémentaire. Il vous faut le pilote qui correspond à cette puce.

Les cartes à USB intégré n'ont pas besoin de ces pilotes

L'ESP32-S3 SuperMini, l'ESP32-C3 SuperMini et les autres cartes dont le port USB est relié directement à la puce ESP32 utilisent l'USB de la puce elle-même. Windows 10 et 11, macOS et Linux les reconnaissent sans aucun pilote. Si l'une de ces cartes n'apparaît pas, la cause est généralement le câble ou un réglage dans votre code (voir les réglages PlatformIO du guide des broches pour l'USB CDC), et non un pilote manquant.

Étape 1 : télécharger le pilote

CP210x (Silicon Labs)

Tous les téléchargements se trouvent sur la page des pilotes VCP CP210x de Silicon Labs. Ouvrez l'onglet Downloads et choisissez :

  • Windows 10 et 11 : CP210x Universal Windows Driver.
  • Mac : CP210x VCP Mac OSX Driver.
  • Linux : rien à télécharger. Le pilote cp210x est intégré au noyau Linux.

CH340 (WCH)

Téléchargez les pilotes uniquement depuis ces pages de fabricants. Les fichiers provenant d'autres sites peuvent être périmés ou dangereux.

Étape 2 : installer le pilote

Windows

  1. Décompressez le téléchargement dans un dossier.
  2. Pilote universel CP210x : faites un clic droit sur silabser.inf et choisissez Installer. (Sous Windows 11, il faut parfois d'abord cliquer sur Afficher d'autres options.) L'ancien paquet CP210x VCP Windows comprend plutôt un installateur : lancez CP210xVCPInstaller_x64.exe.
  3. CH340 : lancez CH341SER.EXE et cliquez sur Install.
  4. Débranchez la carte et rebranchez-la.

Mac

  1. Ouvrez le fichier .dmg ou .pkg téléchargé et lancez l'installateur.
  2. Si macOS le bloque, ouvrez Réglages Système > Confidentialité et sécurité (sur les anciennes versions, Préférences Système > Sécurité et confidentialité) et cliquez sur Autoriser à côté du message de Silicon Labs ou de WCH.
  3. Redémarrez si l'installateur le demande, puis rebranchez la carte.

Les versions récentes de macOS reconnaissent souvent les cartes CP2102 et CH340 sans pilote supplémentaire. Faites d'abord la vérification de l'étape 3 : si votre carte apparaît déjà, inutile d'installer quoi que ce soit.

Linux

Les pilotes sont déjà présents. Il vous faudra peut-être l'autorisation d'utiliser le port série. Ajoutez-vous au groupe dialout (sur les systèmes basés sur Arch, c'est uucp), puis déconnectez-vous et reconnectez-vous :

sudo usermod -a -G dialout $USER

Étape 3 : vérifier la connexion

  • Windows : ouvrez le Gestionnaire de périphériques et développez Ports (COM et LPT). Vous devriez voir Silicon Labs CP210x USB to UART Bridge (COM3), USB-SERIAL CH340 (COM4) ou similaire. Si la carte apparaît sous Autres périphériques avec un triangle jaune, le pilote n'est pas encore installé.
  • Mac : dans le Terminal, lancez ls /dev/cu.*. Cherchez quelque chose comme /dev/cu.SLAB_USBtoUART, /dev/cu.usbserial-0001 ou /dev/cu.wchusbserial....
  • Linux : lancez ls /dev/ttyUSB*. Vous devriez voir /dev/ttyUSB0.

Un test rapide : faites la vérification, débranchez la carte, refaites-la. Le port qui disparaît est celui de votre carte.

Une fois le port visible, choisissez-le dans l'IDE Arduino sous Outils > Port. Dans PlatformIO, le port est généralement détecté automatiquement. Vous pouvez le définir avec upload_port dans platformio.ini si plusieurs cartes sont branchées.

Dépannage

  • Toujours aucun port, même avec le pilote installé. Changez d'abord de câble. Essayez ensuite un autre port USB de votre ordinateur, de préférence directement sur l'ordinateur plutôt que sur un concentrateur.
  • Le port apparaît, mais le téléversement échoue avec « Failed to connect » ou « Timed out waiting for packet header ». Maintenez le bouton BOOT (IO0), lancez le téléversement et relâchez-le quand Connecting... s'affiche.
  • Port occupé ou accès refusé. Un autre programme l'utilise. Fermez tout autre moniteur série ou une deuxième fenêtre d'IDE, puis réessayez.
  • Mauvais port choisi. Windows peut attribuer un nouveau numéro de COM quand vous changez de prise USB. Revérifiez Outils > Port.
  • Le téléversement fonctionne mais le moniteur série affiche des caractères bizarres. Réglez la vitesse du moniteur sur celle de votre code, généralement 115200. Dans PlatformIO, indiquez monitor_speed = 115200.

Pour la suite

Pour aller plus loin : Random Nerd Tutorials : installer les pilotes USB ESP32 / ESP8266 (en anglais).

Retour au blog

Laisser un commentaire