diff --git a/src/tooling/simulating/qemu.md b/src/tooling/simulating/qemu.md index 2fd7768..303a052 100644 --- a/src/tooling/simulating/qemu.md +++ b/src/tooling/simulating/qemu.md @@ -1,12 +1,12 @@ # QEMU Espressif maintains a fork of QEMU in [espressif/QEMU][espressif-qemu] with the necessary patches to make it work on Espressif chips. -See the [QEMU wiki][qemu-wiki] for instructions on how to build QEMU and emulate projects with it. +See the [ESP-specific instructions for running QEMU][esp-qemu-doc] for instructions on how to build QEMU and emulate projects with it. Once you have built QEMU, you should have the `qemu-system-xtensa` file. [espressif-qemu]: https://github.com/espressif/qemu -[qemu-wiki]: https://github.com/espressif/qemu/wiki +[esp-qemu-doc]: https://github.com/espressif/esp-toolchain-docs/tree/main/qemu/esp32#overview ## Running Your Project Using QEMU @@ -20,12 +20,14 @@ cargo espflash save-image --chip esp32 --merge --release ``` If you prefer to use [`espflash`][espflash], you can achieve the same result by building the project first and then generating image: + ```shell cargo build --release -espflash save-image --merge ESP32 target/xtensa-esp32-espidf/release/ +espflash save-image --chip ESP32 --merge target/xtensa-esp32-espidf/release/ ``` Now, run the image in QEMU: + ```shell /path/to/qemu-system-xtensa -nographic -machine esp32 -drive file=,if=mtd,format=raw ```