VCC Plus Diagnostics

Standalone diagnostic disks for the Tandy Color Computer, VCC Plus, and compatible FPGA implementations. Designed by Brian Holman · Sponsored by Dezota LLC.

Diagnostic Tagged release Get started
Sound Lab SL1-44B5F46F Use Disk BASIC and a Speech/Sound Cartridge. Boot a writable copy in drive 0 with DOS.
FPGA Colour Lab CL1 Use Disk BASIC and enable compatible FPGA 256-color support. Leave the Speech/Sound Cartridge out. Run RUN"COLORLAB" from drive 0.

Use a fresh machine session and keep a pristine disk master. The release pages link to the exact disk, checksum and source package hosted in the VCC Plus download area. The compatibility paper identifies the results obtained with these disk revisions.

Build from a tag

Check out the release tag for the diagnostic you want to reproduce.

Sound Lab

Use Python 3.10 or later and VCC Plus 3.7.1 build 67's installed Mac toolchain, which supplies CMOC 0.1.101, LWTools 4.25, the guest SSC and Disk BASIC libraries, and the disk writer and boot-loader installer. The macOS command below assumes the application is installed in Applications.

export PYTHONDONTWRITEBYTECODE=1
python3 examples/sound-lab/check.py \
  --toolchain '/Applications/VCC Plus.app/Contents/Resources/Toolchain' \
  --output .build/sound-lab-sl1

This runs the host checks, builds the disk, and records the input and output hashes. The published source package contains the build inputs for the guest libraries and the source or build recipes for the toolchain components used by this release. See Sound Lab operation and reporting.

The optional headless VCC test compiles the retained runner against a local VCC Plus checkout and built core library. On macOS set CPATH to <VCCPlus checkout>/tests/toolchain/ssc, then add --core and --roms with the paths to the core library and your local ROM directory. The test boots a disposable copy and measures digital behavior and audio activity. Listening assessments are recorded separately.

FPGA Colour Lab

Use Python 3 and LWASM 4.25. The builder accepts an executable path on Mac or Windows:

python3 examples/fpga256/build.py --lwasm /path/to/lwasm --output .build/colour-lab-cl1

On Windows use py -3 and the path to lwasm.exe. See the Colour Lab controls and the Windows FPGA handoff.

Ownership and attribution

Maintain standalone diagnostic sources here. App and FPGA tests consume a specific tagged release and verify the disk hash before making test copies. The examples at the initial tags preserve the source inputs used to build the published disks.

The original diagnostic source is GPL-3.0-or-later. See COPYING. The Sound Lab bootstrap retains Pierre Sarrazin's public-domain notice and credits Roger Schrag. The corresponding Sound Lab sources carry their component notices. FPGA Colour Lab exercises the CoCo3FPGA extension by Gary Becker and the MiSTer adaptation by Stan Hodge, Gary Becker and Alan Steremberg. ROMs are supplied locally by the user for emulator tests.

S
Description
Source and reproducible diagnostic disk releases for the Color Computer, VCC Plus, and FPGA implementations.
Readme GPL-3.0
121 KiB
0 Stars 1 Watchers 0 Forks
2026-11-18 19:30:34 +00:00