Xilinx Quick Emulator (QEMU)

How to use QEMU for baremetal application

This guide adapts the Standalone Application Debug using System Debugger on QEMU guide.

  1. Launch Vitis IDE

  2. Open the UltraZohm workspace: ~/ultrazohm/ultrazohm_sw/vitis/workspace

  3. Select Run > Debug Configurations

  4. Right click on Debug_FreeRTOS_Baremetal_FPGA and select duplicate

../../../../_images/Debug_config_create.png

  1. Change the name to Debug_Baremetal_QEMU

  2. Change the project to Baremetal

../../../../_images/Debug_config_project.png

  1. Check the Emulation box. The connection should automatically change to QMEU

../../../../_images/Debug_config_emulator.png

  1. Don’t change any other settings

  2. Click Apply and then run

  3. Click Start Emulator and Run

  4. View after the emulation and debug have started.

../../../../_images/Debug_view_launch.png

  1. The emulation console should open. If it doesn’t, go to Window > Show view > Xilinx > Emulation Console

  2. To stop the Emulator, go to Xilinx > Start/Stop Emulator

Further information to setup the QEMU emulation for vitis 2020.1

Documentation using QEMU with the Vitis IDE is sparse. The following links mostly reference the old SKD environment.

  1. Xilinx Quick Emulator User Guide QEMU (v2020.1) . To use this system emulation model you must be familiar with:

    • Uses Xilinx® PetaLinux and Software DevelopmentKit (SDK) tools

  2. Introduction to QEMU

    • Short explanation how QEMU works and for what you can use it

    • No information how to set up/start the emulator

  3. Running an RPU Application using QEMU

    • Old video, still uses the SDK instead of the Vitis IDE

    • Outdated workflow