Simulateur Wokwi : tutoriel ESP32, Arduino et Pico en ligne
Simulateur Wokwi pour ESP32, Arduino et Pico : câblage par diagram.json, Wi-Fi, MicroPython, analyseur logique, extension VS Code et différences avec Tinkercad.
Le simulateur Wokwi est un simulateur électronique gratuit qui te permet de faire tourner des projets ESP32, Arduino et Raspberry Pi Pico dans ton navigateur sans acheter un seul composant. Tu écris ton code, tu places des LED, des boutons, des écrans et des capteurs à côté de la carte virtuelle, puis tu appuies sur le bouton vert de lecture : le code est compilé, la LED s'allume, du texte apparaît sur l'OLED et le moniteur série se met à défiler. Sa grande différence avec Tinkercad, c'est la prise en charge de l'ESP32 et de la Pico ; tu peux même connecter l'ESP32 au vrai Internet via un réseau Wi-Fi virtuel et exécuter MicroPython sur la Pico.
Dans ce guide, tu commenceras par ouvrir ton premier projet sur wokwi.com, puis tu apprendras à câbler les composants à la souris et avec le fichier diagram.json, à ajouter des bibliothèques, à tester le Wi-Fi et l'heure Internet avec un ESP32, à lancer MicroPython sur la Pico, à mesurer un signal PWM avec l'analyseur logique et à utiliser la même simulation dans VS Code. À la fin, tu verras quels capteurs sont pris en charge, en quoi la simulation diffère d'un vrai circuit et comment partager ton projet.

