Simulador Wokwi: tutorial para ESP32, Arduino y Pico online
Simulador Wokwi para ESP32, Arduino y Pico: conexiones con diagram.json, Wi-Fi, MicroPython, analizador lógico, extensión VS Code y diferencias con Tinkercad.
El simulador Wokwi es un simulador de electrónica gratuito que te permite ejecutar proyectos con ESP32, Arduino y Raspberry Pi Pico en el navegador sin comprar ni una sola pieza. Escribes tu código, colocas LEDs, pulsadores, pantallas y sensores junto a la placa virtual y pulsas el botón verde de reproducir: el código se compila, el LED se enciende, aparece texto en la OLED y el Monitor Serie empieza a mostrar datos. Su mayor diferencia con Tinkercad es el soporte para ESP32 y Pico; incluso puedes sacar el ESP32 a Internet real a través de una red Wi-Fi virtual y ejecutar MicroPython en la Pico.
En esta guía empezarás abriendo tu primer proyecto en wokwi.com y luego aprenderás a conectar piezas con el ratón y con el archivo diagram.json, añadir librerías, probar la Wi-Fi y la hora de Internet con un ESP32, ejecutar MicroPython en la Pico, medir una señal PWM con el analizador lógico y usar la misma simulación dentro de VS Code. Al final verás qué sensores están soportados, en qué se diferencia la simulación de un circuito real y cómo compartir tu proyecto.

