Accueil Doc Thonny

// doc / outils

Thonny

L'IDE recommandé pour programmer l'ESP32 avec MicroPython. Gratuit, simple, et conçu pour les débutants.

Installation

Windows

Installeur .exe — tout est inclus

Télécharger sur thonny.org →

macOS

Package .pkg — fonctionne sur Intel et Apple Silicon

Télécharger sur thonny.org →

Linux

pip install thonny ou via le gestionnaire de paquets

Télécharger sur thonny.org →

Version recommandée : Thonny 4.x. Il inclut déjà Python 3 — pas besoin d'installer Python séparément.

Connecter l'ESP32

    1
    Brancher l'ESP32 en USB
    Connecte l'ESP32 à ton ordinateur avec un câble micro-USB (ou USB-C selon le modèle). Un nouveau port COM apparaît.
    2
    Choisir l'interpréteur
    Ouvre Thonny → menu Outils (ou Run) → Configurer l'interpréteur → choisir MicroPython (ESP32).
    3
    Sélectionner le port
    Dans la liste des ports, choisis le port COM de l'ESP32. Sur Mac : /dev/cu.usbserial-XXXX. Sur Windows : COM3, COM4...
    4
    Connecter
    Clique sur le bouton Stop/Restart (icône rouge). Si tout va bien, le REPL apparaît en bas : >>> MicroPython sur l'ESP32.

⚠️ Port non visible ? Il faut parfois installer le driver USB. Sur les ESP32 classiques avec puce CH340 : driver CH340. Sur les modèles avec CP2102 : driver Silicon Labs CP210x.

L'interface Thonny

Éditeur (haut)

Zone de code. C'est ici que tu écris tes programmes avant de les envoyer sur la carte.

Shell / REPL (bas)

Console interactive. Tape du code directement, résultat immédiat. Idéal pour tester.

Gestionnaire de fichiers

Menu View → Files. Volet gauche = ton ordi, volet droit = fichiers sur l'ESP32.

Barre d'outils

Boutons Run (▶), Stop (■), nouveau fichier, ouvrir, sauvegarder.

Opérations courantes

Exécuter un script directement (sans sauvegarder)

Appuie sur F5 ou le bouton ▶ vert. Le script tourne sur l'ESP32 mais n'est pas sauvegardé. Si tu débranches, il disparaît.

Sauvegarder sur l'ESP32 (permanent)

Menu Fichier → Sauvegarder sous → choisir MicroPython device → nommer le fichier main.py. Il se relancera automatiquement au prochain démarrage.

Transférer un fichier depuis l'explorateur

Menu View → Files. Clic droit sur un fichier dans la partie gauche (ton ordi) → Upload to /. Le fichier apparaît dans la partie droite (ESP32).

Arrêter le programme en cours

Appuie sur Ctrl + C dans le Shell. Ou clique sur le bouton Stop ■ rouge.

Redémarrer la carte (soft reset)

Dans le Shell, appuie sur Ctrl + D. L'ESP32 repart depuis le début (relance boot.py puis main.py).

Raccourcis clavier essentiels

ActionRaccourci
Exécuter le script F5
Arrêter le programme Ctrl + C (dans le Shell)
Soft reset (redémarrer) Ctrl + D (dans le Shell)
Nouveau fichier Ctrl + N
Ouvrir un fichier Ctrl + O
Sauvegarder Ctrl + S
Zoom avant / arrière Ctrl + + / Ctrl + -
Commenter une ligne Ctrl + F1
Autocomplétion Tab

Flasher MicroPython sur une nouvelle carte

Si ta carte est neuve ou si MicroPython n'est pas installé, Thonny peut le faire directement.

    1. Branche l'ESP32 en USB.
    2. Menu Outils → Configurer l'interpréteur → clic sur "Install or update MicroPython".
    3. Sélectionne la variante : ESP32 / ESP32-S3 / Pico selon ta carte.
    4. Clique sur Install. Thonny télécharge et flash le firmware automatiquement.
    5. Une fois terminé, redémarre Thonny et connecte-toi normalement.

Gestion des fichiers sur l'ESP32

Commandes os : lister, créer, supprimer des fichiers directement depuis le REPL.

Voir la fiche →