x86_64¶

Necessary artifacts

└── x86_64
    ├── lmp-factory-image-intel-corei7-64.wic.gz
    └── ovmf.qcow2

Booting in QEMU¶

Warning

These instructions require QEMU 5.2 or later.

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>

Make a directory to store the artifacts and cd into it.
```
mkdir -p lmp-qemu/x86_64
cd lmp-qemu/x86_64
```

Download the necessary artifacts for x86_64, replace <target_number> with the target you would like to boot

# Download and extract the Factory image
fioctl targets artifacts <target_number> intel-corei7-64/lmp-factory-image-intel-corei7-64.wic.gz | gunzip > lmp-factory-image-intel-corei7-64.wic
# Download OVMF UEFI Firmware
fioctl targets artifacts <target_number> intel-corei7-64/ovmf.qcow2 > ovmf.qcow2

The directory tree should now look like this

lmp-qemu/
└── x86_64
    ├── lmp-factory-image-intel-corei7-64.wic
    └── ovmf.qcow2

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

Note

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:

-vga virtio -display gtk,gl=on

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

QEMU CLI¶

qemu-system-x86_64 -m 1024 -cpu kvm64 -enable-kvm -serial mon:stdio -serial null \
  -drive file=lmp-factory-image-intel-corei7-64.wic,format=raw,if=none,id=hd \
  -device virtio-scsi-pci,id=scsi -device scsi-hd,drive=hd -device virtio-rng-pci \
  -drive if=pflash,format=qcow2,file=ovmf.qcow2 \
  -net user,hostfwd=tcp::22223-:22 -net nic -nographic

Tip

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

Demo¶

Tip

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