This is a cache of https://vccplus.brianholman.com/manuals/software-storage-and-peripherals/field-guide/. It is a snapshot of the page as it appeared on 2026-11-21T00:01:22.826+0000.
What have I got? · Software, Storage, and Peripherals · VCC Plus
← Manual LibraryVCC Plus 3.7.1 · Reading on the web

Try the exercises in VCC Plus. Example links download files here; open them in the app to work beside the emulator.

The complete book · PDF editionBook 5: Software, Storage, and Peripherals

41 pages · VCC Plus 3.7.1 · Keep a copy to read or print.

Download PDF
Contents

Appendix A

What have I got?

Start here if someone has handed you a folder of CoCo files. Pick one file and look at its name in Finder. If macOS hides its ending, use File → Get Info → Name & Extension. Keep the folder together. A readme beside a disk can tell you which machine to use, which disk to insert first, and which key starts the program.

Pick up the practice files

Make a Cargo Practice folder in Finder. Choose a link below. In the app reader, a disk or cassette opens a save panel so you can keep your own copy. From a web preview, move the downloaded file into Cargo Practice before attaching it. If you opened the HTML directly from Finder, you can copy the file from the book’s media folder in Finder. A BASIC source link opens an editable example in the native reader. In a browser you can save the source and open it in Develop → BASIC Development….

File What you'll find Where to start
BLANK.DSK An empty floppy with a Disk BASIC directory already prepared. Save your copy as CARGO.DSK for the first exercise. Make your own cargo disk
CARGO.DSK The finished floppy. Its directory contains one BASIC program called CARGO. Use your own copy of this image to join the course at the SD card or working-copy exercise. Carry a disk to an SD card
CARGO.CAS A cassette with a recording of that same program under the name CARGO. Find the recording
CARGO.bas One line you can edit or type at the BASIC prompt. It prints CARGO ORIGINAL. Follow a program from RAM to disk
VOICE.bas A BASIC program for the Speech/Sound cartridge. The output chapter explains the required firmware and the result to expect. Try the sound cartridges

If you've already made your own CARGO.DSK, give the supplied finished disk a different Finder folder. That lets you compare your work without replacing anything.

Which device opens this file?

You found Look for First move in VCC Plus
A .dsk or .jvc floppy image A readme or catalog entry naming Disk BASIC, another operating system, or a particular controller. The filename's ending alone does not tell you which filesystem it contains. In Floppy Disks…, mount a copy in the drive named by the program, usually FD0. Enable Write protected for the first look. A Disk BASIC directory is useful evidence on a BASIC disk.
A .dmk or .vdk floppy A track image or a disk with a header. DMK can carry information about individual tracks that a simple sector image omits. Start with the FD-502. It accepts supported DMK and uncompressed VDK images. Save As… preserves their representation. Renaming a file to .dsk does not convert its contents.
A folder containing several disk images, perhaps with startup.cfg Directions that name CoCo SDC or SDC-DOS. A program may expect later disks under their original names. Choose a copy of the folder as the card in the CoCo SDC slot. Keep it protected while exploring. The SDC accepts ordinary flat sector images and a narrower range of headers than the FD-502. Choose the controller the author tested.
A .vhd, .os9 or .img file Notes identifying a virtual hard disk or a floppy. Both the device and the filesystem matter. An .os9 file can be a floppy image. Use Virtual Hard Disks… for a documented hard disk and Floppy Disks… for a supported floppy. Read the drive-zero map before writing.
A .cas or .wav tape A title and a loading command in its instructions. WAV can also be ordinary audio. Use Cassette… → Insert… on a CoCo tape image. Rewind, choose Play and use the guest loading command for that recording.
A .ccc or cartridge ROM A cartridge label or release notes. Firmware for a controller can have a .rom or .bin ending too. For a program cartridge, use Cartridges…, choose a ROM cartridge and its startup slot. For controller firmware, use the named device’s own ROM control.
A .bin program An author’s instruction to use LOADM and EXEC, or a description of a CoCo loadable binary. A supported block-format binary can use File → Load Binary… in the expected machine setup. Save the current program in RAM first. For a binary already inside a disk image, follow the guest instructions for that disk.
A .bas listing or a ZIP download Is the .bas readable text? Does the archive contain a readme, several files or some combination of formats? Open plain-text BASIC source in BASIC Development…. A tokenized file inside a CoCo disk belongs to the guest. For a Library edition, use the installer and read the selected edition's instructions. For a personal ZIP, unpack a copy and examine the contents.

What is the machine telling me?

Opening a floppy-compatible file in Finder or File → Open Media… now asks whether to Edit Disk Image or Insert into Floppy Drive. Editing is the default for a general open. For insertion, select FD0–FD3 and Keep current state, Pause or Run. Run resumes only after insertion succeeds; it does not type a boot command or start a program from the disk. An OS-9 file can also retain its hard-disk insertion choice. Use the explicitly named device in the table above when you already know where the image belongs. Inspect disk files from the Mac explains the editor's separate save and restart rules.

You see Check one thing first What to do with the answer
A familiar directory, but your new program is missing Which profile and which drive answered? Under RGB-DOS, compare the floppy and hard-disk routes. Under SDC-DOS, check the mounted image. Use the VZERO experiment to tell two directories apart.
BASIC says ?WP ERROR Open the row for the drive you actually used. Does it say Write protected? Leave protection on for a treasured disk. Write the program still in RAM to a separate writable copy. Prove which copy changed.
BASIC returned to OK but the Mac says Unsaved changes Is the row set to Temporary changes, or is it a new disk with no backing file? Choose Save As… and use a distinct filename. Check which filename the drive row shows afterward.
The Mac reports a failed save Is the backing volume disconnected, read-only, or changed by another program? Reconnect a missing volume and use Retry Save. If another copy changed, rescue the pending guest edits with Save As… under a new name. Keep both until you compare them.
The disk is mounted, but typing does nothing Does the Mac toolbar offer Run? Is the CoCo display focused? Resume a paused machine and choose Input → Focus CoCo Display. Then give the guest its loading command.
BASIC keeps looking for a tape file Is the right tape inserted, rewound and set to Play? Cue it again and check the guest filename. A Mac filename and the name recorded on the tape can differ.
A title starts at an unexpected prompt Which slot supplied the startup ROM? Does the selected edition require a manual loading step? Read the title's instructions. Check the cartridge assignment before changing RAM or installing another ROM.
A newly attached sound cartridge stays quiet Does its slot show the required firmware? Is sound muted, or is the machine paused? Try the known sound exercise. A sound device may be waiting for a command from a program.
An image is unavailable after moving it in Finder Which file path does the app remember? Put it back and retry, or choose the file in its new location. A saved profile keeps file locations. It cannot reconstruct a missing file.

For a supported OS-9 image, the editor also offers Move To… and folder drops for regular files inside the same disk. This does not add folders to Disk BASIC or transfer a file between two disk images.

Original VCC Plus manuals © 2026 Brian K. Holman. Third-party references retain their authors’ copyrights and licenses. Artwork notices. Edition 3.7.1; source and export identity. Printable edition: PDF source and export identity.

A closer look

Open original