This is a cache of https://vccplus.brianholman.com/publications/vcc-plus-architecture/. It is a snapshot of the page as it appeared on 2026-11-21T00:00:35.554+0000.
From Windows Application to Portable Emulation Platform · VCC Plus
← Technical publications

White paper

From Windows Application to Portable Emulation Platform

Architecture, Correctness, and Verified Debugging in VCC Plus

Abstract

Legacy emulators preserve detailed hardware models within applications whose operating-system dependencies can obstruct reuse and verification. In VCC Plus, I separate the Windows-oriented Virtual Color Computer engine into explicit processor, memory, machine-service, and video contracts. A serialized native macOS host composes those components. The extraction exposed defects in instruction operand timing, reset state, interrupt lifetime, raster bounds and storage transfers. Additional CMOC corrections account for effective-address dependencies and condition-code liveness that arithmetic-only optimizer reasoning had discarded. The resulting development platform binds debugging interpretations to executable bytes, compiler metadata, physical mappings and immutable machine observations. It supports conservative stack and variable inspection, bank-aware source debugging, interpreter-aware BASIC stepping, historical tracing and bounded call-context inspection. Process-isolated workers add field-counted input, retry-safe control and graphics/audio evidence without sharing the user's running machine. Guest-library ownership contracts and transactional disk editing extend the same discipline to mappings, interrupts and writable media. I evaluate the design through mechanism-specific regressions, observation-invariance checks, a bounded XRoar comparison, and target-executed compiler cases. A correctness-gated optimization study connects measured code size and guest cycles to the tradeoff between frame omission and inspectable storage. The results show how host decoupling and evidence-backed runtime interpretation can reinforce one another while retaining a mature emulator's useful implementation.

Keywords: emulator architecture; legacy software modernization; Color Computer; MC6809; HD6309; source-level debugging; runtime observability; differential testing.

Attribution and rights · Designed by Brian Holman · Sponsored by Dezota LLC

A closer look

Open original