PlatformIO
v6.0.2

Getting Started

Configuration

Instruments

Advanced

Integration

Miscellaneous

QEMU

../../../../_images/qemu.png

QEMU is a free and open-source emulator that performs hardware virtualization. Official reference can be found here.

Configuration

Integration of the QEMU requires adding the platform compatible package to the platform_packages option in your “platformio.ini” (Project Configuration File), and overriding the test_testing_command.

See the example of platformio.ini for the HiFive1 board from SiFive:

[env:hifive1]
platform = sifive
framework = freedom-e-sdk
board = hifive1

platform_packages =
    platformio/tool-qemu-riscv
test_testing_command =
    ${platformio.packages_dir}/tool-qemu-riscv/bin/qemu-system-riscv32
    -nographic
    -machine
    sifive_e
    -kernel
    ${platformio.build_dir}/${this.__env__}/firmware.elf

Testing

QEMU does not require a firmware uploading stage. Please use the pio test --without-uploading command option.

> pio test --without-uploading

Verbose mode can be enabled via `-v, --verbose` option
Collected 1 tests

Processing test_dummy in hifive1 environment
--------------------------------------------
Building...
Testing...
test/test_dummy/main.c:18: dummy_test [PASSED]
---------------------- hifive1:test_dummy [PASSED] Took 2.05 seconds ----------------------

======================================= SUMMARY =======================================
Environment    Test        Status    Duration
-------------  ----------  --------  ------------
hifive1        test_dummy  PASSED    00:00:02.055
====================== 1 test cases: 1 succeeded in 00:00:02.055 ======================