Files
VCCPlusOSS/platforms/macos/Resources/StarterMedia/README.md
T

3.9 KiB

Authored starter media

These examples are original GPL-3.0-or-later contributions for VCC Plus. They contain no ROM code or third-party programs. The DSK is a 35-track, single-sided, Disk BASIC-initialized 161,280-byte image. The CAS contains one BASIC program, saved through the emulated cassette interface.

The BASIC source for all three starter profiles is Earth or Mars. The floppy stores it as HELLO.BAS and the tape stores it as HELLO. At the menu, press 1 for Earth or 2 for Mars. The greeting appears in 40 columns on a blue or red background, then the normal BASIC prompt returns.

On a fresh packaged-app launch, FD0 contains a writable private copy of the disk and the cassette contains a stopped copy of the tape. Disk BASIC starts with an empty program. Nothing types commands, loads either example into RAM, or runs it automatically.

When ready, type LOAD"HELLO" and then RUN for the disk. For the tape, open Media → Cassette, press Play, type CLOAD"HELLO", and then RUN. Tape Play can wait for BASIC to turn on the motor. NEW clears the current BASIC program before trying the other example.

From the repository root, reproduce and verify both files using the Release VCCCoreChecks runner:

VCCCoreChecks --starter-media /private/path/coco3.rom /private/path/disk11.rom platforms/macos/Resources/StarterMedia

The generator in tests/core/RomBootCheck.cpp formats the disk with DSKINI0, saves the same program with SAVE/CSAVE, then independently boots and reloads/runs them on 6809 and 6309 before writing output. ROM inputs are read-only and stay outside Git. Replacing these source examples never overwrites an installed user's modified copies.

Hard Drive BASIC templates

Hello Hard Disk.dsk is an authored BASIC volume with the same HELLO.BAS in volume 0. CoCo SDC receives its own floppy copy as HELLO.DSK with HELLO.BAS inside.

Blank Disk.dsk is a BASIC-initialized empty volume. Both are 161,280 bytes. StarterKit.seedHardDisk expands these into Hello World.vhd: an empty OS-9 data filesystem occupying $05A000 * 256 bytes, the Hello volume, then 255 blank volumes. Total size is 135,659,520 bytes. Only the user's local working VHD is generated; no 129 MiB image needs to live in Git or the app bundle.

The compatible offset/volume layout is described in the Color Computer Archive empty-disk readme. Its downloaded VHD is not the shipped template. None of its bytes, deleted data or OS-9 filesystem are copied. Our prefix uses an independently authored empty OS-9 filesystem and contains no operating system. ROM inputs remain private.

Reproduce the small templates through the real emulator with the supplied RGBDOS ROM:

VCCCoreChecks --hard-basic-media /private/path/coco3.rom /private/path/rgbdos.rom \
  'platforms/macos/Resources/StarterMedia/Hello World.dsk' /path/to/output-folder

The generator formats volume 0 through RGBDOS (DSKINI0, confirming its erase prompt), captures the blank volume, saves the program with BASIC SAVE, and builds a fresh image in memory. On both CPUs it checks no automatic loading, hard-disk LOAD/RUN, physical-floppy LOAD/RUN through DRIVE OFF, returning with DRIVE ON, and saving/reopening a file on virtual volume 255 without modifying earlier volumes. Output is written only after all checks pass. Packaging compares regenerated templates byte for byte before signing.

Blank OS9 Header.bin is an original deterministic 8 KiB RBF filesystem header, generated by platforms/macos/Tools/make-os9-data-header.py. Together with a zero-filled 90 MiB prefix it defines an empty data filesystem; it contains no OS modules or archived bytes. New shared VHDs use it before their unchanged 256 BASIC volumes. Existing zero-filled prefixes are initialized only during guarded NitrOS-9 profile loads, with a backup. See docs/macos/NITROS9_PROFILE.md.