Wokwi hardware reference
Technical reference for the Wokwi project in gallery. Simulator assets live in gallery/.site/wokwi.
Project layout
Path |
Role |
|---|---|
|
Simulated hardware
Item |
Detail |
|---|---|
MCU |
ESP32-S3 DevKitC-1 ( |
Display |
ILI9341 240×320 via SPI ( |
Touch |
FT6206 I2C (simulated on the cap-touch board) |
Pin wiring
Matches wokwi_ili9341_ft6x36_esp32s3/board_config.py:
Signal |
GPIO |
|
|---|---|---|
Power |
3V3 |
|
SPI SCK |
12 |
|
SPI MOSI |
11 |
|
SPI MISO |
13 |
|
Display D/C |
16 |
|
Display CS |
5 |
|
Touch I2C SDA |
7 |
|
Touch I2C SCL |
6 |
|
Backlight |
3V3 |
|
Reset |
3V3 |
|
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 |
|
Wokwi simulator quirk; may not reproduce on hardware |
Old hosted wokwi.com project IDs |
May be stale; use the |
See also the application troubleshooting guide.