The ESP32 Simulator is currently in preview. There are two ESP32 boards:
You can contribute additional boards by sending us a pull request.
You can use the ESP32 simulator in three ways:
- Build projects using the ESP32 Arduino Core
- Run MicroPython projects
- Simulate bin application files you built on your machine (e.g. using ESP-IDF)
If you want to use third-party Arduino libraries, add a libraries.txt file with the list of libraries that you use.
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.
The following examples use the ESP-IDF functions. They are compiled using Arduino ESP32 Core:
|Processor core||✔️||Both cores are simulated|
|PSRAM||✔️||4MB of external SRAM|
|UART||✔️||Only UART0 for now|
|I2C||✔️||Master only. 10-bit addressing not supported.|
|RMT||🟡||Transmit-only, use to control NeoPixels|
|WIFI||🟡||Scanning works; See notes|
|RTC||🟡||Only RTC Pull-up / Pull-down resistors|
|ADC||✔️||Note: analogRead() returns values up to 4095|
|Hall Effect Sensor||❌|
|GDB Debugging||🟡||Only through wokwi-gdbserver|
✔️ - Simulated
🟡 - Partial implementation/work in progress
❌ - Not implemented (but if you need it, please open a feature request)
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:
|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.