Documentation
¶
Overview ¶
Headless go-virtio validate harness: boots tamago/amd64 under QEMU, drives a real virtio-gpu-pci device through the go-virtio/gpu 2D framebuffer driver, renders a soft3d cube into the framebuffer, flushes it to the host scanout, and reports a pixel checksum over the serial console. The screendump-based pixel validation is performed by the host harness (run.sh) against the QEMU monitor.
NOTE: an earlier version of this harness capped the framebuffer at 96x72 because the guest appeared to "#DF after a fixed compute budget" under QEMU TCG. That was a misdiagnosis: it was not a CPU double fault but the legacy 8259 PIT (IRQ0) firing on IDT vector 8 (the #DF slot) because the board never masked the legacy PIC while routing through the I/O APIC. The board now masks the PIC (board.Init: outb(0x21, 0xff)), so sustained compute is safe and the framebuffer runs at full resolution.