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