esp32sim README

README проекта с github.com/mikroverk/esp32sim. Одним файлом markdown: README.md.

esp32sim logo: a smiling chip in an emulator window

esp32sim

esp32sim is an ESP32 emulator written in Rust. It runs real ESP32 firmware on your computer or in a browser tab, without the hardware.

It boots the chip's own mask ROM, the real second-stage bootloader and your unmodified application. It also models the board around the chip: displays, touch, LEDs, buttons, audio, camera and WiFi.

Try it in your browser, nothing to install: https://mikroverk.github.io/esp32sim/

--chip esp32 --board ai-thinker-cam --cam-image image.ppm supplies the AI-Thinker ESP32-CAM's OV2640 with a BMP/PPM still image. Capture supports raw RGB565/YUV422 into internal DRAM at a fixed approximate 10 FPS; the usual JPEG+PSRAM CameraWebServer path is unsupported. See the camera scope and example.

Supported chips

Chip CPU Status Boards
ESP32-S3 2 x Xtensa LX7 mature Atech 14-port kit, Waveshare Touch-LCD-4B, Touch-AMOLED-1.8, ESP32-S3-CAM
ESP32-C3 RISC-V RV32IMC draft console only
ESP32-C6 RISC-V RV32IMAC draft Waveshare ESP32-C6-LCD-1.47 (with the 802.15.4 radio), Seeed XIAO ESP32-C6
ESP32 (classic) 2 x Xtensa LX6 early LilyGO TTGO T-Display, ESP32-2432S028 "Cheap Yellow Display", AI-Thinker ESP32-CAM (raw capture), Ulanzi TC001
ESP32-P4 (rev < 3 and rev ≥ 3) 2 x RISC-V RV32IMAFC draft Waveshare ESP32-P4-WIFI6-Touch-LCD-3.5 (rev ≥ 3); WiFi through an emulated ESP32-C6 co-processor on SDIO (ESP-Hosted)
ESP32-S31 2 x RISC-V RV32IMAFC draft Espressif ESP-Mosaico (display, touch, WiFi, audio, IMU, keys); IDF v6.1

Features

Demos

These run on the demo site:

You can also load your own firmware for any of the chips.

Quick start

No Rust needed: the releases carry prebuilt binaries for macOS and Linux, and docs/quick-start.md takes your own build from the tarball to a run in three steps. From a checkout:

cargo build --release
tools/fetch-demo-assets.sh --no-linux       # downloads the mask ROMs, which are not in the repo

FW=web/wasm/fw/public                       # demo firmware included in the repo
./target/release/esp32sim --boot rom --rom web/wasm/fw/esp32s3_rev0_rom.elf \
    --bootloader $FW/atech-bootloader.bin --ptable $FW/atech-ptable.bin --app $FW/atech-firmware.bin \
    --script $FW/atech-script1.txt --wav out.wav --tft-png tft.png --max-seconds 5

This boots the Atech synth firmware, plays a short script, and saves the audio to out.wav and the display to tft.png. Use esp32sim-c3, esp32sim-c6, esp32sim-p4, esp32sim-s31 or --chip esp32 for the other chips.

Getting started covers the rest: your own ESP-IDF builds, each chip, WiFi, scripts, the browser build and debugging.

Documentation

Contributing

Bug fixes, peripherals, boards and new chips are welcome. CONTRIBUTING.md lists what a pull request needs; these are the same checks CI runs. Security problems go through SECURITY.md, not the public issue tracker.

Credits and license

esp32sim is released under the MIT License.

Authors: Joakim Eriksson, RISE (@joakimeriksson), Alice (@aliceisjustplaying) and Mattia Fiumara, Schematik (@mfiumara), together with other contributors.

The emulator was written from the ESP-IDF register headers, the Xtensa core configuration that ships with ESP-IDF, the RISC-V specification, the chips' technical reference manuals and observed firmware behaviour. QEMU was consulted only to confirm instruction semantics; no code was copied.