¿Qué es Wokwi y cómo funciona?
Wokwi compila tu código en la nube con compiladores reales y entrega el código máquina resultante a un emulador de procesador que se ejecuta en tu navegador. Así, en una simulación de Arduino Uno las instrucciones del ATmega328P se ejecutan una a una, y el mismo enfoque se aplica al ESP32 y al RP2040. Por eso funciones de hardware como millis(), las interrupciones, los temporizadores, PWM, I2C y SPI se comportan como en la placa real, y las librerías reales funcionan sin cambios. Wokwi no calcula las corrientes ni las tensiones del circuito; modela los niveles digitales de los pines y los valores que llegan a las entradas analógicas. Este diseño lo convierte en una herramienta potente para probar software embebido más que para aprender fundamentos de electrónica.
| Característica | Wokwi |
|---|---|
| Dónde funciona | Navegador (wokwi.com) y extensión de VS Code |
| Placas | Arduino Uno, Nano, Mega; ESP32, ESP32-S3, ESP32-C3; Raspberry Pi Pico y Pico W |
| Lenguajes | Arduino C++, MicroPython, CircuitPython (Pico), ESP-IDF |
| Librerías | La mayoría de las del Gestor de Librerías de Arduino (libraries.txt) |
| Red | Wi-Fi virtual para ESP32 y Pico W: Wokwi-GUEST |
| Herramienta de medida | Analizador lógico de 8 canales; sin medidas eléctricas |
| Cuenta | No hace falta para probar, inicia sesión para guardar el proyecto |
| Precio | El uso básico es gratuito; las funciones extra están en un plan de pago |
¿Qué placas tiene Wokwi?
Cada pieza de Wokwi tiene un nombre de tipo que verás en el archivo diagram.json. La tabla muestra los equivalentes en Wokwi de las tres plataformas en las que se centra este blog. En proyectos antiguos también puedes ver wokwi-esp32-devkit-v1 para el ESP32; ambos simulan el mismo chip ESP32, solo cambia la distribución de pines de la placa.
| Placa | Nombre de tipo en Wokwi | Lenguajes | Nota |
|---|---|---|---|
| Arduino Uno | wokwi-arduino-uno | Arduino C++ | ATmega328P, lógica de 5 V, la simulación más rápida |
| Arduino Nano | wokwi-arduino-nano | Arduino C++ | Mismo chip que el Uno, placa más pequeña |
| Arduino Mega | wokwi-arduino-mega | Arduino C++ | 8 KB de SRAM, proyectos con muchos pines |
| ESP32 DevKit | board-esp32-devkit-c-v4 | Arduino C++, MicroPython, ESP-IDF | Wi-Fi sí, Bluetooth no |
| ESP32-S3 / ESP32-C3 | board-esp32-s3-devkitc-1 / board-esp32-c3-devkitm-1 | Arduino C++, MicroPython, ESP-IDF | Familias ESP32 más nuevas |
| Raspberry Pi Pico | wokwi-pi-pico | MicroPython, CircuitPython, Arduino C++ | RP2040, lógica de 3,3 V |
| Raspberry Pi Pico W | board-pi-pico-w | MicroPython, Arduino C++ | Con Wi-Fi |
Tu primer proyecto en Wokwi desde el navegador, paso a paso
- Abre wokwi.com en tu navegador. La página principal tiene las secciones Arduino, ESP32 y Raspberry Pi Pico; elige una para ver plantillas y proyectos de ejemplo.
- Para empezar desde cero, elige la plantilla Arduino Uno dentro de Arduino. La pantalla se divide en dos: a la izquierda el editor de código (sketch.ino) y a la derecha el área de diagrama donde se dibuja el circuito.
- Pulsa el botón azul + encima del área derecha y escribe LED en el buscador. La pieza elegida aparece cerca de la placa; arrástrala con el ratón hasta donde quieras.
- Añade del mismo modo un Resistor y un Pushbutton. Al hacer clic en una pieza se abre un pequeño panel para cambiar su color o su valor; pon la resistencia a 220 Ω.
- Para trazar un cable, haz clic en el extremo de un pin y después en el pin de destino. Haz clic en un punto vacío intermedio para doblar el recorrido. Si haces clic en un cable puedes cambiar su color o borrarlo con la tecla Supr.
- Escribe tu código a la izquierda o pega el ejemplo de abajo y pulsa el botón verde de reproducir. La primera compilación tarda unos segundos; luego empieza la simulación y, si usas Serial.begin, el Monitor Serie se abre abajo.
- Con la simulación en marcha, haz clic en el pulsador con el ratón. Para detenerla, pulsa el botón cuadrado. Para conservar el proyecto pulsa Save; la primera vez te pedirá iniciar sesión y tu proyecto recibirá un enlace permanente.
Primer circuito: encender y apagar un LED con un pulsador
El clásico primer experimento, un pulsador y un LED, se monta con la misma lógica en las tres placas. La pata larga del LED (ánodo, A en Wokwi) va a través de la resistencia al pin de salida y la corta (cátodo, C) a GND. Un lado del pulsador va al pin de entrada y el otro a GND; el código activa la resistencia pull-up interna. Para calcular la resistencia del LED en tu propio circuito puedes usar la calculadora de resistencia para LED.
| Conexión | Arduino Uno | ESP32 | Raspberry Pi Pico |
|---|---|---|---|
| Ánodo del LED (A), a través de 220 Ω | D13 | GPIO 18 | GP14 |
| Cátodo del LED (C) | GND | GND | GND |
| Pata 1 del pulsador | D2 | GPIO 4 | GP2 |
| Pata 2 del pulsador | GND | GND | GND |
| Nivel lógico | 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}El pulsador de Wokwi tiene rebote como uno real: con una sola pulsación el contacto se abre y se cierra durante unos milisegundos. Por eso el código espera 50 ms; si lo quitas, verás que a veces el LED cambia dos veces. Es un detalle estupendo, porque lo que aprendes en la simulación también sirve en el circuito real. La lógica de tiempos se explica en detalle en el artículo millis frente a delay.
diagram.json: conectar piezas con un archivo
Todo lo que dibujas con el ratón se escribe en realidad en el archivo diagram.json del proyecto. Puedes abrirlo desde las pestañas encima del editor, editarlo a mano o copiarlo a otro proyecto. El archivo tiene tres secciones importantes: parts (las piezas, sus tipos, posiciones y ajustes), connections (los cables) y la opcional dependencies. Este es el diagram.json del circuito con Uno de arriba:
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}| Campo | ¿Para qué sirve? | Ejemplo |
|---|---|---|
| type | Tipo de la pieza | wokwi-led, wokwi-dht22, board-ssd1306 |
| id | Nombre de la pieza; los cables usan este nombre | led1, uno, esp |
| top / left / rotate | Posición en pantalla (píxeles) y ángulo de giro | "rotate": 90 |
| attrs | Ajustes propios de la pieza | "color": "red", "value": "220" |
| connections | Cada cable: [pin inicial, pin final, color, recorrido] | ["uno:13", "r1:1", "green", []] |
| Formato del nombre de pin | id-pieza:nombre-pin | uno:GND.1, esp:18, pico:GP14, btn1:1.l |
La forma más fácil de aprender los nombres de los pines es pasar el ratón por encima de un pin en el diagrama; Wokwi muestra su nombre en una pequeña etiqueta. Las cuatro patas del pulsador se llaman 1.l, 2.l, 1.r, 2.r: las que tienen el mismo número están unidas por dentro y al pulsar se unen 1 y 2. Si pones el atributo bounce del pulsador a "0", se desactiva el rebote; si das al atributo key un valor como "1", también podrás pulsarlo desde el teclado. En circuitos grandes, editar diagram.json a mano es mucho más rápido que dibujar decenas de cables uno a uno.
Añadir librerías: libraries.txt
Para instalar una librería de Arduino en Wokwi, abre la pestaña Library Manager encima del editor, pulsa + y busca el nombre de la librería. La librería elegida se añade como una línea al archivo libraries.txt del proyecto y se instala automáticamente en la nube al compilar. También puedes escribir el archivo a mano; cada línea contiene una librería con el nombre que tiene en el Gestor de Librerías de Arduino:
1# Wokwi Library List
2Adafruit SSD1306
3Adafruit GFX Library
4DHT sensor library
5Adafruit NeoPixelInteractuar con sensores: cambiar valores durante la simulación
Lo más didáctico de Wokwi es que puedes ajustar los valores de los sensores con el ratón. Con la simulación en marcha, haz clic en el DHT22 para abrir los deslizadores de temperatura y humedad; en el HC-SR04 eliges una distancia entre 2 y 400 cm. El sensor PIR tiene un botón que simula movimiento, el potenciómetro una perilla que puedes girar y el módulo LDR un deslizador de intensidad de luz (lux). Así pruebas en segundos una condición como "encender el ventilador cuando la temperatura supere 30 °C" y compruebas los umbrales de tu código sin tener el sensor real.
Simulación de Wi-Fi con el ESP32
El ESP32 de Wokwi se conecta a un punto de acceso virtual llamado Wokwi-GUEST. Esta red no tiene contraseña y funciona en el canal 6; indicar el canal acelera la conexión. La red llega a Internet real a través de la pasarela de Wokwi: puedes obtener la hora por NTP, enviar peticiones HTTP a un servidor o publicar datos en un bróker MQTT. El código de abajo conecta el ESP32, muestra su dirección IP y obtiene la hora de Estambul desde 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}Cuando uses este código en un ESP32 real, basta con escribir el nombre de tu red y tu contraseña; puedes quitar el parámetro del canal. En el uso gratuito el ESP32 puede conectarse hacia fuera, pero el navegador de tu ordenador no puede acceder directamente a un servidor web dentro del ESP32. Para eso necesitas la redirección de puertos de la extensión de VS Code o la pasarela privada del plan de pago. Para NTP y zonas horarias consulta hora NTP con ESP32, y para problemas de conexión en una placa real el ESP32 no se conecta a la Wi-Fi.
Raspberry Pi Pico y soporte de MicroPython

