Files
RedBear-OS/local/scripts/test-wifi-passthrough-qemu.sh
T
vasilito 6dab9b2953 tests: migrate remaining QEMU runtime proofs to qemu-login-expect.py
Convert the remaining expect-based test scripts (phase1-6 runtime, usb,
wifi, bluetooth, dbus, greeter, live-iso, posix) to the stdlib python
harness, completing the migration started in 9ec00d4c81. Each script now
prefers booting the live ISO when present (falling back to harddrive.img
with snapshot=on), and retries up to 5 times when QEMU exits early or is
killed (rc 3 / 137) — the host-contention failure mode recorded in the
2026-07-20 runtime-proof status.

qemu-login-expect.py: treat an incomplete step sequence as a failure even
when a pass marker was seen partway through — partial sequences must not
count as a pass.
2026-07-20 09:01:14 +09:00

186 lines
6.3 KiB
Bash

#!/usr/bin/env bash
# Launch Red Bear OS with an Intel Wi-Fi PCI device passed through for runtime validation.
set -euo pipefail
find_uefi_firmware() {
local candidates=(
"/usr/share/ovmf/x64/OVMF.4m.fd"
"/usr/share/OVMF/x64/OVMF.4m.fd"
"/usr/share/ovmf/x64/OVMF_CODE.4m.fd"
"/usr/share/OVMF/x64/OVMF_CODE.4m.fd"
"/usr/share/ovmf/OVMF.fd"
"/usr/share/OVMF/OVMF_CODE.fd"
"/usr/share/qemu/edk2-x86_64-code.fd"
)
local path
for path in "${candidates[@]}"; do
if [[ -f "$path" ]]; then
printf '%s\n' "$path"
return 0
fi
done
return 1
}
capture_output=""
usage() {
cat <<'EOF'
Usage: test-wifi-passthrough-qemu.sh --host-pci 0000:xx:yy.z [--check] [--capture-output PATH] [extra qemu args...]
Boot Red Bear OS with an Intel Wi-Fi PCI function passed through via VFIO and optionally run the
bounded in-guest Wi-Fi runtime check.
Options:
--host-pci BDF Host PCI address of the Intel Wi-Fi device to pass through (required)
--check Auto-login and run redbear-phase5-network-check plus the bounded Wi-Fi runtime check
--capture-output PATH Save the in-guest Wi-Fi capture bundle to a host-side file during --check
-h, --help Show this help text
Notes:
- The host device must already be detached from the host driver and bound to vfio-pci.
- This script only provides the launch/check harness. Real success still depends on Red Bear OS
runtime behavior on the passed-through hardware.
EOF
}
host_pci=""
check_mode=0
filtered_args=()
while [[ $# -gt 0 ]]; do
case "$1" in
--host-pci)
if [[ $# -lt 2 ]]; then
echo "ERROR: --host-pci requires a PCI BDF" >&2
exit 1
fi
host_pci="$2"
shift 2
;;
--check)
check_mode=1
shift
;;
--capture-output)
if [[ $# -lt 2 ]]; then
echo "ERROR: --capture-output requires a path" >&2
exit 1
fi
capture_output="$2"
shift 2
;;
--help|-h)
usage
exit 0
;;
*)
filtered_args+=("$1")
shift
;;
esac
done
if [[ -z "$host_pci" ]]; then
echo "ERROR: --host-pci is required" >&2
usage
exit 1
fi
firmware="$(find_uefi_firmware)" || {
echo "ERROR: no usable x86_64 UEFI firmware found" >&2
exit 1
}
arch="${ARCH:-$(uname -m)}"
config="redbear-full"
iso="build/$arch/$config.iso"
image="build/$arch/$config/harddrive.img"
extra="build/$arch/$config/extra.img"
boot_args=()
if [[ -f "$iso" ]]; then
boot_args=(-cdrom "$iso")
elif [[ -f "$image" ]]; then
boot_args=(-drive file="$image",format=raw,if=none,id=drv0,snapshot=on -device nvme,drive=drv0,serial=NVME_SERIAL)
else
echo "ERROR: no bootable image found ($iso or $image)" >&2
echo "Build it first with: ./local/scripts/build-redbear.sh $config" >&2
exit 1
fi
if [[ ! -f "$extra" ]]; then
truncate -s 1g "$extra"
fi
vfio_arg="vfio-pci,host=${host_pci}"
if [[ "$check_mode" -eq 1 ]]; then
capture_output="${capture_output:-$(pwd)/wifi-passthrough-capture.json}"
capture_log="build/$arch/$config/wifi-passthrough-check.log"
attempt=1
while true; do
rc=0
python3 local/scripts/qemu-login-expect.py \
--timeout 420 \
--log "$capture_log" \
--step "expect:login:" \
--step "send:root" \
--step "expect:assword:" \
--step "send:password" \
--step "expect:Type 'help' for available commands." \
--step "send:redbear-phase5-network-check" \
--step "expect:Red Bear OS Phase 5 Networking Check" \
--step "send:redbear-phase5-wifi-run wifi-open-bounded wlan0 /tmp/redbear-phase5-wifi-capture.json" \
--step "expect:Red Bear OS Phase 5 Wi-Fi Check" \
--step "expect:PASS: bounded Intel Wi-Fi runtime path exercised on target" \
--step "expect:capture_output=/tmp/redbear-phase5-wifi-capture.json" \
--step "expect:root@" \
--step "send:wc -c /tmp/redbear-phase5-wifi-capture.json" \
--step "expect:/tmp/redbear-phase5-wifi-capture.json" \
--step "send:printf 'CAPTURE-BEGIN\n'; cat /tmp/redbear-phase5-wifi-capture.json; printf '\nCAPTURE-END\n'" \
--step "expect:CAPTURE-BEGIN" \
--step "expect:CAPTURE-END" \
--step "send:shutdown" \
--pass_marker "CAPTURE-END" \
-- \
qemu-system-x86_64 -name "Red Bear OS Wi-Fi Passthrough" -device qemu-xhci -smp 4 -m 4096 -bios "$firmware" -chardev stdio,id=debug,signal=off,mux=on -serial chardev:debug -mon chardev:debug -machine q35 -device ich9-intel-hda -device hda-output -device vfio-pci,host=$host_pci -vga std "${boot_args[@]}" -drive file="$extra",format=raw,if=none,id=drv1,snapshot=on -device nvme,drive=drv1,serial=NVME_EXTRA -enable-kvm -cpu host "${filtered_args[@]}" || rc=$?
if [[ $rc -eq 0 ]]; then
break
fi
if [[ ( $rc -eq 3 || $rc -eq 137 ) && $attempt -lt 5 ]]; then
attempt=$((attempt + 1))
echo "QEMU exited before completing the check; retrying (attempt $attempt/5)"
sleep 2
continue
fi
exit "$rc"
done
# The original expect script used a -re capture group to extract the JSON
# bundle between CAPTURE-BEGIN/CAPTURE-END. The stdlib helper logs all
# serial output, so pull the bundle out of the log here.
awk '/^CAPTURE-BEGIN$/{f=1; next} /^CAPTURE-END$/{f=0} f' "$capture_log" > "$capture_output"
echo "capture_output=$capture_output"
exit 0
fi
exec qemu-system-x86_64 \
-name "Red Bear OS Wi-Fi Passthrough" \
-device qemu-xhci \
-smp 4 \
-m 4096 \
-bios "$firmware" \
-chardev stdio,id=debug,signal=off,mux=on \
-serial chardev:debug \
-mon chardev=debug \
-machine q35 \
-device ich9-intel-hda -device hda-output \
-device "$vfio_arg" \
-vga std \
-drive file="$image",format=raw,if=none,id=drv0 \
-device nvme,drive=drv0,serial=NVME_SERIAL \
-drive file="$extra",format=raw,if=none,id=drv1 \
-device nvme,drive=drv1,serial=NVME_EXTRA \
-enable-kvm -cpu host \
"${filtered_args[@]}"