Wokwi hardware reference

Technical reference for the Wokwi project in gallery. Simulator assets live in gallery/.site/wokwi.

Project layout

Path

Role

wokwi/

main.py, diagram.json — core packages + testris (this folder is in the gallery repo)


Simulated hardware

Item

Detail

MCU

ESP32-S3 DevKitC-1 (board-esp32-s3-devkitc-1), 8 MB flash

Display

ILI9341 240×320 via SPI (board-ili9341-cap-touch)

Touch

FT6206 I2C (simulated on the cap-touch board)

Pin wiring

Matches wokwi_ili9341_ft6x36_esp32s3/board_config.py:

Signal

GPIO

diagram.json part / pin

Power

3V3

lcd1:VCC → esp:3V3.1

SPI SCK

12

lcd1:SCK → esp:12 (SPI2 IOMUX)

SPI MOSI

11

lcd1:MOSI → esp:11

SPI MISO

13

lcd1:MISO → esp:13

Display D/C

16

lcd1:D/C → esp:16

Display CS

5

lcd1:CS → esp:5

Touch I2C SDA

7

lcd1:SDA → esp:7

Touch I2C SCL

6

lcd1:SCL → esp:6

Backlight

3V3

lcd1:LED → esp:3V3.1 (required on board-ili9341-cap-touch)

Reset

3V3

lcd1:RST → esp:3V3.1 (hold out of reset)

SPI baudrate in board_config is 20 MHz (GPIO-matrix-safe; IOMUX pins above also allow higher clocks). Do not use GPIO 35/36/37 for SPI on ESP32-S3 — they collide with Octal PSRAM / MicroPython SPI(2) defaults.

Display part id in diagram.json: lcd1 (board-ili9341-cap-touch).


FT6206 (Wokwi) vs FT6X36 (OmniPython driver)

Wokwi’s cap-touch board simulates an FT6206 I2C controller. The OmniPython board config uses the FT6X36 driver (ft6x36.py) — same FT6xx family and register-style protocol. No board_config change is expected; if touch behaves oddly, compare with real hardware and file an issue.


Board env attribute (optional)

Committed diagram.json pins a MicroPython build in the DevKit’s attrs (env). To use a different one, copy the env value from the ESP32-S3 MicroPython template into the DevKit attrs.


MIP install pattern

mip.install pattern in wokwi/main.py:

import mip

OMNIPYTHON_LIB = "https://lib.omnipython.org"
PYDEVICES = "github:PyDevices/omnipython"
OMNIPYTHON_EXAMPLES = "github:PyDevices/gallery"

# Board package pulls ili9341/ft6x36/spibus from this repo and displaydev from
# the OmniPython index (displaydev → events + keys). Install optional appdev in the
# application when the example uses that traffic controller.
mip.install(
    PYDEVICES + "/board_configs/busdisplay/spi/wokwi_ili9341_ft6x36_esp32s3/",
    index=OMNIPYTHON_LIB,
    target=".",
)
mip.install("pygraphics", index=OMNIPYTHON_LIB, target=".")
mip.install(OMNIPYTHON_EXAMPLES + "/lib/examples/testris.py", target=".")

import testris

No-touch variant:

mip.install(
    "github:PyDevices/omnipython/board_configs/busdisplay/spi/wokwi_ili9341_esp32s3_no_touch"
)

Use a display-only diagram.json (no touch I2C wires) with that config.


Known issues

Issue

Notes

Blank LCD, no traceback

Usually missing LED/RST→3V3 on board-ili9341-cap-touch, or SPI on GPIO 35/36/37 @ 60 MHz — use the pin table above

TouchKeypad IndexError on last row

Wokwi simulator quirk; may not reproduce on hardware

Old hosted wokwi.com project IDs

May be stale; use the wokwi/

See also the application troubleshooting guide.