Cuando eliges la plantilla MicroPython para la Pico en la página principal, el proyecto se abre con un archivo main.py. Al pulsar reproducir se carga el intérprete de MicroPython, se ejecuta main.py y ves la salida de print en la consola de abajo. Cuando el programa termina, la misma consola pasa al REPL, donde puedes escribir comandos y probar al instante. Si necesitas módulos extra como el controlador SSD1306, crea un archivo nuevo desde el menú de archivos y pega el contenido del módulo. Con el ESP32 es igual: elige la plantilla MicroPython en la sección 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)En el código el LED está en GP14, el pulsador en GP2 y el cursor del potenciómetro en GP26 (ADC0); las patas exteriores del potenciómetro van a 3V3 y GND. El ADC de la Pico es de 12 bits, pero read_u16() de MicroPython devuelve un valor escalado a 0–65535. Si empiezas con MicroPython, el artículo fundamentos de MicroPython explica uno a uno los comandos de Pin, ADC, PWM y tiempos.
Ver señales con el analizador lógico
Wokwi no tiene multímetro, pero tiene una herramienta mucho más potente: el Logic Analyzer. Lo añades desde la lista de piezas y graba 8 canales digitales (D0–D7). Conecta los canales a los pines que quieras medir y su GND al GND de la placa. Al detener la simulación, la grabación se descarga como archivo .vcd; ábrelo con programas gratuitos como PulseView o GTKWave para leer la frecuencia y el ancho de pulso, e incluso decodificar bytes UART, I2C o 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}Al abrir la grabación, el canal D0 muestra una onda cuadrada con un periodo de unos 2,04 ms (490 Hz); el pulso está en alto una cuarta parte del periodo, unos 0,51 ms. Se debe a que analogWrite(9, 64) corresponde a un ciclo de trabajo de 64/255 ≈ 25 %. En el Uno, los pines 5 y 6 generan 980 Hz y los demás pines PWM 490 Hz; puedes comprobarlo tú mismo con el analizador. Si añades un decodificador UART al canal D1 en PulseView, leerás el byte 0x41 (A) cada 100 ms. Para entender el PWM consulta ¿Qué es PWM?.
La extensión de Wokwi para VS Code
En proyectos grandes, si prefieres tu propio editor al navegador, puedes instalar la extensión Wokwi Simulator en VS Code. La extensión no compila; simula el archivo de firmware que generas con PlatformIO, ESP-IDF o arduino-cli. Para uso personal se obtiene una licencia gratuita que se renueva cada cierto tiempo. La instalación consta de estos pasos:
- En VS Code, busca Wokwi Simulator en la vista de Extensiones e instálala.
- Abre la paleta de comandos con F1, ejecuta Wokwi: Request a New License y confirma la licencia en la página que se abre en el navegador.
- Añade un archivo wokwi.toml y un archivo diagram.json en la raíz de la carpeta del proyecto. Puedes copiar diagram.json de un proyecto dibujado en el navegador.
- Compila el proyecto como siempre (Build en PlatformIO). Las rutas de wokwi.toml deben apuntar a los archivos .bin y .elf generados.
- Pulsa F1 y ejecuta Wokwi: Start Simulator. La simulación se abre en una pestaña de VS Code; al cambiar el código y recompilar, la simulación se reinicia.
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 sección net.forward redirige el servidor web del puerto 80 del ESP32 al puerto 8180 de tu ordenador. Así puedes abrir en tu propio navegador proyectos como el servidor web y WebSocket con ESP32 sin grabar ninguna placa. La extensión también permite depurar paso a paso con GDB; añade una línea gdbServerPort a wokwi.toml y conecta el depurador de VS Code.
Diferencias entre Wokwi y Tinkercad
Los dos simuladores son gratuitos y funcionan en el navegador, pero responden a preguntas distintas. Tinkercad calcula el circuito eléctricamente: puedes medir con un multímetro la corriente que pasa por una resistencia o la tensión en un LED, y admite programación por bloques. Wokwi emula el procesador de la placa y ofrece ESP32, Pico, Wi-Fi, MicroPython y un amplio soporte de librerías. Lo más eficiente es aprender los fundamentos de electrónica con Tinkercad y los proyectos ESP32 e IoT con Wokwi. Para conocer Tinkercad a fondo, consulta la guía simulador Tinkercad para Arduino.
| Característica | Wokwi | Tinkercad Circuits |
|---|---|---|
| Placas | Uno, Nano, Mega, familia ESP32, Pico, Pico W | Arduino Uno R3, ATtiny, micro:bit |
| Cálculo eléctrico | No; niveles digitales y un modelo de valores analógicos | Sí; multímetro y osciloscopio |
| Wi-Fi e Internet | Sí, con ESP32 y Pico W | No |
| MicroPython | Sí, en Pico y ESP32 | No |
| Librerías | La mayoría de las del Gestor de Librerías | Unas once librerías incluidas |
| Programación por bloques | No | Sí |
| Archivo del circuito | diagram.json, editable a mano | Solo editor visual |
| Medida | Analizador lógico (.vcd) | Multímetro, osciloscopio |
| Escritorio | Extensión de VS Code | No |
Sensores y módulos soportados
| Grupo | Disponible en Wokwi | No disponible o limitado |
|---|---|---|
| Luz y pantallas | LED, LED RGB, tira y anillo NeoPixel, LCD 16x2 y 20x4 (también I2C), OLED SSD1306, TFT ILI9341, matriz MAX7219, TM1637, 7 segmentos | Tinta electrónica y la mayoría de OLED a color |
| Entrada | Pulsador, interruptor, DIP switch, potenciómetro, encoder rotativo (KY-040), joystick, teclado de membrana, receptor IR y mando | Pantalla táctil |
| Sensores | DHT22, DS18B20, HC-SR04, PIR, MPU6050, módulo LDR, módulo NTC, HX711 y celda de carga, gas MQ-2, llama, sonido, inclinación | DHT11 (usa DHT22), sensores de color y de huella |
| Movimiento | Servo, motor paso a paso, driver A4988, módulo de relé, zumbador | Motor DC y drivers como el L298N |
| Comunicación y almacenamiento | RTC DS1307, tarjeta microSD, 74HC595, I2C, SPI, UART | RFID RC522, nRF24L01, HC-05, SIM800L, GPS |
| Circuitos analógicos | Potenciómetro y módulos de sensores analógicos | Cálculo analógico real de transistores, amplificadores operacionales, condensadores |
Para una pieza que no está en la lista hay dos caminos. El primero es usar una pieza que se comporte de forma parecida; por ejemplo, pruebas el código del DHT11 con la pieza DHT22. El segundo es la función Custom Chips: un pequeño programa que escribes en C se compila a WebAssembly y se añade al circuito como una pieza nueva con sus propios pines. Así puedes modelar tú mismo un sensor I2C sencillo o un módulo que se comunica por UART.
Límites de la simulación: diferencias con un circuito real
- Sin cálculo eléctrico: Un LED conectado sin resistencia sigue encendido y meter 5 V en un pin del ESP32 no quema nada. En un circuito real ambas cosas te cuestan piezas. Calcula corriente y tensión tú mismo con la ley de Ohm.
- Velocidad: El indicador en la esquina del área del diagrama muestra a qué porcentaje del tiempo real va la simulación. Los proyectos ESP32 con Wi-Fi o con muchas piezas pueden ir más lentos que el tiempo real; tenlo en cuenta en el código que mide tiempos.
- Sensores ideales: Los sensores virtuales no tienen ruido ni necesitan calibración. Un DHT22 real se desvía ±0,5 °C y un HC-SR04 mide mal en superficies blandas; escribe igualmente filtros y comprobaciones de errores.
- Sin alimentación ni batería: El consumo, la caída de tensión, el calentamiento del regulador y los brownouts no aparecen en la simulación.
- Sin Bluetooth: Las funciones BLE y Bluetooth clásico del ESP32 no se simulan.
- Errores de cableado: No existen problemas reales como un cable suelto, una fila equivocada de la protoboard o una soldadura fría; un circuito que funciona en la simulación puede no funcionar a la primera en la realidad.
Compartir el proyecto y pasarlo a una placa real
Cada proyecto guardado recibe una dirección permanente; con el botón Share copias el enlace y lo envías a un amigo, a tu profesor o a un foro. Quien abre el enlace ejecuta el proyecto con un clic y puede copiarlo a su cuenta para modificarlo. Por eso Wokwi es la forma más rápida de mostrar circuito y código juntos cuando pides ayuda porque "mi código no funciona". Desde el menú junto al botón Save puedes descargar el proyecto como archivo zip con sketch.ino, diagram.json y libraries.txt.
- Pega el código que funciona en la simulación en un sketch nuevo del Arduino IDE o abre sketch.ino del zip descargado.
- Instala cada librería de libraries.txt desde el Gestor de Librerías del Arduino IDE.
- En el código Wi-Fi, cambia Wokwi-GUEST por el nombre de tu red y tu contraseña.
- Pasa las conexiones de diagram.json a una tabla de pines y monta el circuito en la protoboard según esa tabla. No olvides añadir las resistencias que Wokwi no necesitaba (resistencia del LED, pull-ups I2C).
- Selecciona la placa y el puerto y sube el código. Si algo falla, sigue los pasos de la guía Arduino no sube el código.
Ideas de proyectos para probar en Wokwi
- Estación meteorológica con OLED: Muestra temperatura y humedad en pantalla con un ESP32, un DHT22 y una SSD1306; cambia los valores con los deslizadores. Para el código de la pantalla consulta pantalla OLED SSD1306.
- Sensor de aparcamiento: Cambia el ritmo de pitidos del zumbador según la distancia del HC-SR04 y prueba todos los umbrales con el deslizador. Detalles en sensor de distancia HC-SR04.
- Animaciones NeoPixel: Prueba transiciones de color en un anillo o matriz WS2812B y diseña los efectos antes de pensar en la fuente de alimentación de una tira real. Ver LED WS2812B NeoPixel.
- Domótica con MQTT: Envía la temperatura desde el ESP32 virtual a un bróker MQTT. Sigue la guía ESP32 con MQTT y Home Assistant para la instalación.
- Cerradura con teclado: Monta una cerradura con teclado de membrana, servo y LCD, y observa los intentos con clave errónea en el Monitor Serie.
- Experimentos con interrupciones: Lee el pulsador con attachInterrupt y comprueba con el analizador lógico cómo el rebote aumenta el número de interrupciones. Ver interrupciones en Arduino.
Errores frecuentes y cómo solucionarlos
| Síntoma | Causa probable | Solución |
|---|---|---|
| El ESP32 no se conecta a la Wi-Fi y los puntos no paran | Nombre de red incorrecto o se escribió una contraseña | Usa WiFi.begin("Wokwi-GUEST", "", 6); el nombre distingue mayúsculas y minúsculas |
| Error No such file or directory | La librería no está en libraries.txt | Añade la librería desde la pestaña Library Manager |
| El LED no se enciende | LED al revés (A y C cambiados) o falta el cable a GND | Conecta la pata larga A a la resistencia y C a GND |
| Una pulsación suma dos al contador | Se simula el rebote del pulsador | Añade antirrebote al código o usa "bounce": "0" en las pruebas |
| La simulación va muy lenta | Impresión continua por Serial sin pausa en el bucle | Pon un delay corto en loop y reduce la salida innecesaria |
| ImportError: no module named en MicroPython | El archivo del módulo no está en el proyecto | Crea un archivo nuevo desde el menú y pega el módulo |
| El servidor web del ESP32 no se abre en el navegador | La pasarela gratuita solo permite conexiones de dentro hacia fuera | Usa net.forward en la extensión de VS Code |
| El proyecto ha desaparecido | Trabajaste sin iniciar sesión | Guarda con Save; en proyectos ajenos elige Save a copy |
Wokwi es la forma más práctica de probar una idea antes de comprar piezas, compartir un fallo junto con su circuito y probar código Wi-Fi sin riesgos, sobre todo con ESP32 y Pico. La mayoría de los proyectos de la app BlueGrays incluyen un vídeo de simulación grabado mientras el circuito funciona en Wokwi; puedes ver cuándo se enciende el LED y cómo se actualiza la pantalla antes de empezar a montar, y después construir el mismo proyecto en tu placa real con el esquema y el código paso a paso.
Preguntas frecuentes
¿Wokwi es gratis?
Sí, la versión de navegador de Wokwi es gratuita para el uso básico: puedes crear, guardar y compartir proyectos y llevar un ESP32 a Internet con Wi-Fi virtual. Funciones extra como la pasarela privada y las compilaciones más rápidas están en un plan de pago. La extensión de VS Code también funciona con una licencia gratuita para uso personal.
¿Cómo conecto un ESP32 a la Wi-Fi en Wokwi?
En el código del ESP32 usa Wokwi-GUEST como nombre de red y una cadena vacía como contraseña: WiFi.begin("Wokwi-GUEST", "", 6). El último parámetro, el canal 6, acelera la conexión. Una vez conectado, el ESP32 accede a Internet real por NTP, HTTP y MQTT.
¿Wokwi o Tinkercad: cuál es mejor?
Tinkercad es mejor para aprender fundamentos de electrónica, medir corriente y tensión con un multímetro y programar con bloques. Wokwi destaca en proyectos que necesitan ESP32, Raspberry Pi Pico, Wi-Fi, MicroPython y muchas librerías. Muchos estudiantes usan los dos.
¿Cómo se añade una librería en Wokwi?
Abre la pestaña Library Manager encima del editor, pulsa +, busca la librería y selecciónala. Se añade al archivo libraries.txt y se instala automáticamente al compilar. También puedes escribir a mano el nombre de la librería en el archivo, tal como aparece en el Gestor de Librerías de Arduino.
¿Wokwi tiene DHT11?
La lista de piezas de Wokwi incluye el DHT22, pero no el DHT11. Para probar código escrito para un DHT11, coloca una pieza DHT22 en el circuito y cambia el tipo de sensor en la librería a DHT22. Al pasar a una placa real, vuelve a poner el tipo DHT11.
¿El código de Wokwi funciona en una placa real?
Sí. Como Wokwi ejecuta código estándar de Arduino y MicroPython, puedes subir el mismo código a una placa real con el Arduino IDE o Thonny. Solo tienes que instalar las librerías, cambiar el nombre y la contraseña de la Wi-Fi y añadir al circuito las resistencias que Wokwi no necesitaba.
Proyectos para hacer después de leer esto
Ver todos los proyectos
LED Parpadeante con ESP32
Enseña el uso básico de la salida GPIO con ESP32. Conseguimos un efecto de parpadeo encendiendo y apagando un LED desde el pin digital. Versión para ESP32 del clásico proyecto blink en Arduino UNO; los comandos básicos de blink en el entorno Arduino son los mismos, pero la distribución de pines y los niveles GPIO de 3,3 V del ESP32 difieren de los del Arduino UNO.

