Necessary artifacts

└── riscv64
    ├── lmp-factory-image-qemuriscv64.wic.gz
    └── fw_payload.elf

Booting in QEMU


These instructions require QEMU 5.2 or later.

  1. List available Targets and decide on which to boot:

    fioctl targets list


Make sure to set the FIOCTL_FACTORY environment variable:

export FIOCTL_FACTORY=<factory>

  1. Make a directory to store the artifacts and cd into it.

    mkdir -p lmp-qemu/riscv64
    cd lmp-qemu/riscv64
  2. Download the necessary artifacts for riscv64, replace <target_number> with the target you would like to boot

    # Download and extract the Factory image
    fioctl targets artifacts <target_number> qemuriscv64/lmp-factory-image-qemuriscv64.wic.gz | gunzip > lmp-factory-image-qemuriscv64.wic
    # Download OpenSBI Firmware
    fioctl targets artifacts <target_number> qemuriscv64/fw_payload.elf > fw_payload.elf
  3. The directory tree should now look like this

    └── riscv64
        ├── lmp-factory-image-qemuriscv64.wic
        └── fw_payload.elf
  4. Run the QEMU script below against the artifacts inside of lmp-qemu/. You may want to save this as run.sh inside the directory for convenience

Booting Graphically

In order to boot QEMU with an OpenGL capable virtual GPU inside (required for Wayland/Weston), the following flags need to be added to the QEMU CLI:

-display gtk,gl=on -device virtio-gpu-pci

The -nographic flag must also be removed from the QEMU CLI.


qemu-system-riscv64 does not currently support this functionality.



qemu-system-riscv64 -machine virt -m 1024 \
    -device virtio-serial-device -chardev null,id=virtcon -device virtconsole,chardev=virtcon \
    -device virtio-net-device,netdev=usernet \
    -netdev user,id=usernet,hostfwd=tcp::22222-:22 \
    -object rng-random,filename=/dev/urandom,id=rng0 -device virtio-rng-device,rng=rng0 \
    -bios fw_payload.elf \
    -monitor null \
    -drive file=lmp-factory-image-qemuriscv64.wic,format=raw,id=hd0 -device virtio-blk-device,drive=hd0 \



You can register your device following the steps from Register your device.