esp32sim is unofficial and not affiliated with Espressif Systems.

Third-party code, data and demo files keep their own licenses:

esp32sim (mikroverk/esp32sim)

Ищем в базе…

Что это такое?esp32sim — это эмулятор с открытым исходным кодом, работающий на уровне инструкций, для четырёх чипов ESP32 (классический ESP32, S3, C3, C6). Он запускает настоящее масочное ПЗУ (mask ROM), загрузчик и неизменённый образ приложения, без модифицированной прошивки и без какого-либо железа.
Это CLI-инструмент или то, что запускается в браузере?И то, и другое: это нативный эмулятор командной строки (esp32sim, esp32sim-c3, esp32sim-c6) и тот же эмулятор, скомпилированный в WebAssembly, который работает прямо в браузере без установки.
Как запустить свою прошивку?Откройте размещённую в браузере демо-версию и нажмите «Boot», чтобы быстро попробовать, или выполните соответствующую команду CLI и загрузите свой образ прошивки с диска, выбрав нужную плату или чип (esp32c3 / esp32c6).
Нужна ли мне реальная плата ESP32 или аккаунт Espressif, чтобы это использовать?Нет — он запускает настоящие образы ROM и загрузчика полностью программно, без облачного аккаунта, подписки и физического оборудования.
Эмуляторы C3 и C6 так же зрелы, как эмулятор S3?Нет: поддержка классических ESP32 и S3 зрелая, а эмуляторы RISC-V для C3 и C6 пока помечены как черновые и работают на обычном интерпретаторе, а не на JIT.
Быстрый JIT требует Apple Silicon или работает и на других системах?Скорость S3 достигается за счёт компиляции горячих блоков инструкций в нативный код AArch64. На других архитектурах процессора можно передать флаг --no-jit, чтобы перейти на обычный интерпретатор, который гарантированно даёт идентичные результаты.
Весь проект распространяется под MIT, включая встроенную демо-прошивку?Сам esp32sim распространяется под MIT, но он загружает или включает стороннюю прошивку и данные (например, образ ядра Linux), которые сохраняют свои собственные, иногда другие лицензии, такие как GPL-3.0.
Какие платы и периферию может эмулировать ESP32-S3?S3 эмулирует дисплеи, например ST7735 и сенсорный ST7701S 480x480, светодиоды WS2812, камеру и аудио, а также поддержку плат, например LilyGO TTGO T-Display и панели Touch-LCD-4B.
Насколько точен эмулятор по сравнению с реальным железом?Каждый чип сверен с физическими платами: S3 работает в режиме JTAG lock-step без расхождения PC на тысячах шагов, а C3 и C6 совпадают с записанным выводом консоли реального оборудования на 205 из 208 и 203 из 204 строк соответственно.
Насколько быстро эмулятор работает по сравнению с реальным временем?S3 сочетает блочный интерпретатор с JIT-компилятором под AArch64, достигая примерно 150–240 миллионов инструкций в секунду. Этого хватает, чтобы запускать реальную прошивку (например, синтезаторное приложение) в реальном времени, за исключением самых тяжёлых перерисовок экрана, которые ненадолго отстают, а затем восстанавливаются.
Можно ли отлаживать прошивку, пока она работает внутри эмулятора?Да: флаги --trace, --break ADDR, --watch ADDR, --peek и --profile позволяют пошагово проходить выполнение и просматривать память, а дополнительные переменные окружения включают логирование активности периферии, такой как SPI, WiFi, AES и SHA.
Какие есть похожие проекты?tinygo, hermes-gadget-sdk, esp-sdr, InkBoy, ESP32Marauder, frank-386, RuView, ESP32-Bit-Pirate
Автор
mikroverk
Размер
73.8 MB
Звёзды
1.2K
Возраст
2 мес
Коммиты · 90 дней