Qu'est-ce que Wokwi et comment ça marche ?
Wokwi compile ton code dans le cloud avec de vrais compilateurs et transmet le code machine obtenu à un émulateur de processeur qui tourne dans ton navigateur. Dans une simulation d'Arduino Uno, les instructions de l'ATmega328P sont donc exécutées une par une, et le même principe s'applique à l'ESP32 et au RP2040. C'est pourquoi des fonctions matérielles comme millis(), les interruptions, les timers, la PWM, l'I2C et le SPI se comportent comme sur la vraie carte, et les vraies bibliothèques fonctionnent sans modification. Wokwi ne calcule pas les courants et les tensions du circuit ; il modélise les niveaux logiques des broches et les valeurs envoyées aux entrées analogiques. Cette conception en fait un outil puissant pour tester du logiciel embarqué plutôt que pour apprendre les bases de l'électronique.
| Caractéristique | Wokwi |
|---|---|
| Où il fonctionne | Navigateur (wokwi.com) et extension VS Code |
| Cartes | Arduino Uno, Nano, Mega ; ESP32, ESP32-S3, ESP32-C3 ; Raspberry Pi Pico et Pico W |
| Langages | Arduino C++, MicroPython, CircuitPython (Pico), ESP-IDF |
| Bibliothèques | La plupart de celles du gestionnaire de bibliothèques Arduino (libraries.txt) |
| Réseau | Wi-Fi virtuel pour ESP32 et Pico W : Wokwi-GUEST |
| Outil de mesure | Analyseur logique 8 voies ; pas de mesures électriques |
| Compte | Inutile pour essayer, connexion nécessaire pour enregistrer |
| Prix | Usage de base gratuit ; fonctions supplémentaires dans une offre payante |
Quelles cartes sont disponibles dans Wokwi ?
Chaque composant de Wokwi possède un nom de type, visible dans le fichier diagram.json. Le tableau ci-dessous donne les équivalents Wokwi des trois plateformes sur lesquelles ce blog se concentre. Dans d'anciens projets, tu verras peut-être aussi wokwi-esp32-devkit-v1 pour l'ESP32 ; les deux simulent la même puce ESP32, seule la disposition des broches de la carte change.
| Carte | Nom de type Wokwi | Langages | Remarque |
|---|---|---|---|
| Arduino Uno | wokwi-arduino-uno | Arduino C++ | ATmega328P, logique 5 V, simulation la plus rapide |
| Arduino Nano | wokwi-arduino-nano | Arduino C++ | Même puce que l'Uno, carte plus petite |
| Arduino Mega | wokwi-arduino-mega | Arduino C++ | 8 Ko de SRAM, projets avec beaucoup de broches |
| ESP32 DevKit | board-esp32-devkit-c-v4 | Arduino C++, MicroPython, ESP-IDF | Wi-Fi oui, Bluetooth non |
| ESP32-S3 / ESP32-C3 | board-esp32-s3-devkitc-1 / board-esp32-c3-devkitm-1 | Arduino C++, MicroPython, ESP-IDF | Familles ESP32 plus récentes |
| Raspberry Pi Pico | wokwi-pi-pico | MicroPython, CircuitPython, Arduino C++ | RP2040, logique 3,3 V |
| Raspberry Pi Pico W | board-pi-pico-w | MicroPython, Arduino C++ | Avec Wi-Fi |
Ton premier projet Wokwi dans le navigateur, étape par étape
- Ouvre wokwi.com dans ton navigateur. La page d'accueil propose les rubriques Arduino, ESP32 et Raspberry Pi Pico ; choisis-en une pour voir des modèles et des projets d'exemple.
- Pour partir de zéro, choisis le modèle Arduino Uno dans la rubrique Arduino. L'écran se divise en deux : l'éditeur de code (sketch.ino) à gauche et la zone de diagramme où l'on dessine le circuit à droite.
- Clique sur le bouton bleu + au-dessus de la zone de droite et tape LED dans la recherche. Le composant choisi apparaît près de la carte ; fais-le glisser à la souris où tu veux.
- Ajoute de la même façon un Resistor et un Pushbutton. Un clic sur un composant ouvre un petit panneau pour changer sa couleur ou sa valeur ; règle la résistance sur 220 Ω.
- Pour tracer un fil, clique sur l'extrémité d'une broche puis sur la broche de destination. Clique sur un point vide entre les deux pour plier le tracé. En cliquant sur un fil, tu peux changer sa couleur ou le supprimer avec la touche Suppr.
- Écris ton code à gauche ou colle l'exemple ci-dessous, puis appuie sur le bouton vert de lecture. La première compilation prend quelques secondes ; ensuite la simulation démarre et, si tu utilises Serial.begin, le moniteur série s'ouvre en bas.
- Pendant la simulation, clique sur le bouton avec la souris. Pour l'arrêter, appuie sur le bouton carré. Pour garder le projet, clique sur Save ; la première fois, on te demande de te connecter et ton projet reçoit un lien permanent.
Premier circuit : allumer et éteindre une LED avec un bouton
Le grand classique, un bouton et une LED, se monte avec la même logique sur les trois cartes. La patte longue de la LED (anode, A dans Wokwi) passe par la résistance vers la broche de sortie, la patte courte (cathode, C) va au GND. Un côté du bouton va à la broche d'entrée, l'autre au GND ; le code active la résistance de pull-up interne. Pour calculer la résistance de la LED dans ton propre circuit, utilise le calculateur de résistance pour LED.
| Connexion | Arduino Uno | ESP32 | Raspberry Pi Pico |
|---|---|---|---|
| Anode de la LED (A), via une résistance de 220 Ω | D13 | GPIO 18 | GP14 |
| Cathode de la LED (C) | GND | GND | GND |
| Patte 1 du bouton | D2 | GPIO 4 | GP2 |
| Patte 2 du bouton | GND | GND | GND |
| Niveau logique | 5 V | 3,3 V | 3,3 V |
1// Wokwi ilk proje: buton ile LED aç/kapat / Wokwi first project: toggle an LED with a button
2const int LED_PIN = 13; // ESP32'de 18 / 18 on ESP32
3const int BUTON_PIN = 2; // ESP32'de 4, diğer uç GND / 4 on ESP32, other leg to GND
4
5bool ledDurum = false; // LED durumu / LED state
6bool oncekiOkuma = HIGH; // önceki buton okuması / previous button reading
7unsigned long sonDegisim = 0; // son kabul edilen değişim / last accepted change
8
9void setup() {
10 pinMode(LED_PIN, OUTPUT);
11 pinMode(BUTON_PIN, INPUT_PULLUP); // dahili pull-up: basılınca LOW / internal pull-up: LOW when pressed
12 Serial.begin(115200);
13 Serial.println("Wokwi hazir / ready");
14}
15
16void loop() {
17 bool okuma = digitalRead(BUTON_PIN);
18 if (okuma != oncekiOkuma && millis() - sonDegisim > 50) { // 50 ms debounce
19 sonDegisim = millis();
20 oncekiOkuma = okuma;
21 if (okuma == LOW) { // basıldı / pressed
22 ledDurum = !ledDurum;
23 digitalWrite(LED_PIN, ledDurum ? HIGH : LOW);
24 Serial.print("LED: ");
25 Serial.println(ledDurum ? "ACIK / ON" : "KAPALI / OFF");
26 }
27 }
28}Le bouton de Wokwi a des rebonds comme un vrai : sur une seule pression, le contact s'ouvre et se ferme pendant quelques millisecondes. C'est pour cela que le code attend 50 ms ; si tu l'enlèves, tu verras parfois la LED basculer deux fois. C'est un joli détail, car ce que tu apprends en simulation reste utile sur un vrai circuit. La logique de temporisation est expliquée en détail dans l'article millis ou delay.
diagram.json : câbler les composants avec un fichier
Tout ce que tu dessines à la souris est en réalité écrit dans le fichier diagram.json du projet. Tu peux l'ouvrir depuis les onglets au-dessus de l'éditeur, le modifier à la main ou le copier dans un autre projet. Le fichier a trois sections importantes : parts (les composants, leurs types, positions et réglages), connections (les fils) et la section facultative dependencies. Voici le diagram.json du circuit Uno ci-dessus :
1{
2 "version": 1,
3 "author": "BlueGrays",
4 "editor": "wokwi",
5 "parts": [
6 { "type": "wokwi-arduino-uno", "id": "uno", "top": 0, "left": 0, "attrs": {} },
7 { "type": "wokwi-led", "id": "led1", "top": -96, "left": 172, "attrs": { "color": "red" } },
8 { "type": "wokwi-resistor", "id": "r1", "top": -24, "left": 120, "rotate": 90, "attrs": { "value": "220" } },
9 { "type": "wokwi-pushbutton", "id": "btn1", "top": -110, "left": 260, "attrs": { "color": "green", "bounce": "1" } }
10 ],
11 "connections": [
12 [ "uno:13", "r1:1", "green", [] ],
13 [ "r1:2", "led1:A", "green", [] ],
14 [ "led1:C", "uno:GND.1", "black", [] ],
15 [ "uno:2", "btn1:1.l", "blue", [] ],
16 [ "btn1:2.l", "uno:GND.2", "black", [] ]
17 ],
18 "dependencies": {}
19}| Champ | À quoi sert-il ? | Exemple |
|---|---|---|
| type | Type du composant | wokwi-led, wokwi-dht22, board-ssd1306 |
| id | Nom du composant ; les fils utilisent ce nom | led1, uno, esp |
| top / left / rotate | Position à l'écran (pixels) et angle de rotation | "rotate": 90 |
| attrs | Réglages propres au composant | "color": "red", "value": "220" |
| connections | Chaque fil : [broche de départ, broche d'arrivée, couleur, tracé] | ["uno:13", "r1:1", "green", []] |
| Format des noms de broche | id-composant:nom-broche | uno:GND.1, esp:18, pico:GP14, btn1:1.l |
Le plus simple pour apprendre les noms de broche est de survoler une broche avec la souris dans le diagramme ; Wokwi affiche son nom dans une petite étiquette. Les quatre pattes du bouton s'appellent 1.l, 2.l, 1.r, 2.r : celles qui portent le même numéro sont reliées à l'intérieur, et l'appui relie 1 et 2. Mets l'attribut bounce du bouton à "0" pour supprimer les rebonds ; donne à l'attribut key une valeur comme "1" et tu pourras aussi l'actionner au clavier. Sur de gros circuits, éditer diagram.json à la main est bien plus rapide que de tracer des dizaines de fils un par un.
Ajouter des bibliothèques : libraries.txt
Pour installer une bibliothèque Arduino dans Wokwi, ouvre l'onglet Library Manager au-dessus de l'éditeur, clique sur + et cherche le nom de la bibliothèque. La bibliothèque choisie est ajoutée sous forme de ligne dans le fichier libraries.txt du projet et installée automatiquement dans le cloud à la compilation. Tu peux aussi écrire le fichier à la main ; chaque ligne contient une bibliothèque, avec le nom qu'elle porte dans le gestionnaire de bibliothèques Arduino :
1# Wokwi Library List
2Adafruit SSD1306
3Adafruit GFX Library
4DHT sensor library
5Adafruit NeoPixelInteragir avec les capteurs : modifier les valeurs pendant la simulation
Ce qui rend Wokwi si pédagogique, c'est que tu peux régler les valeurs des capteurs à la souris. Pendant la simulation, clique sur le DHT22 pour ouvrir des curseurs de température et d'humidité ; sur le HC-SR04, tu choisis une distance entre 2 et 400 cm. Le capteur PIR a un bouton qui simule un mouvement, le potentiomètre un bouton rotatif et le module LDR un curseur d'intensité lumineuse (lux). Tu testes ainsi en quelques secondes une condition comme « allumer le ventilateur quand la température dépasse 30 °C » et tu vérifies les seuils de ton code sans posséder le vrai capteur.
Simulation Wi-Fi avec l'ESP32
Dans Wokwi, l'ESP32 se connecte à un point d'accès virtuel nommé Wokwi-GUEST. Ce réseau n'a pas de mot de passe et utilise le canal 6 ; indiquer le canal accélère la connexion. Le réseau accède au vrai Internet via la passerelle de Wokwi : tu peux récupérer l'heure par NTP, envoyer des requêtes HTTP à un serveur ou publier des données sur un broker MQTT. Le code ci-dessous connecte l'ESP32, affiche son adresse IP et récupère l'heure d'Istanbul sur Internet.
1#include <WiFi.h>
2#include <time.h>
3
4void setup() {
5 Serial.begin(115200);
6 WiFi.begin("Wokwi-GUEST", "", 6); // Wokwi sanal ağı: şifresiz, kanal 6 / Wokwi virtual network: open, channel 6
7 Serial.print("Baglaniyor / Connecting");
8 while (WiFi.status() != WL_CONNECTED) {
9 delay(250);
10 Serial.print(".");
11 }
12 Serial.println();
13 Serial.print("IP: ");
14 Serial.println(WiFi.localIP());
15 configTime(3 * 3600, 0, "pool.ntp.org"); // UTC+3 İstanbul, yaz saati yok / UTC+3 Istanbul, no DST
16}
17
18void loop() {
19 struct tm zaman; // saat bilgisi / time info
20 if (getLocalTime(&zaman)) {
21 Serial.printf("%02d:%02d:%02d\n", zaman.tm_hour, zaman.tm_min, zaman.tm_sec);
22 } else {
23 Serial.println("Saat alinamadi / Time not ready");
24 }
25 delay(1000);
26}Sur un vrai ESP32, il suffit d'écrire le nom de ton réseau et ton mot de passe ; tu peux supprimer le paramètre du canal. En usage gratuit, l'ESP32 peut se connecter vers l'extérieur, mais le navigateur de ton ordinateur ne peut pas joindre directement un serveur web hébergé dans l'ESP32. Pour cela, il faut la redirection de ports de l'extension VS Code ou la passerelle privée de l'offre payante. Pour le NTP et les fuseaux horaires, vois heure NTP avec l'ESP32, et pour les problèmes de connexion sur une vraie carte l'ESP32 ne se connecte pas au Wi-Fi.
Raspberry Pi Pico et prise en charge de MicroPython

Quand tu choisis le modèle MicroPython pour la Pico sur la page d'accueil, le projet s'ouvre avec un fichier main.py. Appuie sur lecture : l'interpréteur MicroPython se charge, main.py s'exécute et tu vois la sortie de print dans la console en bas. Quand le programme se termine, la même console passe au REPL, où tu peux taper des commandes et tester immédiatement. Si tu as besoin de modules supplémentaires comme le pilote SSD1306, crée un nouveau fichier depuis le menu fichier et colle le contenu du module. C'est pareil pour l'ESP32 : choisis simplement le modèle MicroPython dans la rubrique ESP32.
1from machine import Pin, ADC
2import time
3
4led = Pin(14, Pin.OUT) # LED + 220 ohm direnç / LED + 220 ohm resistor
5buton = Pin(2, Pin.IN, Pin.PULL_UP) # diğer uç GND / other leg to GND
6pot = ADC(26) # potansiyometre orta ucu GP26 / pot wiper on GP26
7
8durum = False
9onceki = 1
10son = time.ticks_ms() # son pot yazdırma zamanı / last pot print time
11while True:
12 okuma = buton.value()
13 if okuma == 0 and onceki == 1: # yeni basış / new press
14 durum = not durum
15 led.value(durum)
16 print("LED:", "ACIK" if durum else "KAPALI")
17 time.sleep_ms(50) # debounce
18 onceki = okuma
19 if time.ticks_diff(time.ticks_ms(), son) >= 500:
20 son = time.ticks_ms()
21 gerilim = pot.read_u16() * 3.3 / 65535 # 16 bit okuma -> volt / 16-bit reading -> volts
22 print("Pot: {:.2f} V".format(gerilim))
23 time.sleep_ms(10)Dans le code, la LED est sur GP14, le bouton sur GP2 et le curseur du potentiomètre sur GP26 (ADC0) ; les pattes extérieures du potentiomètre vont au 3V3 et au GND. L'ADC de la Pico est sur 12 bits, mais read_u16() de MicroPython renvoie une valeur mise à l'échelle sur 0–65535. Si tu débutes en MicroPython, l'article bases de MicroPython explique une à une les commandes Pin, ADC, PWM et de temporisation.
Voir les signaux avec l'analyseur logique
Wokwi n'a pas de multimètre, mais il a un outil bien plus puissant : le Logic Analyzer. Ajoute-le depuis la liste des composants : il enregistre 8 voies numériques (D0–D7). Relie les voies aux broches à mesurer et son GND au GND de la carte. Quand tu arrêtes la simulation, l'enregistrement est téléchargé sous forme de fichier .vcd ; ouvre-le avec des logiciels gratuits comme PulseView ou GTKWave pour lire la fréquence et la largeur d'impulsion, voire décoder des octets UART, I2C ou SPI.
1// Mantık analizörü D0 -> Uno D9, D1 -> Uno D1 (TX), GND -> GND
2// Logic analyzer D0 -> Uno D9, D1 -> Uno D1 (TX), GND -> GND
3void setup() {
4 Serial.begin(9600);
5 analogWrite(9, 64); // %25 doluluk, yaklaşık 490 Hz / 25% duty, about 490 Hz
6}
7
8void loop() {
9 Serial.write('A'); // TX hattında çözülecek bayt / byte to decode on the TX line
10 delay(100);
11}En ouvrant l'enregistrement, la voie D0 montre un signal carré d'une période d'environ 2,04 ms (490 Hz) ; l'impulsion reste à l'état haut pendant un quart de la période, soit environ 0,51 ms. En effet, analogWrite(9, 64) correspond à un rapport cyclique de 64/255 ≈ 25 %. Sur l'Uno, les broches 5 et 6 produisent 980 Hz et les autres broches PWM 490 Hz ; tu peux le vérifier toi-même avec l'analyseur. Ajoute un décodeur UART sur la voie D1 dans PulseView et tu liras l'octet 0x41 (A) toutes les 100 ms. Pour comprendre la PWM, vois Qu'est-ce que la PWM ?.
L'extension Wokwi pour VS Code
Pour les gros projets, si tu préfères ton propre éditeur au navigateur, tu peux installer l'extension Wokwi Simulator dans VS Code. L'extension ne compile pas ; elle simule le fichier firmware que tu produis avec PlatformIO, ESP-IDF ou arduino-cli. Pour un usage personnel, on obtient une licence gratuite à renouveler régulièrement. L'installation se fait en quelques étapes :
- Dans VS Code, cherche Wokwi Simulator dans la vue Extensions et installe-la.
- Ouvre la palette de commandes avec F1, lance Wokwi: Request a New License et confirme la licence sur la page qui s'ouvre dans le navigateur.
- Ajoute un fichier wokwi.toml et un fichier diagram.json à la racine du dossier du projet. Tu peux copier diagram.json depuis un projet dessiné dans le navigateur.
- Compile le projet comme d'habitude (Build dans PlatformIO). Les chemins de wokwi.toml doivent pointer vers les fichiers .bin et .elf générés.
- Appuie sur F1 et lance Wokwi: Start Simulator. La simulation s'ouvre dans un onglet de VS Code ; quand tu modifies le code et recompiles, elle redémarre.
1# wokwi.toml (PlatformIO, esp32dev ortamı / environment)
2[wokwi]
3version = 1
4firmware = ".pio/build/esp32dev/firmware.bin"
5elf = ".pio/build/esp32dev/firmware.elf"
6
7# ESP32 web sunucusunu bilgisayardan açmak: http://localhost:8180
8# Open the ESP32 web server from your computer: http://localhost:8180
9[[net.forward]]
10from = "localhost:8180"
11to = "target:80"La section net.forward redirige le serveur web du port 80 de l'ESP32 vers le port 8180 de ton ordinateur. Tu peux ainsi ouvrir dans ton navigateur des projets comme le serveur web et WebSocket ESP32 sans flasher de carte. L'extension prend aussi en charge le débogage pas à pas avec GDB ; ajoute une ligne gdbServerPort dans wokwi.toml et connecte le débogueur de VS Code.
Différences entre Wokwi et Tinkercad
Les deux simulateurs sont gratuits et tournent dans le navigateur, mais ils répondent à des questions différentes. Tinkercad calcule le circuit électriquement : tu mesures au multimètre le courant dans une résistance ou la tension aux bornes d'une LED, et il propose la programmation par blocs. Wokwi émule le processeur de la carte et offre ESP32, Pico, Wi-Fi, MicroPython et un large choix de bibliothèques. Le plus efficace est d'apprendre les bases de l'électronique avec Tinkercad et les projets ESP32 et IoT avec Wokwi. Pour découvrir Tinkercad en détail, consulte le guide simulation Arduino avec Tinkercad.
| Caractéristique | Wokwi | Tinkercad Circuits |
|---|---|---|
| Cartes | Uno, Nano, Mega, famille ESP32, Pico, Pico W | Arduino Uno R3, ATtiny, micro:bit |
| Calcul électrique | Non ; niveaux logiques et modèle de valeurs analogiques | Oui ; multimètre et oscilloscope |
| Wi-Fi et Internet | Oui, avec ESP32 et Pico W | Non |
| MicroPython | Oui, sur Pico et ESP32 | Non |
| Bibliothèques | La plupart de celles du gestionnaire | Environ onze bibliothèques intégrées |
| Programmation par blocs | Non | Oui |
| Fichier du circuit | diagram.json, modifiable à la main | Éditeur visuel uniquement |
| Mesure | Analyseur logique (.vcd) | Multimètre, oscilloscope |
| Bureau | Extension VS Code | Non |
Capteurs et modules pris en charge
| Groupe | Disponible dans Wokwi | Absent ou limité |
|---|---|---|
| Lumière et écrans | LED, LED RGB, ruban et anneau NeoPixel, LCD 16x2 et 20x4 (I2C compris), OLED SSD1306, TFT ILI9341, matrice MAX7219, TM1637, afficheur 7 segments | Papier électronique et la plupart des OLED couleur |
| Entrées | Bouton, interrupteur, DIP switch, potentiomètre, encodeur rotatif (KY-040), joystick, clavier à membrane, récepteur IR et télécommande | Écran tactile |
| Capteurs | DHT22, DS18B20, HC-SR04, PIR, MPU6050, module LDR, module NTC, HX711 et cellule de charge, gaz MQ-2, flamme, son, inclinaison | DHT11 (utilise le DHT22), capteurs de couleur et d'empreinte |
| Mouvement | Servo, moteur pas à pas, driver A4988, module relais, buzzer | Moteur à courant continu et drivers comme le L298N |
| Communication et stockage | RTC DS1307, carte microSD, 74HC595, I2C, SPI, UART | RFID RC522, nRF24L01, HC-05, SIM800L, GPS |
| Circuits analogiques | Potentiomètre et modules capteurs analogiques | Vrai calcul analogique des transistors, amplis op, condensateurs |
Pour un composant absent de la liste, deux solutions existent. La première consiste à utiliser un composant au comportement proche ; par exemple, tu testes un code DHT11 avec le DHT22. La seconde est la fonction Custom Chips : un petit programme écrit en C est compilé en WebAssembly et ajouté au circuit comme un nouveau composant avec ses propres broches. Tu peux ainsi modéliser toi-même un capteur I2C simple ou un module qui communique en UART.
Limites de la simulation : différences avec un vrai circuit
- Pas de calcul électrique : une LED branchée sans résistance continue de briller, et 5 V sur une broche de l'ESP32 ne grillent rien. Dans un vrai circuit, les deux te coûtent des composants. Calcule toi-même courant et tension avec la loi d'Ohm.
- Vitesse : l'indicateur dans le coin de la zone de diagramme montre à quel pourcentage du temps réel tourne la simulation. Les projets ESP32 avec Wi-Fi ou avec beaucoup de composants peuvent tourner moins vite que le temps réel ; tiens-en compte dans le code qui mesure des durées.
- Capteurs idéaux : les capteurs virtuels n'ont ni bruit ni besoin d'étalonnage. Un vrai DHT22 dévie de ±0,5 °C et un HC-SR04 mesure mal sur les surfaces molles ; écris quand même des filtres et des contrôles d'erreur.
- Ni alimentation ni batterie : consommation, chute de tension, échauffement du régulateur et brownout n'apparaissent pas dans la simulation.
- Pas de Bluetooth : les fonctions BLE et Bluetooth classique de l'ESP32 ne sont pas simulées.
- Erreurs de câblage : les vrais problèmes, comme un fil desserré, une mauvaise rangée de breadboard ou une soudure froide, n'existent pas ; un circuit qui marche en simulation peut ne pas fonctionner du premier coup en vrai.
Partager le projet et le passer sur une vraie carte
Chaque projet enregistré reçoit une adresse permanente ; avec le bouton Share, tu copies le lien et tu l'envoies à un ami, à ton professeur ou sur un forum. La personne qui ouvre le lien lance le projet en un clic et peut le copier sur son compte pour le modifier. Wokwi est donc le moyen le plus rapide de montrer circuit et code ensemble quand tu demandes de l'aide parce que « mon code ne marche pas ». Depuis le menu à côté du bouton Save, tu peux télécharger le projet en fichier zip contenant sketch.ino, diagram.json et libraries.txt.
- Colle le code qui fonctionne en simulation dans un nouveau croquis de l'Arduino IDE, ou ouvre le sketch.ino du zip téléchargé.
- Installe chaque bibliothèque de libraries.txt depuis le gestionnaire de bibliothèques de l'Arduino IDE.
- Dans le code Wi-Fi, remplace Wokwi-GUEST par le nom de ton réseau et ton mot de passe.
- Reporte les connexions de diagram.json dans un tableau de broches et monte le circuit sur la breadboard d'après ce tableau. N'oublie pas les résistances dont Wokwi n'avait pas besoin (résistance de LED, pull-up I2C).
- Choisis la carte et le port, puis téléverse. En cas de problème, suis les étapes du guide Arduino : le téléversement ne fonctionne pas.
Idées de projets à tester dans Wokwi
- Station météo avec OLED : affiche température et humidité avec un ESP32, un DHT22 et un SSD1306 ; modifie les valeurs avec les curseurs. Pour le code de l'écran, vois l'article écran OLED SSD1306.
- Radar de recul : change la cadence des bips du buzzer selon la distance du HC-SR04 et teste chaque seuil avec le curseur de distance. Détails dans l'article capteur de distance HC-SR04.
- Animations NeoPixel : essaie des transitions de couleur sur un anneau ou une matrice WS2812B et conçois les effets avant de penser à l'alimentation d'un vrai ruban. Vois LED WS2812B NeoPixel.
- Domotique avec MQTT : envoie la température depuis l'ESP32 virtuel vers un broker MQTT. Suis le guide ESP32, MQTT et Home Assistant pour l'installation.
- Serrure à code avec clavier : monte une serrure avec clavier à membrane, servo et LCD, et observe les mauvais codes dans le moniteur série.
- Expériences d'interruptions : lis le bouton avec attachInterrupt et vois avec l'analyseur logique comment les rebonds augmentent le nombre d'interruptions. Vois les interruptions Arduino.
Erreurs fréquentes et solutions
| Symptôme | Cause probable | Solution |
|---|---|---|
| L'ESP32 ne se connecte pas au Wi-Fi, les points défilent sans fin | Mauvais nom de réseau ou mot de passe saisi | Utilise WiFi.begin("Wokwi-GUEST", "", 6) ; le nom respecte la casse |
| Erreur No such file or directory | La bibliothèque manque dans libraries.txt | Ajoute la bibliothèque depuis l'onglet Library Manager |
| La LED ne s'allume pas | LED à l'envers (A et C inversées) ou fil GND manquant | Relie la patte longue A à la résistance et C au GND |
| Une pression incrémente le compteur de deux | Les rebonds du bouton sont simulés | Ajoute un anti-rebond au code ou utilise "bounce": "0" pour les essais |
| La simulation est très lente | Affichage Serial continu sans pause dans la boucle | Ajoute un court delay dans loop et réduis les sorties inutiles |
| ImportError: no module named en MicroPython | Le fichier du module manque dans le projet | Crée un nouveau fichier depuis le menu et colle le module |
| Le serveur web de l'ESP32 ne s'ouvre pas dans le navigateur | La passerelle gratuite n'autorise que les connexions de l'intérieur vers l'extérieur | Utilise net.forward dans l'extension VS Code |
| Le projet a disparu | Travail sans connexion | Enregistre avec Save ; sur le projet d'un autre, choisis Save a copy |
Wokwi est le moyen le plus pratique de tester une idée avant d'acheter des composants, de partager un bug avec son circuit et d'essayer du code Wi-Fi sans risque, surtout avec l'ESP32 et la Pico. La plupart des projets de l'application BlueGrays comportent une vidéo de simulation enregistrée pendant que le circuit tourne dans Wokwi ; tu peux voir quand la LED s'allume et comment l'écran se met à jour avant de commencer le montage, puis réaliser le même projet sur ta vraie carte avec le schéma et le code pas à pas.
Questions fréquentes
Wokwi est-il gratuit ?
Oui, la version navigateur de Wokwi est gratuite pour un usage de base : tu peux créer, enregistrer et partager des projets et connecter un ESP32 à Internet via le Wi-Fi virtuel. Des fonctions supplémentaires comme la passerelle privée et des compilations plus rapides font partie d'une offre payante. L'extension VS Code fonctionne aussi avec une licence gratuite pour un usage personnel.
Comment connecter un ESP32 au Wi-Fi dans Wokwi ?
Dans le code de l'ESP32, utilise Wokwi-GUEST comme nom de réseau et une chaîne vide comme mot de passe : WiFi.begin("Wokwi-GUEST", "", 6). Le dernier paramètre, le canal 6, accélère la connexion. Une fois connecté, l'ESP32 accède au vrai Internet par NTP, HTTP et MQTT.
Wokwi ou Tinkercad : lequel choisir ?
Tinkercad convient mieux pour apprendre les bases de l'électronique, mesurer courant et tension au multimètre et programmer par blocs. Wokwi se distingue pour les projets qui demandent ESP32, Raspberry Pi Pico, Wi-Fi, MicroPython et de nombreuses bibliothèques. Beaucoup d'élèves utilisent les deux.
Comment ajouter une bibliothèque dans Wokwi ?
Ouvre l'onglet Library Manager au-dessus de l'éditeur, clique sur +, cherche la bibliothèque et sélectionne-la. Elle est ajoutée au fichier libraries.txt et installée automatiquement à la compilation. Tu peux aussi écrire à la main le nom de la bibliothèque dans le fichier, tel qu'il apparaît dans le gestionnaire de bibliothèques Arduino.
Y a-t-il un DHT11 dans Wokwi ?
La liste des composants de Wokwi contient le DHT22, mais pas le DHT11. Pour tester un code écrit pour un DHT11, place un DHT22 dans le circuit et règle le type de capteur sur DHT22 dans la bibliothèque. Sur une vraie carte, remets simplement le type DHT11.
Le code Wokwi fonctionne-t-il sur une vraie carte ?
Oui. Comme Wokwi exécute du code Arduino et MicroPython standard, tu peux téléverser le même code sur une vraie carte avec l'Arduino IDE ou Thonny. Il suffit d'installer les bibliothèques, de changer le nom et le mot de passe du Wi-Fi et d'ajouter au circuit les résistances dont Wokwi n'avait pas besoin.
Projets à réaliser après cet article
Voir tous les projets
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.

ESP32 Contrôle de LED avec bouton (Toggle)
Chaque fois que l'on appuie sur le bouton, la LED change d'état : si elle est allumée, elle s'éteint, si elle est éteinte, elle s'allume. Modèle classique de basculement. Avec le debounce, nous nettoyons le bruit mécanique du bouton-poussoir pour garantir un seul basculement avec une seule pression.

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.

Allumage d'une LED externe sur le Raspberry Pi Pico (plaque d'essai)
L'étape suivante après la LED intégrée du Pico : brancher une LED externe sur une plaque d'essai et la piloter par la broche GP14. Tu apprends à utiliser n'importe quelle broche GPIO du Pico en sortie, la polarité de la LED (patte longue = anode/+, patte courte = cathode/–) et pourquoi une résistance de limitation (220Ω) est indispensable. Sans elle, trop de courant traverse la LED, qui peut griller.

Raspberry Pi Pico LED Contrôlée par Bouton (Push)
Premier projet entrée avec Pico — lecture bouton ! LED s'allume tant que le bouton est pressé. Apprends Pin.IN, Pin.PULL_UP et button.value(). GP14 LED, GP2 bouton avec PULL_UP interne. Pressé = 0, relâché = 1 — standard.

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.

ESP32 : heure réelle depuis Internet via NTP
L'ESP32 se connecte au Wi-Fi et récupère l'heure exacte auprès de serveurs NTP (Network Time Protocol) à la milliseconde près. Avec configTzTime(), le fuseau horaire de la Turquie (TRT, UTC+3) s'applique automatiquement, et dans les pays à heure d'été, le changement (DST) est géré tout seul par une chaîne POSIX TZ. L'heure s'affiche dans le Serial Monitor et sur un LCD I2C en option.
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

