Necessary artifacts

└── arm64
    ├── lmp-factory-image-qemuarm64-secureboot.wic.gz
    └── flash.bin

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/arm64
    cd lmp-qemu/arm64
  2. Download the necessary artifacts for arm64, replace <target_number> with the target you would like to boot

    # Download and extract the Factory image
    fioctl targets artifacts <target_number> qemuarm64-secureboot/lmp-factory-image-qemuarm64-secureboot.wic.gz | gunzip > lmp-factory-image-qemuarm64-secureboot.wic
    # Download ATF + OP-TEE + U-Boot binary
    fioctl targets artifacts <target_number> qemuarm64-secureboot/flash.bin > flash.bin
  3. The directory tree should now look like this

    └── arm64
        ├── lmp-factory-image-qemuarm64-secureboot.wic
        └── flash.bin
  4. Run the QEMU script below against the artifacts inside of lmp-qemu/. You may want to save this as inside the directory for convenience


The QEMU CLI passes the necessary flags and parameters to the appropriate qemu-system command, such as image, CPU, network, and other device information. For specifics, consult QEMU’s Documentation.

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-aarch64 -m 1024 -cpu cortex-a57 -no-acpi -bios flash.bin \
   -device virtio-net-device,netdev=net0,mac=52:54:00:12:35:02 -device virtio-serial-device \
   -drive id=disk0,file=lmp-factory-image-qemuarm64-secureboot.wic,if=none,format=raw \
   -device virtio-blk-device,drive=disk0 -netdev user,id=net0,hostfwd=tcp::2222-:22 \
   -object rng-random,filename=/dev/urandom,id=rng0 -device virtio-rng-pci,rng=rng0 \
   -chardev null,id=virtcon -machine virt,secure=on -nographic


It is possible to access QEMU via SSH by appending these parameters to the QEMU CLI command above:

-netdev user,id=net0,hostfwd=tcp::2222-:22

Then, run SSH with:

ssh -p 2222 fio@localhost



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