run-qemu.py

[lool]

Add a new run-qemu.py helper script and update docs.

• feat(scripts): Add run-qemu helper
• refactor: Update README to use new run-qemu.py

Fixes: #66

[github-actions]

Test Results

 2 files  ±0   6 suites  ±0   13m 38s ⏱️ ±0s
20 tests ±0  20 ✅ ±0  0 💤 ±0  0 ❌ ±0 
64 runs  ±0  64 ✅ ±0  0 💤 ±0  0 ❌ ±0 

Results for commit 42e8ba5. ± Comparison against base commit e6d5312.

[github-actions]

Test jobs for commit 42e8ba5

• Job 110360 on qcs6490
• Job 110359 on qrb2210-rb1

[github-actions]

Test jobs for commit bdeb207

• Job 110358 on qrb2210-rb1
• Job 110357 on qcs6490
• Job 110374 on qcs6490

[lool]

I tested this with:

• ufs and sdcard images from our fileserver
• on macOS and Linux
• in the default GUI mode and in headless
• passing extra args like memory
• passing image file

This is a typical run on macOS:

% /path/to/run-qemu.py
Running: qemu-img create -b /Users/lminier/Downloads/daily-2025-10-14/disk-ufs.img -f qcow2 -F raw /var/folders/ck/_x41b6f91x993rvpkh0sw1nm04fpg8/T/qemu-cow-g2144upc/overlay.qcow
Formatting '/var/folders/ck/_x41b6f91x993rvpkh0sw1nm04fpg8/T/qemu-cow-g2144upc/overlay.qcow', fmt=qcow2 cluster_size=65536 extended_l2=off compression_type=zlib size=4294967296 backing_file=/Users/lminier/Downloads/daily-2025-10-14/disk-ufs.img backing_fmt=raw lazy_refcounts=off refcount_bits=16
Running: qemu-system-aarch64 -cpu cortex-a57 -m 2048 -M virt -device virtio-gpu-pci -display cocoa -device usb-ehci,id=ehci -device usb-kbd -device usb-mouse -device virtio-scsi-pci,id=scsi1 -device scsi-hd,bus=scsi1.0,drive=disk1,physical_block_size=4096,logical_block_size=4096 -drive if=none,file=/var/folders/ck/_x41b6f91x993rvpkh0sw1nm04fpg8/T/qemu-cow-g2144upc/overlay.qcow,format=qcow2,id=disk1 -bios /opt/homebrew/opt/qemu/share/qemu/edk2-aarch64-code.fd

and on Debian:

/path/to/run-qemu.py --headless --image /path/to/disk-ufs.img
Running: qemu-img create -b /path/to/disk-ufs.img -f qcow2 -F raw /tmp/qemu-cow-knc3124_/overlay.qcow
Formatting '/tmp/qemu-cow-knc3124_/overlay.qcow', fmt=qcow2 cluster_size=65536 extended_l2=off compression_type=zlib size=4294967296 backing_file=/path/to/disk-ufs.img backing_fmt=raw lazy_refcounts=off refcount_bits=16
Running: qemu-system-aarch64 -cpu cortex-a57 -m 2048 -M virt -device virtio-gpu-pci -display none -device usb-ehci,id=ehci -device usb-kbd -device usb-mouse -device virtio-scsi-pci,id=scsi1 -device scsi-hd,bus=scsi1.0,drive=disk1,physical_block_size=4096,logical_block_size=4096 -drive if=none,file=/tmp/qemu-cow-knc3124_/overlay.qcow,format=qcow2,id=disk1 -bios /usr/share/qemu-efi-aarch64/QEMU_EFI.fd -serial mon:stdio
UEFI firmware (version 2025.02-8 built at 02:18:11 on May 13 2025)

I can jump to the systemd-boot menu both in GUI and headless mode; I can see console boot messages and getty in headless mode, but not in GUI mode, and I can see the desktop in GUI mode.