Touch-LCD-4B energy panel
An LVGL home-energy panel on a 480×480 RGB display with GT911 touch. Swipe between pages, toggle tiles, then enable audio and play a SID tune from the last page.
esp32sim is an instruction-level emulator for Espressif's ESP32-S3, C3, C6, P4, S31 and the classic ESP32, written in Rust. It boots the real mask ROM, the real bootloader and an unmodified application image — here in this tab, or on your command line as a hardware test bench that a coding agent can drive.
Every demo is a real firmware image booting through the real ROM inside this tab. Nothing runs on a server. The first load fetches the emulator (about 5 MB); firmware after that is small, except Linux's 16 MB flash and Pocket Tank's 7.6 MB model.
An LVGL home-energy panel on a 480×480 RGB display with GT911 touch. Swipe between pages, toggle tiles, then enable audio and play a SID tune from the last page.
A 14.3M-parameter transformer decides what each fish does, running from flash on the S3's PIE vector unit while the other core draws the tank. Slower than real time in a browser.
Starting network (background): OK Starting inetd: OK Starting cron: OK Welcome to Buildroot buildroot login: root Password: # uname -a Linux buildroot 6.11.0 #1 PREEMPT xtensa GNU/Linux # █
Linux-on-esp32-S3: the network adapter on core 0, Linux executing in place from flash on core 1. Log in as root, run top, edit in vi, start MicroPython.
Arduino firmware with an ST7735 display, a WS2812 ring, an encoder and buttons. Turn the knob, press the buttons, hear the SID voice. The jukebox variant plays real C64 tunes.
Stock MicroPython v1.29.0 booted by the mask ROM on the original dual-core ESP32, running a pure-Python spot-price app on the LilyGO T-Display's ST7789 over VSPI. Demo data from its own filesystem, since the browser has no sockets; the two buttons are below the panel.
A little hardware optimism on a TTGO T-Display. GPIO35 cycles through the schematik wordmark, four fun lines and emulator specs; GPIO0 powers off into deep sleep and wakes back to the wordmark.
Espressif's newest chip on its ESP-Mosaico board: LVGL through the board's own BSP on the round 480×480 AMOLED, a compass needle from the magnetometer and a rolling ball from the accelerometer while the board is turned. Tap it; the AI button recolours it and buzzes the motor.
The Elka Synthex in integer C on the Waveshare ESP32-P4-WIFI6-Touch-LCD-3.5: LVGL on the ST7796, FT5x06 touch and the ES8311 codec. Enable audio, play the keys, tap the red display for 80 presets. Slower than real time in a browser.
[I] RPL: created DAG with instance ID 0, DAG ID fd00::ff:fe00:1, rank 128 [I] RPL: sending a multicast-DIO with rank 128 to ff02::1a [I] RPL: received a unicast-DIO from fe80::ff:fe00:2, instance_id 0 …
Two emulated C6 motes on one 802.15.4 medium: Contiki-NG's rpl-udp server as the DAG root and a client that joins, then sends a UDP request every 10 s and gets a reply. Hardware ACKs included.
A station firmware scans two virtual access points and three networks around them, joins one with WPA2, takes a DHCP lease and pings the gateway. The Network panel lists every frame both ways, dissects the one you click and saves them all as a pcap.
Our blink firmware on Seeed's XIAO: the low-active user LED on GPIO 15 lights while the pin sinks current, and the BOOT button on GPIO 9 reads back. The script presses it at 2 s; the page's BOOT button presses it too.
Agents write embedded code well and test it badly: a board on a desk cannot be scripted, read back or reset from a shell. esp32sim can. It is the same emulator as the demos above, as a command-line tool any agent with shell access already knows how to use.
# build as always $ idf.py build # run it 8 emulated seconds with a script of touches, keep the display $ esp32sim --board waveshare-lcd4b --boot rom \ --bootloader build/bootloader/bootloader.bin \ --ptable build/partition_table/partition-table.bin \ --app build/app.bin --elf build/app.elf \ --script test/swipe.txt --max-seconds 8 \ --tft-png panel.png --vcd gpio.vcd --coverage-file cov.txt # test/swipe.txt — one action per line, at emulated seconds 3.0 touch 450 240 1 # press near the right edge 3.1 touch 300 240 1 # drag left … 3.2 touch 100 240 1 3.3 touch 100 240 0 # release: the panel swipes to its next page 8.0 stop # what the agent reads back (this run, verbatim) I (725) main: up [emu] stop: Halted — core0 231572900 + core1 66167543 insns in 3.0s wall = 100.5 Minsn/s; emulated 8.000s (1920000000 cycles) [emu] wrote panel.png # the second page, as the firmware drew it
Point an agent at docs/cli.md and a board name. Runs are single-process with no daemon and no device, so they parallelise like unit tests, and --no-jit is the oracle when a result looks wrong.
Six SoCs across both of Espressif's CPU architectures. Most of the SoC model is shared; only the CPU crates are separate. The numbers are from the README and its tests.
Every release has ready-to-run downloads for Linux (x86-64 and ARM64) and macOS (Apple silicon).
Two new chips, each on a real board: the ESP32-P4 on Waveshare's LCD-3.5, with WiFi through an emulated ESP32-C6 co-processor running the unmodified ESP-Hosted firmware, and the ESP32-S31 on Espressif's ESP-Mosaico, whose factory firmware runs to its home screen. esptool flashes the S3, C3, C6 and P4 through the ROM. WiFi you can shape from the page: several access points, nearby networks and BLE devices, and a live Network panel. RISC-V runs about three times faster.
A fourth chip, the classic ESP32, from its own mask ROM to MicroPython on a TTGO T-Display. WiFi and Bluetooth on every chip, a much wider set of peripherals, and a browser build that runs some workloads faster than real time.
A third chip, the ESP32-C6, with an 802.15.4 radio and Contiki-NG. Linux 6.11 boots on the ESP32-S3, and the S3 gets a WebAssembly JIT in the browser.
The first release: unmodified ESP-IDF and Arduino firmware on the ESP32-S3 and ESP32-C3, from the real mask ROM through the bootloader into the application, natively and in the browser.
Choose the chip and board, pick your bootloader, partition table and app (or a whole flash image), add ELF symbols and a script if you like, and boot. The mask ROM comes from this site; files stay in the browser; nothing is uploaded. On your own machine, the quick start does the same from a release tarball in three steps.