Wokwi simulator

Run pydevices-examples on a simulated ESP32-S3 with an ILI9341 capacitive touch display — no hardware required.

In-repo project: web/wokwi/

Who: You want MCU-faithful testing (SPI display, I2C touch, MicroPython machine APIs) without flashing a board.

What you get: testris — a Tetris-style game driven by the on-screen touch keypad. One main.py; full example catalog = uncomment two lines.

Prerequisites:

• Network on first boot (mip.install pulls packages from GitHub)
• wokwi.com account (free)

---

Run in the browser

1. Create a new ESP32-S3 MicroPython project.
2. Replace diagram.json and main.py with the files from web/wokwi/.
3. Start the simulation. Serial shows mip downloads, then testris appears.

Full install: uncomment the two utils / examples lines in main.py before starting (several-minute first boot).

The browser sim ships MicroPython — no local tools or firmware download needed.

---

Quick vs full

	Quick (default)	Full
User action	Use main.py as committed	Uncomment utils + examples lines
First boot	~30 s	Several minutes
Demo	testris	Same + full examples/ catalog
Also enables	—	hello.py, bmp565, pydevices_demo, LVGL prep, etc.

---

Verify it worked

The testris game appears and responds to the on-screen touch keypad; serial has no Traceback.

---

Board configs

MIP package	Touch
board_configs/busdisplay/spi/wokwi_ili9341_ft6x36_esp32s3	FT6X36 (default)
board_configs/busdisplay/spi/wokwi_ili9341_esp32s3_no_touch	None — use if touch is not wired

Hardware details: Wokwi reference.

---

Next

• ESP32 board guide — same workflow on real hardware
• Try pydevices-examples — PyScript browser demo
• pydevices_demo example
• Desktop CPython