ESP32 Simulation

The ESP32 Simulator is currently in preview. There are two ESP32 boards:

• ESP32 DevKit v1 - Popular ESP32 development board
• TinyPico - an ESP32 board by UnexpectedMaker

You can contribute additional boards by sending us a pull request.

Getting Started

You can use the ESP32 simulator in three ways:

1. Build projects using the ESP32 Arduino Core
2. Run MicroPython projects
3. Simulate bin application files you built on your machine (e.g. using ESP-IDF)

Arduino Core

Start from the Arduino-ESP32 Project Template, or from the ESP32 Blink Example.

If you want to use third-party Arduino libraries, add a libraries.txt file with the list of libraries that you use.

MicroPython

Start from the MicroPython ESP32 Project Template, or from the MicroPython ESP32 Blink Example.

Note: While the simulation is running, press Ctrl+C inside the Serial Terminal to get into the MicroPython REPL. Alternatively, you can edit the Blink Example code and remove the while loop. For more information, check out the MicroPython Guide.

Custom Application (.bin) File

Open the ESP32 custom application project template, and press "F1" in the code editor. Then choose "Load HEX File and Start Simulation…". Choose any .bin file from your computer and the simulation will start.

Simulator Examples

Arduino Examples

• Blink
• Seven segment counter
• FastLED NeoPixel Blink
• APA102 Color Cycles (TinyPico Board)
• WiFi Scanning

MicroPython Examples

• SSD1306 Example
• NeoPixels
• AES256 Encryption
• WiFi Scanning

ESP-IDF Examples

The following examples use the ESP-IDF functions. They are compiled using Arduino ESP32 Core:

• Blink using FreeRTOS API
• Binary LED counter using FreeRTOS tasks
• GPIO button input + interrupts

Simulation Features

Peripheral	Status	Notes
Processor core	✔️	Both cores are simulated
GPIO	✔️	Interrupts supported
IOMUX	🟡
PSRAM	✔️	4MB of external SRAM
UART	✔️	Only UART0 for now
I2C	✔️	Master only. 10-bit addressing not supported.
I2S	❌
SPI	❌
RMT	🟡	Transmit-only, use to control NeoPixels
PWM	❌
DMA	❌
WiFi	🟡	Scanning works; See notes
Bluetooth	❌
Timers	🟡
Watchdog	❌
RTC	🟡	Only RTC Pull-up / Pull-down resistors
ADC	✔️	Note: analogRead() returns values up to 4095
RNG	✔️	Random Number Generator
AES Accelerator	✔️
SHA Accelerator	✔️
RSA Accelerator	❌	Required for HTTPS / SSL
Hall Effect Sensor	❌
GDB Debugging	🟡	Only through wokwi-gdbserver

Legend:
✔️ - Simulated
🟡 - Partial implementation/work in progress
❌ - Not implemented (but if you need it, please open a feature request)

WiFi Simulation

The WiFi simulation is still very much work-in-progress. You can scan for WiFi networks, and we're now working on the ability to connect to networks (association).

The simulator currently provides two built-in virtual WiFi access points:

Name (SSID)	BSSID	Description
Wokwi-GUEST	42:13:37:55:aa:01	Open WiFi network (no password required)
Wokwi-Club	42:13:37:55:aa:02	Club-only WiFi network

The Wokwi-GUEST network can be used by anyone, and can access a limited set of internet services. The Wokwi-Club network is limited for subscribers, and can access all internet servers through a metered proxy.