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.