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

38 lines
3.9 KiB
Markdown

# 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](../../../../examples/basic/planet.bas). 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:
```sh
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](https://colorcomputerarchive.com/repo/Virtual%20Hard%20Drives/Empty%20Hard%20Disk/readme.txt). 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:
```sh
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`.