arm64

Necessary artifacts

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

Booting in QEMU

Warning

These instructions require QEMU 5.2 or later.

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

    fioctl targets list
    

Note

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

    lmp-qemu/
    └── arm64
        ├── lmp-factory-image-qemuarm64.wic
        └── flash.bin
    
  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 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.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

Demo

Tip

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