Control de LED con pulsador en ESP32 (Push)
El LED se enciende cuando se pulsa el botón y se apaga cuando se suelta. Muestra cómo se utiliza el pin de entrada digital del ESP32 y la resistencia pull-up interna. Gracias al modo INPUT_PULLUP, no se necesita ninguna resistencia externa.

Control de LED con botón en ESP32 (Toggle)
Cada vez que se pulsa el botón, cambia el estado del LED: si está encendido se apaga, si está apagado se enciende. Patrón de conmutación clásico. Con debounce limpiamos el ruido mecánico del pulsador para garantizar una sola conmutación con una sola pulsación.

Lectura de la intensidad luminosa con el módulo LDR del ESP32
Visualización en tiempo real en el monitor serie del valor bruto del ADC del módulo LDR y del porcentaje relativo de luz calculado a partir de referencias de oscuridad y claridad. Este porcentaje no es una medición en lux. Explica el funcionamiento de la calibración del módulo. Es recomendable realizarlo antes del Proyecto 10, ya que se utiliza para determinar el valor umbral.

Encendido de un LED externo con la Raspberry Pi Pico (placa de pruebas)
El siguiente paso tras el LED integrado de la Pico: conectar un LED externo en la protoboard y controlarlo con el pin GP14. Aprenderás a usar cualquier pin GPIO de la Pico como salida, la polaridad del LED (pata larga = ánodo/+, pata corta = cátodo/–) y por qué es imprescindible una resistencia limitadora de corriente (220Ω). Sin ella, pasa demasiada corriente por el LED y puede quemarse.

Raspberry Pi Pico LED Controlado por Botón (Push)
¡Primer proyecto de entrada con Pico — lectura de botón! LED se enciende mientras el botón está presionado. Aprende Pin.IN, Pin.PULL_UP y button.value(). GP14 LED, GP2 botón con PULL_UP interno. Presionado = 0, liberado = 1 — estándar.

Conexión Wi-Fi STA con ESP32 (con pantalla LCD)
En este proyecto, conectamos el ESP32 a la red Wi-Fi doméstica en modo Station (STA) de forma segura y tolerante a fallos. Separamos el SSID y la contraseña en el archivo secrets.h para evitar que se filtren a Git, configuramos un mecanismo de reconexión automática y mostramos el nivel de señal RSSI y la dirección IP en una pantalla LCD I2C. El LED interno actúa como indicador de estado.

ESP32: hora real desde Internet con NTP
El ESP32 se conecta al Wi-Fi y obtiene la hora real de servidores NTP (Network Time Protocol) con precisión de milisegundos. Gracias a configTzTime(), se aplica automáticamente la zona horaria de Turquía (TRT, UTC+3), y en los países con horario de verano el cambio (DST) se gestiona solo mediante una cadena POSIX TZ. La hora se muestra en el Serial Monitor y en una LCD I2C opcional.
Más artículos
App BlueGrays
Monta este circuito paso a paso en tu teléfono
Esquema, código y lista de piezas en una sola pantalla. Más de 500 proyectos de Arduino, ESP32 y Pico listos para montar.
Escanea con tu teléfono
Apunta la cámara al código y se abrirá la tienda de apps de tu teléfono.
o ábrela en la tienda

